Sicherheitsspezifische Optionen: Siehe auch Abschnitt 5.7.3, „Startoptionen für mysqld in Bezug auf Sicherheit“.

SSL-spezifische Optionen: Siehe auch Abschnitt 5.9.7.5, „SSL-Befehlsoptionen“.

Optionen zur Steuerung von Binärlogs: Siehe auch Abschnitt 5.12.3, „Die binäre Update-Logdatei“.

Optionen zur Replikation: Siehe auch Abschnitt 6.9, „Replikationsoptionen in my.cnf“.

Optionen für bestimmte Speicher-Engines: Siehe auch Abschnitt 14.1.1, „MyISAM-Startoptionen“, Abschnitt 14.5.3, „BDB-Startoptionen“, Abschnitt 14.2.4, „InnoDB: Startoptionen und Systemvariablen“, und Abschnitt 16.5.5.1, „MySQL Cluster-spezifische Befehlsoptionen für mysqld“.

--help, -?

Zeigt eine kurze Hilfemeldung an und wird dann beendet. Verwenden Sie die Optionen --verbose und --help, um die vollständige Meldung zu sehen.

--allow-suspicious-udfs

Diese Option bestimmt, ob UDFs (User-Defined Functions, benutzerdefinierte Funktionen), die nur ein xxx-Symbol für die Hauptfunktion aufweisen, geladen werden dürfen. Standardmäßig ist die Option deaktiviert, und es dürfen nur UDFs geladen werden, die mindestens ein Hilfssymbol aufweisen. Hierdurch soll das Laden von Funktionen aus solchen freigegebenen Objektdateien verhindert werden, die keine zulässigen UDFs enthalten. Siehe auch Abschnitt 26.3.4.6, „Vorsichtsmaßnahmen bei benutzerdefinierten Funktionen (UDF)“.

--ansi

Verwendet die ANSI-konforme SQL-Standardsyntax (statt der MySQL-Syntax). Für eine genauere Steuerung des SQL-Modus des Servers verwenden Sie stattdessen die Option --sql-mode. Siehe auch Abschnitt 1.9.3, „MySQL im ANSI-Modus laufen lassen“, und Abschnitt 5.2.5, „Der SQL-Modus des Servers“.

--basedir=path, -b path

Der Pfad zum MySQL-Installationsverzeichnis. Normalerweise werden alle Pfad relativ zu diesem Verzeichnis aufgelöst.

--bind-address=IP

Die IP-Adresse, zu der eine Bindung hergestellt wird.

--binlog-format={row|statement}

Gibt an, ob die datensatz- oder die anweisungsbasierte Replikation verwendet werden soll (die anweisungsbasierte Replikation ist die Vorgabe). Siehe auch Abschnitt 6.3, „Zeilenbasierte Replikation“. Diese Option wurde in MySQL 5.1.5 hinzugefügt.

--binlog-row-event-max-size=N

Gibt die maximale Größe eines datensatzbasierten Binärlogereignisses in Byte an. Datensätze werden zu Ereignissen zusammengefasst, die – sofern möglich – kleiner sind als die hier angegebene Größe. Der Wert sollte ein Vielfaches von 256 sein, Standard ist 1.024. Siehe auch Abschnitt 6.3, „Zeilenbasierte Replikation“. Diese Option wurde in MySQL 5.1.5 hinzugefügt.

--both-log-formats

Aktiviert alte und neue Logformate (Logdateien und Logtabellen). Diese Option wurde in MySQL 5.1.6 hinzugefügt.

--bootstrap

Diese Option wird vom Skript mysql_install_db verwendet, um die MySQL-Berechtigungstabellen zu erstellen, ohne einen vollständigen MySQL-Server starten zu müssen.

--character-sets-dir=path

Das Verzeichnis, in dem Zeichensätze installiert sind. Siehe auch Abschnitt 5.11.1, „Der für Daten und zum Sortieren benutzte Zeichensatz“.

--character-set-client-handshake

Zeichensatzinformationen, die vom Client übermittelt wurden, sollten nicht ignoriert werden. Um die Clientangaben zu ignorieren und den Standardzeichensatz des Servers zu benutzen, verwenden Sie --skip-character-set-client-handshake. In diesem Fall verhält sich MySQL wie MySQL 4.0.

--character-set-filesystem=charset_name

Der Zeichensatz des Dateisystems. Diese Option wurde in MySQL 5.1.6 hinzugefügt.

--character-set-server=charset_name, -C charset_name

Verwendet charset_name als Standardzeichensatz am Server. Siehe auch Abschnitt 5.11.1, „Der für Daten und zum Sortieren benutzte Zeichensatz“.

--chroot=path

Versetzt den Server mysqld während des Starts mithilfe des Systemaufrufs chroot() in eine geschlossene Umgebung. Dies ist eine empfohlene Sicherheitsmaßnahme. Beachten Sie, dass durch Verwendung dieser Option LOAD DATA INFILE und SELECT ... INTO OUTFILE in geringem Maße eingeschränkt werden.

--collation-server=collation_name

Verwendet collation_name als Standardsortierung auf dem Server. Siehe auch Abschnitt 5.11.1, „Der für Daten und zum Sortieren benutzte Zeichensatz“.

--console

(Nur für Windows.) Schreibt Fehlerlogmeldungen auch dann in stderr und stdout, wenn --log-error angegeben ist. Wenn diese Option verwendet wird, schließt mysqld das Konsolenfenster nicht.

--core-file

Schreibt eine Speicherauszugsdatei, wenn mysqld sich aufhängt. Bei einigen Systemen müssen Sie zusätzlich die Option --core-file-size für mysqld_safe angeben. Siehe auch Abschnitt 5.4.1, „mysqld_safe — Startskript für den MySQL-Server“. Beachten Sie, dass auf manchen Systemen (z. B. Solaris) keine Speicherauszugsdateien geschrieben werden, wenn gleichzeitig die Option --user verwendet wird.

--datadir=path, -h path

Der Pfad zum Datenverzeichnis.

--debug[=debug_options], -# [debug_options]

Wird MySQL mit der Option --with-debug konfiguriert, dann können Sie mithilfe dieser Option eine Trace-Datei mit Angaben dazu erstellen, was mysqld tut. Der String debug_options heißt häufig 'd:t:o,file_name'. Standardwert ist 'd:t:i:o,mysqld.trace'. Siehe auch Abschnitt E.1.2, „Trace-Dateien erzeugen“.

--default-character-set=charset_name (AUSLAUFEND)

Verwendet charset_name als Standardzeichensatz. Diese Option läuft zugunsten von --character-set-server aus. Siehe auch Abschnitt 5.11.1, „Der für Daten und zum Sortieren benutzte Zeichensatz“.

--default-collation=collation_name

Verwendet collation_name als Standardsortierung. Diese Option läuft zugunsten von --collation-server aus. Siehe auch Abschnitt 5.11.1, „Der für Daten und zum Sortieren benutzte Zeichensatz“.

--default-storage-engine=type

Stellt die standardmäßige Speicher-Engine für Tabellen ein. Siehe auch Kapitel 14, Speicher-Engines und Tabellentypen.

--default-table-type=type

Diese Option ist synonym zu --default-storage-engine.

--default-time-zone=timezone

Stellt die Standardzeitzone des Servers ein. Diese Option stellt die globale Systemvariable time_zone ein. Wird die Option nicht angegeben, dann ist die Standardzeitzone mit der Systemzeitzone identisch (diese wird durch den Wert der Systemvariablen system_time_zone bestimmt).

--delay-key-write[= OFF | ON | ALL]

Legt fest, wie verzögerte Schlüsselschreiboperationen gehandhabt werden. Das verzögerte Schreiben von Schlüsseln sorgt dafür, dass Schlüsselpuffer zwischen einzelnen Schreibvorgängen für MyISAM-Tabellen neu geladen werden. OFF deaktiviert das verzögerte Schreiben von Schlüsseln, während ON es für jene Tabellen aktiviert, die mit der Option DELAY_KEY_WRITE erstellt worden sind. ALL schließlich verzögert das Schreiben der Schlüssel für alle MyISAM-Tabellen. Siehe auch Abschnitt 7.5.2, „Serverparameter feineinstellen“, und Abschnitt 14.1.1, „MyISAM-Startoptionen“.

Hinweis: Wenn Sie diese Variable auf ALL setzen, sollten Sie MyISAM-Tabellen nicht aus einem anderen Programm (z. B. einem anderen MySQL-Server oder myisamchk) heraus verwenden, wenn diese Tabellen bereits in Benutzung sind. Andernfalls können Indizes beschädigt werden.

--des-key-file=file_name

Liest den DES-Standardschlüssel aus der angegebenen Datei aus. Diese Schlüssel werden von den Funktionen DES_ENCRYPT() und DES_DECRYPT() verwendet.

--enable-named-pipe

Aktiviert die Unterstützung für Named Pipes. Diese Option betrifft nur Systeme unter Windows NT/2000/XP/2003 und kann nur für die Server mysqld-nt und mysqld-max-nt benutzt werden, die Named-Pipe-Verbindungen benutzen.

--event-scheduler

Aktiviert den Ereignisplaner. Diese Option wurde in MySQL 5.1.6 hinzugefügt.

--exit-info[=flags], -T [flags]

Dies ist eine Bitmaske mit verschiedenen Flags, die Sie zum Debugging des Servers mysqld verwenden können. Verwenden Sie diese Option nur, wenn Sie genau wissen, was sie tut!

--external-locking

Aktiviert die externe Sperrung (Systemsperrung). Diese ist seit MySQL 4.0 standardmäßig deaktiviert. Beachten Sie, dass, wenn Sie diese Option auf einem System verwenden, auf dem lockd nicht vollständig funktioniert (z. B. unter Linux), mysqld vollständig gesperrt werden kann. Diese Option hieß früher --enable-locking.

Hinweis: Wenn Sie diese Option verwenden, um das Aktualisieren von MyISAM-Tabellen durch mehrere MySQL-Prozesse zu ermöglichen, dann müssen Sie sicherstellen, dass die folgenden Bedingungen erfüllt sind:

Die einfachste Möglichkeit, dies zu gewährleisten, besteht darin, --external-locking immer zusammen mit --delay-key-write=OFF und --query-cache-size=0 zu benutzen. (Dies wird standardmäßig nicht gemacht, weil es in vielen Konfigurationen nützlich ist, eine Mischung der vorangegangenen Optionen einzusetzen.)

--flush

Schreibt nach jeder SQL-Anweisung alle Änderungen neu auf die Festplatte (Synchronisierung). Normalerweise schreibt MySQL alle Änderungen erst nach der jeweiligen SQL-Anweisung auf die Festplatte und überlässt dem Betriebssystem die Festplattensynchronisierung. Siehe auch Abschnitt A.4.2, „Was zu tun ist, wenn MySQL andauernd abstürzt“.

--init-file=file

Liest beim Start SQL-Anweisungen aus der angegebenen Datei aus. Jede Anweisung muss in einer eigenen Zeile stehen und darf keine Kommentare enthalten.

--innodb-xxx

Die InnoDB-Optionen sind in Abschnitt 14.2.4, „InnoDB: Startoptionen und Systemvariablen“, beschrieben.

--language=lang_name, -L lang_name

Gibt Clientfehlermeldungen in der angegebenen Sprache zurück. lang_name kann als Sprachname oder als vollständiger Pfadname zu dem Verzeichnis angegeben werden, in dem die Sprachdateien installiert sind. Siehe auch Abschnitt 5.11.2, „Nicht englische Fehlermeldungen“.

--large-pages

Einige Hardware- und Betriebssystemarchitekturen unterstützen Speicherseiten, die größer als der Standardwert (normalerweise 4 Kbyte) sind. Die eigentliche Implementierung dieser Unterstützung hängt von der zugrundeliegenden Hardware und dem Betriebssystem ab. Anwendungen, die häufig auf den Speicher zugreifen, können leistungsseitig von der Verwendung großer Seiten profitieren, da die Anzahl von TLB-Fehlschlägen (Translation Lookaside Buffer, Übersetzungspuffer) verringert wird.

Zurzeit unterstützt MySQL nur die Linux-Implementierung der Unterstützung für große Seiten (diese heißt in Linux HugeTLB). Wir beabsichtigen, diese Unterstützung auf FreeBSD, Solaris und möglicherweise auch andere Plattformen auszudehnen.

Bevor unter Linux große Seiten verwendet werden können, ist es notwendig, den HugeTLB-Speicherpool zu konfigurieren. Hinweise hierzu entnehmen Sie der Datei hugetlbpage.txt im Linux-Kernel-Quellcode.

Die Option ist standardmäßig deaktiviert.

--log[=file_name], -l [file_name]

Verbindungen und SQL-Anweisungen, die von Clients empfangen werden, werden in dieser Datei protokolliert. Siehe auch Abschnitt 5.12.2, „Die allgemeine Anfragen-Logdatei“. Wenn Sie den Dateinamen weglassen, verwendet MySQL host_name.log als Dateinamen.

--log-bin=[base_name]

Aktiviert das binäre Loggen. Der Server loggt alle datenändernden Anweisungen in das Binärlog, welches für Sicherungs- und Replikationszwecke verwendet wird. Siehe auch Abschnitt 5.12.3, „Die binäre Update-Logdatei“.

Sofern angegeben, ist der Optionswert der Basisname der Logabfolge. Der Server erstellt Binärlogs in einer Abfolge und fügt dabei an den Basisnamen jeweils ein numerisches Suffix an. Die Angabe eines Basisnamens wird empfohlen (siehe Abschnitt A.8.1, „Offene Probleme in MySQL“ zu den Gründen). Andernfalls verwendet MySQL host_name-bin als Basisnamen.

--log-bin-index[=file_name]

Dies ist die Indexdatei für Dateinamen von Binärlogs. Siehe auch Abschnitt 5.12.3, „Die binäre Update-Logdatei“. Wenn Sie den Dateinamen weglassen und auch mit --log-bin keinen Namen festgelegt haben, verwendet MySQL host_name-bin.index als Dateinamen.

--log-bin-trust-function-creators[={0|1}]

Ohne Argument oder mit dem Argument 1 setzt diese Option die Systemvariable log_bin_trust_function_creators auf 1. Wird als Argument 0 übergeben, dann wird die Systemvariable auf 0 gesetzt. log_bin_trust_function_creators beeinflusst, wie MySQL Beschränkungen für die Erstellung gespeicherter Funktionen durchsetzt. Siehe auch Abschnitt 19.4, „Binärloggen gespeicherter Routinen und Trigger“.

--log-error[=file_name]

Fehler- und Startmeldungen werden in der genannten Datei protokolliert. Siehe auch Abschnitt 5.12.1, „Die Fehler-Logdatei“. Wenn Sie den Dateinamen weglassen, verwendet MySQL host_name.err. Hat der Dateiname keine Erweiterung, dann fügt der Server die Erweiterung .err hinzu.

--log-isam[=file_name]

Protokolliert alle MyISAM-Änderungen an dieser Datei (wird nur zum MyISAM-Debugging verwendet).

--log-long-format (AUSLAUFEND)

Schreibt Zusatzinformationen in das Update-Log, das Binärlog und das Log für langsame Abfragen, sofern diese aktiviert sind. So werden etwa der Benutzername und ein Zeitstempel für alle Abfragen protokolliert. Diese Option läuft aus, da sie mittlerweile das Standardverhalten beim Loggen darstellt. (Siehe Beschreibung zu --log-short-format.) Die Option --log-queries-not-using-indexes dient dem Loggen von Abfragen, die keine Indizes verwenden, in das Log für langsame Abfragen.

--log-queries-not-using-indexes

Wenn Sie diese Option in Verbindung mit --log-slow-queries verwenden, werden Abfragen, die keine Indizes verwenden, in das Log für langsame Abfragen geschrieben. Siehe auch Abschnitt 5.12.4, „Die Logdatei für langsame Anfragen“.

--log-short-format

Protokolliert weniger Informationen in das Update-Log, das Binärlog und das Log für langsame Abfragen, sofern diese aktiviert sind. So werden etwa weder Benutzername noch ein Zeitstempel für Abfragen protokolliert.

--log-slow-admin-statements

Protokolliert administrative Anweisungen wie OPTIMIZE TABLE, ANALYZE TABLE und ALTER TABLE in das Log für langsame Abfragen.

--log-slow-queries[=file_name]

Protokolliert alle Abfragen, deren Ausführung mehr als long_query_time Sekunden gedauert hat, in die angegebene Datei. Siehe auch Abschnitt 5.12.4, „Die Logdatei für langsame Anfragen“. Details finden Sie in den Beschreibungen zu den Optionen --log-long-format und --log-short-format.

--log-warnings, -W

Schreibt Warnungen wie Aborted connection... in das Fehlerlog. Die Aktivierung dieser Option wird beispielsweise empfohlen, wenn Sie die Replikation verwenden. (Sie erhalten dann mehr Informationen zu den ablaufenden Vorgängen, z. B. Netzwerkausfälle und Neuverbindungen.) Die Option ist standardmäßig aktiviert. Sie können sie mithilfe von --skip-log-warnings deaktivieren. Unterbrochene Verbindungen werden nicht in das Fehlerlog protokolliert, sofern der Wert größer als 1 ist. Siehe auch Abschnitt A.2.10, „Kommunikationsfehler/abgebrochene Verbindung“.

--low-priority-updates

Gibt tabellenändernden Operationen (INSERT, REPLACE, DELETE, UPDATE) eine niedrigere Priorität als Auswahloperationen. Dies kann auch via {INSERT | REPLACE | DELETE | UPDATE} LOW_PRIORITY ... erfolgen, um die Priorität nur einer Abfrage zu verringern. Die Priorität eines Threads können Sie mit SET LOW_PRIORITY_UPDATES=1 verringern. Siehe auch Abschnitt 7.3.2, „Themen, die Tabellensperren betreffen“.

--memlock

Sperrt den mysqld-Prozess im Speicher. Dies funktioniert auf Systemen wie Solaris, die den Systemaufruf mlockall() unterstützen. Die Option kann hilfreich sein, wenn ein Problem auftritt, bei dem das Betriebssystem eine Auslagerung von mysqld auf die Festplatte verursacht. Beachten Sie, dass die Verwendung dieser Option eine Ausführung des Servers als root erfordert, wovon in der Regel aus Sicherheitsgründen abzuraten ist. Siehe auch Abschnitt 5.7.5, „Wie man MySQL als normaler Benutzer laufen läßt“.

--myisam-recover [=option[,option]...]]

Stellt den Wiederherstellungsmodus der MyISAM-Speicher-Engine ein. Der Optionswert ist eine beliebige Kombination der Werte DEFAULT, BACKUP, FORCE oder QUICK. Wenn Sie mehrere Werte angeben, trennen Sie sie durch Kommata. Sie können auch den Wert "" angeben, um die Option zu deaktivieren. Wird die Option verwendet, dann prüft mysqld bei jedem Öffnen einer MyISAM-Tabelle, ob diese als abgestürzt gekennzeichnet ist oder beim letzten Mal nicht korrekt geschlossen wurde. (Die zweite Option funktioniert nur, wenn die Ausführung mit deaktivierter externer Sperrung erfolgt.) In diesem Fall führt mysqld eine Überprüfung der Tabelle durch. Ist die Tabelle tatsächlich beschädigt, dann versucht mysqld sie zu reparieren.

Die folgenden Optionen beeinflussen die Ausführung der Reparatur:

Bevor der Server eine Tabelle automatisch repariert, schreibt er einen Hinweis zur Reparatur in das Fehlerlog. Wollen Sie die meisten Probleme durch eine Wiederherstellung ohne Benutzereingriff beseitigen, dann sollten Sie die Optionen BACKUP,FORCE angeben. Hierdurch wird die Reparatur der Tabelle auch dann erzwungen, wenn mehrere Datensätze gelöscht würden; gleichzeitig wird aber die alte Datendatei als Sicherungskopie vorgehalten, sodass Sie später untersuchen können, was passiert ist.

Siehe auch Abschnitt 14.1.1, „MyISAM-Startoptionen“.

--ndb-connectstring=connect_string

Wenn Sie die NDB-Speicher-Engine verwenden, können Sie den Managementserver angeben, der die Clusterkonfiguration verteilt. Dies tun Sie durch Einstellung der Option --ndb-connectstring. Informationen zur Syntax finden Sie in Abschnitt 16.4.4.2, „MySQL Cluster: connectstring“.

--ndbcluster

Wenn die Binärdatei eine Unterstützung der NDB Cluster-Speicher-Engine enthält, aktiviert diese Option die Engine (diese ist standardmäßig deaktiviert). Siehe auch Kapitel 16, MySQL Cluster.

--old-log-format

Aktiviert nur das alte Logformat. Hierdurch werden Logtabellen und die SELECT-Funktionalität für Loginhalte deaktiviert. Diese Option wurde in MySQL 5.1.6 hinzugefügt.

--old-passwords

Erzwingt die Erzeugung kurzer Passwort-Hashes (wie vor Version 4.1) auch für neue Passwörter. Dies kann zu Kompatibilitätszwecken erforderlich sein, wenn der Server ältere Clientprogramme unterstützen muss. Siehe auch Abschnitt 5.8.9, „Kennwort-Hashing ab MySQL 4.1“.

--one-thread

Verwendet nur einen Thread (zum Debuggen unter Linux). Diese Option ist nur verfügbar, wenn der Server mit aktiviertem Debugging erstellt wurde. Siehe auch Abschnitt E.1, „Einen MySQL-Server debuggen“.

--open-files-limit=count

Ändert die Anzahl der für mysqld verfügbaren Dateideskriptoren. Wenn diese Option nicht oder auf 0 gesetzt ist, verwendet mysqld den Wert, um Dateideskriptoren mit setrlimit() zu reservieren. Ist der Wert hingegen 0, dann reserviert mysqld max_connections×5 oder max_connections + table_open_cache×2 Dateien (je nachdem, welcher Wert höher ist). Versuchen Sie, diesen Wert zu erhöhen, wenn mysqld die Fehlermeldung Too many open files ausgibt.

--pid-file=path

Der Pfadname der Prozesskennungsdatei. Diese Datei wird von anderen Programmen wie mysqld_safe verwendet, um die Prozesskennung des Servers zu bestimmen.

--port=port_num, -P port_num

Die Portnummer, die beim Horchen auf TCP/IP-Verbindungen verwendet wird. Die Portnummer muss 1024 oder höher sein, sofern der Server nicht vom Systembenutzer root gestartet wird.

--port-open-timeout=num

Bei manchen Systemen wird, wenn der Server beendet wird, der TCP/IP-Port unter Umständen nicht mehr verfügbar gemacht. Wenn der Server kurz darauf neu gestartet wird, kann der Versuch fehlschlagen, den Port neu zu öffnen. Diese Option gibt an, wie viele Sekunden der Server warten soll, bis der TCP/IP-Port wieder frei wird, sofern er nicht geöffnet werden kann. Standardmäßig gibt es keine Wartezeit. Diese Option wurde in MySQL 5.1.5 hinzugefügt.

--safe-mode

Überspringt einige Optimierungsstufen.

--safe-show-database (AUSLAUFEND)

Siehe auch Abschnitt 5.8.3, „Von MySQL zur Verfügung gestellte Berechtigungen“.

--safe-user-create

Wenn diese Option aktiviert ist, kann ein Benutzer mit der GRANT-Anweisung keine neuen MySQL-Benutzer erstellen, wenn er für die Tabelle mysql.user oder eine der Spalten in dieser Tabelle nicht die Berechtigung INSERT hat.

--secure-auth

Unterbindet die Authentifizierung von Clients, die Konten mit alten Passwörtern (vor Version 4.1) zu verwenden versuchen.

--shared-memory

Aktiviert Verbindungen mit gemeinsamem Speicher durch lokale Clients. Diese Option ist nur unter Windows verfügbar.

--shared-memory-base-name=name

