Auf der Befehlszeile angegebene Programmoptionen unterliegen den folgenden Regeln:

Einige Optionen steuern Verhaltensweisen, die sich aktivieren oder deaktivieren lassen. So unterstützt der Client mysql etwa eine Option --column-names, die bestimmt, ob zu Beginn der Abfrageergebnisse eine Zeile mit Spaltennamen angezeigt wird oder nicht. Standardmäßig ist diese Option aktiviert. Unter Umständen kann es jedoch sinnvoll sein, sie zu deaktivieren, wenn Sie beispielsweise die Ausgabe von mysql an ein anderes Programm übergeben, das nur die Daten und keine Kopfzeile erwartet.

Sie können die Spaltennamen mit jeder der folgenden Optionen deaktivieren:

--disable-column-names
--skip-column-names
--column-names=0

Die Präfixe --disable und --skip und das Suffix =0 haben den jeweils gleichen Effekt: Sie schalten die Option ab.

Um die „einschaltende“ Form der Option anzugeben, gibt es die folgenden Möglichkeiten:

--column-names
--enable-column-names
--column-names=1

Wenn einer Option das Präfix --loose vorangestellt wird, bricht ein Programm, dass die Option nicht erkennt, nicht mit einer Fehlermeldung ab, sondern setzt lediglich eine Warnung ab:

shell> mysql --loose-no-such-option
mysql: WARNING: unknown option '--no-such-option'

Das Präfix --loose kann nützlich sein, wenn Sie Programme unter mehreren MySQL-Installationen auf demselben Computer ausführen und die Optionen in einer Optionsdatei auflisten. Eine Option, die unter Umständen nicht von allen Versionen eines Programms erkannt wird, kann mithilfe des Präfixes --loose (bzw. loose in einer Optionsdatei) angegeben werden. Versionen des Programms, die die Option erkennen, werden sie dann in der Regel auch verarbeiten, während Programmversionen, die sie nicht erkennen, eine Warnung absetzen und sie ansonsten ignorieren.

Eine andere Option, die in Verbindung mit mysql gelegentlich nützlich sein kann, ist --execute oder -e. Hiermit können Sie SQL-Anweisungen an den Server übergeben. Die Anweisungen müssen in einfache oder doppelte Anführungszeichen gesetzt sein. Wenn Sie Werte in Anführungszeichen innerhalb einer Anweisung angeben wollen, sollten Sie doppelte Anführungszeichen für die Anweisung selbst und einfache Anführungszeichen für Werte innerhalb der Anweisung benutzen. Wenn Sie diese Option verwenden, führt mysql die Anweisung aus und wird dann beendet.

So können Sie beispielsweise mithilfe des folgenden Befehls eine Liste der Benutzerkonten aufrufen:

shell> mysql -u root -p --execute="SELECT User, Host FROM user" mysql
Enter password: ******
+------+-----------+
| User | Host      |
+------+-----------+
|      | gigan     |
| root | gigan     |
|      | localhost |
| jon  | localhost |
| root | localhost |
+------+-----------+
shell>

Beachten Sie, dass auf die Langform (--execute) das Gleichheitszeichen (=) folgen muss.

In obigem Beispiel wurde der Name der Datenbank mysql als separates Argument übergeben. Dieselbe Anweisung hätte auch mit dem folgenden Befehl ausgeführt werden können, der keine Standarddatenbank angibt:

mysql> mysql -u root -p --execute="SELECT User, Host FROM mysql.user"

Über die Befehlszeile lassen sich mehrere SQL-Anweisungen durch Semikola getrennt angeben:

shell> mysql -u root -p -e "SELECT VERSION();SELECT NOW()"
Enter password: ******
+-----------------+
| VERSION()       |
+-----------------+
| 5.1.5-alpha-log |
+-----------------+
+---------------------+
| NOW()               |
+---------------------+
| 2006-01-05 21:19:04 |
+---------------------+

Die Option --execute oder -e kann auch verwendet werden, um Befehle in analoger Form an ndb_mgm, den Verwaltungsclient für MySQL Cluster, zu übergeben. Ein Beispiel finden Sie in Abschnitt 16.3.6, „Sicheres Herunterfahren und Neustarten“.

