Версия дистрибутива MySQL, которую вы используете (например, MySQL 5.7.10). Вы можете узнать, какую версию вы используете, выполнив команду mysqladmin version. Программа mysqladmin находится в каталоге bin вашей установки MySQL.

Производитель и модель машины, на которой у вас возникла проблема.

Название и версия операционной системы. Если вы работаете с Windows, вы обычно можете получить название и номер версии, дважды щелкнув значок «Мой компьютер» и выбрав меню «“Справка/О Windows“». Для большинства операционных систем Unix-подобного типа вы можете получить эту информацию, выполнив команду uname -a.

Иногда объем памяти (физической и виртуальной) имеет значение. Если вы сомневаетесь, укажите эти значения.

Содержимое файла docs/INFO_BIN из вашей установки MySQL. Этот файл содержит информацию о том, как был сконфигурирован и скомпилирован MySQL.

Если вы используете исходный дистрибутив программного обеспечения MySQL, укажите имя и номер версии компилятора, который вы использовали. Если у вас дистрибутив в виде бинарных файлов, укажите имя дистрибутива.

Если проблема возникла во время компиляции, укажите точные сообщения об ошибках и несколько строк контекста вокруг проблемного кода в файле, где произошла ошибка.

Если mysqld завершился неожиданно, укажите утверждение, которое вызвало неожиданное завершение mysqld. Обычно вы можете получить эту информацию, запустив mysqld с включённой регистрацией запросов, а затем проверив логи после завершения работы mysqld. См. Раздел 7.9, «Отладка MySQL».

Если проблема связана с таблицей базы данных, включите в отчёт вывод от команды SHOW CREATE TABLE db_name.tbl_name. Это очень простой способ получить определение любой таблицы в базе данных. Эта информация поможет нам смоделировать ситуацию, с которой вы столкнулись.

SQL-режим, активный во время возникновения проблемы, может быть значимым, поэтому укажите значение системной переменной sql_mode. Для процедур, функций и триггеров, значение sql_mode должно соответствовать значению, активному при создании объекта. Для хранимой процедуры или функции, команда SHOW CREATE PROCEDURE или SHOW CREATE FUNCTION отображает соответствующий SQL-режим, или вы можете запросить INFORMATION_SCHEMA для получения этой информации:

SELECT ROUTINE_SCHEMA, ROUTINE_NAME, SQL_MODE
FROM INFORMATION_SCHEMA.ROUTINES;

Для триггеров, вы можете использовать следующую команду:

SELECT EVENT_OBJECT_SCHEMA, EVENT_OBJECT_TABLE, TRIGGER_NAME, SQL_MODE
FROM INFORMATION_SCHEMA.TRIGGERS;

Для ошибок или проблем, связанных с производительностью или SELECT утверждениями, всегда следует включать вывод EXPLAIN SELECT ..., а также количество строк, которое генерирует SELECT утверждение. Также следует включить вывод SHOW CREATE TABLE tbl_name для каждой вовлечённой таблицы. Чем больше информации вы предоставите о вашей ситуации, тем больше вероятность, что вам помогут.

Ниже приведен пример очень хорошего отчёта об ошибках. Команды запускаются с помощью командной строки mysql. Обратите внимание на использование \G в качестве разделителя для утверждений, которые в противном случае могут генерировать очень длинные строки вывода, что затрудняет чтение.

mysql> SHOW VARIABLES;
mysql> SHOW COLUMNS FROM ...\G
       <output from SHOW COLUMNS>
mysql> EXPLAIN SELECT ...\G
       <output from EXPLAIN>
mysql> FLUSH STATUS;
mysql> SELECT ...;
       <A short version of the output from SELECT,
       including the time taken to run the query>
mysql> SHOW STATUS;
       <output from SHOW STATUS>

Если ошибка или проблема возникает во время выполнения mysqld, попробуйте предоставить скрипт ввода, который воспроизводит аномалию. Этот скрипт должен включать все необходимые исходные файлы. Чем точнее скрипт воспроизведёт вашу ситуацию, тем лучше. Если вы можете создать воспроизводимый тестовый случай, загрузите его для добавления к отчёту об ошибке.

Если вы не можете предоставить скрипт, то, по крайней мере, включите в отчёт вывод команды mysqladmin variables extended-status processlist для получения некоторой информации о работе вашей системы.

Если вы не можете создать тестовый случай с небольшим количеством строк, или если тестовая таблица слишком велика для включения в отчёт об ошибке (более 10 строк), вы должны экспортировать свои таблицы с помощью mysqldump и создать файл README, который описывает вашу проблему. Создайте сжатый архив ваших файлов с помощью tar и gzip или zip. После отправки отчета об ошибке в базу данных отчетов о проблемах на http://bugs.mysql.com/, перейдите на вкладку «Файлы» в отчёте об ошибках для получения инструкций по загрузке архива в базу данных отчётов об ошибках.