Der Name des gemeinsamen Speichers, der für Verbindungen mit gemeinsamem Speicher verwendet werden soll. Diese Option ist nur unter Windows verfügbar. Der Standardname ist MYSQL. Beim Namen wird die Groß-/Kleinschreibung unterschieden.

--skip-bdb

Deaktiviert die BDB-Speicher-Engine. Hierdurch wird Speicher gespart, ferner werden einige Operationen beschleunigt. Verwenden Sie die Option nicht, wenn Sie BDB-Tabellen benötigen.

--skip-concurrent-insert

Schaltet die Möglichkeit ab, bei MyISAM-Tabellen gleichzeitig auszuwählen und einzufügen. (Diese Option sollte nur verwendet werden, wenn Sie das Gefühl haben, einen Bug in dieser Funktion gefunden zu haben.)

--skip-external-locking

Eine externe Sperrung (Systemsperrung) wird nicht verwendet. Bei deaktivierter externer Sperrung müssen Sie den Server herunterfahren, um myisamchk verwenden zu können. (Siehe auch Abschnitt 1.4.3, „Wie stabil ist MySQL?“.) Um diese Anforderung zu umgehen, verwenden Sie die Anweisungen CHECK TABLE und REPAIR TABLE zur Überprüfung und Reparatur von MyISAM-Tabellen.

Die externe Sperrung wird seit MySQL 4.0 standardmäßig deaktiviert.

--skip-grant-tables

Diese Option sorgt dafür, dass der Server das Berechtigungssystem überhaupt nicht verwendet. Hierdurch erhalten alle Benutzer, die auf den Server zugreifen können, uneingeschränkten Zugang zu allen Datenbanken. Sie können einen laufenden Server dazu bringen, die Grant-Tabellen wieder zu verwenden, indem Sie mysqladmin flush-privileges oder mysqladmin reload über die System-Shell ausführen oder die MySQL-Anweisung FLUSH PRIVILEGES nach Herstellen einer Verbindung zum Server absetzen. Diese Option unterbindet auch das Laden von Plug-Ins und benutzerdefinierten Funktionen (UDFs).

--skip-host-cache

Der interne Hostnamencache wird nicht zur schnelleren Namensauflösung verwendet. Stattdessen wird bei jeder Verbindungsherstellung durch einen Client der DNS-Server abgefragt. Siehe auch Abschnitt 7.5.6, „Wie MySQL DNS benutzt“.

--skip-innodb

Deaktiviert die InnoDB-Speicher-Engine. Hierdurch wird Speicher und Festplattenkapazität gespart, ferner werden einige Operationen beschleunigt. Verwenden Sie die Option nicht, wenn Sie InnoDB-Tabellen benötigen.

--skip-name-resolve

Bei der Überprüfung von Clientverbindungen werden Hostnamen nicht aufgelöst. Es werden ausschließlich IP-Nummern verwendet. Wenn Sie diese Option verwenden, müssen alle Werte in der Spalte Host der Grant-Tabellen IP-Nummern oder localhost sein. Siehe auch Abschnitt 7.5.6, „Wie MySQL DNS benutzt“.

--skip-ndbcluster

Deaktiviert die NDB Cluster-Speicher-Engine. Dies ist die Standardeinstellung bei Binärdistributionen, die mit Unterstützung für die NDB Cluster-Speicher-Engine erstellt wurden. Der Server reserviert dieser Speicher-Engine nur dann Speicher und andere Ressourcen, wenn die Option --ndbcluster explizit angegeben wird. Ein Anwendungsbeispiel finden Sie in Abschnitt 16.4.3, „Schnelle Testeinrichtung von MySQL Cluster“.

--skip-networking

Unterbindet das Horchen auf TCP/IP-Verbindungen ganz. Die gesamte Interaktion mit mysqld muss über Named Pipes oder gemeinsamen Speicher (unter Windows) bzw. Unix-Socketdateien (unter Unix) erfolgen. Diese Option ist für Systeme, bei denen nur lokale Clients zulässig sind, sehr empfehlenswert. Siehe auch Abschnitt 7.5.6, „Wie MySQL DNS benutzt“.

--standalone

Nur unter Windows NT-basierten Systemen vorhanden. Die Option weist den MySQL-Server an, nicht als Dienst ausgeführt zu werden.

--symbolic-links, --skip-symbolic-links

Aktiviert bzw. deaktiviert die Unterstützung für symbolische Verknüpfungen. Die Option hat unter Windows und Unix unterschiedliche Auswirkungen:

--skip-safemalloc

Wenn MySQL mit der Option --with-debug=full konfiguriert wird, prüfen alle MySQL-Programme bei jedem Speicherzuweisungs- und -freigabevorgang auf Speicherüberläufe. Diese Überprüfung erfolgt recht langsam, weswegen Sie sie für den Server mithilfe der Option --skip-safemalloc umgehen sollten, wenn Sie sie nicht brauchen.

--skip-show-database

Bei dieser Option darf die SHOW DATABASES-Anweisung nur von Benutzern verwendet werden, die die Berechtigung SHOW DATABASES haben. Die Anweisung zeigt dann alle Datenbanknamen an. Ohne diese Option dürfen alle Benutzer SHOW DATABASES verwenden, aber die Datenbanknamen werden nur angezeigt, wenn der Benutzer die Berechtigung SHOW DATABASES oder spezifische Berechtigungen für eine Datenbank hat. Beachten Sie, dass jede globale Berechtigung als Berechtigung für die Datenbank betrachtet wird.

--skip-stack-trace

Stapel-Trace-Dateien werden nicht geschrieben. Diese Option ist praktisch, wenn Sie mysqld unter einem Debugger ausführen. Bei manchen Systemen müssen Sie die Option auch verwenden, um eine Speicherauszugsdatei zu erhalten. Siehe auch Abschnitt E.1, „Einen MySQL-Server debuggen“.

--skip-thread-priority

Deaktiviert die Verwendung von Thread-Prioritäten für eine schnellere Antwortzeit.

--socket=path

Unter Unix gibt diese Option die Unix-Socketdatei an, die beim Horchen nach lokalen Verbindungen verwendet werden soll. Der Vorgabewert ist /tmp/mysql.sock. Unter Windows legt die Option den Pipe-Namen fest, der beim Horchen nach lokalen Verbindungen verwendet werden soll, die eine Named Pipe nutzen. Der Vorgabewert ist MySQL (keine Unterscheidung der Groß-/Kleinschreibung).

--sql-mode=value[,value[,value...]]

Stellt den SQL-Modus ein. Siehe auch Abschnitt 5.2.5, „Der SQL-Modus des Servers“.

--temp-pool

Diese Option sorgt dafür, dass die meisten vom Server erstellten Temporärdateien eine kleine Menge von Namen nutzt (statt dass ein eindeutiger Name für jede neue Datei erstellt wird). Hierdurch wird ein Problem umgangen, dass der Linux-Kernel mit der Erstellung vieler neuer Dateien mit unterschiedlichen Namen hat. Beim ursprünglichen Verhalten scheint Linux ein „Speicherleck“ aufzuweisen, da der Speicher nicht dem Festplattencache, sondern dem Verzeichniseintragscache zugewiesen wird.

--transaction-isolation=level

Stellt die Standardstufe für die Transaktionsisolierung ein. Der Wert level kann READ-UNCOMMITTED, READ-COMMITTED, REPEATABLE-READ oder SERIALIZABLE sein. Siehe auch Abschnitt 13.4.6, „SET TRANSACTION“.

--tmpdir=path, -t path

Der Pfad des Verzeichnisses, in dem Temporärdateien erstellt werden. Die Option kann nützlich sein, wenn Ihr /tmp-Standardverzeichnis auf einer Partition liegt, die zu klein für die Aufnahme temporärer Tabellen ist. Die Option akzeptiert mehrere Pfade, die zyklisch abwechselnd verwendet werden. Pfade sollten unter Unix durch Doppelpunkte (‘:’) und unter Windows, NetWare und OS/2 durch Semikola (‘;’) getrennt werden. Wenn der MySQL-Server als Replikations-Slave agiert, sollten Sie die Option --tmpdir nicht auf ein Verzeichnis auf einem speicherbasierten Dateisystem oder aber ein Verzeichnis verweisen lassen, welches gelöscht wird, wenn der Serverhost neu gestartet wird. Weitere Informationen zur Speicherposition temporärer Dateien finden Sie in Abschnitt A.4.4, „Wohin MySQL temporäre Dateien speichert“. Ein Replikations-Slave benötigt einen Teil seiner Temporärdateien, um einen Systemneustart so zu überstehen, dass er Temporärtabellen oder LOAD DATA INFILE-Operationen replizieren kann. Wenn Dateien in im Verzeichnis für Temporärdateien beim Serverneustart verloren gehen, schlägt die Replikation fehl.

--user={user_name | user_id}, -u {user_name | user_id}

Führt den Server mysqld als Benutzer mit dem spezifizierten Benutzernamen (user_name) oder der numerischen Benutzerkennung (user_id) aus. („Benutzer“ bezeichnet in diesem Kontext ein Systemanmeldekonto und keinen in den Grant-Tabellen aufgeführten MySQL-Benutzer.)

Diese Option zwingend erforderlich, wenn Sie mysqld als root starten. Der Server wechselt seine Benutzerkennung während der Startsequenz und wird dann als der angegebene Benutzer statt als root ausgeführt. Siehe auch Abschnitt 5.7.1, „Allgemeine Sicherheitsrichtlinien“.

Um eine potenzielle Sicherheitslücke zu vermeiden, wenn ein Benutzer die Option --user=root in einer Datei my.cnf hinzufügt (und auf diese Weise eine Ausführung des Servers als root veranlasst), verwendet mysqld nur die erste angegebene Option --user und erzeugt eine Warnung, wenn mehrere --user-Optionen vorhanden sind. Optionen in /etc/my.cnf und $MYSQL_HOME/my.cnf werden vor eventuellen Befehlszeilenoptionen verarbeitet, weswegen empfohlen wird, eine Option --user in /etc/my.cnf einzufügen und dort einen anderen Wert als root anzugeben. Die Option in /etc/my.cnf wird vor allen anderen --user-Optionen gefunden; hierdurch ist sichergestellt, dass der Server als ein anderer Benutzer als root ausgeführt und eine Warnung erzeugt wird, wenn eine andere --user- Option gefunden wird.

--version, -V

Zeigt die Versionsinformation an und wird dann beendet.

auto_increment_increment

auto_increment_increment und auto_increment_offset sind zur Verwendung bei der Master-to-Master-Replikation vorgesehen und können zur Steuerung des Betriebs von AUTO_INCREMENT-Spalten eingesetzt werden. Beide Variablen können global oder lokal eingestellt werden und jeweils einen Integer-Wert zwischen 1 und 65.535 einnehmen. Wenn eine dieser Variablen auf 0 gesetzt wird, wird der Wert automatisch auf 1 umgestellt. Der Versuch, ihnen einen ganzzahligen Wert größer 65.535 oder kleiner 0 zuzuweisen, führt hingegen zur automatischen Zuweisung des Wertes 65.535. Sollten Sie versuchen, auto_increment_increment oder auto_increment_offset auf einen nicht ganzzahligen Wert zu stellen, dann wird eine Fehlermeldung ausgegeben, und der Wert der Variable bleibt unverändert.

Diese beiden Variablen beeinflussen das Verhalten von AUTO_INCREMENT-Spalten wie folgt:

Sollte eine dieser Variablen (oder beide) geändert werden und dann neue Datensätze in eine Tabelle mit einer AUTO_INCREMENT-Spalte eingefügt werden, dann könnten die Ergebnisse unlogisch erscheinen, da die Berechnung der AUTO_INCREMENT-Wertereihe ohne Berücksichtigung ggf. bereits in der Spalte vorhandener Werte erfolgt und der nächste eingefügte Wert der kleinste Wert in der Reihe ist, der größer ist als der größte vorhandene Wert in der AUTO_INCREMENT-Spalte. Mit anderen Worten wird die Reihe so berechnet:

auto_increment_offset + N × auto_increment_increment

Hierbei ist N ist ein positiver Integer-Wert in der Reihe [1, 2, 3, ...]. Zum Beispiel:

mysql> SHOW VARIABLES LIKE 'auto_inc%';
+--------------------------+-------+
| Variable_name            | Value |
+--------------------------+-------+
| auto_increment_increment | 10    |
| auto_increment_offset    | 5     |
+--------------------------+-------+
2 rows in set (0.00 sec)

mysql> SELECT col FROM autoinc1;
+-----+
| col |
+-----+
|   1 |
|  11 |
|  21 |
|  31 |
+-----+
4 rows in set (0.00 sec)

mysql> INSERT INTO autoinc1 VALUES (NULL), (NULL), (NULL), (NULL);
Query OK, 4 rows affected (0.00 sec)
Records: 4  Duplicates: 0  Warnings: 0

mysql> SELECT col FROM autoinc1;
+-----+
| col |
+-----+
|   1 |
|  11 |
|  21 |
|  31 |
|  35 |
|  45 |
|  55 |
|  65 |
+-----+
8 rows in set (0.00 sec)

Die für auto_increment_increment und auto_increment_offset angezeigten Werte erzeugen die Reihe 5 + N × 10, also [5, 15, 25, 35, 45, ...]. Der größte Wert, der vor der INSERT-Anweisung in der col-Spalte vorhanden ist, ist 31. Der nächste verfügbare Wert in der AUTO_INCREMENT-Reihe ist 35, d. h. die eingefügten Werte für col beginnen bei diesem Punkt; die Ergebnisse der SELECT-Abfrage sehen also so aus wie angezeigt.

Es ist wichtig, sich zu vergegenwärtigen, dass es nicht möglich ist, die Wirkungen dieser zwei Variablen auf eine einzige Tabelle zu beschränken, weswegen sie nicht die Funktion von Folgen wahrnehmen, die einige andere Datenbanksysteme anbieten; die Variablen steuern vielmehr das Verhalten aller AUTO_INCREMENT-Spalten in allen Tabellen auf dem MySQL-Server. Wird eine dieser Variablen global eingestellt, dann wird die Wirkung aufrechterhalten, bis der globale Wert geändert oder durch eine lokale Einstellung außer Kraft gesetzt oder mysqld neu gestartet wird. Bei einer lokalen Einstellung wirkt sich der neue Wert auf die AUTO_INCREMENT in allen Tabellen aus, in die vom aktuellen Benutzer während der laufenden Sitzung neue Datensätze eingefügt werden, sofern die Werte nicht während dieser Sitzung geändert werden.

Der Standardwert von auto_increment_increment ist 1. Siehe auch Abschnitt 6.15, „Auto-Increment in der Multi-Master-Replikation“.

auto_increment_offset

Diese Variable hat den Vorgabewert 1. Besonderheiten entnehmen Sie der Beschreibung von auto_increment_increment.

back_log

Dies ist die Anzahl der ausstehenden Verbindungsanforderungen, die bei MySQL zulässig sind. Die Option wird wichtig, wenn der MySQL-Haupt-Thread sehr viele Verbindungsanforderungen innerhalb kürzester Zeit erhält. Es dauert dann eine (wenn auch sehr kurze) Zeit, bis der Haupt-Thread die Verbindung geprüft und einen neuen Thread gestartet hat. Der Wert back_log gibt an, wie viele Anforderungen während dieser kurzen Zeit gestapelt werden können, bevor MySQL neue Anforderungen vorübergehend nicht mehr beantwortet. Sie müssen diesen Wert nur dann erhöhen, wenn Sie eine hohe Anzahl von Verbindungen innerhalb kurzer Zeit erwarten.

Anders gesagt bestimmt der Wert die Größe der Horchwarteschlange für eingehende TCP/IP-Verbindungen. Ihr Betriebssystem hat eine eigene Begrenzung dieser Warteschlangengröße. Weitere Informationen hierzu sollten Sie auf der Manpage zum Unix-Systemaufruf listen() finden. Überprüfen Sie Ihre Betriebssystemdokumentation zu Angaben für den Maximalwert dieser Variablen. back_log darf nicht höher gesetzt sein als für das jeweilige Betriebssystem zulässig.

basedir

Gibt das Basisverzeichnis der MySQL-Installation an. Die Variable kann mit der Option --basedir eingestellt werden.

bdb_cache_parts

Die Anzahl der Teile, die für den BDB-Cache verwendet werden sollen. Wurde in MySQL 5.1.2 hinzugefügt.

bdb_cache_size

Die Größe des Puffers, der für das Caching von Indizes und Datensätzen für BDB-Tabellen reserviert wird. Einige Systeme erlauben eine Einstellung dieser Variablen auf einen Wert von mehr als 4 Gbyte. Wenn Sie keine BDB-Tabellen verwenden, sollten Sie mysqld mit --skip-bdb starten, damit für diesen Cache kein Speicher reserviert wird.

bdb_home

Dies ist das Basisverzeichnis für BDB-Tabellen. Hier sollte der gleiche Wert stehen wie bei der Variablen datadir.

bdb_log_buffer_size

Gibt die Größe des Puffers an, der für das Caching von Indizes und Datensätzen für BDB-Tabellen reserviert wird. Wenn Sie keine BDB-Tabellen verwenden, sollten Sie hier 0 zuweisen oder mysqld mit --skip-bdb, damit für diesen Cache kein Speicher reserviert wird.

bdb_logdir

Gibt das Verzeichnis an, in das die BDB-Speicher-Engine ihre Logdateien schreibt. Die Variable kann mit der Option --bdb-logdir eingestellt werden.

bdb_max_lock

Die maximale Anzahl von Sperren, die für eine BDB-Tabelle aktiv sein können (standardmäßig 10.000). Sie sollten diesen Wert erhöhen, wenn bei der Durchführung langer Transaktionen oder dann, wenn mysqld viele Datensätze zur Berechnung einer Abfrage untersuchen muss, die folgende Fehlermeldung auftritt:

bdb: Lock table is out of available locks
Got error 12 from ...

bdb_region_size

Die Größe des zugrundeliegenden Logbereichs der BDB-Umgebung. Dies ist die Größe des Speicherpools, der zur Aufzeichnung der in einer Transaktion verwendeten Dateinamen verwendet wird. Wurde in MySQL 5.1.2 hinzugefügt.

bdb_shared_data

Ist ON, wenn Sie Berkeley DB mithilfe von --bdb-shared-data im Multiprozessmodus starten. (Verwenden Sie DB_PRIVATE nicht bei der Initialisierung von Berkeley DB.)

bdb_tmpdir

Gibt das Verzeichnis für BDB-Temporärdateien an.

binlog_cache_size

Gibt die Größe des Caches an, der die SQL-Anweisungen für das Binärlog während einer Transaktion aufnimmt. Ein Binärlog-Cache wird jedem Client zugewiesen, wenn der Server transaktionssichere Speicher-Engines unterstützt und an ihm das Binärlog aktiviert ist (Option --log-bin). Wenn Sie häufig umfangreiche, aus mehreren Anweisungen bestehende Transaktionen verwenden, können Sie diese Cachegröße erhöhen, um mehr Leistung zu erzielen. Die Statusvariablen Binlog_cache_use und Binlog_cache_disk_use können für die Optimierung dieser Variable nützlich sein. Siehe auch Abschnitt 5.12.3, „Die binäre Update-Logdatei“.

binlog_format

Das Binärlogformat (entweder STATEMENT oder ROW). Diese Variable wird von der Option --binlog-format eingestellt. Siehe auch Abschnitt 6.3, „Zeilenbasierte Replikation“.

bulk_insert_buffer_size

MyISAM verwendet einen speziellen Cache mit Baumstruktur, um Masseneinfügeoperation für INSERT ... SELECT, INSERT ... VALUES (...), (...), ... und LOAD DATA INFILE beim Hinzufügen von Daten in nicht leere Tabellen zu beschleunigen. Diese Variable beschränkt die Größe der Cachebaumstruktur und ist in Byte pro Thread angegeben. Die Einstellung 0 deaktiviert diese Optimierung. Der Vorgabewert ist 8 Mbyte.

character_set_client

Der Zeichensatz für Anweisungen, die vom Client kommend eintreffen.

character_set_connection

Der Zeichensatz für Literale, die keine Zeichensatzeinführung aufweisen, und für die Umwandlung von Zahlen in Strings.

character_set_database

Der von der Standarddatenbank verwendete Zeichensatz. Der Server stellt diese Variable immer dann ein, wenn die Standarddatenbank sich ändert. Ist keine Standarddatenbank vorhanden, dann hat die Variable denselben Wert wie character_set_server.

character_set_filesystem

Der Zeichensatz des Dateisystems. Der Vorgabewert ist binary. Diese Variable wurde in MySQL 5.1.6 hinzugefügt.

character_set_results

Der zur Rückgabe von Abfrageergebnissen an den Client verwendete Zeichensatz.

character_set_server

Der Standardzeichensatz des Servers.

character_set_system

Der vom Server zur Speicherung von Bezeichnern verwendete Zeichensatz. Der Wert ist immer utf8.

character_sets_dir

Das Verzeichnis, in dem Zeichensätze installiert sind.

collation_connection

Die Sortierung des Verbindungszeichensatzes.

collation_database

Die von der Standarddatenbank verwendete Sortierung. Der Server stellt diese Variable immer dann ein, wenn die Standarddatenbank sich ändert. Ist keine Standarddatenbank vorhanden, dann hat die Variable denselben Wert wie collation_server.

collation_server

Die Standardsortierung des Servers.

completion_type

Der Transaktionsabschlusstyp:

concurrent_insert

Wenn die Variable den Wert ON hat (Standardeinstellung), gestattet MySQL die nebenläufige Ausführung von INSERT- und SELECT-Anweisungen für MyISAM-Tabellen, die in der Mitte keine freien Blöcke aufweisen. Sie können diese Option deaktivieren, indem Sie mysqld mit --safe oder --skip-new starten.

Diese Variable kann drei ganzzahlige Werte annehmen:

Siehe auch Abschnitt 7.3.3, „Gleichzeitige Einfügevorgänge“.

connect_timeout

Zeit in Sekunden, während der der mysqld-Server auf ein Verbindungspaket wartet, bevor er mit der Meldung Bad handshake antwortet.

datadir

Das MySQL-Datenverzeichnis. Die Variable kann mit der Option --datadir eingestellt werden.

date_format

Diese Variable ist nicht implementiert.

datetime_format

Diese Variable ist nicht implementiert.

default_week_format

Standardmoduswert für die Funktion WEEK(). Siehe auch Abschnitt 12.5, „Datums- und Zeitfunktionen“.

delay_key_write

Diese Option gilt nur für MyISAM-Tabellen. Sie kann einen der folgenden Werte annehmen und beeinflusst hierdurch die Wirkung der Tabellenoption DELAY_KEY_WRITE, die in CREATE TABLE-Anweisungen verwendet werden kann.

Wenn DELAY_KEY_WRITE für eine Tabelle aktiviert ist, wird der Schlüsselpuffer der Tabelle nicht bei jeder Indexaktualisierung, sondern nur dann neu geschrieben, wenn die Tabelle geschlossen wird. Hierdurch werden Schreiboperationen für Schlüssel erheblich beschleunigt. Wenn Sie diese Funktion nutzen, sollten Sie jedoch eine automatische Überprüfung aller MyISAM-Tabellen ergänzen, indem Sie den Server mit der Option --myisam-recover starten (beispielsweise --myisam-recover=BACKUP,FORCE). Siehe auch Abschnitt 5.2.1, „Befehlsoptionen für mysqld“, und Abschnitt 14.1.1, „MyISAM-Startoptionen“.

Beachten Sie, dass die Aktivierung der externen Sperrung mit --external-locking keinen Schutz gegen die Beschädigung von Indizes gewährleistet, deren Tabellen das verzögerte Schreiben von Schlüsseln verwenden.

delayed_insert_limit

Nach dem Einfügen von mit delayed_insert_limit verzögerten Datensätzen überprüft der Handler INSERT DELAYED, ob noch SELECT-Anweisungen ausstehen. Ist dies der Fall, dann gestattet er deren Ausführung, bevor er mit dem Einfügen verzögerter Datensätze fortfährt.

