Dieses Handbuch verwendet folgende typografische Konventionen:

Wenn Befehle dargestellt werden, die innerhalb eines bestimmten Programms eingegeben werden sollen, gibt die Eingabeaufforderung am Zeilenbeginn das zu verwendende Programm an. Beispielsweise gibt shell> einen Befehl an, der von einer Login-Shell ausgeführt werden soll. mysql> gibt eine Anweisung an, die innerhalb des Clientprogramms mysql ausgeführt wird.

shell> geben Sie hier einen Shell-Befehl ein
mysql> geben Sie hier eine MySQL-Anweisung ein

Die „Shell“ ist Ihr Befehlszeilen-Interpreter. Unter Unix ist das typischerweise ein Programm wie sh, csh oder bash. Unter Windows ist das entsprechende Programm command.com oder cmd.exe, die typischerweise in einem Eingabefenster ausgeführt werden.

Wenn Sie einen Befehl oder eine Anweisung aus einem Beispiel eingeben, geben Sie bitte nicht die Eingabeaufforderung (den Prompt) ein, die in dem Beispiel angegeben ist.

Innerhalb von Anweisungen müssen Datenbank-, Tabellen- und Spaltennamen oftmals ersetzt werden. Das Handbuch verwendet zum Kenntlichmachen, dass eine Ersetzung notwendig ist, db_name, tbl_name und col_name. Beispielsweise könnten Sie folgende Anweisung finden:

mysql> SELECT col_name FROM db_name.tbl_name;

Das bedeutet, dass Sie bei Eingabe einer ähnlichen Anweisung Ihre eigenen Namen für Datenbank, Tabelle und Spalten angeben sollen, beispielsweise so:

mysql> SELECT author_name FROM biblio_db.author_list;

SQL-Schlüsselwörter sind unabhängig von der verwendeten Groß- und Kleinschreibung. Dieses Handbuch verwendet ausschließlich zur besseren Kenntlichmachung Großschreibung.

In Syntaxbeschreibungen geben eckige Klammern (‘[’ und ‘]’) optionale Wörter oder Klauseln an. In folgender Anweisung beispielsweise ist IF EXISTS optional:

DROP TABLE [IF EXISTS] tbl_name

Wenn ein Syntaxelement eine Anzahl von Alternativen hat, werden diese durch vertikale Striche (‘|’) getrennt. Wenn ein Element ausgewählt werden kann, aber nicht muss, werden die Alternativen in eckigen Klammern (‘[’ und ‘]’) angegeben:

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

Wenn ein Element ausgewählt werden muss, werden die Alternativen in geschweiften Klammern (‘{’ und ‘}’) angegeben:

{DESCRIBE | DESC} tbl_name [col_name | wild]

Eine Auslassung (…) gibt an, dass ein Abschnitt einer Anweisung weggelassen wurde, normalerweise, um eine kürzere Version einer komplexeren Syntax darzustellen. Beispielsweise ist INSERT … SELECT die Abkürzung der Form der INSERT-Anweisung, bei der eine SELECT-Anweisung folgt.

Eine Auslassung kann darüber hinaus angeben, dass das vorhergehende Syntaxelement einer Anweisung wiederholt werden kann. Im folgenden Beispiel können mehrere reset_option-Werte angegeben werden, wobei jedem Wert nach dem ersten ein Komma vorangestellt wird:

RESET reset_option [,reset_option] ...

Befehle zum Setzen von Shell-Variablen werden in der Syntax der Bourne-Shell dargestellt, wie beispielsweise die Folge zum Setzen der Umgebungsvariablen CC und der Ausführung des Befehls configure:

shell> CC=gcc ./configure

Wenn Sie csh oder tcsh verwenden, müssen Sie die Befehle etwas anders eingeben:

shell> setenv CC gcc
shell> ./configure