Die meisten MySQL-Programme können Startoptionen aus Optionsdateien (die manchmal auch Konfigurationsdateien genannt werden) auslesen. Optionsdateien stellen eine praktische Möglichkeit dar, häufig verwendete Optionen anzugeben, damit sie nicht mehr bei jeder Ausführung eines Programms explizit eingegeben werden müssen.

Um zu ermitteln, ob ein Programm Optionsdateien ausliest, rufen Sie es mit der Option --help auf (--verbose und --help bei mysqld). Wenn das Programm Optionsdateien ausliest, zeigt die Hilfemeldung an, nach welchen Dateien sie sucht und welche Optionsabschnitte (Gruppen) sie erkennt.

Hinweis: Optionsdateien, die für MySQL Cluster-Dateien verwendet werden, werden in Abschnitt 16.4, „MySQL Cluster: Konfiguration“, behandelt.

Unter Windows lesen MySQL-Programme Startoptionen aus den folgenden Dateien aus:

WINDIR steht dabei für die Position Ihres Windows-Verzeichnisses. Dies ist in der Regel C:\WINDOWS oder C:\WINNT. Sie können die exakte Position der Umgebungsvariablen WINDIR entnehmen. Hierzu geben Sie den folgenden Befehl ein:

C:\> echo %WINDIR%

INSTALLDIR steht für das MySQL-Installationsverzeichnis. Dies ist normalerweise C:\PROGRAMDIR\MySQL\MySQL 5.1 Server, wobei PROGRAMDIR das Programmverzeichnis (bei deutschsprachigen Windows-Versionen üblicherweise Programme) ist, wenn MySQL 5.1 mithilfe der Installations- und Konfigurations-Assistenten eingerichtet wurde. Siehe auch Abschnitt 2.3.5.14, „Speicherort der Datei my.ini“.

Unter Unix lesen MySQL-Programme Startoptionen aus den folgenden Dateien aus:

MYSQL_HOME ist eine Umgebungsvariable, die den Pfad angibt, in dem die serverspezifische Datei my.cnf abgelegt ist.

Wenn MYSQL_HOME nicht eingestellt ist und Sie den Server mit dem Programm mysqld_safe starten, versucht mysqld_safe, MYSQL_HOME wie folgt einzustellen:

Normalerweise ist DATADIR /usr/local/mysql/data in einer Binärinstallation bzw. /usr/local/var in einer Quellinstallation. Beachten Sie, dass dies jeweils die Position des Datenverzeichnisses ist, die zum Zeitpunkt der Konfiguration angegeben wurde, und nicht die mit der Option --datadir beim Start von mysqld spezifizierte Position. Die Verwendung von --datadir während der Laufzeit hat keinen Einfluss darauf, wo der Server nach Optionsdateien sucht, denn die Suche erfolgt vor der Verarbeitung ggf. angegebener Optionen.

MySQL sucht in der gerade beschriebenen Reihenfolge nach Optionsdateien und liest diese aus, sofern sie vorhanden sind. Ist eine Optionsdatei, die Sie verwenden wollen, nicht vorhanden, dann können Sie sie mit einem Texteditor erstellen.

Werden mehrere Instanzen einer gegebenen Option gefunden, dann hat die jeweils zuletzt gefundene Instanz immer Vorrang. Es gibt allerdings eine Ausnahme: Bei mysqld wird aus Sicherheitsgründen immer die erste Instanz der Option --user verarbeitet, damit verhindert wird, dass eine Benutzerangabe in einer Optionsdatei über die Befehlszeile außer Kraft gesetzt werden kann.

Hinweis: Auf Unix-Plattformen ignoriert MySQL Konfigurationsdateien, die für alle schreibbar („world-writable“) sind. Dies ist beabsichtigt und dient der Erhöhung der Sicherheit.

Jede Langformoption, die beim Start eines MySQL-Programms über die Befehlszeile angegeben wird, kann ebenso gut auch in einer Optionsdatei spezifiziert werden. Um eine Liste der für ein Programm verfügbaren Optionen zu erhalten, führen Sie es mit der Option --help aus.

Die Syntax zur Angabe von Optionen in einer Optionsdatei ähnelt der Befehlszeilensyntax, nur können Sie die beiden Bindestriche am Anfang weglassen. So werden etwa die Befehlszeilenoptionen --quick oder --host=localhost in einer Optionsdatei als quick bzw. host=localhost angegeben. Um eine Option des Typs --loose-opt_name in einer Optionsdatei anzugeben, schreiben Sie sie als loose-opt_name.