delayed_insert_timeout

Gibt an, wie viele Sekunden ein INSERT DELAYED-Handler auf INSERT-Anweisungen warten soll, bevor er beendet wird.

delayed_queue_size

Dies ist eine tabellenspezifische Beschränkung der Anzahl von Datensätze, die bei der Verarbeitung von INSERT DELAYED-Anweisungen in der Warteschlange stehen dürfen. Wenn die Warteschlange voll wird, wartet jeder Client mit dem Absetzen einer INSERT DELAYED-Anweisung, bis wieder Platz in der Warteschlange ist.

div_precision_increment

Diese Variable gibt die Anzahl der Präzisionsstellen an, um die das Ergebnis von Divisionsoperationen mit dem Operator / erweitert werden soll. Der Standardwert ist 4, der Mindestwert 0 und der Höchstwert 30. Das folgende Beispiel veranschaulicht die Wirkung einer Erhöhung des Standardwertes.

mysql> SELECT 1/7;
+--------+
| 1/7    |
+--------+
| 0.1429 |
+--------+
mysql> SET div_precision_increment = 12;
mysql> SELECT 1/7;
+----------------+
| 1/7            |
+----------------+
| 0.142857142857 |
+----------------+

event_scheduler

Gibt an, ob der Ereignisplaner aktiviert oder deaktiviert ist. Standardmäßig ist der Planer deaktiviert. Diese Variable wurde in MySQL 5.1.6 hinzugefügt.

engine_condition_pushdown

Diese Variable betrifft NDB. Der Standardwert ist 0 (deaktiviert): Wenn Sie eine Abfrage wie SELECT * FROM t WHERE mycol = 42 ausführen, wobei mycol eine nicht indizierte Spalte ist, dann wird die Abfrage als vollständiger Tabellenscan an jedem NDB-Knoten durchgeführt. Jeder Knoten sendet jeden Datensatz an den MySQL-Server, auf dem dann die WHERE-Bedingung angewendet wird. Ist engine_condition_pushdown auf 1 gesetzt (aktiviert), dann wird die Bedingung an die Speicher-Engine „zurückverwiesen“ und an die NDB-Knoten gesendet. Jeder Knoten führt dann den Scan unter Anwendung der Bedingung durch und sendet nur diejenigen Datensätze an den MySQL-Server zurück, bei denen eine Übereinstimmung vorliegt.

expire_logs_days

Die Anzahl der Tage, nach denen Binärlogs automatisch entfernt werden. Der Standardwert ist 0, d. h. es erfolgt keine automatische Entfernung. Sofern Logs entfernt werden, erfolgt dies beim Start sowie bei der Binärlogrotation.

flush

Wenn aktiviert, schreibt der Server nach jeder SQL-Anweisung alle Änderungen neu auf die Festplatte (Synchronisierung). Normalerweise schreibt MySQL alle Änderungen erst nach der jeweiligen SQL-Anweisung auf die Festplatte und überlässt dem Betriebssystem die Festplattensynchronisierung. Siehe auch Abschnitt A.4.2, „Was zu tun ist, wenn MySQL andauernd abstürzt“. Diese Variable ist aktiviert, wenn Sie mysqld mit der Option --flush starten.

flush_time

Hat diese Variable einen Wert ungleich Null, dann werden alle Tabellen nach Verstreichen des durch flush_time (in Sekunden) angegebenen Zeitraums geschlossen, um Ressourcen freizugeben und nicht geschriebene Daten auf die Festplatte zu synchronisieren. Wir empfehlen die Verwendung dieser Option lediglich unter Windows 9x/Me und auf Systemen mit nur minimalen Ressourcen.

ft_boolean_syntax

Die Liste der Operatoren, die bei mit der Option IN BOOLEAN MODE durchgeführter Volltextsuche unterstützt werden. Siehe auch Abschnitt 12.7.1, „Boolesche Volltextsuche“.

Vorgabe ist '+ -><()~*:""&|'. Es gelten folgende Regeln zur Änderung des Wertes:

ft_max_word_len

Die maximale Länge des Wortes, das in einem FULLTEXT-Index enthalten sein darf.

Hinweis: Wenn Sie diese Variable ändern, müssen Sie FULLTEXT-Indizes neu erstellen. Verwenden Sie REPAIR TABLE tbl_name QUICK.

ft_min_word_len

Die minimale Länge des Wortes, das in einem FULLTEXT-Index enthalten sein darf.

Hinweis: Wenn Sie diese Variable ändern, müssen Sie FULLTEXT-Indizes neu erstellen. Verwenden Sie REPAIR TABLE tbl_name QUICK.

ft_query_expansion_limit

Die Anzahl der obersten zu verwendenden Übereinstimmungen, die bei einer mit WITH QUERY EXPANSION ausgeführten Volltextsuche verwendet werden.

ft_stopword_file

Datei, aus der die Liste der Stoppwörter für die Volltextsuche ausgelesen wird. Es werden alle Wörter aus der Datei verwendet; Kommentare hingegen werden nicht berücksichtigt. Standardmäßig wird eine eingebaute Liste mit Stoppwörtern (wie in der Datei myisam/ft_static.c definiert) verwendet. Wenn Sie die Variable auf den Leer-String setzen (''), wird die Ausfilterung von Stoppwörtern deaktiviert.

Hinweis: Wenn Sie diese Variable ändern oder den Inhalt der Stoppwortdatei ändern, müssen die FULLTEXT-Indizes neu erstellt werden. Verwenden Sie REPAIR TABLE tbl_name QUICK.

group_concat_max_len

Die maximal zulässige Ergebnislänge der Funktion GROUP_CONCAT(). Der Standardwert ist 1.024.

have_archive

YES, wenn mysqld ARCHIVE-Tabellen unterstützt, andernfalls NO.

have_bdb

YES, wenn mysqld BDB-Tabellen unterstützt. DISABLED, wenn --skip-bdb verwendet wird.

have_blackhole_engine

YES, wenn mysqld BLACKHOLE-Tabellen unterstützt, andernfalls NO.

have_compress

YES, wenn die Komprimierungsbibliothek zlib auf dem Server verfügbar ist, andernfalls NO. In diesem Fall können die Funktionen COMPRESS() und UNCOMPRESS() nicht verwendet werden.

have_crypt

YES, wenn der Systemaufruf crypt() auf dem Server verfügbar ist, andernfalls NO. In diesem Fall kann die Funktion ENCRYPT() nicht verwendet werden.

have_csv

YES, wenn mysqld ARCHIVE-Tabellen unterstützt, andernfalls NO.

have_example_engine

YES, wenn mysqld EXAMPLE-Tabellen unterstützt, andernfalls NO.

have_federated_engine

YES, wenn mysqld FEDERATED-Tabellen unterstützt, andernfalls NO.

have_geometry

YES, wenn der Server raumbezogene Datentypen unterstützt, andernfalls NO.

have_innodb

YES, wenn mysqld InnoDB-Tabellen unterstützt. DISABLED, wenn --skip-innodb verwendet wird.

have_isam

In MySQL 5.1 ist diese Variable nur aus Gründen der Abwärtskompatibilität vorhanden. Sie hat immer den Wert NO, da ISAM nicht mehr unterstützt werden.

have_ndbcluster

YES, wenn mysqld NDB Cluster-Tabellen unterstützt. DISABLED, wenn --skip-ndbcluster verwendet wird.

have_partitioning

YES, wenn mysqld die Partitionierung unterstützt. Wurde in MySQL 5.1.1 als have_partition_engine hinzugefügt und in 5.1.6 in have_partioning umbenannt.

have_openssl

YES, wenn mysqld eine SSL-Verschlüsselung des Client/Server-Protokolls unterstützt, andernfalls NO.

have_query_cache

YES, wenn mysqld den Abfrage-Cache unterstützt, andernfalls NO.

have_raid

YES, wenn mysqld die Option RAID unterstützt, andernfalls NO.

have_row_based_replication

YES, wenn der Server die Replikation unter Verwendung datensatzbasierten Binärloggens durchführen kann. Wenn der Wert NO ist, kann der Server nur anweisungsbasiertes Loggen durchführen. Siehe auch Abschnitt 6.3, „Zeilenbasierte Replikation“. Diese Variable wurde in MySQL 5.1.5 hinzugefügt.

have_rtree_keys

YES, wenn RTREE-Indizes verfügbar sind, andernfalls NO. (Diese werden für raumbezogene Indizes in MyISAM-Tabellen verwendet.)

have_symlink

YES, wenn die Unterstützung für symbolische Verknüpfungen aktiviert ist, andernfalls NO. Diese ist unter Unix für die Unterstützung der Tabellenoptionen DATA DIRECTORY und INDEX DIRECTORY und unter Windows für die Unterstützung von symbolischen Verknüpfungen mit Datenverzeichnissen erforderlich.

init_connect

Ein String, der vom Server immer dann ausgeführt wird, wenn ein Client eine Verbindung herstellt. Der String besteht aus einer oder mehreren SQL-Anweisungen. Wenn Sie mehrere Anweisungen angeben wollen, trennen Sie sie durch Semikola. So beginnt beispielsweise jeder Client bei einer Verbindung mit aktiviertem Autocommit-Modus. Es gibt keine globale Systemvariable, mit der festgelegt werden kann, dass Autocommit standardmäßig deaktiviert werden soll; mithilfe von init_connect aber können Sie genau dies realisieren:

SET GLOBAL init_connect='SET AUTOCOMMIT=0';

Diese Variable können Sie sowohl über die Befehlszeile als auch in einer Optionsdatei einstellen. Wenn Sie die Variable wie gezeigt in einer Optionsdatei einstellen wollen, ergänzen Sie die folgenden Zeilen:

[mysqld]
init_connect='SET AUTOCOMMIT=0'

Beachten Sie, dass der Inhalt von init_connect nicht für Benutzer ausgeführt wird, die die Berechtigung SUPER haben. Zweck dieser Maßnahme ist es zu verhindern, dass ein fehlerhafter Wert für init_connect eine Verbindung zum System für alle Benutzer unmöglich macht. Wenn der Wert etwa eine Anweisung mit einem Syntaxfehler enthält, dann könnte dieser dazu führen, dass sich die Clients nicht mehr anmelden können. Da init_connect für Benutzer mit der Berechtigung SUPER nicht ausgeführt wird, können diese eine Verbindung herstellen und den Wert von init_connect korrigieren.

init_file

Der Name der beim Serverstart mit der Option --init-file angegebenen Datei. Es sollte sich hierbei um eine Datei mit SQL-Anweisungen handeln, die der Server beim Start ausführen soll. Jede Anweisung muss in einer eigenen Zeile stehen und darf keine Kommentare enthalten.

init_slave

Diese Variable ähnelt init_connect, es handelt sich hierbei aber um einen String, der von einem Slave-Server jedes Mal dann ausgeführt wird, wenn der SQL-Thread startet. Das Format des Strings ist identisch mit dem der Variable init_connect.

innodb_xxx

InnoDB-Systemvariablen werden in Abschnitt 14.2.4, „InnoDB: Startoptionen und Systemvariablen“ beschrieben.

interactive_timeout

Zeit in Sekunden, während der der Server bei einer interaktiven Verbindung auf Aktivitäten wartet, bevor er sie schließt. Ein interaktiver Client ist als Client definiert, der die Option CLIENT_INTERACTIVE für mysql_real_connect() verwendet. Siehe auch wait_timeout.

join_buffer_size

Die Größe des Puffers, der für Joins benutzt wird, die keine Indizes verwenden und deswegen vollständige Tabellenscans durchführen. Normalerweise besteht die beste Möglichkeit der Realisierung schneller Joins darin, Indizes hinzuzufügen. Erhöhen Sie den Wert von join_buffer_size, um einen schnelleren vollständigen Join zu implementieren, wenn das Hinzufügen von Indizes nicht möglich ist. Für jeden vollständigen Join zwischen zwei Tabellen wird ein Join-Puffer hinzugefügt. Für einen komplexen Join zwischen mehreren Tabellen, für den Indizes nicht verwendet werden, sind unter Umständen mehrere Join-Puffer erforderlich.

key_buffer_size

Indexblöcke für MyISAM-Tabellen werden gepuffert und von allen Threads gemeinsam verwendet. key_buffer_size ist die Größe des für die Indexblöcke verwendeten Puffers. Der Schlüsselpuffer heißt auch Schlüssel-Cache.

Die maximal zulässige Größe für key_buffer_size beträgt 4 Gbyte. Das effektive Limit kann abhängig davon, wie viel physisches RAM vorhanden ist und welche RAM-spezifischen Grenzwerte je Prozess unter Ihrem Betriebssystem bzw. auf Ihrer Hardwareplattform gelten, niedriger liegen.

Wenn Sie die Indexverwaltung (für Lese- und mehrfachen Schreiboperationen) optimieren wollen, erhöhen Sie diesen Wert so weit wie möglich. Ein Wert von 25 Prozent des gesamten Speichers auf einem System, auf dem hauptsächlich MySQL läuft, ist durchaus normal. Wenn Sie den Wert jedoch zu hoch (beispielsweise auf mehr als 50 Prozent Ihres gesamten Speichers) setzen, wird Ihr System Daten auslagern und so extrem langsam werden. Zur Durchführung des Dateisystem-Cachings für Datenleseoperationen ist MySQL auf das Betriebssystem angewiesen, d. h. Sie müssen ein wenig Platz für den Dateisystem-Cache lassen. Außerdem müssen Sie die Speicheranforderungen anderer Speicher-Engines berücksichtigen.

Um eine noch höhere Geschwindigkeit beim Schreiben vieler Datensätze zur gleichen Zeit zu erzielen, verwenden Sie LOCK TABLES. Siehe auch Abschnitt 7.2.16, „Geschwindigkeit von INSERT-Anweisungen“.

Sie können die Leistung des Schlüsselpuffers durch Absetzen einer SHOW STATUS-Anweisung und Überprüfung der Statusvariablen Key_read_requests, Key_reads, Key_write_requests und Key_writes verifizieren. (Siehe auch Abschnitt 13.5.4, „SHOW“.) Das Verhältnis von Key_reads zu Key_read_requests sollte möglichst kleiner als 0,01 sein. Das Key_writes/Key_write_requests-Verhältnis hat normalerweise einen Wert von knapp 1, wenn Sie in erster Linie Aktualisierungs- und Löschvorgänge durchführen, kann aber wesentlich kleiner sein, wenn Sie entweder häufig Updates ausführen, die zahlreiche Datensätze gleichzeitig betreffen, oder die Tabellenoption DELAY_KEY_WRITE verwenden.

Der Anteil des verwendeten Schlüsselpuffers kann mithilfe von key_buffer_size in Verbindung mit der Statusvariablen Key_blocks_unused und der Pufferblockgröße bestimmt werden, die über die Systemvariable key_cache_block_size verfügbar ist:

1 - ((Key_blocks_unused × key_cache_block_size) / key_buffer_size)

Dies ist lediglich ein Näherungswert, weil ein Teil des Schlüsselpuffers möglicherweise intern für Verwaltungsstrukturen reserviert ist.

Sie können mehrere MyISAM-Schlüssel-Caches erstellen. Die Größenbeschränkung von 4 Gbyte gilt für jeden einzelnen Cache, nicht für die Summe aller Caches. Siehe auch Abschnitt 7.4.6, „Der MyISAM-Schlüssel-Cache“.

key_cache_age_threshold

Dieser Wert steuert die Herabstufung von Puffern aus der heißen Unterkette eines Schlüssel-Caches in eine warme Unterkette. Niedrige Werte führen dazu, dass diese Herabstufung schneller erfolgt. Der minimale Wert ist 100, der Vorgabewert 300. Siehe auch Abschnitt 7.4.6, „Der MyISAM-Schlüssel-Cache“.

key_cache_block_size

Größe der Blocks im Schlüssel-Cache in Byte. Der Standardwert ist 1.024. Siehe auch Abschnitt 7.4.6, „Der MyISAM-Schlüssel-Cache“.

key_cache_division_limit

Der Trennpunkt zwischen heißen und warmen Unterketten der Schlüssel-Cache-Pufferkette. Der Wert gibt den Anteil der Pufferkette, die für die warme Unterkette benutzt wird, prozentual an. Der zulässige Wertebereich liegt zwischen 1 und 100, Vorgabewert ist 100. Siehe auch Abschnitt 7.4.6, „Der MyISAM-Schlüssel-Cache“.

language

Sprache, in der Fehlermeldungen ausgegeben werden.

large_file_support

Gibt an, ob mysqld mit Optionen zur Unterstützung großer Dateien kompiliert wurde.

large_pages

Gibt an, ob die Unterstützung großer Seiten aktiviert wurde.

license

Der Lizenztyp des Servers.

local_infile

Gibt an, ob LOCAL für LOAD DATA INFILE-Anweisungen unterstützt wird. Siehe auch Abschnitt 5.7.4, „Sicherheitsprobleme mit LOAD DATA LOCAL“.

locked_in_memory

Gibt an, ob mysqld mit der Option --memlock im Speicher gesperrt wurde.

log

Gibt an, ob das Loggen aller Anweisungen im allgemeinen Abfragelog aktiviert wurde Siehe auch Abschnitt 5.12.2, „Die allgemeine Anfragen-Logdatei“.

log_bin

Gibt an, ob das Binärlog aktiviert wurde. Siehe auch Abschnitt 5.12.3, „Die binäre Update-Logdatei“.

log_bin_trust_function_creators

Diese Variable wird angewendet, wenn das binäre Loggen aktiviert ist. Sie steuert, ob die Ersteller gespeicherter Funktionen vertrauenswürdig sind, keine gespeicherten Funktionen zu erstellen, die das Schreiben unsicherer Ereignisse in das Binärlog bewirken könnten. Wenn die Variable den Wert 0 hat (Standardeinstellung), dann dürfen Benutzer gespeicherte Routinen nur dann erstellen oder ändern, wenn sie zusätzlich zu den Berechtigungen CREATE ROUTINE oder ALTER ROUTINE die Berechtigung SUPER haben. Die Einstellung 0 implementiert auch eine Beschränkung, dass eine Funktion mit der Eigenschaft DETERMINISTIC, der Eigenschaft READS SQL DATA oder der Eigenschaft NO SQL deklariert werden muss. Hat die Variable den Wert 1, dann setzt MySQL diese Beschränkungen bei der Erstellung gespeicherter Funktionen nicht durch. Siehe auch Abschnitt 19.4, „Binärloggen gespeicherter Routinen und Trigger“.

log_error

Die Position des Fehlerlogs.

log_slave_updates

Gibt an, ob Updates, die ein Slave-Server von einem Master-Server empfängt, im eigenen Binärlog des Slave-Servers aufgezeichnet werden sollen. Damit diese Variable Wirkung zeigt, muss das binäre Loggen am Slave aktiviert sein. Siehe auch Abschnitt 6.9, „Replikationsoptionen in my.cnf“.

log_slow_queries

Gibt an, ob langsame Abfragen protokolliert werden sollen. „Langsam“ wird hierbei durch den Wert der Variable long_query_time bestimmt. Siehe auch Abschnitt 5.12.4, „Die Logdatei für langsame Anfragen“.

log_warnings

Gibt an, ob zusätzliche Warnmeldungen erzeugt werden sollen. Die Funktion ist standardmäßig aktiviert. Unterbrochene Verbindungen werden nicht in das Fehlerlog protokolliert, sofern der Wert größer als 1 ist.

long_query_time

Wenn eine Abfrage länger dauert als durch diese Variable (in Sekunden) angegeben, erhöht der Server die Statusvariable Slow_queries entsprechend. Wenn Sie die Option --log-slow-queries verwenden, wird die Abfrage in der Logdatei für langsame Abfragen protokolliert. Dieser Wert wird als Echtzeit (nicht als Prozessorzeit) gemessen, d. h. eine Abfrage, die bei einem System mit geringer Belastung den Schwellwert unterschreitet, kann bei einem stark belasteten System bereits darüber liegen. Der Mindestwert ist 1. Siehe auch Abschnitt 5.12.4, „Die Logdatei für langsame Anfragen“.

low_priority_updates

Wenn diese Variable den Wert 1 hat, warten alle INSERT-, UPDATE-, DELETE- und LOCK TABLE WRITE-Anweisungen, bis keine SELECT- oder LOCK TABLE READ-Anweisungen für die betreffende Tabelle mehr anhängig sind. Diese Variable hieß früher sql_low_priority_updates.

lower_case_file_system

Diese Variable beschreibt die Auswirkungen der Groß-/Kleinschreibung auf dem Dateisystem, auf dem sich das Datenverzeichnis befindet. OFF bedeutet, dass die Groß-/Kleinschreibung bei Dateinamen unterschieden wird, bei ON ist dies nicht der Fall.

lower_case_table_names

Hat die Variable den Wert 1, dann werden Tabellennamen in Kleinschreibung auf der Festplatte gespeichert. Vergleiche von Tabellennamen werden dann nicht durch unterschiedliche Groß-/Kleinschreibung beeinträchtigt. Der Wert 2 führt zu einer Speicherung der Tabellennamen in der eingegebenen Form, Vergleiche erfolgen aber stets in Kleinschreibung. Diese Option gilt auch für Datenbanknamen und Tabellenaliase. Siehe auch Abschnitt 9.2.2, „Groß-/Kleinschreibung in Namen“.

Wenn Sie InnoDB-Tabellen verwenden, sollten Sie diese Variable auf allen Plattformen auf 1 setzen. Hiermit wird die Konvertierung von Namen in die Kleinschreibung erzwungen.

Sie sollten diese Variable keinesfalls auf 0 setzen, wenn Sie MySQL auf einem System ausführen, bei dem die Groß-/Kleinschreibung von Dateinamen nicht unterschieden wird (dies betrifft etwa Windows oder Mac OS X). Wird diese Variable beim Start nicht eingestellt und unterscheidet das Dateisystem, auf dem sich das Datenverzeichnis befindet, keine Groß-/Kleinschreibung bei Dateinamen, dann stellt MySQL lower_case_table_names automatisch auf 2.

max_allowed_packet

Die maximale Größe eines Pakets oder eines erzeugten oder temporären Strings.

Der Paketmeldungspuffer wird mit net_buffer_length Bytes initialisiert, kann aber bei Bedarf auf bis zu max_allowed_packet Bytes anwachsen. Dieser Wert ist standardmäßig niedrig, damit große (und möglicherweise falsche) Pakete abgefangen werden.

Wenn Sie große BLOB-Spalten oder lange Strings verwenden, müssen Sie ihn erhöhen. Es sollte so groß sein wie das größte BLOB, das Sie verwenden wollen. Das Protokolllimit für max_allowed_packet beträgt 1Gbyte.

max_binlog_cache_size

Wenn eine Transaktion mit mehreren Anweisungen mehr Speicher benötigt als hier angegeben, dann erzeugt der Server die Fehlermeldung Multi-statement transaction required more than 'max_binlog_cache_size' bytes of storage.

max_binlog_size

Wenn eine Schreiboperation in das Binärlog bewirkt, dass die aktuelle Größe der Logdatei den Wert dieser Variable überschreitet, dann führt der Server eine Rotation der Binärlogs durch (d. h. er schließt die aktuelle Datei und öffnet die nächste). Sie können diese Variable nur auf einen Wert im Bereich zwischen 4096 Bytes und 1 Gbyte setzen. Der Vorgabewert ist 1 Gbyte.

Eine Transaktion wird am Stück in das Binärlog geschrieben, kann also niemals auf mehrere Binärlogs verteilt werden. Deswegen kann es vorkommen, dass, wenn Transaktionen sehr groß sind, Binärlogs am Ende größer sind als mit max_binlog_size angegeben.

Wenn max_relay_log_size 0 ist, gilt der Wert von max_binlog_size auch für Relay-Logdateien.

max_connect_errors

Wenn die Anzahl unterbrochener Verbindungen zu einem Host höher liegt als durch diese Variable angegeben, dann werden weitere Verbindungen für diesen Host gesperrt. Diese Sperrung von Hosts können Sie mit FLUSH HOSTS aufheben.

