Номер версии дистрибутива 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. См. Раздел 5.8, «Отладка 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'. Эта переменная влияет на то, как сервер обрабатывает регистр букв в именах баз данных и таблиц. Её эффект для данного значения должен быть описан в разделе 9.2.3, «Чувствительность к регистру идентификаторов».

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

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