В этом руководстве используются определённые типографические соглашения:

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

$> type a command here
#> type a command as root here
C:\> type a command here (Windows only)
mysql> type a mysql statement here

Команды выполняются в вашем интерпретаторе команд. В Unix это обычно программа, такая как sh, csh или bash. В Windows эквивалентной программой является command.com или cmd.exe, обычно выполняемая в окне консоли. Инструкции, предваряемые mysql, выполняются в клиенте командной строки mysql.

В некоторых разделах могут быть выделены различные системы, чтобы показать, что команды должны выполняться в двух разных средах. Например, при работе с репликацией команды могут предваряться source и replica:

source> type a mysql statement on the replication source here
replica> type a mysql statement on the replica here

Имена баз данных, таблиц и столбцов часто должны заменяться в инструкциях. Для обозначения необходимости такой замены в этом руководстве используются db_name, tbl_name и col_name. Например, вы можете увидеть инструкцию такого вида:

mysql> SELECT col_name FROM db_name.tbl_name;

Это означает, что при вводе аналогичной инструкции вы должны будете указать свои собственные имена базы данных, таблицы и столбца, возможно, так:

mysql> SELECT author_name FROM biblio_db.author_list;

Ключевые слова SQL не чувствительны к регистру и могут быть записаны в любом регистре. В этом руководстве используются заглавные буквы.

В описаниях синтаксиса квадратные скобки (“[” и “]”) указывают необязательные слова или фразы. Например, в следующей инструкции IF EXISTS является необязательной:

DROP TABLE [IF EXISTS] tbl_name

Когда синтаксический элемент состоит из нескольких альтернатив, альтернативы разделяются вертикальными чертами (“|”). Когда может быть выбран один член из набора вариантов, альтернативы перечисляются в квадратных скобках (“[” и “]”):

TRIM([[BOTH | LEADING | TRAILING] [remstr] FROM] str)

Когда один член из набора вариантов должен быть выбран, альтернативы перечисляются в фигурных скобках (“{” и “}”):

{DESCRIBE | DESC} tbl_name [col_name | wild]

Многоточие (...) указывает на пропуск части инструкции, обычно для предоставления более короткой версии более сложного синтаксиса. Например, SELECT ... INTO OUTFILE является сокращением для формы инструкции SELECT, имеющей дополнительную INTO OUTFILE-строку.

Многоточие также может указывать на то, что предыдущий синтаксический элемент инструкции может повторяться. В приведенном ниже примере могут быть указаны несколько значений reset_option, и каждое из них после первого будет предваряться запятыми:

RESET reset_option [,reset_option] ...

Команды для установки переменных оболочки показаны с использованием синтаксиса оболочки Bourne. Например, последовательность для установки переменной среды CC и выполнения команды configure выглядит так в синтаксисе оболочки Bourne:

$> CC=gcc ./configure

Если вы используете csh или tcsh, вы должны выдавать команды несколько иначе:

$> setenv CC gcc
$> ./configure

Исходные файлы Справочного руководства написаны в формате DocBook XML. HTML-версия и другие форматы генерируются автоматически, в основном с использованием стилей XSL для DocBook. Сведения о DocBook см. на http://docbook.org/

Это руководство первоначально было написано Дэвидом Акмарком и Майклом “Монти” Видениюсом. Оно поддерживается командой документации MySQL, состоящей из Эдварда Гилмора, Стефана Хинца, Дэвида Холлиса, Филипа Олсона, Дэниела Со и Джона Стивенса.