max_connections

Die zulässige Anzahl nebenläufiger Clientverbindungen. Wenn Sie diesen Wert erhöhen, erhöht sich auch die Anzahl der Dateideskriptoren, die mysqld benötigt. Anmerkungen zu Grenzwerten für Dateideskriptoren finden Sie in Abschnitt 7.4.8, „Nachteile der Erzeugung großer Mengen von Tabellen in derselben Datenbank“. Siehe auch Abschnitt A.2.6, „Too many connections-Fehler“.

max_delayed_threads

Maximale Anzahl von Threads, die zur Verarbeitung von INSERT DELAYED-Anweisungen gestartet werden dürfen. Wenn Sie versuchen, Daten in eine neue Tabelle einzufügen, während alle INSERT DELAYED-Threads gerade verwendet werden, dann wird der Datensatz so eingefügt, als ob das Attribut DELAYED nicht angegeben worden wäre. Wenn Sie hier den Wert 0 angeben, erstellt MySQL in keinem Fall einen Thread zur Verarbeitung von DELAYED-Datensätzen; im Endeffekt bedeutet dies eine vollständige Deaktivierung von DELAYED.

max_error_count

Die maximale Anzahl von Fehlermeldungen, Warnungen und Hinweisen, die mit SHOW ERRORS- und SHOW WARNINGS-Anweisungen zur Anzeige gespeichert werden.

max_heap_table_size

Diese Variable bestimmt die maximale Größe, auf die MEMORY-Tabellen anwachsen dürfen. Der Wert der Variable wird zur Berechnung von MAX_ROWS-Werte für MEMORY-Tabellen verwendet. Die Einstellung der Variable hat keine Auswirkungen auf bereits vorhandene MEMORY-Tabellen, sofern diese nicht mit einer Anweisung wie CREATE TABLE neu erstellt oder mit ALTER TABLE oder TRUNCATE TABLE modifiziert werden.

max_insert_delayed_threads

Diese Variable ist synonym zu max_delayed_threads.

max_join_size

Ermöglicht das Unterbinden von SELECT-Anweisungen, die unter Umständen eine größere Anzahl von Datensätzen (bei Anweisungen für eine Tabelle) oder Datensatzkombinationen (bei Anweisungen für mehrere Tabellen) untersuchen müssen als durch max_join_size angegeben. Ebenfalls unterbunden werden SELECT-Anweisungen, bei denen mehr Festplattenzugriffe erfolgen würden als durch max_join_size angegeben. Durch Einstellen dieses Wertes können Sie SELECT-Anweisungen abfangen, bei denen Schlüssel nicht korrekt verwendet wurden und deren Verarbeitung wahrscheinlich sehr lange dauern würde. Nehmen Sie diese Einstellung vor, wenn Ihre Benutzer dazu neigen, Joins durchzuführen, bei denen entweder eine WHERE-Klausel fehlt oder die sehr lange dauern oder mehrere Millionen Datensätze zurückgeben könnten.

Wenn Sie die Variable auf einen anderen Wert als DEFAULT setzen, wird der Wert von SQL_BIG_SELECTS auf 0 zurückgesetzt. Stellen Sie den Wert von SQL_BIG_SELECTS erneut ein, dann wird die Variable max_join_size ignoriert.

Befindet sich ein Abfrageergebnis im Abfrage-Cache, dann wird keine Überprüfung der Ergebnisgröße durchgeführt, weil das Ergebnis zuvor bereits berechnet wurde und der Server durch den Versand des Ergebnisses nicht belastet würde.

Diese Variable hieß früher sql_max_join_size.

max_length_for_sort_data

Die Teilungsgröße bei Indexwerten. Sie bestimmt, welcher filesort-Algorithmus verwendet werden soll. Siehe auch Abschnitt 7.2.12, „ORDER BY-Optimierung“.

max_relay_log_size

Wenn eine Schreiboperation durch einen Replikations-Slave in seine Relay-Logdatei bewirkt, dass die aktuelle Größe der Logdatei den Wert dieser Variable überschreitet, dann führt der Slave eine Rotation der Relay-Logs durch (d. h. er schließt die aktuelle Datei und öffnet die nächste). Wenn max_relay_log_size 0 ist, verwendet der Server max_binlog_size sowohl für das Binär- als auch für das Relay-Log. Ist max_relay_log_size größer als 0, dann wird hierdurch die Größe des Relay-Logs beschränkt. Dies ermöglicht Ihnen die Konfiguration unterschiedlicher Größen für die beiden Logdateien. Sie müssen max_relay_log_size auf einen Wert zwischen 4.096 Bytes und 1 Gbyte (jeweils einschließlich) oder auf 0 setzen. Der Standardwert ist 0. Siehe auch Abschnitt 6.4, „Replikation: Implementationsdetails“.

max_seeks_for_key

Beschränkt die voraussichtliche Anzahl von Festplattenzugriffen beim schlüsselbasierten Suchen nach Datensätzen. Der MySQL-Optimierer geht davon aus, dass nicht mehr als die hier angegebene Anzahl von Schlüsselsuchvorgängen bei der Suche nach passenden Datensätzen in einer Tabelle durch einen Indexscan erforderlich ist (und zwar unabhängig von der tatsächlichen Kardinalität des Index; siehe auch Abschnitt 13.5.4.12, „SHOW INDEX“). Durch Einstellen eines niedrigen Wertes (z. B. 100) können Sie MySQL dazu zwingen, Indizes statt Tabellenscans zu bevorzugen.

max_sort_length

Die bei der Sortierung von BLOB- oder TEXT-Werten zu verwendende Anzahl von Bytes. Nur die ersten max_sort_length Bytes jedes Wertes werden berücksichtigt; der Rest wird ignoriert.

max_tmp_tables

Die maximale Anzahl temporärer Tabellen, die ein Client zur selben Zeit offen halten darf. (Diese Option hat derzeit noch keine Auswirkungen.)

max_user_connections

Die maximale Anzahl gleichzeitiger Verbindungen zu einem gegebenen MySQL-Konto. Der Wert 0 hat die Bedeutung „unbeschränkt“.

Diese Variable hat sowohl einen globalen als auch einen (schreibgeschützten) sitzungsbezogenen Geltungsbereich. Die Sitzungsvariable hat denselben Wert wie die globale Variable, sofern das aktuelle Konto nicht eine MAX_USER_CONNECTIONS-Ressourcenbeschränkung ungleich Null hat. In diesem Fall beschreibt der Sitzungswert die kontenbezogene Beschränkung.

max_write_lock_count

Nach Verstreichen der hier angegebenen Anzahl von Schreibsperren muss zunächst einmal eine Anzahl anhängiger Anforderungen für Lesesperren verarbeitet werden.

myisam_data_pointer_size

Die Standardgröße (in Byte) des Zeigers, der von CREATE TABLE für MyISAM-Tabellen verwendet wird, wenn die Option MAX_ROWS nicht angegeben ist. Der Variablenwert muss zwischen 2 und 7 liegen, der Standardwert ist 6. Siehe auch Abschnitt A.2.11, „The table is full-Fehler“.

myisam_max_extra_sort_file_size (AUSLAUFEND)

Hinweis: Diese Variable wird in MySQL 5.1 nicht unterstützt. Weitere Informationen finden Sie im MySQL 5.0 Reference Manual.

myisam_max_sort_file_size

Die maximale Größe der Temporärdatei, die MySQL bei der Neuerstellung eines MyISAM-Indexes (bei REPAIR TABLE, ALTER TABLE oder LOAD DATA INFILE) verwenden darf. Ist die Datei größer als durch diesen Wert angegeben, dann wird der Index stattdessen unter Verwendung des Schlüssel-Caches erstellt (was allerdings langsamer ist). Der Wert wird in Byte angegeben.

myisam_recover_options

Der Wert der Option --myisam-recover. Siehe auch Abschnitt 5.2.1, „Befehlsoptionen für mysqld“.

myisam_repair_threads

Wenn dieser Wert größer als 1 ist, werden Indizes von MyISAM-Tabellen parallel (d. h. jeder Index mit einem eigenen Thread) während des Prozesses Repair by sorting erstellt. Der Standardwert ist 1. Hinweis: Der Code für die Multithread-Reparatur befindet sich noch im Betastadium.

myisam_sort_buffer_size

Die Größe des Puffers, der bei der Sortierung von MyISAM-Indizes bei Ausführung von REPAIR TABLE oder bei der Erstellung von Indizes mit CREATE INDEX oder ALTER TABLE zugewiesen wird.

myisam_stats_method

Bestimmt, wie der Server NULL-Werte bei der Ermittlung von Statistiken zur Verteilung von Indexwerten bei MyISAM-Tabellen behandelt. Für die Variable gibt es zwei mögliche Werte: nulls_equal und nulls_unequal. Bei nulls_equal werden alle NULL-Indexwerte als gleichwertig betrachtet und bilden eine einzelne Wertegruppe, deren Größe der Anzahl der NULL-Werte entspricht. Bei nulls_unequal hingegen werden NULL-Werte nicht als gleichwertig betrachtet, und jeder NULL-Wert bildet eine eigene Wertegruppe der Größe 1.

Die Methode, mit der Tabellenstatistiken erzeugt werden, wirkt sich darauf aus, wie der Optimierer Indizes zur Abfrageausführung auswählt. Eine Beschreibung finden Sie in Abschnitt 7.4.7, „Sammlung von MyISAM-Indexstatistiken“.

myisam_use_mmap

Sorgt für die Verwendung der Speicherzuordnung zum Lesen und Schreiben von MyISAM-Tabellen. Diese Variable wurde in MySQL 5.1.4 hinzugefügt.

multi_read_range

Gibt die maximale Anzahl von Bereichen an, die bei der Bereichsauswahl an eine Speicher-Engine gesendet werden. Der Standardwert beträgt 256. Das Senden mehrerer Bereiche an eine Engine ist eine Funktion, die die Leistung bestimmter Auswahloperationen drastisch optimieren kann. Dies gilt insbesondere für NDBCLUSTER: Diese Engine muss Bereichsanforderungen an alle Knoten senden, und das gleichzeitige Senden vieler derartiger Anforderungen verringert die Kommunikationskosten erheblich.

named_pipe

(Nur für Windows.) Gibt an, ob der Server Verbindungen über Named Pipes unterstützt.

ndb_extra_logging

Diese Variable kann auf einen Wert ungleich Null gesetzt werden, um das zusätzliche NDB-Loggen zu aktivieren. Diese Variable wurde in MySQL 5.1.6 hinzugefügt.

net_buffer_length

Der Kommunikationspuffer wird zwischen SQL-Anweisungen auf diese Größe zurücksetzt. Der Wert dieser Variable sollte normalerweise nicht geändert werden. Wenn Sie aber sehr wenig Speicher haben, können Sie ihn auf die voraussichtliche Länge der von Clients gesendeten Anweisungen setzen. Überschreiten Anweisungen diese Länge, dann wird der Puffer automatisch auf bis zu max_allowed_packet Bytes vergrößert.

net_read_timeout

Gibt an (in Sekunden), wie lange auf weitere Daten über eine Verbindung gewartet wird, bevor die Leseoperation abgebrochen wird. Dieser Grenzwert gilt nur für TCP/IP-Verbindungen, nicht jedoch für Verbindungen, die über Unix-Socketdateien, Named Pipes oder gemeinsamen Speicher erfolgen. Wenn der Server vom Client liest, gibt net_read_timeout den Zeitwert an, mit dem der Zeitpunkt des Abbruchs gesteuert wird. Wenn der Server hingegen auf den Client schreibt, gibt net_write_timeout den Zeitwert an, mit dem der Zeitpunkt des Abbruchs gesteuert wird. Siehe auch slave_net_timeout.

net_retry_count

Wenn eine Leseoperation an einem Kommunikationsport unterbrochen wird, erfolgt die hier angegebene Anzahl von Wiederverbindungsversuchen, bevor der Vorgang endgültig abgebrochen wird. Bei FreeBSD sollte dieser Wert ziemlich hoch sein, weil interne Interrupts an alle Threads gesendet werden.

net_write_timeout

Gibt an (in Sekunden), wie lange auf das Schreiben eines Blocks über eine Verbindung gewartet wird, bis die Schreiboperation abgebrochen wird. Dieser Grenzwert gilt nur für TCP/IP-Verbindungen, nicht jedoch für Verbindungen, die über Unix-Socketdateien, Named Pipes oder gemeinsamen Speicher erfolgen. Siehe auch net_read_timeout.

new

Diese Variable wurde in MySQL 4.0 verwendet, um bestimmte Verhaltensweisen von Version 4.1 zu aktivieren. Sie ist aus Gründen der Abwärtskompatibilität noch vorhanden. In MySQL 5.1 ist der Wert immer OFF.

old_passwords

Gibt an, ob der Server Passwörter im vor Version 4.1 verwendeten Stil benutzen soll. Siehe auch Abschnitt A.2.3, „Client does not support authentication protocol“.

one_shot

Dies ist keine Variable, kann aber zur Einstellung einiger Variablen verwendet werden. Eine Beschreibung finden Sie in Abschnitt 13.5.3, „SET“.

open_files_limit

Die Anzahl der Dateien, die mysqld nach Maßgabe des Betriebssystems öffnen darf. Dies ist der wirkliche, vom System gestattete Wert; er kann sich von dem Wert unterscheiden, den Sie mithilfe der Option --open-files-limit an mysqld bzw. mysqld_safe übergeben haben. Auf Systemen, bei denen MySQL die Anzahl offener Dateien nicht ändern kann, ist der Wert 0.

optimizer_prune_level

Steuert die bei der Abfrageoptimierung angewendete Heuristik, um den Suchraum des Optimierers von wenig vielversprechenden Teilplänen zu säubern. Der Wert 0 deaktiviert die Heuristik, d. h. der Optimierer führt eine erschöpfende Suche durch. Der Wert 1 hingegen sorgt dafür, dass der Optimierer Pläne basierend auf der Anzahl der von temporären Plänen abgerufenen Datensätze entfernt.

optimizer_search_depth

Die maximale Tiefe der vom Abfrageoptimierer durchgeführten Suche. Werte, die größer sind als die Anzahl der Beziehungen in einer Abfrage, führen zu besseren Abfrageplänen, benötigen aber mehr Zeit zur Erzeugung eines Ausführungsplans für eine Abfrage. Bei Werten hingegen, die kleiner sind als die Anzahl der Beziehungen in einer Abfrage, wird der Ausführungsplan schneller zurückgegeben; allerdings ist der zurückgegebene Plan unter Umständen weit davon entfernt, optimal zu sein. Wenn der Wert 0 gewählt wird, wählt das System automatisch einen sinnvollen Wert aus. Wird ein Wert zugewiesen, der der maximalen Anzahl der in einer Abfrage verwendeten Tabelle plus 2 entspricht, dann verwendet der Optimierer zur Durchführung von Suchvorgängen den in MySQL 5.0.0 (und vorher) verwendeten Algorithmus.

pid_file

Der Pfadname der Prozesskennungsdatei. Die Variable kann mit der Option --pid-file eingestellt werden.

plugin_dir

Der Pfadname des Plug-In-Verzeichnisses. Diese Variable wurde in MySQL 5.1.2 hinzugefügt.

port

Die Nummer des Ports, auf dem der Server nach TCP/IP-Verbindungen horcht. Die Variable kann mit der Option --port eingestellt werden.

preload_buffer_size

Die Größe des Puffers, der beim Vorabladen von Indizes reserviert wird.

protocol_version

Die Version des vom MySQL-Server verwendeten Client/Server-Protokolls.

query_alloc_block_size

Die Zuweisungsgröße von Speicherblöcken, die für Objekte reserviert sind, welche während der Verarbeitung und Ausführung von Anweisungen erstellt werden. Wenn Sie Probleme mit der Speicherfragmentierung haben, kann es hilfreich sein, diesen Wert ein wenig zu erhöhen.

query_cache_limit

Es werden nur Ergebnisse zwischengespeichert, die nicht größer sind als die hier angegebene Anzahl von Bytes. Der Vorgabewert ist 1 Mbyte.

query_cache_min_res_unit

Die Mindestgröße (in Byte) für Blöcke, die vom Abfrage-Cache reserviert wurden. Der Vorgabewert ist 4.096 (4 Kbyte). Informationen zur Optimierung dieser Variable finden Sie in Abschnitt 5.14.3, „Konfiguration des Anfragen-Cache“.

query_cache_size

Die Menge des Speichers, der zur Zwischenspeicherung von Abfrageergebnissen reserviert wird. Der Standardwert ist 0, d. h. der Abfrage-Cache ist deaktiviert. Beachten Sie, dass die hier angegebene Speichermenge auch dann reserviert wird, wenn query_cache_type den Wert 0 hat. Weitere Informationen finden Sie in Abschnitt 5.14.3, „Konfiguration des Anfragen-Cache“.

query_cache_type

Bestimmt den Typ des Abfrage-Caches. Die Einstellung des GLOBAL-Wertes legt den Typ für alle Clients fest, die sich nachfolgend anmelden. Einzelne Clients können den SESSION-Wert einstellen, um die eigene Verwendung des Abfrage-Caches zu beeinflussen. Die zulässigen Werte entnehmen Sie folgender Tabelle:

Diese Variable hat den Standardwert ON.

query_cache_wlock_invalidate

Wenn ein Client eine Schreibsperre auf eine MyISAM-Tabelle erwirkt, dann wird das Absetzen von Anweisungen anderer Clients, die aus dieser Tabelle lesen, normalerweise nicht unterbunden, wenn die Abfrageergebnisse im Abfrage-Cache vorhanden sind. Wenn Sie diese Variable auf 1 setzen, werden bei vorhandener Schreibsperre für eine Tabelle alle Abfragen im Abfrage-Cache, die auf diese Tabelle verweisen, ungültig. Hierdurch sind andere Clients, die auf diese Tabelle zugreifen wollen, zum Warten gezwungen, bis die Sperre aufgehoben wird.

query_prealloc_size

Die Größe des Permanentpuffers, der zur Abarbeitung und Ausführung von Anweisungen verwendet wird. Dieser Puffer wird zwischen den Anweisungen nicht geleert. Wenn Sie komplexe Abfragen ausführen, kann ein höherer Wert für query_prealloc_size die Leistung optimieren, weil er dafür sorgt, dass der Server während der Abfrageausführung weniger Speicherreservierungen vornehmen muss.

range_alloc_block_size

Die Größe der Blöcke, die bei der Bereichsoptimierung reserviert werden.

read_buffer_size

Jeder Thread, der einen sequenziellen Scan durchführt, reserviert einen Puffer dieser Größe (in Byte) pro gescannter Tabelle. Wenn Sie mehrere sequenzielle Scans durchführen, sollten Sie den Wert erhöhen. Standardmäßig steht er bei 131.072.

read_only

Wenn die Variable für einen Replikations-Slave-Server auf ON gesetzt ist, gestattet der Slave Updates lediglich von Slave-Threads oder von Benutzern, die die Berechtigung SUPER haben. Dies kann sinnvoll sein, um sicherzustellen, dass ein Slave-Server Updates nur von seinem Master-Server und nicht von Clients akzeptiert. Diese Variable gilt nicht für TEMPORARY-Tabellen.

relay_log_purge

Aktiviert oder deaktiviert das automatische Säubern von Relay-Logdateien, sobald diese nicht mehr benötigt werden. Der Vorgabewert ist 1 (ON).

read_rnd_buffer_size

Beim Lesen von Datensätzen in sortierter Reihenfolge (auf einen Schlüsselsortiervorgang folgend) werden die Datensätze über diesen Puffer gelesen, um Festplattenzugriffe zu vermeiden. Das Setzen dieser Variable auf einen hohen Wert kann die Leistung von ORDER BY erheblich verbessern. Allerdings ist dies ein Puffer, der je Client zugewiesen wird. Deswegen sollten Sie die globale Variable nicht auf einen hohen Wert setzen. Ändern Sie stattdessen die Sitzungsvariablen nur bei den Clients, die große Abfragen ausführen müssen.

secure_auth

Wenn der MySQL-Server mit der Option --secure-auth gestartet wurde, sperrt er Verbindungen aller Konten, deren Passwörter im alten (d. h. vor Version 4.1 gültigen) Format gespeichert sind. In diesem Fall ist der Wert dieser Variable ON, andernfalls OFF.

Sie sollten diese Option aktivieren, wenn Sie die Verwendung von Passwörtern im alten Format (und damit eine unsichere Kommunikation über das Netzwerk) generell unterbinden wollen.

Der Serverstart schlägt mit einer Fehlermeldung fehl, wenn diese Option aktiviert ist, die Berechtigungstabellen jedoch das alte Format verwenden. Siehe auch Abschnitt A.2.3, „Client does not support authentication protocol“.

server_id

Die Serverkennung. Der Wert wird mit der Option --server-id eingestellt. Er erlaubt im Rahmen der Replikation die eindeutige Identifizierung von Master- und Slave-Servern.

shared_memory

(Nur für Windows.) Gibt an, ob der Server Verbindungen mit gemeinsamem Speicher gestattet.

shared_memory_base_name

(Nur für Windows.) Der Name des gemeinsamen Speichers, der für Verbindungen mit gemeinsamem Speicher verwendet werden soll. Dies ist praktisch, wenn Sie mehrere MySQL-Instanzen auf einem einzelnen physischen Computer ausführen. Der Standardname ist MYSQL. Beim Namen wird die Groß-/Kleinschreibung unterschieden.

skip_external_locking

Hat den Wert OFF, wenn mysqld die externe Sperrung verwendet, bzw. ON, wenn die externe Sperrung deaktiviert ist.

skip_networking

Diese Variable hat den Wert ON, wenn der Server nur lokale Verbindungen (Nicht-TCP/IP-Verbindungen) zulässt. Unter Unix verwenden lokale Verbindungen eine Unix-Socketdatei. Unter Windows nutzen lokale Verbindungen eine Named Pipe oder gemeinsamen Speicher. Unter NetWare werden nur TCP/IP-Verbindungen unterstützt; hier dürfen Sie diese Variable nicht auf ON setzen. Die Variable kann mit der Option --skip-networking auf ON gesetzt werden.

skip_show_database

Diese Variable verhindert, dass Benutzer die Anweisung SHOW DATABASES verwenden, wenn sie die Berechtigung SHOW DATABASES nicht haben. Dies kann die Sicherheit erhöhen, wenn Sie es für unerwünscht halten, dass Benutzer Datenbanken sehen können, die anderen Benutzern gehören. Die Wirkung der Variable hängt von der Berechtigung SHOW DATABASES ab: Wenn der Variablenwert ON ist, darf die SHOW DATABASES-Anweisung nur von Benutzern verwendet werden, die die Berechtigung SHOW DATABASES haben. Die Anweisung zeigt dann alle Datenbanknamen an. Ist der Wert hingegen OFF, dann dürfen alle Benutzer SHOW DATABASES absetzen; angezeigt werden in diesem Fall aber nur diejenigen Datenbanken, für die der jeweilige Benutzer die Berechtigung SHOW DATABASES oder eine ähnliche Berechtigung hat.

slave_compressed_protocol

Gibt an, ob eine Komprimierung des Slave/Master-Protokolls verwendet werden soll, wenn sowohl Slave als auch Master diese unterstützen.

slave_load_tmpdir

Der Name des Verzeichnisses, in dem der Slave Temporärdateien zur Replikation von LOAD DATA INFILE-Anweisungen erstellt.

slave_net_timeout

Gibt an (in Sekunden), wie lange auf weitere Daten über eine Master/Slave-Verbindung gewartet wird, bevor die Leseoperation abgebrochen wird. Dieser Grenzwert gilt nur für TCP/IP-Verbindungen, nicht jedoch für Verbindungen, die über Unix-Socketdateien, Named Pipes oder gemeinsamen Speicher erfolgen.

slave_skip_errors