Если вы считаете, что MySQL-сервер возвращает странный результат из-за утверждения, включите не только результат, но и ваше мнение о том, каким должен быть результат, а также объяснение, обосновывающее вашу точку зрения.

При предоставлении примера проблемы лучше использовать имена таблиц, переменных и т. д., которые существуют в вашей реальной ситуации, а не придумывать новые имена. Проблема может быть связана с именем таблицы или переменной. Такие случаи редки, но лучше перестраховаться. В конце концов, вам будет проще предоставить пример, использующий вашу реальную ситуацию, и это определённо лучше для нас. Если у вас есть данные, которые вы не хотите показывать другим в отчёте об ошибках, вы можете загрузить их, используя вкладку «Файлы», как описано ранее. Если информация действительно является строго конфиденциальной и вы не хотите показывать её даже нам, используйте другие имена в примере, но, пожалуйста, рассматривайте это как последний вариант.

При возможности включите все опции, заданные соответствующим программам. Например, укажите опции, которые вы используете при запуске сервера mysqld, а также опции, которые вы используете для запуска любых программных клиентов MySQL. Опции для программ, таких как mysqld и mysql, а также для скрипта configure, часто являются ключевыми для решения проблем и очень актуальны. Их включение никогда не будет лишним. Если ваша проблема связана с программой, написанной на языке, таком как Perl или PHP, укажите номер версии процессора языка, а также версии любых модулей, которые использует программа. Например, если у вас есть скрипт Perl, который использует модули DBI и DBD::mysql, укажите номера версий Perl, DBI и DBD::mysql.

Если ваш вопрос связан с системой привилегий, укажите вывод от mysqladmin reload и все сообщения об ошибках, которые возникают при попытке подключения. При проверке ваших привилегий следует выполнить mysqladmin reload version и попытаться подключиться с помощью программы, которая вызывает проблемы.

Если у вас есть исправление для ошибки, укажите его. Но не предполагайте, что исправление - это всё, что нам нужно, или что мы можем его использовать, если вы не предоставите необходимую информацию, такую как тестовые случаи, демонстрирующие ошибку, которую исправляет ваше исправление. Мы можем найти проблемы с вашим исправлением или можем его вообще не понять. В таком случае, мы не сможем его использовать.

Если мы не сможем проверить точное назначение исправления, мы не будем его использовать. Тестовые случаи нам в этом помогут. Покажите, что исправление обрабатывает все возможные ситуации. Если мы найдём пограничный случай (даже редкий), в котором исправление не работает, оно может быть бесполезным.

Предположения о том, в чём заключается ошибка, почему она возникает или от чего она зависит, обычно неверны. Даже команда MySQL не может сделать таких предположений, не используя отладчик для определения реальной причины ошибки.

Укажите в отчёте об ошибке, что вы проверили справочник и архив сообщений, чтобы другие знали, что вы пытались решить проблему самостоятельно.

Если ваши данные выглядят повреждёнными или при доступе к определённой таблице возникают ошибки, сначала проверьте свои таблицы с помощью CHECK TABLE. Если эта команда сообщит об ошибках:

Если вы работаете в Windows, пожалуйста, проверьте значение lower_case_table_names с помощью команды SHOW VARIABLES LIKE 'lower_case_table_names'. Эта переменная влияет на то, как сервер обрабатывает регистр букв в именах баз данных и таблиц. Её влияние для данного значения должно быть описано в Разделе 11.2.3, «Чувствительность к регистру идентификаторов».

Если у вас часто возникают повреждённые таблицы, вы должны попытаться выяснить, когда и почему это происходит. В этом случае журнал ошибок в каталоге данных MySQL может содержать информацию о произошедшем. (Это файл с суффиксом .err в имени.) См. Раздел 7.4.2, «Журнал ошибок». Пожалуйста, включите любую соответствующую информацию из этого файла в свой отчёт об ошибке. Обычно mysqld не должен повреждать таблицу, если ничего не прервало её обновление. Если вы сможете найти причину завершения работы mysqld, нам будет гораздо легче предоставить вам исправление проблемы. См. Раздел B.3.1, «Как определить причину проблемы».

Если возможно, загрузите и установите последнюю версию сервера MySQL и проверьте, решит ли это вашу проблему. Все версии программного обеспечения MySQL тщательно тестируются и должны работать без проблем. Мы стремимся сделать всё максимально совместимым со старыми версиями, и вы должны иметь возможность без труда переключаться между версиями MySQL. См. Раздел 2.1.2, «Какую версию и дистрибутив MySQL установить».