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

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

$> 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 и другие форматы производятся автоматически, в основном с использованием стилей DocBook XSL. Сведения о DocBook см. на странице http://docbook.org/

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