Anzahl der Replikationsfehler, die der Slave übergehen (d. h. ignorieren) soll.

slave_transaction_retries

Wenn ein SQL-Thread auf einem Replikations-Slave eine Transaktion nicht ausführen kann, weil eine InnoDB-Blockade aufgetreten ist oder die Werte innodb_lock_wait_timeout von InnoDB bzw. TransactionDeadlockDetectionTimeout oder TransactionInactiveTimeout von NDBCluster überschritten wurden, erfolgt die durch slave_transaction_retries angegebene Anzahl von Neuversuchen, bevor der Vorgang mit einer Fehlermeldung beendet wird. Der Vorgabewert ist 10.

slow_launch_time

Wenn die Erstellung eines Threads länger dauert als durch diese Variable (in Sekunden) angegeben, dann erhöht der Server den Wert der Statusvariablen Slow_launch_threads entsprechend.

socket

Auf Unix-Plattformen bezeichnet diese Variable den Namen der Socketdatei, die für lokale Clientverbindungen verwendet wird. Der Vorgabewert ist /tmp/mysql.sock. (Bei einigen Distributionsformaten kann das Verzeichnis anders aussehen, z. B. /var/lib/mysql bei RPMs.)

Unter Windows bezeichnet diese Variable den Namen der Named Pipe, die für lokale Clientverbindungen verwendet wird. Der Vorgabewert ist MySQL (keine Unterscheidung der Groß-/Kleinschreibung).

sort_buffer_size

Jeder Thread, der eine Sortierung durchführen muss, reserviert einen Puffer dieser Größe. Erhöhen Sie den Wert, um ORDER BY- oder GROUP BY-Operationen zu beschleunigen. Siehe auch Abschnitt A.4.4, „Wohin MySQL temporäre Dateien speichert“.

sql_mode

Der aktuelle SQL-Modus des Servers. Dieser kann dynamisch eingestellt werden. Siehe auch Abschnitt 5.2.5, „Der SQL-Modus des Servers“.

sql_slave_skip_counter

Die Anzahl der vom Master kommenden Ereignisse, die ein Slave-Server übergehen soll. Siehe auch Abschnitt 13.6.2.6, „SET GLOBAL SQL_SLAVE_SKIP_COUNTER“.

storage_engine

Die vorgabeseitige Speicher-Engine (Tabellentyp). Um die Speicher-Engine beim Serverstart einzustellen, verwenden Sie die Option --default-storage-engine. Siehe auch Abschnitt 5.2.1, „Befehlsoptionen für mysqld“.

sync_binlog

Ist der Wert dieser Variable positiv, dann synchronisiert der MySQL-Server sein Binärlog jedes Mal auf die Festplatte (unter Verwendung von fdatasync()), wenn sync_binlog in das Binärlog geschrieben wird. Beachten Sie, dass, wenn der Autocommit-Modus aktiviert ist, eine Schreiboperation pro Anweisung im Binärlog gespeichert wird; andernfalls handelt es sich um eine Schreiboperation je Transaktion. Der Standardwert ist 0, d. h. es wird keine Synchronisierung auf Festplatte durchgeführt. Der Wert 1 ist die sicherste Variante, denn im Falle eines Absturzes verlieren Sie maximal eine Anweisung bzw. eine Transaktion aus dem Binärlog. Allerdings ist diese Methode auch die langsamste (sofern die Festplatte nicht über einen batteriegestützten Cache verfügt, der die Synchronisierung extrem beschleunigt).

Ist der Wert von sync_binlog 0 (Standardeinstellung), dann erfolgt kein zusätzliches Schreiben auf die Festplatte. Der Server ist wie bei jeder anderen Datei auch auf das Betriebssystem angewiesen, um den Dateiinhalt regelmäßig auf die Festplatte schreiben zu können.

sync_frm

Wenn diese Variable auf 1 gesetzt ist, wird, wenn eine nichttemporäre Tabelle erstellt wird, deren .frm-Datei auf Festplatte synchronisiert (dies geschieht mithilfe von fdatasync()). Dies ist zwar langsamer, im Falle eines Absturzes aber sicherer. Der Standardwert ist 1.

system_time_zone

Die Systemzeitzone des Servers. Wenn die Serverausführung startet, erbt sie eine Zeitzoneneinstellung von den Standardwerten des Computers, welche unter Umständen von der Umgebung des Kontos modifiziert wird, welches zur Ausführung des Servers oder Startskripts verwendet wird. Der Wert wird verwendet, um system_time_zone einzustellen. Normalerweise wird die Zeitzone durch die Umgebungsvariable TZ festgelegt. Eine Definition kann aber auch mithilfe der Option --timezone des Skripts mysqld_safe erfolgen.

Die Variable system_time_zone unterscheidet sich von time_zone. Zwar können diese beiden Variablen denselben Wert haben, letztere wird aber zur Initialisierung der Zeitzone für die Clients verwendet, die eine Verbindung herstellen. Siehe auch Abschnitt 5.11.8, „Zeitzonen-Unterstützung des MySQL-Servers“.

table_cache

Dies ist der alte Name von table_open_cache, der vor MySQL 5.1.3 verwendet wurde. Verwenden Sie ab MySQL 5.1.3 stattdessen table_open_cache.

table_definition_cache

Die Anzahl der Tabellendefinitionen, die im Definitions-Cache gespeichert werden können. Wenn Sie eine hohe Anzahl von Tabellen verwenden, können Sie einen großen Tabellendefinitions-Cache erstellen, um das Öffnen von Tabellen zu beschleunigen. Der Tabellendefinitions-Cache benötigt weniger Platz als der normale Tabellen-Cache und verwendet anders als jener keine Dateideskriptoren. Diese Variable wurde in MySQL 5.1.3 hinzugefügt.

table_open_cache

Die Anzahl offener Tabellen für alle Threads. Wenn Sie diesen Wert erhöhen, erhöht sich auch die Anzahl der Dateideskriptoren, die mysqld benötigt. Wenn Sie überprüfen wollen, ob Sie den Tabellen-Cache vergrößern müssen, kontrollieren Sie die Statusvariable Opened_tables. Siehe auch Abschnitt 5.2.4, „Server-Statusvariablen“. Wenn der Wert von Opened_tables sehr groß ist und Sie FLUSH TABLES nicht sehr häufig verwenden (was nichts anderes tut, als alle Tabellen zu schließen und neu zu öffnen), dann sollten Sie den Wert von table_open_cache erhöhen. Weitere Informationen zum Tabellen-Cache finden Sie unter Abschnitt 7.4.8, „Nachteile der Erzeugung großer Mengen von Tabellen in derselben Datenbank“. Vor MySQL 5.1.3 hieß diese Variable table_cache.

table_type

Diese Variable ist synonym zu storage_engine. Bei MySQL 5.1 ist storage_engine der bevorzugte Name.

thread_cache_size

Gibt an, wie viele Threads der Server zur Neuverwendung zwischenspeichern soll. Wenn ein Client seine Verbindung trennt, dann werden die Threads dieses Clients im Cache abgelegt, sofern die Anzahl der dort vorhandenen Threads geringer als thread_cache_size ist. Thread-Anforderungen werden erfüllt, indem, sofern möglich, Threads aus dem Cache neu verwendet werden; neue Threads werden nur erstellt, wenn der Cache leer ist. Der Wert dieser Variablen kann erhöht werden, um die Leistung zu optimieren, wenn viele neue Verbindungen auftreten. (Bei einer guten Thread-Implementierung werden Sie normalerweise jedoch keine spürbare Leistungsverbesserung bemerken.) Durch Überprüfung der Differenz zwischen den Statusvariablen Connections und Threads_created können Sie die Wirksamkeit des Thread-Caches kontrollieren. Detaillierte Informationen finden Sie in Abschnitt 5.2.4, „Server-Statusvariablen“.

thread_concurrency

Unter Solaris ruft mysqld thr_setconcurrency() mit diesem Wert auf. Diese Funktionen erlaubt es Anwendungen, dem Thread-System Hinweise zur gewünschten Anzahl der gleichzeitig ausgeführten Threads zukommen zu lassen.

thread_stack

Die Stapelgröße für jeden Thread. Viele der vom crash-me-Test erkannten Einschränkungen hängen von diesem Wert ab. Der Standardwert ist für den normalen Betrieb ausreichend groß. Siehe auch Abschnitt 7.1.4, „Die MySQL-Benchmark-Reihe“. Standardwert ist 192 Kbyte.

time_format

Diese Variable ist nicht implementiert.

time_zone

Die aktuelle Zeitzone. Diese Variable wird zur Initialisierung der Zeitzone für die Clients verwendet, die eine Verbindung herstellen. Standardmäßig ist der Ausgangswert 'SYSTEM' (mit der Bedeutung „Den Wert von system_time_zone verwenden“). Der Wert kann beim Serverstart mit der Option --default-time-zone explizit angegeben werden. Siehe auch Abschnitt 5.11.8, „Zeitzonen-Unterstützung des MySQL-Servers“.

tmp_table_size

Wenn eine temporäre Tabelle im Arbeitsspeicher diese Größe überschreitet, wandelt MySQL sie automatisch in eine MyISAM-Tabelle auf der Festplatte um. Erhöhen Sie den Wert von tmp_table_size, wenn Sie viele erweiterte GROUP BY-Abfragen ausführen und viel Speicher haben.

tmpdir

Das für Temporärdateien und Temporärtabellen verwendete Verzeichnis. Dieser Variable kann eine Liste mit mehreren verschiedenen Pfaden zugewiesen werden, die zyklisch abwechselnd verwendet werden. Die Pfade sollten unter Unix mit Doppelpunkten (‘:’) und unter Windows, NetWare und OS/2 mit Semikola (‘;’) voneinander getrennt werden.

Diese Multiverzeichnisfunktion kann verwendet werden, um die Last auf mehrere physische Festplatten zu verteilen. Wenn der MySQL-Server als Replikations-Slave agiert, sollten Sie tmpdir nicht auf ein Verzeichnis auf einem speicherbasierten Dateisystem oder ein Verzeichnis verweisen lassen, das gelöscht wird, wenn der Server neu startet. Ein Replikations-Slave benötigt einen Teil seiner Temporärdateien, um einen Systemneustart so zu überstehen, dass er Temporärtabellen oder LOAD DATA INFILE-Operationen replizieren kann. Wenn Dateien im Verzeichnis für Temporärdateien beim Serverneustart verloren gehen, schlägt die Replikation fehl. Wenn Sie allerdings MySQL 4.0.0 oder höher verwenden, können Sie das Temporärverzeichnis des Slaves mithilfe der Variable slave_load_tmpdir einstellen. In diesem Fall wird der Slave den globalen Wert von tmpdir nicht verwenden, und Sie können tmpdir auch auf eine nichtpermanente Position verweisen lassen.

transaction_alloc_block_size

Die Menge an Bytes, um die ein Speicherpool für eine Transaktion erhöht wird, für die Speicher benötigt wird. Siehe auch die Beschreibung zu transaction_prealloc_size.

transaction_prealloc_size

Es gibt für jede Transaktion einen Speicherpool, aus dem verschiedene transaktionsbezogene Reservierungen Speicher entnehmen. Die Ausgangsgröße dieses Pools entspricht der Anzahl von Bytes, die durch transaction_prealloc_size angegeben ist. Für jede Reservierung, die aus dem Pool nicht erfüllt werden kann, da zu wenig Speicher verfügbar ist, wird der Pool um die Anzahl von Bytes erhöht, die durch transaction_alloc_block_size angegeben ist. Sobald die Transaktion endet, wird der Pool wieder um die durch transaction_prealloc_size angegebene Anzahl von Bytes verringert.

Wenn Sie dafür Sorge tragen, dass transaction_prealloc_size groß genug ist, um alle Anweisungen einer einzelnen Transaktion aufzunehmen, können Sie viele malloc()-Aufrufe vermeiden.

tx_isolation

Die Standardstufe für die Transaktionsisolierung. Der Vorgabewert ist REPEATABLE-READ.

Diese Variable wird durch die SET TRANSACTION ISOLATION LEVEL-Anweisung eingestellt. Siehe auch Abschnitt 13.4.6, „SET TRANSACTION“. Wenn Sie tx_isolation direkt auf einen Isolierungsstufennamen setzen, der ein Leerzeichen enthält, dann sollte der Name in Anführungszeichen gesetzt und das Leerzeichen durch einen Bindestrich ersetzt werden. Zum Beispiel:

SET tx_isolation = 'READ-COMMITTED';

updatable_views_with_limit

Diese Variable steuert, ob Updates unter Verwendung einer View vorgenommen werden können, die keinen Primärschlüssel in der zugrundeliegenden Tabelle enthält, wenn das Update eine LIMIT-Klausel enthält. (Derartige Updates werden häufig von GUI-Tools erzeugt.) Ein Update ist eine UPDATE- oder DELETE-Anweisung. Unter dem Primärschlüssel versteht man hier einen PRIMARY KEY- oder einen UNIQUE-Index, bei dem keine Spalte NULL enthalten kann.

Die Variable kann zwei Werte haben:

version

Die Versionsnummer des Servers.

version_bdb

Die Version der BDB-Speicher-Engine.

version_comment

Das Skript configure umfasst eine Option --with-comment, die die Angabe eines Kommentars bei der Erstellung von MySQL erlaubt. Diese Variable enthält den Wert dieses Kommentars.

version_compile_machine

Der Typ des Computers oder der Architektur, auf der MySQL erstellt wurde.

version_compile_os

Der Typ des Betriebssystem, auf der MySQL erstellt wurde.

wait_timeout

Zeit (in Sekunden), während der der Server bei einer nichtinteraktiven Verbindung auf Aktivitäten wartet, bevor er sie schließt. Dieser Grenzwert gilt nur für TCP/IP-Verbindungen, nicht jedoch für Verbindungen, die über Unix-Socketdateien, Named Pipes oder gemeinsamen Speicher erfolgen.

Beim Thread-Start wird der Sitzungswert wait_timeout auf der Basis des globalen Wertes wait_timeout oder des globalen Wertes interactive_timeout initialisiert. Welcher Wert verwendet wird, hängt vom Clienttyp (entsprechend der Definition durch die Verbindungsoption CLIENT_INTERACTIVE von mysql_real_connect()) ab. Siehe auch interactive_timeout.

Aborted_clients

Anzahl der Verbindungen, die abgebrochen wurden, weil der Client beendet wurde, ohne die Verbindung ordnungsgemäß zu schließen. Siehe auch Abschnitt A.2.10, „Kommunikationsfehler/abgebrochene Verbindung“.

Aborted_connects

Anzahl der fehlgeschlagenen Versuche, eine Verbindung mit dem MySQL-Server herzustellen. Siehe auch Abschnitt A.2.10, „Kommunikationsfehler/abgebrochene Verbindung“.

Binlog_cache_disk_use

Anzahl der Transaktionen, die den temporären Binärlog-Cache verwendeten, aber den Wert von binlog_cache_size überstiegen, weswegen eine Temporärdatei zur Speicherung von Anweisungen aus der Transaktion benutzt wurde.

Binlog_cache_use

Anzahl der Transaktionen, die den Binärlog-Cache verwendet haben.

Bytes_received

Anzahl der Bytes, die von allen Clients empfangen wurden.

Bytes_sent

Anzahl der Bytes, die an alle Clients gesendet wurden.

Com_xxx

Die Com_xxx-Variablen zum Zählen von Anweisungen geben die Häufigkeit an, mit der die Anweisung xxx ausgeführt wurde. Für jeden Anweisungstyp gibt es eine Statusvariable. So zählen etwa Com_delete und Com_insert die DELETE- bzw. INSERT-Anweisungen.

Die folgenden Com_stmt_xxx-Statusvariablen sind vorhanden:

Diese Variablen stehen für vorbereitete Anweisungsbefehle. Ihre Namen beziehen sich auf den COM_xxx-Befehlssatz, der in der Vermittlungsschicht zum Einsatz kommt. Mit anderen Worten erhöhen sich ihre Werte immer dann, wenn vorbereitete Anweisungs-API-Aufrufe wie mysql_stmt_prepare(), mysql_stmt_execute() usw. ausgeführt werden. Allerdings erhöhen sich Com_stmt_prepare, Com_stmt_execute und Com_stmt_close auch bei PREPARE, EXECUTE bzw. DEALLOCATE PREPARE. Ferner erhöhen sich die Werte der älteren (d. h. seit MySQL 4.1.3 vorhandenen) Anweisungszählvariablen Com_prepare_sql, Com_execute_sql und Com_dealloc_sql bei den Anweisungen PREPARE, EXECUTE und DEALLOCATE PREPARE. Com_stmt_fetch steht für die Gesamtanzahl der beim Holen von Cursorn abgesetzten Netzwerkrundreisen.

Alle Com_stmt_xxx-Variablen werden auch dann erhöht, wenn ein Argument einer vorbereiteten Anweisung unbekannt ist oder während der Ausführung ein Fehler aufgetreten ist. Mit anderen Worten entsprechen ihre Werte der Anzahl der abgesetzten (und nicht der erfolgreich verarbeiteten) Anfragen.

Compression

Gibt an, ob die Clientverbindung eine Komprimierung im Client/Server-Protokoll verwendet. Wurde in MySQL 5.1.2 hinzugefügt.

Connections

Anzahl der Versuche, eine Verbindung mit dem MySQL-Server herzustellen (unabhängig davon, ob diese erfolgreich waren oder nicht).

Created_tmp_disk_tables

Anzahl der vom Server bei der Ausführung von Anweisungen automatisch auf der Festplatte erstellten Temporärtabellen.

Created_tmp_files

Gibt an, wie viele Temporärdateien mysqld erstellt hat.

Created_tmp_tables

Anzahl der vom Server bei der Ausführung von Anweisungen automatisch im Speicher erstellten Temporärtabellen. Wenn Created_tmp_disk_tables einen hohen Wert hat, sollten Sie den Wert von tmp_table_size erhöhen, damit Temporärtabellen im Speicher statt auf Festplatte erstellt werden.

Delayed_errors

Anzahl der mit INSERT DELAYED geschriebenen Datensätze, bei denen ein Fehler aufgetreten ist (wahrscheinlich duplicate key).

Delayed_insert_threads

Anzahl der verzögerten INSERT DELAYED-Threads, die in Verwendung sind.

Delayed_writes

Anzahl der geschriebenen INSERT DELAYED-Datensätze.

Flush_commands

Anzahl der ausgeführten FLUSH-Anweisungen.

Handler_commit

Anzahl der internen COMMIT-Anweisungen.

Handler_discover

Der MySQL-Server kann bei der NDB Cluster-Speicher-Engine fragen, ob sie eine Tabelle mit einem gegebenen Namen kennt. Dies bezeichnet man als Entdeckung. Handler_discover gibt die Häufigkeit ein, mit der Tabellen mithilfe dieser Methode entdeckt wurden.

Handler_delete

Häufigkeit, mit der Datensätze aus Tabellen gelöscht wurden.

Handler_read_first

Häufigkeit, mit der der erste Eintrag aus einem Index gelesen wurde. Wenn dieser Wert hoch ist, kann man davon ausgehen, dass der Server eine große Zahl vollständiger Indexscans ausführt (z. B. für die Spalte SELECT col1 FROM foo, vorausgesetzt, col1 ist indiziert).

Handler_read_key

Anzahl der Anforderungen zum Auslesen eines Datensatzes basierend auf einem Schlüssel. Wenn der Wert hoch ist, können Sie davon ausgehen, dass Ihre Tabellen passend für Ihre Abfragen indiziert sind.

Handler_read_next

Anzahl der Anforderungen zum Auslesen des nächsten Datensatzes in der Schlüsselreihenfolge. Dieser Wert wird hochgezählt, wenn Sie eine Indexspalte mit einer Bereichsbeschränkung abfragen oder einen Indexscan ausführen.

Handler_read_prev

Anzahl der Anforderungen zum Auslesen des vorherigen Datensatzes in der Schlüsselreihenfolge. Diese Lesemethode wird in erster Linie zur Optimierung von ORDER BY ... DESC verwendet.

Handler_read_rnd

Anzahl der Anforderungen zum Auslesen eines Datensatzes basierend auf einer festen Position. Dieser Wert ist hoch, wenn Sie viele Abfragen ausführen, die eine Sortierung des Ergebnisses erfordern. Sie setzen dann wahrscheinlich viele Abfragen ab, die für MySQL das Scannen ganzer Tabellen erforderlich machen, oder verwenden Joins, die die Schlüssel nicht optimal nutzen.

Handler_read_rnd_next

Anzahl der Anforderungen zum Auslesen des nächsten Datensatzes in der Datendatei. Dieser Wert ist hoch, wenn Sie viele Tabellenscans ausführen. Im Allgemeinen lässt dies darauf schließen, dass Ihre Tabellen nicht korrekt indiziert sind oder Ihre Abfragen nicht so geschrieben sind, dass sie die vorhandenen Indizes nutzen können.

Handler_rollback

Anzahl der internen ROLLBACK-Anweisungen.

Handler_update

Anzahl der Anforderungen zur Aktualisierung eines Datensatzes in einer Tabelle.

Handler_write

Anzahl der Anforderungen zum Einfügen eines Datensatzes in eine Tabelle.

Innodb_buffer_pool_pages_data

Anzahl der Seiten, die (schmutzige wie auch saubere) Daten enthalten.

Innodb_buffer_pool_pages_dirty

Anzahl der derzeit schmutzigen Seiten.

Innodb_buffer_pool_pages_flushed

Anzahl der Anforderungen nach einem Neuladen der Pufferpoolseiten.

Innodb_buffer_pool_pages_free

Anzahl der freien Seiten.

Innodb_buffer_pool_pages_latched

Anzahl der verriegelten Seiten im InnoDB-Pufferpool. Dies sind die Seiten, die derzeit gelesen oder geschrieben oder aus einem anderen Grund nicht auf Festplatte synchronisiert werden können.

Innodb_buffer_pool_pages_misc

Anzahl der Seiten, die in Verwendung sind, weil sie aufgrund administrativer Mehrbelastung (z. B. Datensatzsperren oder eines adaptiven Hash-Index) zugewiesen wurden. Dieser Wert kann auch als Innodb_buffer_pool_pages_total – Innodb_buffer_pool_pages_free – Innodb_buffer_pool_pages_data berechnet werden.

Innodb_buffer_pool_pages_total

Gesamtgröße des Pufferpools in Seiten.

Innodb_buffer_pool_read_ahead_rnd

Anzahl der vorab durchgeführten „zufälligen“ Leseoperationen, die durch InnoDB eingeleitet wurden. Dies geschieht, wenn eine Abfrage einen Großteil einer Tabelle in zufälliger Reihenfolge scannt.

Innodb_buffer_pool_read_ahead_seq

Anzahl der vorab durchgeführten sequenziellen Leseoperationen, die durch InnoDB eingeleitet wurden. Dies geschieht, wenn InnoDB einen vollständigen sequenziellen Tabellenscan durchführt.

Innodb_buffer_pool_read_requests

Anzahl der Anforderungen logischer Leseoperationen durch InnoDB.

Innodb_buffer_pool_reads

Anzahl der Anforderungen logischer Leseoperationen, die InnoDB nicht aus dem Pufferpool erfüllen konnte, weswegen eine Leseoperationen für eine einzelne Seite ausgeführt werden musste.

Innodb_buffer_pool_wait_free

Normalerweise erfolgen Schreiboperationen in den InnoDB-Pufferpool im Hintergrund. Wenn es allerdings notwendig ist, eine Seite zu lesen oder zu erstellen, und keine sauberen Seiten verfügbar sind, ist es auch erforderlich zu warten, bis die Seiten neu geschrieben wurden. Dieser Zähler enthält die Anzahl der Instanzen dieser Wartevorgänge. Wenn die Größe des Pufferpools korrekt eingestellt wurde, sollte dieser Wert niedrig sein.

Innodb_buffer_pool_write_requests

Anzahl der Schreiboperationen in den InnoDB-Pufferpool.

Innodb_data_fsyncs

