Номер версии используемого вами дистрибутива 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 установить».