Leerzeilen in Optionsdateien werden ignoriert. Nichtleere Zeilen können die folgenden Formen annehmen:

Bei Optionen, die numerische Werte annehmen, kann dieser mit den Suffixen K, M oder G (in Groß- oder Kleinschreibung) angegeben werden, um einen Multiplikator von 1024, 1024² oder 1024³ anzuzeigen. Der folgende Befehl beispielsweise weist mysqladmin an, 1024 Ping-Befehle im Abstand von jeweils zehn Sekunden an den Server zu senden:

mysql> mysqladmin --count=1K --sleep=10 ping

Bei Optionsnamen oder -werten werden Leerzeichen am Anfang oder Ende automatisch gelöscht. Sie können die Escape-Sequenzen ‘\b’, ‘\t’, ‘\n’, ‘\r’, ‘\\’ und ‘\s’ in Optionswerten zur Darstellung von Rückschritt-, Tabulator-, Zeilenwechsel-, Absatzschaltungs- und Leerzeichen verwenden.

Da die Escape-Sequenz ‘\\’ genau einen Backslash darstellt, müssen Sie jeden Backslash als ‘\\’ schreiben. Alternativ geben Sie den Wert unter Einsatz von ‘/’ statt ‘\’ als Trennzeichen in Pfadnamen an.

Wenn der Name eines Optionsabschnitts mit dem eines Programms identisch ist, gelten die Optionen in diesem Abschnitt speziell für dieses Programm. So betreffen beispielsweise die Abschnitte [mysqld] und [mysql] den Server mysqld bzw. das Clientprogramm mysql.

Der Optionsabschnitt [client] wird von allen Clientprogrammen (aber nicht von mysqld) ausgelesen. Auf diese Weise können Sie Optionen angeben, die für alle Clients gelten. Beispielsweise ist [client] der optimale Abschnitt zur Angabe des Passworts, mit dem Sie die Serververbindung herstellen. (Hierbei müssen Sie natürlich sicherstellen, dass nur Sie die Optionsdatei lesen und in sie schreiben können, damit Dritte Ihr Passwort nicht ermitteln können.) Beachten Sie, dass Sie eine Option nicht im Abschnitt [client] ablegen dürfen, wenn nicht gewährleistet ist, dass alle von Ihnen verwendeten Clientprogramme sie erkennen. Wenn Sie Programme starten, die eine bestimmte Option nicht verstehen, dann zeigen diese eine Fehlermeldung an und werden nachfolgend beendet.

Eine typische Datei mit globalen Optionen sieht so aus:

[client]
port=3306
socket=/tmp/mysql.sock

[mysqld]
port=3306
socket=/tmp/mysql.sock
key_buffer_size=16M
max_allowed_packet=8M

[mysqldump]
quick

Diese Optionsdatei verwendet die Syntax var_name=value für Zeilen, die die Variablen key_buffer_size und max_allowed_packet einstellen.

Eine typische Datei mit Benutzeroptionen sieht so aus:

[client]
# The following password will be sent to all standard MySQL clients
password="my_password"

[mysql]
no-auto-rehash
connect_timeout=2

[mysqlhotcopy]
interactive-timeout

Wenn Sie Optionsabschnitte erstellen wollen, die nur von mysqld-Servern einer bestimmten MySQL-Release-Serie ausgelesen werden sollen, dann sollten Sie Abschnittsnamen in der Form [mysqld-5.0], [mysqld-5.1] usw. verwenden. Der folgende Abschnitt gibt an, dass die Option --new nur von MySQL Servern der Versionsnummern 5.1.x verwendet werden soll:

[mysqld-5.1]
new

Seit MySQL 5.0.4 ist es möglich, !include-Direktiven in Optionsdateien zu verwenden, um andere Optionsdateien zu integrieren. Ebenfalls nutzbar ist !includedir; hiermit wird das Durchsuchen bestimmter Verzeichnisse nach Optionsdateien veranlasst. Um beispielsweise die Datei /home/mydir/myopt.cnf zu integrieren, können Sie die folgende Direktive verwenden:

!include /home/me/myopt.cnf

Wenn Sie das Verzeichnis /home/mydir durchsuchen und die darin vorhandenen Optionsdateien auslesen wollen, würde die Direktive wie folgt aussehen:

!includedir /home/mydir

Hinweis: Zurzeit müssen alle Dateien, die auf Unix-Betriebssystemen mithilfe der Direktive !includedir gesucht und integriert werden sollen, Dateinamen mit der Erweiterung .cnf aufweisen. Unter Windows prüft die Direktive auf Dateien mit den Erweiterungen .ini oder .cnf.

Beachten Sie, dass Optionen, die aus integrierten Dateien ausgelesen werden, im Kontext des aktuellen Optionsabschnitts angewendet werden. Nehmen wir einmal an, Sie würden die folgenden Zeilen in my.cnf ablegen:

[mysqld]
!include /home/mydir/myopt.cnf

In diesem Fall wird die Datei myopt.cnf nur für den Server verarbeitet; die Direktive !include wird von allen Clientanwendungen ignoriert. Würden Sie jedoch wie folgt formulieren, dann würde das Verzeichnis /home/mydir/my-dump-options nur von mysqldump auf Optionsdateien geprüft, nicht jedoch vom Server oder anderen Clientanwendungen:

[mysqldump]
!includedir /home/mydir/my-dump-options

Wenn Sie eine Quelldistribution verwenden, finden Sie Beispieloptionsdateien mit dem Namen my-xxxx.cnf im Verzeichnis support-files. Im Falle einer Binärdistribution schauen Sie im Verzeichnis support-files nach, welches sich im MySQL-Installationsverzeichnis befindet. Unter Windows sind die Beispieloptionsdateien unter Umständen im MySQL-Installationsverzeichnis selbst abgelegt (siehe auch weiter oben in diesem Abschnitt oder in Kapitel 2, Installation von MySQL, wenn Sie nicht wissen, wo sich dieses befindet). Derzeit sind Beispieloptionsdateien für kleine, mittelgroße, große und sehr große Systeme vorhanden. Um mit einer dieser Dateien zu experimentieren, kopieren Sie sie unter Windows als C:\my.cnf bzw. unter Unix als .my.cnf in Ihr Homeverzeichnis.

Hinweis: Unter Windows wird die Dateierweiterung .cnf unter Umständen nicht angezeigt.

Alle MySQL-Programme, die Optionsdateien unterstützen, verarbeiten die folgenden Optionen. Diese betreffen den Umgang mit Optionsdateien, müssen also über die Befehlszeile (und nicht in einer Optionsdatei) angegeben werden. Damit sie einwandfrei funktionieren, müssen die Optionen jeweils unmittelbar auf den Befehlsnamen folgen. Ausgenommen ist --print-defaults, das unmittelbar auf --defaults-file oder --defaults-extra-file angegeben werden muss.

In Shell-Skripten können Sie mit dem Programm my_print_defaults die Optionsdateien durchsuchen und überprüfen, welche Optionen für ein gegebenes Programm verwendet würden. Das folgende Beispiel zeigt eine Ausgabe, die my_print_defaults erzeugen könnte, wenn es die in den Abschnitten [client] und [mysql] gefundenen Optionen anzeigen sollte:

shell> my_print_defaults client mysql
--port=3306
--socket=/tmp/mysql.sock
--no-auto-rehash

Hinweis für Entwickler: Die Verarbeitung von Optionsdateien wird in der C-Clientbibliothek implementiert, indem einfach alle Optionen in dem oder den entsprechenden Abschnitten vor den Befehlszeilenargumenten ausgelesen werden. Dies funktioniert bei Programmen, die das letzte Auftreten einer mehrfach angegebenen Option verwenden, einwandfrei. Wenn Sie jedoch ein C- oder C++-Programm haben, das zwar mehrfach angegebene Optionen verarbeitet, aber die Optionsdateien nicht ausliest, müssen Sie lediglich zwei Zeilen hinzufügen, um diese Funktionalität zu implementieren. Studieren Sie den Quellcode eines beliebigen MySQL-Standardclients, um zu erfahren, wie es gemacht wird.