Anzahl der bislang aufgetretenen fsync()-Operationen.

Innodb_data_pending_fsyncs

Aktuelle Anzahl anhängiger fsync()-Operationen.

Innodb_data_pending_reads

Aktuelle Anzahl anhängiger Leseoperationen.

Innodb_data_pending_writes

Aktuelle Anzahl anhängiger Schreiboperationen.

Innodb_data_read

Menge der bislang gelesenen Daten (in Byte).

Innodb_data_reads

Gesamtanzahl der Datenleseoperationen.

Innodb_data_writes

Gesamtanzahl der Datenschreiboperationen.

Innodb_data_written

Menge der bislang geschriebenen Daten (in Byte).

Innodb_dblwr_writes, Innodb_dblwr_pages_written

Anzahl der durchgeführten doppelten Schreiboperationen und Anzahl der Seiten, die zu diesem Zweck geschrieben wurden. Siehe auch Abschnitt 14.2.14.1, „Festplattenein- und -ausgaben“.

Innodb_log_waits

Häufigkeit, mit der der Logpuffer zu klein und ein Wartevorgang erforderlich war, bis der Vorgang nach dem Neuschreiben fortgesetzt werden konnte.

Innodb_log_write_requests

Anzahl der Logschreibeanforderungen.

Innodb_log_writes

Anzahl der physischen Schreiboperationen in die Logdatei.

Innodb_os_log_fsyncs

Anzahl der abgeschlossenen fsync()-Schreiboperationen in die Logdatei.

Innodb_os_log_pending_fsyncs

Anzahl der anhängigen fsync()-Operationen für die Logdatei.

Innodb_os_log_pending_writes

Anzahl der anhängigen Schreiboperationen für die Logdatei.

Innodb_os_log_written

Anzahl der in die Logdatei geschriebenen Bytes.

Innodb_page_size

Die einkompilierte InnoDB-Seitengröße (standardmäßig 16 Kbyte). Viele Werte werden in Seiten gezählt. Die Angabe der Seitengröße erlaubt eine einfache Konvertierung in Bytes.

Innodb_pages_created

Anzahl der erstellten Seiten.

Innodb_pages_read

Anzahl der gelesenen Seiten.

Innodb_pages_written

Anzahl der geschriebenen Seiten.

Innodb_row_lock_current_waits

Anzahl der Datensatzsperren, auf die derzeit gewartet wird.

Innodb_row_lock_time

Die mit dem Erwirken von Datensatzsperren verbrachte Zeit (in Millisekunden).

Innodb_row_lock_time_avg

Die durchschnittliche Zeit zum Erwirken einer Datensatzsperre (in Millisekunden).

Innodb_row_lock_time_max

Die maximale Zeit zum Erwirken einer Datensatzsperre (in Millisekunden).

Innodb_row_lock_waits

Häufigkeit, mit der auf eine Datensatzsperre gewartet werden musste.

Innodb_rows_deleted

Anzahl der Datensätze, die aus InnoDB-Tabellen gelöscht wurden.

Innodb_rows_inserted

Anzahl der Datensätze, die in InnoDB-Tabellen eingefügt wurden.

Innodb_rows_read

Anzahl der Datensätze, die aus InnoDB-Tabellen gelesen wurden.

Innodb_rows_updated

Anzahl der Datensätze, die in InnoDB-Tabellen aktualisiert wurden.

Key_blocks_not_flushed

Anzahl der Schlüsselblöcke im Schlüssel-Cache, die geändert, aber noch nicht neu auf Festplatte geschrieben wurden.

Key_blocks_unused

Anzahl der unbenutzten Blöcke im Schlüssel-Cache. Sie können anhand dieses Wertes bestimmen, wie groß der verwendete Anteil des Schlüssel-Caches ist. Lesen Sie auch die Beschreibung zu key_buffer_size in Abschnitt 5.2.2, „Server-Systemvariablen“.

Key_blocks_used

Anzahl der benutzten Blöcke im Schlüssel-Cache. Dieser Wert ist eine Art Hochwassermarke, die die maximale Anzahl von Blöcken angibt, die jemals gleichzeitig verwendet wurden.

Key_read_requests

Anzahl der Anforderungen zum Auslesen eines Schlüsselblocks aus dem Cache.

Key_reads

Die Anzahl physischer Lesezugriffe eines Schlüsselblocks von der Festplatte. Wenn der Wert von Key_reads hoch ist, dann ist Ihr Wert für key_buffer_size wahrscheinlich zu niedrig. Die Cache-Fehlrate kann berechnet werden als Key_reads ÷ Key_read_requests.

Key_write_requests

Die Anzahl der Anforderungen zum Schreiben eines Schlüsselblocks in den Cache.

Key_writes

Anzahl physischer Schreibvorgänge eines Schlüsselblocks auf die Festplatte.

Last_query_cost

Gesamtkosten der letzten kompilierten Abfrage nach Berechnung durch den Abfrageoptimierer. Dieser Wert ist praktisch, um die Kosten verschiedener Abfragepläne für dieselbe Abfrage zu vergleichen. Der Vorgabewert 0 bedeutet, dass noch keine Abfrage kompiliert wurde. Last_query_cost hat sitzungsbezogen Geltung.

Max_used_connections

Maximale Anzahl von Verbindungen, die seit dem Start des Servers gleichzeitig in Verwendung waren.

Not_flushed_delayed_rows

Anzahl der Datensätze, die darauf warten, in INSERT DELAY-Warteschlangen geschrieben zu werden.

Open_files

Anzahl der offenen Dateien.

Open_streams

Anzahl der offenen Streams (hauptsächlich zum Loggen verwendet).

Open_tables

Anzahl der offenen Tabellen.

Opened_tables

Anzahl der Tabellen, die geöffnet wurden. Wenn der Wert von Opened_tables hoch ist, dann ist Ihr Wert für table_open_cache wahrscheinlich zu niedrig.

Qcache_free_blocks

Anzahl freier Speicherblöcke im Abfrage-Cache.

Qcache_free_memory

Menge des freien Speichers für den Abfrage-Cache.

Qcache_hits

Anzahl der Treffer im Abfrage-Cache.

Qcache_inserts

Anzahl der Abfragen, die zum Abfrage-Cache hinzugefügt wurden.

Qcache_lowmem_prunes

Anzahl der Abfragen, die wegen Speichermangels aus dem Abfrage-Cache gelöscht wurden.

Qcache_not_cached

Anzahl der nicht im Cache abgelegten Abfragen (weil diese entweder nicht speicherbar waren oder aufgrund der query_cache_type-Einstellung nicht abgelegt wurden).

Qcache_queries_in_cache

Anzahl der im Abfrage-Cache registrierten Abfragen.

Qcache_total_blocks

Gesamtzahl von Blöcken im Abfrage-Cache.

Questions

Anzahl der Anweisungen, die Clients an den Server gesendet haben.

Rpl_status

Status der ausfallsicheren Replikation (noch nicht implementiert).

Select_full_join

Anzahl der Joins, die Tabellenscans durchführen, weil sie keine Indizes verwenden. Wenn der Wert nicht 0 ist, sollten Sie die Indizes Ihrer Tabellen sorgfältig prüfen.

Select_full_range_join

Anzahl der Joins, die eine Bereichssuche in einer Referenztabelle verwendet haben.

Select_range

Anzahl der Joins, die Bereiche in der ersten Tabelle verwendet haben. Dies ist normalerweise auch dann kein kritisches Problem, wenn der Wert zu groß ist.

Select_range_check

Anzahl der Joins ohne Schlüssel, die nach jedem Datensatz auf Schlüsselverwendung prüfen. Wenn der Wert nicht 0 ist, sollten Sie die Indizes Ihrer Tabellen sorgfältig prüfen.

Select_scan

Anzahl der Joins, die einen vollständigen Scan der ersten Tabelle durchgeführt haben.

Slave_open_temp_tables

Anzahl der Temporärtabellen, die der Slave-SQL-Thread derzeit geöffnet hält.

Slave_running

Ist ON, wenn dieser Server ein Slave ist, der mit einem Master verbunden ist.

Slave_retried_transactions

Gesamthäufigkeit seit dem Serverstart, mit der der Replikations-Slave-SQL-Thread Transaktionen erneut versucht hat.

Slow_launch_threads

Anzahl der Threads, deren Erzeugung länger als die durch slow_launch_time angegebene Anzahl von Sekunden dauerte.

Slow_queries

Anzahl der Abfragen, die länger als die durch long_query_time angegebene Anzahl von Sekunden dauerten. Siehe auch Abschnitt 5.12.4, „Die Logdatei für langsame Anfragen“.

Sort_merge_passes

Anzahl der Merge-Durchgänge, die der Sortieralgorithmus durchführen musste. Wenn dieser Wert hoch ist, sollten Sie unter Umständen den Wert der Systemvariable sort_buffer_size erhöhen.

Sort_range

Anzahl der Sortiervorgänge, die mit Bereichen durchgeführt wurden.

Sort_rows

Anzahl der sortierten Datensätze.

Sort_scan

Anzahl der Sortiervorgänge, die durchgeführt wurden, indem die Tabelle gescannt wurde.

Ssl_xxx

Für SSL-Verbindungen verwendete Variablen.

Table_locks_immediate

Häufigkeit, mit der eine Tabellensperre sofort erwirkt werden konnte.

Table_locks_waited

Häufigkeit, mit der eine Tabellensperre nicht sofort erwirkt werden konnte und ein Wartevorgang erforderlich wurde. Wenn dieser Wert hoch und die Leistung problematisch niedrig ist, sollten Sie zunächst Ihre Abfragen optimieren und dann Ihre Tabelle(n) entweder unterteilen oder die Replikation verwenden.

Threads_cached

Anzahl der Threads im Thread-Cache.

Threads_connected

Anzahl der momentan offenen Verbindungen.

Threads_created

Anzahl der Threads, die zur Verwaltung von Verbindungen erstellt wurden. Wenn der Wert von Threads_created hoch ist, sollten Sie den Wert von thread_cache_size erhöhen. Die Cache-Trefferrate kann berechnet werden als Threads_created ÷ Connections.

Threads_running

Anzahl nicht schlafender Threads.

Uptime

Dauer seit dem Serverstart (in Sekunden).

ANSI

Ändert Syntax und Verhalten so, dass eine höhere Kompatibilität mit Standard-SQL erzielt wird.

STRICT_TRANS_TABLES

Wenn ein Wert nicht wie eingegeben in eine transaktionssichere Tabelle eingefügt werden konnte, wird die Anweisung abgebrochen. Bei nicht transaktionssicheren Tabellen wird die Anweisung abgebrochen, wenn der Wert in einer Anweisung für genau einen Datensatz oder im ersten Datensatz einer Anweisung für mehrere Datensätze erscheint. Weitere Informationen erhalten Sie im Verlauf dieses Abschnitts.

TRADITIONAL

Hierbei verhält sich MySQL wie ein „traditionelles“ SQL-Datenbanksystem. Eine einfache Beschreibung dieses Modus wäre: „Gib eine Fehlermeldung anstelle einer Warnung aus, wenn ein falscher Wert in eine Spalte eingefügt wird“. Hinweis: Die Anweisung INSERT/UPDATE wird abgebrochen, sobald der Fehler bemerkt wird. Wenn Sie eine nicht transaktionssichere Speicher-Engine verwenden, ist dies ein unter Umständen unerwünschtes Verhalten, weil Datenänderungen, die vor dem Fehler ausgeführt wurden, nicht rückgängig gemacht werden, was zu einer „unvollständigen“ Aktualisierung führt.

ALLOW_INVALID_DATES

Führt keine vollständige Datumsüberprüfung durch. Geprüft wird nur, ob die Monatsangabe zwischen 1 und 12 und die Tagesangabe zwischen 1 und 31 liegt. Dies ist sehr praktisch für Webanwendungen, bei denen man die Jahres-, Monats- und Tagesangabe drei verschiedenen Feldern entnimmt und diese Angaben dann genau so gespeichert werden sollen, wie der Benutzer sie eingegeben hat (d. h. ohne Plausibilitätsprüfung). Dieser Modus betrifft DATE- und DATETIME-Spalten. Für TIMESTAMP-Spalten gilt er hingegen nicht, da diese immer ein gültiges Datum erfordern.

Für den Server ist es erforderlich, dass Monats- und Tagesangaben gültig sind und sich nicht einfach nur in den Bereichen 1 bis 12 bzw. 1 bis 31 bewegen. Wenn der strikte Modus deaktiviert ist, werden ungültige Daten wie '2004-04-31' in '0000-00-00' umgewandelt, und es wird eine Warnung erzeugt. Ist der strikte Modus hingegen aktiviert, dann erzeugen ungültige Datumsangaben einen Fehler. Um derartige Daten zuzulassen, aktivieren Sie ALLOW_INVALID_DATES.

ANSI_QUOTES

Hierbei wird ‘"’ als Anführungszeichen für Bezeichner (wie ‘`’) und nicht als String-Anführungszeichen behandelt. Auch wenn dieser Modus aktiviert ist, können Sie ‘`’ als Anführungszeichen für Bezeichner verwenden. Ist ANSI_QUOTES aktiviert, dann dürfen Sie doppelte Anführungszeichen für einen literalen String verwenden, da dieser andernfalls als Bezeichner erkannt würde.

ERROR_FOR_DIVISION_BY_ZERO

Erzeugt im strikten Modus einen Fehler (sonst eine Warnung), wenn bei INSERT- oder UPDATE-Anweisungen eine Division durch Null (oder MOD(X,0)) auftritt. Wenn dieser Modus nicht aktiviert ist, gibt MySQL stattdessen NULL als Ergebnis einer Division durch Null zurück. Bei INSERT IGNORE oder UPDATE IGNORE erzeugt MySQL eine Warnung bezüglich einer Division durch Null, das Ergebnis des Vorgangs ist aber NULL.

HIGH_NOT_PRECEDENCE

Die Vorrangstellung des Operators NOT besteht darin, dass Ausdrücke wie NOT a BETWEEN b AND c als NOT (a BETWEEN b AND c) verarbeitet werden. Bei einigen älteren Versionen von MySQL wurde der Ausdruck hingegen als (NOT a) BETWEEN b AND c aufgefasst. Dieses ältere Vorrangsverhalten kann verwendet werden, indem man den SQL-Modus HIGH_NOT_PRECEDENCE aktiviert.

mysql> SET sql_mode = '';
mysql> SELECT NOT 1 BETWEEN -5 AND 5;
        -> 0
mysql> SET sql_mode = 'broken_not';
mysql> SELECT NOT 1 BETWEEN -5 AND 5;
        -> 1

IGNORE_SPACE