Mehrere andere Sprachschnittstellen zu MySQL basieren auf der C-Clientbibliothek, und eine davon ermöglicht den Zugriff auf die Inhalte von Optionsdateien. Dies betrifft Perl und Python. Details entnehmen Sie der Dokumentation Ihrer bevorzugten Schnittstelle.

Um eine Option in einer Umgebungsvariablen anzugeben, stellen Sie die Variable unter Verwendung der für Ihren Befehls-Interpreter passenden Syntax ein. Unter Windows oder NetWare etwa können Sie die Variable USER zur Angabe Ihres MySQL-Kontennamens verwenden. Benutzen Sie zu diesem Zweck folgende Syntax:

SET USER=your_name

Die Unix-Syntax hängt von der verwendeten Shell ab. Nehmen wir an, Sie wollen die TCP/IP-Portnummer über die Variable MYSQL_TCP_PORT festlegen. Die typische Syntax (etwa bei sh, bash, zsh usw.) sieht so aus:

MYSQL_TCP_PORT=3306
export MYSQL_TCP_PORT

Der erste Befehl stellt die Variable ein, und der Befehl export exportiert diese dann in die Shell-Umgebung, sodass ihr Wert für MySQL und andere Prozesse verfügbar wird.

Bei csh und tcsh machen Sie die Shell-Variable mithilfe von setenv für die Umgebung verfügbar:

setenv MYSQL_TCP_PORT 3306

Die Befehle zur Einstellung von Umgebungsvariablen können Sie an der Eingabeaufforderung ausführen; sie werden dann sofort gültig, bleiben es aber nur, bis Sie sich abmelden. Damit die Einstellungen bei jeder Anmeldung übernommen werden, legen Sie den oder die entsprechenden Befehle in einer Autostartdatei ab, die Ihr Befehls-Interpreter bei jedem Start ausliest. Typische Autostartdateien sind AUTOEXEC.BAT unter Windows, .bash_profile unter bash oder .tcshrc unter tcsh. Weitere Informationen entnehmen Sie der Dokumentation zu Ihrem Befehls-Interpreter.

Anhang F, Umgebungsvariablen, listet alle Umgebungsvariablen auf, die den Betrieb von MySQL-Programmen beeinflussen.

Viele MySQL-Programme haben interne Variablen, die zur Laufzeit eingestellt werden können. Programmvariablen werden auf die gleiche Weise eingestellt wie andere Langformoptionen, die einen Wert entgegennehmen. Beispielsweise hat mysql eine Variable max_allowed_packet, mit der die maximale Größe des Kommunikationspuffers eingestellt wird. Um die Variable max_allowed_packet für mysql auf einen Wert von 16 Mbyte einzustellen, können Sie einen der folgenden Befehle verwenden:

shell> mysql --max_allowed_packet=16777216
shell> mysql --max_allowed_packet=16M

Der erste Befehl gibt den Wert in Byte an, der zweite den Wert in Mbyte. Bei Variablen, die numerische Werte annehmen, kann dieser mit den Suffixen K, M oder G (in Groß- oder Kleinschreibung) angegeben werden, um einen Multiplikator von 1024, 1024² oder 1024³ anzuzeigen. (Bei der Einstellung von max_allowed_packet etwa würden hiermit die Werte als Kbyte, Mbyte oder Gbyte angegeben.)

In einer Optionsdatei werden die Variableneinstellungen ohne führende Bindestriche angegeben:

[mysql]
max_allowed_packet=16777216

Oder:

[mysql]
max_allowed_packet=16M

Wenn Sie wollen, können Sie Unterstriche in einem Variablennamen als Bindestriche angeben. Die folgenden Optionsabschnitte sind gleichwertig. Beide setzen die Größe des Schlüsselpuffers am Server auf 512 Mbyte:

[mysqld]
key_buffer_size=512M

[mysqld]
key-buffer-size=512M

Hinweis: Vor MySQL 4.0.2 lautet die einzige verfügbare Syntax zur Einstellung von Programmvariablen --set-variable=option=value (bzw. set-variable=option=value in Optionsdateien). Diese Syntax wird zwar nach wie vor erkannt, findet aber seit MySQL 4.0.2 keine Akzeptanz mehr.

Viele Serversystemvariablen können auch zur Laufzeit angegeben werden. Detaillierte Informationen finden Sie in Abschnitt 5.2.3.2, „Dynamische Systemvariablen“.