Gestattet Leerzeichen zwischen einem Funktionsnamen und dem Zeichen ‘(’. Hierdurch wird die Behandlung aller Funktionsnamen als reservierte Wörter erzwungen. Dies wiederum bedingt, dass Sie Datenbank-, Tabellen- oder Spaltennamen, die Sie verwenden wollen, als referenzierte Wörter in Anführungszeichen setzen müssen. Weil es beispielsweise eine Funktion USER() gibt, sind die Namen der Tabelle user in der mysql-Datenbank und der Spalte User in dieser Tabelle reservierte Wörter, müssen also in Anführungszeichen gesetzt werden:

SELECT "User" FROM mysql."user";

Der SQL-Modus IGNORE_SPACE gilt für integrierte Funktionen, nicht aber für gespeicherte Routinen. Nach einem Routinennamen müssen unabhängig davon, ob IGNORE_SPACE aktiviert ist oder nicht, immer Leerzeichen stehen dürfen.

NO_AUTO_CREATE_USER

Verhindert, dass GRANT automatisch neue Benutzer erstellt, sofern es dies tun würde (es sei denn, es wird ein nicht leeres Passwort angegeben).

NO_AUTO_VALUE_ON_ZERO

NO_AUTO_VALUE_ON_ZERO wirkt sich auf die Verarbeitung von AUTO_INCREMENT-Spalten aus. Normalerweise erzeugen Sie die nächste Sequenznummer für die Spalte, indem Sie entweder NULL oder 0 einfügen. NO_AUTO_VALUE_ON_ZERO unterdrückt dieses Verhalten für 0, sodass nur NULL die nächste Sequenznummer erzeugt.

Dieser Modus kann nützlich sein, wenn 0 in einer AUTO_INCREMENT-Spalte einer Tabelle gespeichert wurde. (Nebenbei gesagt: Das Speichern von 0 ist keine empfehlenswerte Vorgehensweise.) Wenn Sie beispielsweise die Tabelle mit mysqldump speichern und sie dann neu laden, erzeugt MySQL normalerweise neue Sequenznummern, sobald die 0-Werte gefunden werden; das Ergebnis ist also eine Tabelle, deren Inhalt sich von dem ursprünglich gespeicherten unterscheidet. Die Aktivierung von NO_AUTO_VALUE_ON_ZERO vor dem Neuladen der Speicherauszugsdatei löst dieses Problem. mysqldump schließt nun automatisch eine Anweisung in seine Ausgabe mit ein, die NO_AUTO_VALUE_ON_ZERO aktiviert, um das Problem zu vermeiden.

NO_BACKSLASH_ESCAPES

Deaktiviert die Verwendung des Backslashs (‘\’) als Escape-Zeichen innerhalb von Strings. Wenn dieser Modus aktiviert ist, wird der Backslash zu einem ganz gewöhnlichen Zeichen.

NO_DIR_IN_CREATE

Wenn Sie eine Tabelle erstellen, werden in diesem Modus alle INDEX DIRECTORY- und DATA DIRECTORY-Direktiven ignoriert. Diese Option ist praktisch bei Slave-Replikationsservern.

NO_ENGINE_SUBSTITUTION

Verhindert die automatische Ersetzung der vorgabeseitigen Speicher-Engine, wenn eine Anweisung wie CREATE TABLE eine Speicher-Engine angibt, die deaktiviert oder nicht einkompiliert ist.

NO_FIELD_OPTIONS

Sorgt dafür, dass MySQL-spezifische Spaltenoptionen in der Ausgabe von SHOW CREATE TABLE nicht angegeben werden. Dieser Modus wird von mysqldump im Portabilitätsmodus verwendet.

NO_KEY_OPTIONS

Sorgt dafür, dass MySQL-spezifische Indexoptionen in der Ausgabe von SHOW CREATE TABLE nicht angegeben werden. Dieser Modus wird von mysqldump im Portabilitätsmodus verwendet.

NO_TABLE_OPTIONS

Sorgt dafür, dass MySQL-spezifische Tabellenoptionen (wie ENGINE) in der Ausgabe von SHOW CREATE TABLE nicht angegeben werden. Dieser Modus wird von mysqldump im Portabilitätsmodus verwendet.

NO_UNSIGNED_SUBTRACTION

Bei Subtraktionsoperationen wird das Ergebnis nicht als UNSIGNED gekennzeichnet, wenn einer der Operanden ohne Vorzeichen ist. Beachten Sie, dass hiermit BIGINT UNSIGNED nicht mehr in allen Kontexten hundertprozentig einsetzbar ist. Siehe auch Abschnitt 12.8, „Cast-Funktionen und Operatoren“.

NO_ZERO_DATE

Im strikten Modus wird '0000-00-00' nicht als gültiges Datum zugelassen. Mit der Option IGNORE können Sie trotzdem Nulldatumsangaben einfügen. Außerhalb des strikten Modus wird das Datum zwar akzeptiert, aber es wird eine Warnung erzeugt.

NO_ZERO_IN_DATE

Im strikten Modus werden Daten nicht akzeptiert, wenn die Monats- oder Tagesangabe 0 ist. Wenn der Modus mit der Option IGNORE verwendet wird, fügt MySQL das Datum '0000-00-00' für derartige Datumsangaben ein. Außerhalb des strikten Modus wird das Datum zwar akzeptiert, aber es wird eine Warnung erzeugt.

ONLY_FULL_GROUP_BY

Erlaubt keine Abfragen, bei denen die GROUP BY-Klausel auf eine Spalte verweist, die in der Ausgabespaltenliste nicht vorhanden ist.

PIPES_AS_CONCAT

Behandelt || als Operator zur String-Verkettung (also identisch mit CONCAT()) statt als Synonym von OR.

REAL_AS_FLOAT

Behandelt REAL als Synonym von FLOAT. Standardmäßig behandelt MySQL REAL als Synonym von DOUBLE.

STRICT_ALL_TABLES

Aktiviert den strikten Modus für alle Speicher-Engines. Ungültige Datenwerte werden abgewiesen. Zusätzliche Informationen folgen.

STRICT_TRANS_TABLES

Aktiviert den strikten Modus für transaktionssichere Speicher-Engines sowie – sofern möglich – für nicht transaktionssichere Speicher-Engines. Zusätzliche Informationen folgen.

Bei STRICT_ALL_TABLES gibt MySQL einen Fehler zurück und ignoriert die verbleibenden Datensätze. Allerdings bleiben die zuvor durch Einfügung oder Aktualisierung an Datensätzen vorgenommenen Änderung erhalten. Das bedeutet, dass unter Umständen eine Teilaktualisierung erfolgt, was vielleicht nicht wünschenswert ist. Um dies zu vermeiden, sollten Sie am besten Anweisungen nur für jeweils einen Datensatz verwenden, da diese abgebrochen werden können, ohne die Tabelle zu verändern.

Bei STRICT_TRANS_TABLES wandelt MySQL einen ungültigen Wert in den nächstgelegenen für die Spalte gültigen Wert um und fügt diesen umgewandelten Wert dann ein. Fehlt ein Wert, dann fügt MySQL den impliziten Vorgabewert für den Spaltendatentyp ein. In beiden Fällen erzeugt MySQL zudem eine Warnung (statt eines Fehlers) und fährt dann mit der Verarbeitung der Anweisung fort. Implizite Vorgabewerte sind in Abschnitt 11.1.4, „Vorgabewerte von Datentypen“, beschrieben.

ANSI

Entspricht REAL_AS_FLOAT, PIPES_AS_CONCAT, ANSI_QUOTES, IGNORE_SPACE. Siehe auch Abschnitt 1.9.3, „MySQL im ANSI-Modus laufen lassen“.

DB2

Entspricht PIPES_AS_CONCAT, ANSI_QUOTES, IGNORE_SPACE, NO_KEY_OPTIONS, NO_TABLE_OPTIONS, NO_FIELD_OPTIONS.

MAXDB

Entspricht PIPES_AS_CONCAT, ANSI_QUOTES, IGNORE_SPACE, NO_KEY_OPTIONS, NO_TABLE_OPTIONS, NO_FIELD_OPTIONS, NO_AUTO_CREATE_USER.

MSSQL

Entspricht PIPES_AS_CONCAT, ANSI_QUOTES, IGNORE_SPACE, NO_KEY_OPTIONS, NO_TABLE_OPTIONS, NO_FIELD_OPTIONS.

MYSQL323

Entspricht NO_FIELD_OPTIONS, HIGH_NOT_PRECEDENCE.

MYSQL40

Entspricht NO_FIELD_OPTIONS, HIGH_NOT_PRECEDENCE.

ORACLE

Entspricht PIPES_AS_CONCAT, ANSI_QUOTES, IGNORE_SPACE, NO_KEY_OPTIONS, NO_TABLE_OPTIONS, NO_FIELD_OPTIONS, NO_AUTO_CREATE_USER.

POSTGRESQL

Entspricht PIPES_AS_CONCAT, ANSI_QUOTES, IGNORE_SPACE, NO_KEY_OPTIONS, NO_TABLE_OPTIONS, NO_FIELD_OPTIONS.

TRADITIONAL

Entspricht STRICT_TRANS_TABLES, STRICT_ALL_TABLES, NO_ZERO_IN_DATE, NO_ZERO_DATE, ERROR_FOR_DIVISION_BY_ZERO, NO_AUTO_CREATE_USER.

Unter Linux ist das MySQL-Max-RPM auf dieses Verhalten von mysqld_safe angewiesen. Das RPM installiert eine ausführbare Datei namens mysqld-max; aufgrund dessen verwendet mysqld_safe ab sofort automatisch diese Datei anstelle von mysqld.

Wenn Sie eine MySQL-Max-Distribution installieren, die einen Server namens mysqld-max enthält, und nachfolgend auf eine Nicht-Max-Version von MySQL aktualisieren wollen, dann beachten Sie, dass mysqld_safe nach wie vor versuchen wird, den alten Server mysqld-max auszuführen. Führen Sie ein solches Upgrade durch, dann sollten Sie den alten mysqld-max-Server manuell entfernen, um sicherzustellen, dass mysqld_safe den neuen Server mysqld ausführt.

--help

Zeigt eine Hilfsmeldung an und wird dann beendet.

--autoclose

(Nur NetWare.) mysqld_safe stellt unter NetWare eine Bildschirmpräsenz bereit. Wenn Sie das NLM mysqld_safe entladen (herunterfahren), verschwindet der Bildschirm standardmäßig nicht. Stattdessen wird eine Benutzereingabe angefordert:

*<NLM has terminated; Press any key to close the screen>*

Wenn Sie hingegen wollen, dass NetWare den Bildschirm automatisch schließt, dann verwenden Sie die Option --autoclose für mysqld_safe.

--basedir=path

Der Pfad zum MySQL-Installationsverzeichnis.

--core-file-size=size

Größe der Speicherauszugsdatei, die mysqld erstellen können soll. Der Optionswert wird an ulimit -c übergeben.

--datadir=path

Der Pfad zum Datenverzeichnis.

--defaults-extra-file=path

Der Name einer Optionsdatei, die zusätzlich zu den normalen Optionsdateien ausgelesen wird. Wenn diese Option verwendet wird, muss Sie auf der Befehlszeile die erste angegebene Option sein.

--defaults-file=file_name

Der Name einer Optionsdatei, die anstelle der normalen Optionsdateien ausgelesen wird. Wenn diese Option verwendet wird, muss Sie auf der Befehlszeile die erste angegebene Option sein.

--ledir=path

Wenn mysqld_safe den Server nicht finden kann, können Sie diese Option verwenden, um einen Pfadnamen zu dem Verzeichnis anzugeben, in dem sich der Server befindet.

--log-error=file_name

Schreibt das Fehlerlog in die angegebene Datei. Siehe auch Abschnitt 5.12.1, „Die Fehler-Logdatei“.

--mysqld=prog_name

Name des Serverprogramms (im Verzeichnis ledir), das Sie starten wollen. Diese Option ist erforderlich, wenn Sie die MySQL-Binärdistribution verwenden, aber das Datenverzeichnis sich außerhalb der Binärdistribution befindet. Wenn mysqld_safe den Server nicht finden kann, können Sie die Option --ledir verwenden, um einen Pfadnamen zu dem Verzeichnis anzugeben, in dem sich der Server befindet.

--mysqld-version=suffix

Diese Option ähnelt --mysqld, Sie geben aber nur das Suffix für den Serverprogrammnamen an. Als Basisname wird mysqld vorausgesetzt. Wenn Sie beispielsweise --mysqld-version=max verwenden, startet mysqld_safe das Programm mysqld-max im Verzeichnis ledir. Wenn das Argument für --mysqld-version leer ist, verwendet mysqld_safe mysqld im Verzeichnis ledir.

--nice=priority

Stellt die Zeitplanungspriorität mit dem Programm nice auf den angegebenen Wert.

--no-defaults

Optionsdateien werden nicht auslesen. Wenn diese Option verwendet wird, muss Sie auf der Befehlszeile die erste angegebene Option sein.

--open-files-limit=count

Anzahl der Dateien, die mysqld öffnen können sollte. Der Optionswert wird an ulimit -n übergeben. Beachten Sie, dass Sie mysqld_safe als root starten müssen, damit dies einwandfrei funktioniert!

--pid-file=file_name

Der Pfadname der Prozesskennungsdatei.

--port=port_num

Portnummer, die der Server beim Horchen auf TCP/IP-Verbindungen verwenden soll. Die Portnummer muss 1.024 oder höher sein, sofern der Server nicht vom Systembenutzer root gestartet wird.

--socket=path

Unix-Socketdatei, die der Server bei Horchen auf lokale Verbindungen verwenden soll.

--timezone=timezone

Weist der Zeitzonen-Umgebungsvariablen TZ den angegebenen Optionswert zu. Informationen zu zulässigen Formaten für Zeitzonenangaben finden Sie in der Dokumentation zu Ihrem Betriebssystem.

--user={user_name | user_id}

Führt den Server mysqld als Benutzer mit dem spezifizierten Benutzernamen (user_name) oder der numerischen Benutzerkennung (user_id) aus. („Benutzer“ bezeichnet in diesem Kontext ein Systemanmeldekonto und keinen in den Grant-Tabellen aufgeführten MySQL-Benutzer.)

Server und Datenbanken befinden sich relativ zum Arbeitsverzeichnis (d. h. zu dem Verzeichnis, aus dem heraus mysqld_safe aufgerufen wurde). Bei Binärdistributionen sucht mysqld_safe in seinem Arbeitsverzeichnis nach den Verzeichnissen bin und data. Bei Quelldistributionen hingegen wird nach den Verzeichnissen libexec und var gesucht. Diese Bedingung sollte erfüllt sein, wenn Sie mysqld_safe aus Ihrem MySQL-Installationsverzeichnis heraus aufrufen (z. B. /usr/local/mysql bei einer Binärdistribution).

Wenn der Server und die Datenbanken relativ zum Arbeitsverzeichnis nicht vorgefunden werden, versucht mysqld_safe sie anhand absoluter Pfadnamen zu ermitteln. Typische Positionen sind /usr/local/libexec und /usr/local/var. Die tatsächlichen Verzeichnisse werden den Werten entnommen, die bei der Erstellung in die Distribution einkonfiguriert wurden. Sie sollten korrekt sein, wenn MySQL im während der Konfiguration angegebenen Verzeichnis installiert ist.

--help

Zeigt eine Hilfsmeldung an und wird dann beendet.

--config-file=name

Gibt den Namen einer alternativen Optionsdatei an. Die Option bestimmt, wo mysqld_multi nach [mysqldN]-Optionsabschnitten sucht. Ohne Angabe dieser Option werden alle Optionen aus der normalen Optionsdatei my.cnf ausgelesen. Die Option beeinflusst nicht, wo mysqld_multi seine eigenen Optionen ausliest (diese werden immer dem Abschnitt [mysqld_multi] in der normalen Datei my.cnf entnommen).

--example

Zeigt eine Beispieloptionsdatei an.

--log=file_name

Gibt den Namen der Logdatei an. Wenn die Datei vorhanden ist, werden geloggte Einträge angehängt.

--mysqladmin=prog_name

Gibt die mysqladmin-Binärdatei an, die zum Beenden von Servern verwendet wird.

--mysqld=prog_name

Die zu verwendende mysqld-Binärdatei. Beachten Sie, dass Sie auch mysqld_safe als Wert angeben können. Wenn Sie den Server mit mysqld_safe starten, können Sie die Optionen mysqld oder ledir im entsprechenden Abschnitt [mysqldN] angeben. Diese Optionen bezeichnen den Namen des Servers, den mysqld_safe starten soll, und den Pfadnamen des Verzeichnisses, in dem der Server sich befindet. (Beschreibungen zu diesen Optionen finden Sie in Abschnitt 5.4.1, „mysqld_safe — Startskript für den MySQL-Server“.) Beispiel:

[mysqld38]
mysqld = mysqld-max
ledir  = /opt/local/mysql/libexec

--no-log

Schreibt Loginformationen in stdout statt in die Logdatei. (Standardmäßig erfolgt die Ausgabe in die Logdatei.)

--password=password

Passwort des MySQL-Kontos, das für den Aufruf von mysqladmin verwendet wird. Beachten Sie, dass der Passwortwert – anders als bei anderen MySQL-Programmen – bei dieser Option nicht optional ist.

--silent

Stummer Modus (Warnungen werden deaktiviert).

--tcp-ip

Alle betreffenden MySQL-Server werden statt über die Unix-Socketdatei über den TCP/IP-Port angebunden. (Wenn eine Socketdatei fehlt, kann der Server zwar unter Umständen noch laufen, ist aber nur über den TCP/IP-Port erreichbar.) Standardmäßig werden Verbindungen unter Verwendung der Unix-Socketdatei hergestellt. Diese Option wirkt sich auf alle stop- und reportOperationen aus.

--user=user_name

Benutzername des MySQL-Kontos, das für den Aufruf von mysqladmin verwendet wird.

--verbose

Zeigt mehr Informationen an.

--version

Zeigt die Versionsinformation an und wird dann beendet.

Extrem wichtig: Bevor Sie mysqld_multi verwenden, müssen Sie die Bedeutung der Optionen, die an die mysqld-Server übergeben werden, verstanden haben und genau wissen, warum Sie separate mysqld-Prozesse benutzen wollen. Die Verwendung mehrerer mysqld-Server mit demselben Datenverzeichnis ist extrem gefährlich. Sofern Sie nicht genauestens wissen, was Sie tun, verwenden Sie in jedem Fall getrennte Datenverzeichnisse. Das Starten mehrerer Server mit demselben Datenverzeichnis steigert die Leistungsfähigkeit eines Thread-basierten Systems nicht! Siehe auch Abschnitt 5.13, „Mehrere MySQL-Server auf derselben Maschine laufen lassen“.

Wichtig: Vergewissern Sie sich, dass das Datenverzeichnis jedes Servers für das Unix-Konto, unter dem der jeweilige mysqld-Prozess gestartet wurde, uneingeschränkt zugänglich ist. Verwenden Sie hierfür keinesfalls das Unix-Konto root, sofern Sie nicht genauestens wissen, was Sie tun. Siehe auch Abschnitt 5.7.5, „Wie man MySQL als normaler Benutzer laufen läßt“.

Vergewissern Sie sich, dass das MySQL-Konto, welches zum Beenden der mysqld-Server (mit dem Programm mysqladmin) verwendet wird, für jeden Server den gleichen Benutzernamen und das gleiche Passwort hat. Außerdem müssen Sie sicherstellen, dass das Konto über die Berechtigung SHUTDOWN verfügt. Wenn die Server, die Sie verwalten wollen, unterschiedliche Benutzernamen oder Passwörter für die Administrationskonten aufweisen, sollten Sie auf jedem Server ein Konto mit jeweils demselben Benutzernamen und Passwort einrichten. Sie könnten etwa ein gemeinsames Konto multi_admin erstellen, indem Sie auf jedem Server die folgenden Befehle ausführen:

shell> mysql -u root -S /tmp/mysql.sock -p
Enter password:
mysql> GRANT SHUTDOWN ON *.*
    -> TO 'multi_admin'@'localhost' IDENTIFIED BY 'multipass';

Siehe auch Abschnitt 5.8.2, „Wie das Berechtigungssystem funktioniert“. Sie müssen diesen Schritt für jeden mysqld-Server durchführen. Ändern Sie die Verbindungsparameter entsprechend, wenn Sie mit den einzelnen Servern Verbindungen herstellen. Beachten Sie, dass der Hostnamensteil des Kontonamens die Herstellung einer Verbindung als multi_admin von dem Host aus ermöglichen muss, auf dem sie mysqld_multi ausführen wollen.

Die Unix-Socketdatei und die TCP/IP-Portnummer müssen für jeden mysqld-Server unterschiedlich sein.

Die Option --pid-file ist sehr wichtig, wenn Sie mysqld_safe zum Starten von mysqld verwenden (z. B. --mysqld=mysqld_safe). Jeder mysqld-Server sollte seine eigene Prozesskennungsdatei haben. Der Vorteil der Verwendung von mysqld_safe anstelle von mysqld besteht darin, dass mysqld_safe seinen mysqld-Prozess überwacht und ihn neu startet, wenn der Prozess aufgrund eines Signals, welches mit kill -9 gesendet wurde, oder aus einem anderen Grund (z. B. wegen eines Segmentierungsfehlers) terminiert wurde. Bitte beachten Sie, dass das Skript mysqld_safe unter Umständen erfordert, dass Sie es von einer bestimmten Position aus starten. Das bedeutet, dass Sie möglicherweise in ein bestimmtes Verzeichnis wechseln müssen, bevor Sie mysqld_multi ausführen. Wenn Sie Probleme mit dem Starten haben, rufen Sie das Skript mysqld_safe zur Anzeige auf. Suchen Sie dort die folgenden Zeilen:

----------------------------------------------------------------
MY_PWD=`pwd`
# Check if we are starting this relative (for the binary release)
if test -d $MY_PWD/data/mysql -a -f ./share/mysql/english/errmsg.sys -a \
 -x ./bin/mysqld
----------------------------------------------------------------

Der mit diesen Zeilen durchgeführte Test sollte erfolgreich sein, andernfalls könnten Probleme auftreten. Siehe auch Abschnitt 5.4.1, „mysqld_safe — Startskript für den MySQL-Server“.

Sie sollten die Option --user für mysqld verwenden. Zu diesem Zweck müssen Sie das Skript mysqld_multi jedoch als Unix-Benutzer root ausführen. Das Einfügen der Option in die Optionsdatei ist irrelevant: Wenn Sie nicht der Superuser sind und die mysqld-Prozesse unter Ihrem eigenen Unix-Konto gestartet werden, erhalten Sie lediglich eine Warnung.

--help, -?

Zeigt eine Hilfemeldung an und wird dann beendet.

--bind-address=IP

Die IP-Adresse, zu der eine Bindung hergestellt wird.

--default-mysqld-path=path

Unter Unix der Pfadname der MySQL-Serverbinärdatei, sofern kein Pfad im Instanzabschnitt angegeben ist. Beispiel: --default-mysqld-path=/usr/sbin/mysqld

--defaults-file=file_name

Datei, aus der die Einstellungen für den Instance Manager und MySQL Server ausgelesen werden sollen. Alle Konfigurationsänderungen, die der Instance Manager durchführt, werden an dieser Datei vorgenommen. Wenn diese Option verwendet wird, muss Sie auf der Befehlszeile die erste angegebene Option sein.

--install

Gibt an, dass der Instance Manager unter Windows als Dienst installiert werden soll.

--log=file_name

Der Pfad zur IM-Logdatei. Wird mit der Option --run-as-service verwendet.

--monitoring-interval=seconds

Das Intervall zur Überwachung der Instanzen, angegeben in Sekunden. Der Vorgabewert beträgt 20 Sekunden. Der Instance Manager versucht mit jeder überwachten Instanz eine Verbindung herzustellen, um festzustellen, ob sie läuft bzw. nicht abgestürzt ist. Stellt der Instance Manager fest, dass die Instanz terminiert wurde, versucht er mehrfach, sie neu zu starten. Über die Option nonguarded im Abschnitt der betreffenden Instanz kann man dieses Verhalten für eine bestimmte Instanz deaktivieren.

--passwd, -P

Bereitet einen Eintrag für die Passwortdatei vor und beendet sich dann.

--password-file=file_name

Datei, in der nach Instance Manager-Benutzern und -Passwörtern gesucht wird. Die Standarddatei ist /etc/mysqlmanager.passwd.

--pid-file=file_name

Die zu verwendende Prozesskennung. Standardmäßig heißt die Datei mysqlmanager.pid.

--port=port_num

Die TCP/IP-Portnummer, die für eingehende Verbindungen verwendet werden soll (der von der IANA vergebene Standardport ist 2273).

--print-defaults

Gibt die aktuellen Standardwerte an und beendet sich nachfolgend. Wenn diese Option verwendet wird, muss Sie auf der Befehlszeile die erste angegebene Option sein.

--remove

Gibt unter Windows an, dass der Instance Manager als Windows-Dienst entfernt wird. Dies setzt voraus, dass der Instance Manager zuvor mit der Option --install ausgeführt wurde.

--run-as-service

Gibt an, dass eine Daemonisierung durchgeführt und nachfolgend der Engelsprozess gestartet werden soll. Der Engelsprozess ist einfach und stürzt mit hoher Wahrscheinlichkeit nicht ab. Im Falle eines Absturzes startet er den Instance Manager selbst neu.

--socket=path

Unter Unix die Socketdatei, die für eingehende Verbindungen verwendet werden soll. Standardmäßig heißt die Datei /tmp/mysqlmanager.sock.

--standalone

Führt den Instance Manager unter Windows im autarken Modus aus.

--user=user_name

Benutzername, unter dem mysqlmanager gestartet und ausgeführt werden soll. Es wird empfohlen, mysqlmanager unter demselben Benutzerkonto auszuführen, unter dem auch der Server mysqld läuft. („Benutzer“ bezeichnet in diesem Kontext ein Systemanmeldekonto und keinen in den Grant-Tabellen aufgeführten MySQL-Benutzer.)

--version, -V

Gibt die Versionsinformation aus und wird dann beendet.

mysqld-path = path

Pfadname zur Binärdatei des mysqld-Servers.

shutdown-delay = seconds

Dauer (in Sekunden), die der IM auf das Herunterfahren der Instanz warten soll. Der Vorgabewert beträgt 35 Sekunden. Wird dieses Intervall überschritten, dann geht der IM davon aus, dass die Instanz abgestürzt ist, und versucht sie zu terminieren. Wenn Sie InnoDB mit großen Tabellen verwenden, sollten Sie diesen Wert erhöhen.

nonguarded

Diese Option sollte angegeben werden, wenn Sie die IM-Überwachungsfunktion für eine bestimmte Instanz deaktivieren wollen.

START INSTANCE instance_name

Dieser Befehl versucht eine Instanz zu starten.

mysql> START INSTANCE mysqld4;
Query OK, 0 rows affected (0,00 sec)

STOP INSTANCE instance_name

Dieser Befehl versucht eine Instanz zu beenden.

mysql> STOP INSTANCE mysqld4;
Query OK, 0 rows affected (0,00 sec)

SHOW INSTANCES

Zeigt die Namen aller geladenen Instanzen an.

mysql> SHOW INSTANCES;
+---------------+---------+
| instance_name | status  |
+---------------+---------+
| mysqld3       | offline |
| mysqld4       | online  |
| mysqld2       | offline |
+---------------+---------+
3 rows in set (0,04 sec)

SHOW INSTANCE STATUS instance_name

Zeigt den Status und die Versionsinformation für eine Instanz an.

mysql> SHOW INSTANCE STATUS mysqld3;
+---------------+--------+---------+
| instance_name | status | version |
+---------------+--------+---------+
| mysqld3       | online | unknown |
+---------------+--------+---------+
1 row in set (0.00 sec)

SHOW INSTANCE OPTIONS instance_name

Zeigt die von der Instanz verwendeten Optionen an.

mysql> SHOW INSTANCE OPTIONS mysqld3;
+---------------+---------------------------------------------------+
| option_name   | value                                             |
+---------------+---------------------------------------------------+
| instance_name | mysqld3                                           |
| mysqld-path   | /home/cps/mysql/trees/mysql-4.1/sql/mysqld        |
| port          | 3309                                              |
| socket        | /tmp/mysql.sock3                                  |
| pid-file      | hostname.pid3                                     |
| datadir       | /home/cps/mysql_data/data_dir1/                   |
| language      | /home/cps/mysql/trees/mysql-4.1/sql/share/english |
+---------------+---------------------------------------------------+
7 rows in set (0.01 sec)

SHOW instance_name LOG FILES

Dieser Befehl listet alle von der Instanz verwendeten Logdateien auf. Die Ergebnisliste enthält die Pfade und die Größe der Logdateien. Wird in der Konfigurationsdatei kein Logdateipfad (wie etwa log=/var/mysql.log) angegeben, dann versucht der Instance Manager, die Position der Logdatei zu erschließen. Wenn der IM die Position jedoch nicht erraten kann, dann sollten Sie sie unter Verwendung der entsprechenden Logoption explizit im Instanzabschnitt der Konfigurationsdatei angeben.

mysql> SHOW mysqld LOG FILES;
+-------------+------------------------------------+----------+
| Logfile     | Path                               | Filesize |
+-------------+------------------------------------+----------+
| ERROR LOG   | /home/cps/var/mysql/owlet.err      | 9186     |
| GENERAL LOG | /home/cps/var/mysql/owlet.log      | 471503   |
| SLOW LOG    | /home/cps/var/mysql/owlet-slow.log | 4463     |
+-------------+------------------------------------+----------+
3 rows in set (0.01 sec)

SHOW instance_name LOG {ERROR | SLOW | GENERAL} size[,offset_from_end]

Dieser Befehl ruft einen Teil der angegebenen Logdatei ab. Da die meisten Benutzer wohl an den neuesten Logmeldungen interessiert sein werden, können Sie mit dem Parameter size die Anzahl der Bytes definieren, die Sie – rückwärts vom Ende der Logdatei ausgehend – abrufen wollen. Sie können Daten aber auch aus einem Bereich mitten in der Datei abrufen, indem Sie den optionalen Parameter offset_from_end angeben. Das folgende Beispiel ruft 21 Datenbytes ab, beginnend 23 Bytes vor dem Ende der Logdatei und zwei Bytes vor ihrem Ende endend:

mysql> SHOW mysqld LOG GENERAL 21, 2;
+---------------------+
| Log                 |
+---------------------+
| using password: YES |
+---------------------+
1 row in set (0.00 sec)

SET instance_name.option_name=option_value

Dieser Befehl bearbeitet die Konfigurationsdatei der angegebenen Instanz dahingehend, dass er Instanzoptionen ändert oder hinzufügt. Der IM geht dabei davon aus, dass die Konfigurationsdatei sich in /etc/my.cnf befindet. Sie sollten sicherstellen, dass die Datei existiert und die passenden Berechtigungen hat.

mysql> SET mysqld2.port=3322;
Query OK, 0 rows affected (0.00 sec)

Änderungen, die an der Konfigurationsdatei vorgenommen werden, werden erst beim nächsten Start des MySQL-Servers umgesetzt. Außerdem werden diese Änderungen erst im lokalen Cache des Instance Managers für die Instanzeinstellungen gespeichert, wenn der Befehl FLUSH INSTANCES ausgeführt wird.

UNSET instance_name.option_name

Dieser Befehl entfernt eine Option aus der Konfigurationsdatei einer Instanz.

mysql> UNSET mysqld2.port;
Query OK, 0 rows affected (0.00 sec)

Änderungen, die an der Konfigurationsdatei vorgenommen werden, werden erst beim nächsten Start des MySQL-Servers umgesetzt. Außerdem werden diese Änderungen erst im lokalen Cache des Instance Managers für die Instanzeinstellungen gespeichert, wenn der Befehl FLUSH INSTANCES ausgeführt wird.

FLUSH INSTANCES

Dieser Befehl erzwingt das Neueinlesen der Konfigurationsdatei durch den IM und die Aktualisierung der internen Strukturen. Der Befehl sollte nach einer Bearbeitung der Konfigurationsdatei ausgeführt werden. Er startet Instanzen nicht neu.

mysql> FLUSH INSTANCES;
Query OK, 0 rows affected (0.04 sec)

Gewähren Sie niemals irgendjemandem (mit Ausnahme von MySQL-root-Konten) Zugang zur Tabelle user in der mysql-Datenbank! Dies ist entscheidend. Das verschlüsselte Passwort ist das echte Passwort in MySQL. Jeder, der das Passwort kennt, welches in der Tabelle user aufgeführt ist, und Zugang zu dem für das betreffende Konto gelisteten Host hat, kann sich problemlos als dieser Benutzer anmelden.

Machen Sie sich mit dem MySQL-Zugriffsberechtigungssystem vertraut. Die Anweisungen GRANT und REVOKE werden zur Steuerung des Zugriffs auf MySQL verwendet. Gewähren Sie nie mehr Berechtigungen als notwendig. Gewähren Sie Berechtigungen niemals allen Hosts.

Checkliste:

Speichern Sie Passwörter nicht unverschlüsselt in Ihrer Datenbank. Wenn der Computer in die Hände eines Angreifers fällt, kann dieser die Passwortliste lesen und die Passwörter verwenden. Verwenden Sie stattdessen MD5(), SHA1() oder eine andere unidirektionale Hashing-Funktion und speichern Sie den Hash-Wert.

Wählen Sie keine Passwörter aus Wörterbüchern aus. Es gibt Spezialprogramme zum Knacken von Passwörtern. Sogar Passwörter wie „fisch98“ sind ziemlich schlecht. Wesentlich besser ist „duaxg98“: Dieses Passwort enthält zwar auch das Wort „fisch“, jedoch wurde jeder Buchstabe auf einer QWERTZ-Standardtastatur durch die Taste zu seiner Linken ersetzt. Eine andere Methode, ein Passwort zu verwenden, besteht darin, die jeweils ersten Buchstaben jedes Wortes eines Satzes zu benutzen; so wird etwa aus „Hoch auf dem gelben Wagen“ ganz einfach das Passwort „HadgW“. Dieses Passwort ist vergleichsweise einfach zu merken und einzugeben, aber für jemanden, der den Satz gar nicht kennt, schwer zu erraten.

Schaffen Sie eine Firewall an. Diese schützt Sie vor mindestens 50 Prozent aller Sicherheitslücken in jeder beliebigen Software. Setzen Sie MySQL hinter die Firewall oder in eine DMZ (De-Militarized Zone, entmilitarisierte Zone).

Checkliste:

Schenken Sie Daten, die von Benutzern Ihrer Anwendungen eingegeben wurden, kein Vertrauen. Benutzer können Ihren Code überlisten, indem Sie Sonderzeichen oder Zeichenfolgen mit vorangestelltem Escape-Zeichen in Webformulare, URLs oder andere Eingabemöglichkeiten der von Ihnen erstellten Anwendungen eintragen. Sie müssen sicherstellen, dass Ihre Anwendung auch dann sicher bleibt, wenn ein Benutzer so etwas wie „; DROP DATABASE mysql;“ eingibt. Dies ist natürlich ein Extrembeispiel, aber große Sicherheitslücken oder umfangreiche Datenverlust können die Folge sein, wenn Hacker ähnliche Methoden verwenden und Sie nicht darauf vorbereitet sind.

Ein häufiger Fehler besteht darin, nur String-Datenwerte zu schützen. Denken Sie daran, auch numerische Daten abzusichern. Wenn eine Anwendung eine Abfrage wie SELECT * FROM table WHERE ID=234 erzeugt, weil ein Benutzer den Wert 234 eingegeben hat, dann kann der Benutzer auch den Wert 234 OR 1=1 eingeben; hierauf generiert die Anwendung die Abfrage SELECT * FROM table WHERE ID=234 OR 1=1. Folge ist, dass der Server jeden Datensatz in der Tabelle abruft. Mithin wird jeder Datensatz angezeigt, zudem wird der Server extrem belastet. Die einfachste Möglichkeit, sich vor diesem Angriffstyp zu schützen, besteht darin, numerische Konstanten in Anführungszeichen zu setzen: SELECT * FROM table WHERE ID='234'. Gibt nämlich der Benutzer zusätzliche Daten an, so werden sie alle Teil des Strings. In einem numerischen Kontext wandelt MySQL diesen String automatisch in eine Zahl um und entfernt alle nachfolgenden nichtnumerischen Zeichen.

Manche Leute gehen davon aus, dass eine Datenbank, die nur öffentlich verfügbare Daten enthält, nicht geschützt werden muss. Das stimmt nicht. Auch wenn jeder Datensatz in der Datenbank angezeigt werden dürfte, sollten Sie sich trotzdem etwa gegen DoS-Angriffe schützen (z. B. jene, die auf der im vorigen Absatz beschriebenen Methode basieren und den Server dazu bringen, Ressourcen zu vergeuden). Andernfalls kann Ihr Server für legitime Benutzer unerreichbar werden.

Checkliste:

Viele APIs stellen eine Methode bereit, um Sonderzeichen in Datenwerten zu kennzeichnen. Richtig verwendet, verhindert dies, dass Anwendungsbenutzer Werte eingeben können, die eine Erzeugung von Anweisungen durch die Anwendung verursachen könnten, welche einen anderen Effekt als von Ihnen erwünscht hervorrufen:

Andere Programmierschnittstellen weisen möglicherweise ähnliche Funktionalitäten auf.

Übertragen Sie keine unverschlüsselten Daten über das Internet. Auf solche Daten kann jeder zugreifen, der die Zeit und die Fähigkeiten hat, sie abzufangen und für eigene Zwecke zu verwenden. Verwenden Sie stattdessen ein verschlüsseltes Protokoll wie SSL oder SSH. MySQL unterstützt interne SSL-Verbindungen ab Version 4.0. Eine andere Methode besteht in der Verwendung der SSH-Portweiterleitung, mit der man einen verschlüsselten (und komprimierten) Kommunikationstunnel einrichten kann.

Machen Sie sich mit den Hilfsprogrammen tcpdump und strings vertraut. In den meisten Fällen können Sie durch Absetzen eines Befehls wie des folgenden überprüfen, ob MySQL-Datenströme unverschlüsselt sind:

shell> tcpdump -l -i eth0 -w - src or dst port 3306 | strings

(Das funktioniert unter Linux und sollte mit kleinen Anpassungen auf unter anderen Betriebssystemen laufen.) Warnung: Wenn Sie keine Klartextdaten sehen, bedeutet dies nicht notwendigerweise, dass die Daten tatsächlich verschlüsselt sind. Sofern Sie ein hohes Maß an Sicherheit benötigen, sollten Sie sich an einen Sicherheitsexperten wenden.

Verlangen Sie für alle MySQL-Konten die Nutzung eines Passworts. Ein Clientprogramm kennt die Identität seines Benutzers nicht unbedingt. Bei Client/Server-Anwendungen ist es durchaus üblich, dass der Benutzer einen beliebigen Benutzernamen für das Clientprogramm angeben kann. So kann beispielsweise jede beliebige Person das Programm mysql verwenden, um eine Verbindung als eine andere Person herzustellen, indem sie mysql -u other_user db_name aufruft, wenn für other_user kein Passwort konfiguriert ist. Wenn alle Konten ein Passwort besitzen, wird das Herstellen einer Verbindung unter Verwendung des Kontos eines anderen Benutzers erheblich schwieriger.

Eine Beschreibung der Methoden zur Konfiguration von Passwörtern finden Sie in Abschnitt 5.9.5, „Kennwörter einrichten“.

Führen Sie den MySQL-Server niemals als Unix-Benutzer root aus. Dies ist extrem gefährlich, weil jeder Benutzer mit der Berechtigung FILE in der Lage ist, auf dem Server die Erstellung von Dateien als root anzufordern (z. B. ~root/.bashrc). Um dies zu verhindern, verweigert mysqld die Ausführung als root, sofern dies nicht ausdrücklich mit der Option --user=root festgelegt wurde.

mysqld kann (und sollte) stattdessen als gewöhnlicher, nichtberechtigter Benutzer ausgeführt werden. Sie können ein separates Unix-Konto namens mysql einrichten, um die Sicherheit noch weiter zu erhöhen. Dieses Konto verwenden Sie dann nur zur Administration von MySQL. Um mysqld als ein anderer Unix-Benutzer zu starten, fügen Sie die Option user hinzu, die den Benutzernamen im Abschnitt [mysqld] der Optionsdatei my.cnf angibt, in der Sie die Serveroptionen konfigurieren. Zum Beispiel:

[mysqld]
user=mysql

Hierdurch wird der Server unabhängig davon, ob Sie ihn manuell oder mithilfe von mysqld_safe oder mysql.server starten, als der angegebene Benutzer gestartet. Weitere Informationen finden Sie unter Abschnitt 5.7.5, „Wie man MySQL als normaler Benutzer laufen läßt“.

Die Ausführung von mysqld als ein anderer Unix-Benutzer als root hat nicht zur Folge, dass Sie den Benutzernamen root in der Tabelle user ändern müssen. Benutzernamen für MySQL-Konten haben nichts mit den Benutzernamen für Unix-Konten zu tun.

Unterbinden Sie die Verwendung von symbolischen Verknüpfungen mit Tabellen. (Diese Funktionalität kann mit der Option --skip-symbolic-links deaktiviert werden.) Dies ist insbesondere dann wichtig, wenn Sie mysqld als root ausführen, da jeder Benutzer, der Schreibzugriff auf das Datenverzeichnis des Servers hat, jede beliebige Datei im System löschen kann! Siehe auch Abschnitt 7.6.1.2, „Benutzung symbolischer Links für Tabellen“.

Vergewissern Sie sich, dass der einzige Unix-Benutzer mit Lese- und Schreibberechtigungen in den Datenbankverzeichnissen der Benutzer ist, als der mysqld ausgeführt wird.

Gewähren Sie die Berechtigungen PROCESS und SUPER ausschließlich Administratoren. Die Ausgabe von mysqladmin processlist und SHOW PROCESSLIST zeigt den Text aller Anweisungen, die gerade ausgeführt werden. Insofern kann jeder Benutzer, der die Serverprozessliste anzeigen kann, unter Umständen Anweisungen sehen, die von anderen Benutzern abgesetzt werden – z. B. auch UPDATE user SET password=PASSWORD('not_secure').

mysqld reserviert eine zusätzliche Verbindung für Benutzer mit der Berechtigung SUPER, sodass ein MySQL-Benutzer root sich auch dann anmelden und die Serveraktivitäten überprüfen kann, wenn alle normalen Verbindungen gerade verwendet werden.

Die Berechtigung SUPER kann zur Terminierung von Clientverbindungen, zur Änderung des Serverbetriebs durch Modifikation von Systemvariablen und zur Steuerung von Replikationsservern verwendet werden.

Gewähren Sie die Berechtigung FILE ausschließlich Administratoren. Jeder Benutzer mit dieser Berechtigung kann eine Datei an beliebiger Stelle im Dateisystem mit den Berechtigungen des mysqld-Daemons speichern. Um dies ein wenig sicherer zu gestalten, überschreiben Dateien, die mit SELECT ... INTO OUTFILE erzeugt wurden, keine vorhandenen Dateien und können von allen geschrieben werden.

Die Berechtigung FILE kann auch eingesetzt werden, um jede Datei zu lesen, die von allen gelesen werden kann oder für den Unix-Benutzer, als der der Server ausgeführt wird, zugänglich ist. Mit dieser Berechtigung können Sie jede Datei in eine Datenbanktabelle einlesen. Dies könnte beispielsweise missbraucht werden, indem man mit LOAD DATA die Datei /etc/passwd in eine Tabelle einlädt, die dann mit SELECT angezeigt werden könnte.

Wenn Sie Ihrem DNS nicht trauen, sollten Sie IP-Nummern statt Hostnamen in den Grant-Tabellen verwenden. In jedem Fall sollten Sie sehr vorsichtig mit der Erstellung von Einträgen in Grant-Tabellen unter Verwendung von Hostnamenswerten sein, die Jokerzeichen enthalten.

Wenn Sie die Anzahl der für ein Konto verwendbaren Verbindungen einschränken wollen, können Sie dies tun, indem Sie die Variable max_user_connections in mysqld einstellen. Die GRANT-Anweisung unterstützt auch Ressourcensteuerungsoptionen, mit denen die Servernutzung durch ein Konto beschränkt werden kann. Siehe auch Abschnitt 13.5.1.3, „GRANT und REVOKE“.

--allow-suspicious-udfs

Diese Option bestimmt, ob UDFs (User-Defined Functions, benutzerdefinierte Funktionen), die nur ein xxx-Symbol für die Hauptfunktion aufweisen, geladen werden dürfen. Standardmäßig ist die Option deaktiviert, und es dürfen nur UDFs geladen werden, die mindestens ein Hilfssymbol aufweisen. Hierdurch soll das Laden von Funktionen aus solchen freigegebenen Objektdateien verhindert werden, die keine zulässigen UDFs enthalten. Siehe auch Abschnitt 26.3.4.6, „Vorsichtsmaßnahmen bei benutzerdefinierten Funktionen (UDF)“.

--local-infile[={0|1}]

Wenn Sie den Server mit --local-infile=0 starten, können Clients LOCAL in LOAD DATA-Anweisungen nicht verwenden. Siehe auch Abschnitt 5.7.4, „Sicherheitsprobleme mit LOAD DATA LOCAL“.

--old-passwords

Erzwingt die Erzeugung kurzer Passwort-Hashes (wie vor Version 4.1) auch für neue Passwörter. Dies kann zu Kompatibilitätszwecken erforderlich sein, wenn der Server ältere Clientprogramme unterstützen muss. Siehe auch Abschnitt 5.8.9, „Kennwort-Hashing ab MySQL 4.1“.

--safe-show-database (AUSGELAUFEN)

In älteren MySQL-Versionen konnte mit dieser Option festgelegt werden, dass die SHOW DATABASES-Anweisung die Namen nur derjenigen Datenbanken anzeigte, für die der Benutzer eine entsprechende Berechtigung hatte. In MySQL 5.1 steht diese Option nicht mehr zur Verfügung, da dies nun das Standardverhalten ist und es eine SHOW DATABASES-Berechtigung gibt, die zur kontenspezifischen Steuerung des Zugriffs auf Datenbanknamen verwendet werden kann. Siehe auch Abschnitt 13.5.1.3, „GRANT und REVOKE“.

--safe-user-create

Wenn diese Option aktiviert ist, kann ein Benutzer nur dann neue Benutzer mit der GRANT-Anweisung erstellen, wenn er die Berechtigung INSERT für die Tabelle mysql.user hat. Wenn Sie wollen, dass ein bestimmter Benutzer die Möglichkeit zur Einrichtung neuer Benutzer hat, die diejenigen Berechtigungen haben, die der erstellende Benutzer gewähren darf, dann sollten Sie dem Benutzer die folgende Berechtigung gewähren:

GRANT INSERT(user) ON mysql.user TO 'user_name'@'host_name';

Hierdurch ist gewährleistet, dass der Benutzer Berechtigungsspalten nicht direkt ändern kann, sondern die GRANT-Anweisung zur Gewährung von Berechtigungen an andere Benutzer verwenden muss.

--secure-auth

Unterbindet die Authentifizierung für Konten, die alte Passwörter (d. h. solche im Stil vor MySQL 4.1) haben.

Der Client mysql verfügt ebenfalls über eine Option namens --secure-auth, die Verbindungen mit einem Server verhindert, wenn dieser für das Clientkonto ein Passwort im alten Format anfordert.

--skip-grant-tables

Mit dieser Option verwendet der Server das Berechtigungssystem überhaupt nicht. Das bedeutet, dass jeder, der Zugriff auf den Server erhält, uneingeschränkten Zugang zu allen Datenbanken bekommt. Sie können einen laufenden Server dazu bringen, die Grant-Tabellen wieder zu verwenden, indem Sie mysqladmin flush-privileges oder mysqladmin reload über die System-Shell ausführen oder die MySQL-Anweisung FLUSH PRIVILEGES absetzen. Diese Option unterbindet auch das Laden von Plug-Ins und benutzerdefinierten Funktionen (UDFs).

--skip-name-resolve

Hostnamen werden nicht aufgelöst. Alle Host-Spaltenwerte in den Grant-Tabellen müssen IP-Nummern oder localhost sein.

--skip-networking

TCP/IP-Verbindungen über das Netzwerk werden unterbunden. Alle Verbindungen zu mysqld müssen über Unix-Socketdateien erfolgen.

--skip-show-database

Bei dieser Option darf die SHOW DATABASES-Anweisung nur von Benutzern verwendet werden, die die Berechtigung SHOW DATABASES haben. Die Anweisung zeigt dann alle Datenbanknamen an. Ohne diese Option dürfen alle Benutzer SHOW DATABASES verwenden, aber die Datenbanknamen werden nur angezeigt, wenn der Benutzer die Berechtigung SHOW DATABASES oder spezifische Berechtigungen für eine Datenbank hat. Beachten Sie, dass jede globale Berechtigung als Berechtigung für die Datenbank betrachtet wird.

Die Übertragung der Datei vom Client- auf den Serverhost wird durch den MySQL-Server eingeleitet. Theoretisch ließe sich ein gepatchter Server erstellen, der das Clientprogramm anweisen könnte, eine Datei nach Maßgabe des Servers (statt der vom Client in der LOAD DATA-Anweisung festgelegten Datei) zu übertragen. Ein solcher Server könnte dann auf jede Datei auf dem Clienthost zugreifen, auf die der Clientbenutzer Lesezugriff hat.

In einer Webumgebung, in der die Clients Verbindungen über einen Webserver herstellen, könnte ein Benutzer mit LOAD DATA LOCAL beliebige Dateien lesen, auf die der Webserverprozess Lesezugriff hat (vorausgesetzt, der Benutzer kann einen beliebigen Befehl den SQL-Server betreffend ausführen). In dieser Umgebung ist der Client aus Sicht des MySQL-Servers eigentlich der Webserver und nicht das entfernte Programm, das von dem Benutzer ausgeführt wird, der die Verbindung zum Webserver hergestellt hat.

Standardmäßig werden alle MySQL-Clients und -Bibliotheken mit der Option --enable-local-infile kompiliert, um die Kompatibilität mit MySQL 3.23.48 und vorher aufrechtzuerhalten.

Wenn Sie MySQL aus der Quelldistribution erstellt, aber configure nicht mit der Option --enable-local-infile aufgerufen haben, kann LOAD DATA LOCAL nicht von beliebigen Clients verwendet werden, sofern nicht ausdrücklich der Aufruf von mysql_options(... MYSQL_OPT_LOCAL_INFILE, 0) einkompiliert wurde. Siehe auch Abschnitt 24.2.3.48, „mysql_options()“.

Sie können alle LOAD DATA LOCAL-Befehle auf der Serverseite deaktivieren, indem Sie mysqld mit der Option --local-infile=0 starten.

Für den Befehlszeilenclient mysql kann LOAD DATA LOCAL durch Angabe der Option --local-infile[=1] aktiviert bzw. mit der Option --local-infile=0 deaktiviert werden. Ähnlich aktiviert die Option --local bzw. -L das Laden lokaler Dateien für mysqlimport. In jedem Fall setzt die erfolgreiche Verwendung einer lokalen Ladeoperation voraus, dass die Durchführung derartiger Operationen durch den Server zugelassen ist.

Wenn Sie LOAD DATA LOCAL in Perl-Skripten oder anderen Programmen verwenden, die den Abschnitt [client] aus Optionsdateien auslesen, können Sie die Option local-infile=1 in diesem Abschnitt hinzufügen. Allerdings sollten Sie sie mit dem Präfix loose- versehen, um Probleme mit Programmen zu vermeiden, die local-infile nicht verstehen:

[client]
loose-local-infile=1

Wenn LOAD DATA LOCAL INFILE deaktiviert ist – sei es am Server oder am Client –, dann erhält ein Client, der eine solche Anweisung abzusetzen versucht, die folgende Fehlermeldung:

ERROR 1148: The used command is not allowed with this MySQL version

Stufe 1: Der Server überprüft, ob er Ihnen die Verbindungsherstellung gestattet.

Stufe 2: Sofern Sie eine Verbindung herstellen konnten, überprüft der Server nun jede von Ihnen abgesetzte Anweisung, um zu ermitteln, ob Sie ausreichende Berechtigungen für deren Durchführung genießen. Versuchen Sie beispielsweise, Datensätze aus einer Tabelle in einer Datenbank auszuwählen oder eine Tabelle aus der Datenbank zu löschen, dann vergewissert sich der Server, dass Sie die Berechtigung SELECT für die Tabelle bzw. die Berechtigung DROP für die Datenbank haben.

Bereichsspalten bestimmen den Gültigkeitsbereich aller Datensätze in den Tabellen, d. h. den Kontext, in dem der Datensatz gültig ist. So würde beispielsweise eine Tabelle user mit den Host- und User-Werten 'thomas.loc.gov' bzw. 'bob' zur Authentifizierung von Verbindungen verwendet, die vom Host thomas.loc.gov aus durch einen Client, der den Benutzernamen bob angibt, hergestellt würden. Ähnlich würde ein Datensatz in der Tabelle db mit den Werten 'thomas.loc.gov', 'bob' und 'reports' in den Spalten Host, User und Db verwendet werden, wenn der Benutzer bob vom Host thomas.loc.gov aus auf die Datenbank reports zuzugreifen versucht. Die Tabellen tables_priv und columns_priv enthalten Gültigkeitsbereichsspalten, die die Tabellen oder Tabellenkombinationen angeben, für die der jeweilige Datensatz gilt. Die Bereichsspalten in procs_priv geben die jeweilige gespeicherte Routine an, für die der Datensatz gilt.

Berechtigungsspalten legen fest, welche Berechtigungen durch einen Datensatz gewährt werden, d. h. welche Operationen durchgeführt werden können. Der Server kombiniert die Daten in den verschiedenen Grant-Tabellen zu einer vollständigen Beschreibung der Berechtigungen eines Benutzers. Abschnitt 5.8.6, „Zugriffskontrolle, Phase 2: Anfrageüberprüfung“, beschreibt, welches Regeln hierbei zugrundegelegt werden.

Die Bereichsspalten in der Tabelle user bestimmen, ob eingehende Verbindungen abgewiesen oder zugelassen werden. Bei zulässigen Verbindungen geben alle in der Tabelle user gewährten Berechtigungen die globalen Berechtigungen (Superuser-Berechtigungen) des Benutzers an. Jede Berechtigung, die in dieser Tabelle gewährt wird, gilt für alle Datenbanken auf dem Server.

Hinweis: Da alle globalen Berechtigungen als Berechtigungen für alle Datenbanken zu betrachten sind, erlaubt das Vorhandensein einer beliebigen globalen Berechtigung für einen Benutzer diesem, alle Datenbanknamen mit SHOW DATABASES oder durch Untersuchen der Tabelle SCHEMATA von INFORMATION_SCHEMA anzuzeigen.

Die Bereichsspalten der Tabelle db bestimmen dabei, welche Benutzer von welchen Hosts aus auf welche Datenbanken zugreifen können. Die Berechtigungsspalten legen hingegen fest, welche Operationen zulässig sind. Eine auf der Datenbankebene gewährte Berechtigung gilt für die Datenbank und alle in ihr enthaltenen Tabellen.

Die Tabelle host wird in Verbindung mit der Tabelle db benutzt, wenn ein bestimmte Datensatz in der Tabelle db für mehrere Hosts gelten soll. Wenn Sie beispielsweise einem Benutzer die Verwendung einer Datenbank von verschiedenen Hosts in Ihrem Netzwerk aus gestatten wollen, lassen Sie den Wert Host im Datensatz des betreffenden Benutzers in der Tabelle db frei und geben Sie dann einen Datensatz für jeden der betreffenden Hosts in die Tabelle host ein. Diese Vorgehensweise wird in Abschnitt 5.8.6, „Zugriffskontrolle, Phase 2: Anfrageüberprüfung“, genauer beschrieben.

Hinweis: Die Tabelle host muss mit Anweisungen wie INSERT, UPDATE und DELETE direkt modifiziert werden. Anweisungen wie GRANT und REVOKE, die die Grant-Tabellen indirekt manipulieren, haben keine Auswirkungen auf diese Tabelle. Die meisten MySQL-Installationen verwenden die Tabelle ohnehin nicht.

Die Tabellen tables_priv und columns_priv ähneln der Tabelle db, sind aber feiner abgestuft: Sie werden nicht auf Datenbankebene, sondern auf der Tabellen- und der Spaltenebene angewendet. Eine auf der Tabellenebene gewährte Berechtigung gilt für die Tabelle und alle in ihr enthaltenen Spalten. Eine auf der Spaltenebene gewährte Berechtigung gilt indes nur für eine bestimmte Spalte.

Die Tabelle procs_priv gilt für gespeicherte Routinen. Eine auf der Routinenebene gewährte Berechtigung gilt nur für eine bestimmte Routine.