Kapitel 8. Client- und Hilfsprogramme

-?, -I

Zeigt eine Hilfemeldung an und wird dann beendet.

-c N

Führt nur N Befehle aus.

-f N

Gibt die maximale Anzahl offener Dateien an.

-i

Zeigt vor dem Beenden zusätzliche Informationen an.

-o offset

Gibt den Startoffset an.

-p N

Entfernt N Komponenten aus dem Pfad.

-r

Führt eine Wiederherstellungsoperation durch.

-R record_pos_file record_pos

Gibt die Datensatzpositionsdatei und die Datensatzposition an.

-u

Führt eine Aktualisierungsoperation durch.

-v

Ausführlicher Modus. Es werden zusätzliche Angaben zu den Aktivitäten des Programms ausgegeben. Diese Option kann mehrfach angegeben werden, um den Umfang der Ausgabe kontinuierlich zu erhöhen.

-w write_file

Gibt die zu schreibende Datei an.

-V

Zeigt Versionsinformationen an.

Wenn der mysqld-Server mit deaktivierter externer Sperrung aufgerufen wurde, sollte myisampack nicht aufgerufen werden, sofern die Möglichkeit besteht, dass die Tabelle während des Komprimierungsvorgangs durch den Server aktualisiert werden könnte. Am besten wird der Server vor der Komprimierung der Tabellen beendet.

Wenn eine Tabelle gepackt wurde, ist sie schreibgeschützt. Dies ist normalerweise auch beabsichtigt (z. B. beim Zugriff auf komprimierte Tabellen auf einer CD). Die Möglichkeit, in eine gepackte Tabelle zu schreiben, ist von uns zur mittel- bis langfristigen Implementierung vorgesehen.

myisampack kann BLOB- oder TEXT-Spalten packen. (Das ältere Programm pack_isam für ISAM-Tabellen bot diese Möglichkeit nicht.)

--help, -?

Zeigt eine Hilfemeldung an und wird dann beendet.

--backup, -b

Erstellt ein Backup der Datendateien aller Tabellen. Die Sicherungsdateien erhalten den Namen tbl_name.OLD.

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

Schreibt ein Debuglog. Der String debug_options heißt häufig 'd:t:o,file_name'.

--force, -f

Erzeugt auch dann eine gepackte Tabelle, wenn diese größer als die Ursprungstabelle wird oder noch eine Zwischendatei von myisampack vorhanden ist. (myisampack erzeugt im Verlauf der Komprimierung eine Zwischendatei namens tbl_name.TMD im Datenbankverzeichnis. Wenn Sie myisampack terminieren, dann wird die .TMD-Datei unter Umständen nicht gelöscht.) Normalerweise wird myisampack mit einem Fehler beendet, wenn es eine vorhandene Datei tbl_name.TMD findet. Mit --force packt myisampack die Tabelle jedoch in jedem Fall.

--join=big_tbl_name, -j big_tbl_name

Fasst alle auf der Befehlszeile aufgeführten Tabellen zu einer großen Tabelle big_tbl_name zusammen. Alle Tabellen, die zusammengefasst werden sollen, müssen eine identische Struktur aufweisen (d. h. gleiche Spaltennamen und -typen, gleiche Indizes usw.).

--packlength=len, -p len

Gibt die Speichergröße für die Datensatzlänge (in Byte) an. Der Wert darf zwischen 1 und 3 liegen. myisampack speichert alle Datensätze mit 1, 2 oder 3 Byte langen Längenzeigern. In den meisten normalen Fällen kann myisampack den korrekten Längenwert bestimmen, bevor es mit dem Packen der Datei beginnt. Es kann allerdings während des Packvorgangs feststellen, dass es eine geringere Länge hätte verwenden können. In diesem Fall gibt myisampack einen Hinweis aus, dass Sie, wenn Sie dieselbe Datei beim nächsten Mal packen, eine geringere Datensatzlänge verwenden können.

--silent, -s

Stummer Modus. Eine Ausgabe erfolgt nur, wenn ein Fehler auftritt.

--test, -t

Die Tabelle wird nicht gepackt, sondern das Packen wird lediglich geprüft.

--tmpdir=path, -T path

Verwendet das angegebene Verzeichnis als Position, an der myisamchk Temporärdateien erstellt.

--verbose, -v

Ausführlicher Modus. Gibt Informationen zum Fortschritt des Komprimierungsvorgangs und -ergebnisses aus.

--version, -V

Zeigt die Versionsinformation an und wird dann beendet.

--wait, -w

Sorgt dafür, dass der Packvorgang nach einer Wartezeit neu versucht wird, wenn die Tabelle gerade verwendet wird. Wenn der mysqld-Server mit deaktivierter externer Sperrung aufgerufen wurde, sollte myisampack nicht aufgerufen werden, sofern die Möglichkeit besteht, dass die Tabelle während des Komprimierungsvorgangs durch den Server aktualisiert werden könnte.

normal

Anzahl der Spalten, für die keine zusätzliche Komprimierung verwendet wird.

empty-space

Anzahl der Spalten, die ausschließlich aus Leerzeichen bestehende Werte enthalten. Diese benötigen genau ein Bit.

empty-zero

Anzahl der Spalten, die ausschließlich aus binären Nullen bestehende Werte enthalten. Diese benötigen genau 1 Bit.

empty-fill

Anzahl der Integer-Spalten, die nicht den gesamten Bytebereich des entsprechenden Typs besetzen. Diese werden auf einen kleineren Typ umgestellt. So kann beispielsweise eine BIGINT-Spalte (8 Byte) als TINYINT-Spalte (1 Byte) gespeichert werden, wenn alle in ihr enthaltenen Werte zwischen -128 und 127 liegen.

pre-space

Anzahl der Dezimalspalten, die mit Leerzeichen am Anfang gespeichert werden. In diesem Fall enthält jeder Wert die Anzahl dieser Leerzeichen.

end-space

Anzahl der Spalten, die viele Leerzeichen am Ende aufweisen. In diesem Fall enthält jeder Wert die Anzahl dieser Leerzeichen.

table-lookup

Die Spalte enthielt nur eine kleine Anzahl verschiedener Werte und wurde deswegen vor der Komprimierung in eine ENUM-Spalte konvertiert.

zero

Anzahl der Spalten, in der alle Werte null sind.

Original trees

Anfängliche Anzahl der Huffman-Bäume.

After join

Anzahl der separaten Huffman-Bäume, die nach dem Verknüpfen von Bäumen zum Zwecke der Speicherersparnis übrig bleiben.

Type

Der Datentyp. Der Wert kann die folgenden Deskriptoren enthalten:

Huff tree

Anzahl der mit der Spalte verknüpften Huffman-Bäume.

Bits

Anzahl der im Huffman-Baum verwendeten Bits.

--help, -?

Zeigt eine Hilfemeldung an und wird dann beendet.

--brief, -b

Erzeugt Berichte in einem einzeiligen tabellarischen Format.

--commit

Kopiert die neuen Zugriffsberechtigungen aus den Temporärtabellen in die ursprünglichen Grant-Tabellen. Damit die neuen Berechtigungen angewendet werden, müssen die Grant-Tabellen auf Festplatte synchronisiert werden. (Führen Sie hierzu etwa den Befehl mysqladmin reload aus.)

--copy

Lädt die temporären Grant-Tabellen aus den Originaltabellen.

--db=db_name, -d db_name

Gibt den Datenbanknamen an.

--debug=N

Gibt die Debugstufe an. N ist ein Integer zwischen 0 und 3.

--host=host_name, -h host_name

Der in den Zugriffsberechtigungen zu verwendende Hostname.

--howto

Zeigt einige Beispiele für die Verwendung von mysqlaccess an.

--old_server

Legt fest, dass der Server ein alter MySQL Server (vor MySQL 3.21) ist, der vollständige WHERE-Klauseln noch nicht verarbeiten kann.

--password[=password], -p[password]

Verwendet das angegebene Passwort zur Verbindung mit dem Server. Lassen Sie den Wert password auf die Option --password bzw. -p folgend weg, dann werden Sie zur Eingabe des Passworts aufgefordert.

Die Angabe eines Passworts direkt auf der Befehlszeile ist als nicht sicher einzuordnen. Siehe auch Abschnitt 5.9.6, „Wie Sie Ihre Kennwörter sicher halten“.

--plan

Zeigt Vorschläge und Ideen für zukünftige Releases an.

--preview

Zeigt die Unterschiede in den Berechtigungen nach der Durchführung von Änderungen in den Grant-Tabellen an.

--relnotes

Zeigt die Versionshinweise an.

--rhost=host_name, -H host_name

Stellt eine Verbindung zum MySQL Server auf dem angegebenen Host her.

--rollback

Macht die letzten Änderungen an den temporären Grant-Tabellen rückgängig.

--spassword[=password], -P[password]

Verwendet das angegebene Passwort zur Verbindung als Superuser mit dem Server. Lassen Sie den Wert password auf die Option --password bzw. -p folgend weg, dann werden Sie zur Eingabe des Passworts aufgefordert.

Die Angabe eines Passworts direkt auf der Befehlszeile ist als nicht sicher einzuordnen. Siehe auch Abschnitt 5.9.6, „Wie Sie Ihre Kennwörter sicher halten“.

--superuser=user_name, -U user_name

Gibt den Benutzernamen zur Verbindung als Superuser an.

--table, -t

Erzeugt Berichte im Tabellenformat.

--user=user_name, -u user_name

Der in den Zugriffsberechtigungen zu verwendende Benutzername.

--version, -v

Zeigt die Versionsinformation an und wird dann beendet.

create db_name

Erstellt eine neue Datenbank namens db_name.

debug

Weist den Server an, Debuginformationen in das Fehlerlog zu schreiben.

drop db_name

Löscht die Datenbank namens db_name und alle in ihr enthaltenen Tabellen.

extended-status

Zeigt die Serverstatusvariablen und ihre jeweiligen Werte an.

flush-hosts

Synchronisiert alle Daten in den Host-Cache.

flush-logs

Schreibt alle Logs auf Festplatte.

flush-privileges

Lädt die Grant-Tabellen neu (wie reload).

flush-status

Löscht die Statusvariablen.

flush-tables

Synchronisiert alle Tabellen auf Festplatte.

flush-threads

Synchronisiert den Thread-Cache.

kill id,id,…

Terminiert Server-Threads. Werden mehrere Thread-Kennungswerte übergeben, dann dürfen in der Liste keine Leerzeichen enthalten sein.

old-password new-password

Entspricht dem Befehl password, speichert das Passwort aber im alten (vor MySQL 4.1 verwendeten) Hashing-Format. (Siehe auch Abschnitt 5.8.9, „Kennwort-Hashing ab MySQL 4.1“.)

password new-password

Legt ein neues Passwort fest. Hierdurch wird das Passwort des Kontos, das Sie bei mysqladmin zur Verbindung mit dem Server verwenden, auf new-password gesetzt. Wenn Sie also beim nächsten Mal mysqladmin (oder ein anderes Clientprogramm) über dieses Konto aufrufen, müssen Sie das neue Passwort angeben.

Wenn der Wert new-password Leerzeichen oder andere Zeichen enthält, die von Ihrem Befehls-Interpreter als Sonderzeichen interpretiert werden, dann müssen Sie es in Anführungszeichen setzen. Dabei sind unter Windows in jedem Fall doppelte statt einfache Anführungszeichen zu benutzen, da Letztere bei der Verarbeitung nicht entfernt, sondern als Teil des Passworts betrachtet werden. Zum Beispiel:

shell> mysqladmin password "my new password"

ping

Überprüft, ob der Server ausgeführt wird. Der Rückgabestatus von mysqladmin ist 0, wenn der Server läuft, andernfalls 1. 0 ist auch im Falle eines Fehlers wie Access denied das Ergebnis, denn hierbei hat der Server die Verbindung zwar abgewiesen, wird aber trotzdem ausgeführt.

processlist

Zeigt eine Liste aktiver Server-Threads an. Dies ähnelt der Ausgabe der Anweisung SHOW PROCESSLIST. Wird die Option --verbose angegeben, dann entspricht die Ausgabe derjenigen von SHOW FULL PROCESSLIST. (Siehe auch Abschnitt 13.5.4.19, „SHOW PROCESSLIST“.)

reload

Lädt die Grant-Tabellen neu.

refresh

Synchronisiert alle Tabellen und schließt und öffnet die Logdateien.

shutdown

Beendet den Server.

start-slave

Startet die Replikation auf einem Slave-Server.

status

Zeigt eine kurze Meldung zum Serverstatus an.

stop-slave

Beendet die Replikation auf einem Slave-Server.

variables

Zeigt die Serversystemvariablen und ihre jeweiligen Werte an.

version

Zeigt Versionsinformationen vom Server an.

Uptime

Dauer seit dem Serverstart (in Sekunden).

Threads

Anzahl der aktiven Threads (Clients).

Questions

Anzahl der Abfragen, die seit dem Serverstart von Clients eingegangen sind.

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“.

Opens

Anzahl der Tabellen, die vom Server geöffnet wurden.

Flush tables

Anzahl der vom Server ausgeführten flush-*-, refresh- und reload-Befehle.

Open tables

Anzahl der derzeit offenen Tabellen.

Memory in use

Umfang des Speichers, der direkt von mysqld reserviert wurde. Der Wert wird nur angezeigt, wenn MySQL mit der Option --with-debug=full kompiliert wurde.

Maximum memory used

Maximaler Umfang des Speichers, der direkt von mysqld reserviert wurde. Der Wert wird nur angezeigt, wenn MySQL mit der Option --with-debug=full kompiliert wurde.

--help, -?

Zeigt eine Hilfemeldung an und wird dann beendet.

--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“.

--compress, -C

Komprimiert alle Daten, die zwischen Client und Server ausgetauscht werden, sofern beide die Komprimierung unterstützen.

--count=N, -c N

Anzahl der Iterationen, die für die wiederholte Befehlsausführung erforderlich sind. Funktioniert nur mit der Option --sleep.

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

Schreibt ein Debuglog. Der String debug_options heißt häufig 'd:t:o,file_name'. Standardwert ist 'd:t:o,/tmp/mysqladmin.trace'.

--default-character-set=charset_name

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

--force, -f

Fordert für den Befehl drop db_name keine Bestätigung an. Bei mehreren Befehlen erfolgt auch bei Auftreten eines Fehlers kein Abbruch.

--host=host_name, -h host_name

Stellt eine Verbindung zum MySQL Server auf dem angegebenen Host her.

--password[=password], -p[password]

Verwendet das angegebene Passwort zur Verbindung mit dem Server. Wenn Sie die Kurzform der Option (-p) verwenden, dürfen Sie kein Leerzeichen zwischen Option und Passwort setzen. Lassen Sie den Wert password auf die Option --password bzw. -p folgend weg, dann werden Sie zur Eingabe des Passworts aufgefordert.

Die Angabe eines Passworts direkt auf der Befehlszeile ist als nicht sicher einzuordnen. Siehe auch Abschnitt 5.9.6, „Wie Sie Ihre Kennwörter sicher halten“.

--port=port_num, -P port_num

Die TCP/IP-Portnummer, die für die Verbindung verwendet werden soll.

--protocol={TCP|SOCKET|PIPE|MEMORY}

Das zu verwendende Verbindungsprotokoll.

--relative, -r

Zeigt bei gemeinsamer Verwendung mit der Option --sleep den Unterschied zwischen aktuellem und vorherigem Wert. Derzeit funktioniert diese Option nur mit dem Befehl extended-status.

--silent, -s

Wenn keine Verbindung zum Server hergestellt werden kann, erfolgt eine stillschweigende Beendigung.

--sleep=delay, -i delay

Führt Befehle wiederholt aus, wobei dazwischen die mit delay angegebene Anzahl von Sekunden verstreicht. Die Option --count bestimmt die Anzahl der Iterationen.

--socket=path, -S path

Bei Verbindungen mit localhost ist dies die zu verwendende Unix-Socketdatei bzw. (unter Windows) der Name der zu verwendenden Named Pipe.

--user=user_name, -u user_name

Verwendet den angegebenen MySQL-Benutzernamen zur Verbindung mit dem Server.

--verbose, -v

Ausführlicher Modus. Es werden zusätzliche Angaben zur Tätigkeit des Programms ausgegeben.

--version, -V

Zeigt die Versionsinformation an und wird dann beendet.

--vertical, -E

Erzeugt eine vertikale Ausgabe. Dies ähnelt --relative, die Ausgabe erfolgt jedoch vertikal.

--wait[=count], -w[count]

Wenn die Verbindung nicht hergestellt werden kann, erfolgt anstelle eines Abbruchs nach einer Wartezeit ein neuer Verbindungsversuch. Wenn ein count-Wert spezifiziert wird, gibt dieser die Anzahl der Wiederholungsversuche an. Standardmäßig erfolgt genau eine Wiederholung.

connect_timeout

Maximale Anzahl der Sekunden bis zur Zeitüberschreitung der Verbindung. Der Vorgabewert ist 43.200 (12 Stunden).

shutdown_timeout

Gibt an (in Sekunden), wie lange auf das Herunterfahren des Servers gewartet wird. Der Vorgabewert ist 3.600 (1 Stunde).

--help, -?

Zeigt eine Hilfemeldung an und wird dann beendet.

--base64-output

Gibt alle Binärlogeinträge unter Verwendung der base64-Kodierung aus. Dies dient nur Debugzwecken. Logs, die mithilfe dieser Option erzeugt wurden, sollten nicht auf Produktionssysteme angewendet werden. Diese Option wurde in MySQL 5.1.5 hinzugefügt.

--database=db_name, -d db_name

Listet Einträge nur für genau diese Datenbank auf (nur lokales Log).

--force-read, -f

Mit dieser Option gibt mysqlbinlog, wenn es ein Binärlogereignis liest, das es nicht erkennt, eine Warnung aus, ignoriert das Ereignis und fährt fort. Ohne diese Option beendet sich mysqlbinlog beim Lesen eines solchen Ereignisses.

--hexdump, -H

Zeigt einen hexadezimalen Speicherauszug des Logs in Kommentaren an. Diese Ausgabe kann für das Debuggen der Replikation hilfreich sein. Das Format des hexadezimalen Speicherauszugs wird im weiteren Verlauf dieses Abschnitts beschrieben. Diese Option wurde in MySQL 5.1.2 hinzugefügt.

--host=host_name, -h host_name

Holt das Binärlog vom MySQL Server des angegebenen Hosts.

--local-load=path, -l path

Bereitet lokale Temporärdateien für LOAD DATA INFILE im angegebenen Verzeichnis vor.

--offset=N, -o N

Überspringt die ersten N Einträge im Log.

--password[=password], -p[password]

Verwendet das angegebene Passwort zur Verbindung mit dem Server. Wenn Sie die Kurzform der Option (-p) verwenden, dürfen Sie kein Leerzeichen zwischen Option und Passwort setzen. Lassen Sie den Wert password auf die Option --password bzw. -p folgend weg, dann werden Sie zur Eingabe des Passworts aufgefordert.

Die Angabe eines Passworts direkt auf der Befehlszeile ist als nicht sicher einzuordnen. Siehe auch Abschnitt 5.9.6, „Wie Sie Ihre Kennwörter sicher halten“.

--port=port_num, -P port_num

Die TCP/IP-Portnummer, die zur Verbindung mit einem entfernten Server verwendet werden soll.

--position=N, -j N

Veraltet. Verwenden Sie stattdessen --start-position.

--protocol={TCP|SOCKET|PIPE|MEMORY}

Das zu verwendende Verbindungsprotokoll.

--read-from-remote-server, -R

Liest das Binärlog von einem MySQL Server, statt eine lokale Logdatei auszulesen. Sofern diese Option nicht angegeben ist, werden auch alle weiteren Verbindungsparameteroptionen ignoriert. Diese Optionen sind --host, --password, --port, --protocol, --socket und --user.

--result-file=name, -r name

Die Ausgabe erfolgt direkt in die angegebene Datei.

--server-id=id

Extrahiert nur diejenigen Ereignisse, die vom Server mit der angegebenen Serverkennung stammen. Diese Option wurde in MySQL 5.1.4 hinzugefügt.

--short-form, -s

Zeigt nur die im Log enthaltenen Anweisungen (d. h. keine zusätzlichen Informationen) an.

--socket=path, -S path

Bei Verbindungen mit localhost ist dies die zu verwendende Unix-Socketdatei bzw. (unter Windows) der Name der zu verwendenden Named Pipe.

--start-datetime=datetime

Startet das Auslesen des Binärlogs beim ersten Ereignis, dessen Zeitstempel dem durch datetime angegebenen oder einem späteren Zeitpunkt entspricht. Der datetime-Wert ist relativ zur lokalen Zeitzone des Computers, auf dem Sie mysqlbinlog ausführen. Der Wert sollte in einem Format angegeben sein, das für die DATETIME- oder TIMESTAMP-Datentypen unterstützt wird. Zum Beispiel:

shell> mysqlbinlog --start-datetime="2005-12-25 11:25:56" binlog.000003

Diese Option ist für eine Point-in-Time-Wiederherstellung nützlich. Siehe auch Abschnitt 5.10.2, „Beispielhaftes Vorgehen zur Datensicherung und Wiederherstellung“.

--stop-datetime=datetime

Beendet das Auslesen des Binärlogs beim ersten Ereignis, dessen Zeitstempel dem durch datetime angegebenen oder einem späteren Zeitpunkt entspricht. Diese Option ist für eine Point-in-Time-Wiederherstellung nützlich. Informationen zum datetime-Wert finden Sie weiter oben in der Beschreibung zur Option --start-datetime.

--start-position=N

Startet das Auslesen des Binärlogs beim ersten Ereignis, dessen Position dem Argument N entspricht.

--stop-position=N

Beendet das Auslesen des Binärlogs beim ersten Ereignis, dessen Position N oder höher ist.

--to-last-log, -t

Beendet die Verarbeitung nicht am Ende des bei einem MySQL Server angeforderten Binärlogs, sondern fährt mit der Ausgabe bis zum Ende des letzten Binärlogs fort. Wenn Sie die Ausgabe zum selben MySQL Server leiten, kann dies eine Endlosschleife verursachen. Diese Option erfordert --read-from-remote-server.

--disable-log-bin, -D

Deaktiviert das binäre Loggen. Dies ist nützlich zur Vermeidung einer Endlosschleife, wenn Sie die Option --to-last-log verwenden und die Ausgabe an denselben MySQL Server senden. Ferner ist die Option praktisch bei der Datenwiederherstellung nach einem Absturz: Sie vermeiden hiermit eine Duplizierung der protokollierten Anweisungen.

Für diese Option benötigen Sie die Berechtigung SUPER. Sie sorgt dafür, dass mysqlbinlog in seine Ausgabe eine SET SQL_LOG_BIN=0-Anweisung einfügt, um das binäre Loggen der restlichen Ausgabe zu deaktivieren. Die SET-Anweisung wird nur dann ausgeführt, wenn Sie die Berechtigung SUPER haben.

--user=user_name, -u user_name

Verwendet den angegebenen MySQL-Benutzernamen zur Verbindung mit dem entfernten Server.

--version, -V

Zeigt die Versionsinformation an und wird dann beendet.

open_files_limit

Gibt die Anzahl der Deskriptoren für offene Dateien an, die reserviert werden müssen.

Position: Byteposition in der Logdatei.

Timestamp: Zeitstempel des Ereignisses. Im gezeigten Beispiel ist '9d fc 5c 43' die Darstellung von '051024 17:24:13' in hexadezimaler Form.

Type: Typ des Logereignisses. Im gezeigten Beispiel bedeutet '0f', dass das Beispielereignis FORMAT_DESCRIPTION_EVENT ist. Die nachfolgende Tabelle listet mögliche Typen auf.

Master ID: Serverkennung des Masters, der das Ereignis erstellt hat.

Size: Größe des Ereignisses in Byte.

Master Pos: Position des Ereignisses in der ursprünglichen Logdatei auf dem Master.

Flags: 16 Flags. Zurzeit werden die nachfolgend aufgeführten Flags verwendet. Die übrigen sind für zukünftige Verwendung reserviert.

Die übrigen Flags sind für eine zukünftige Verwendung reserviert.

--help, -?

Zeigt eine Hilfemeldung an und wird dann beendet.

--all-databases, -A

Überprüft alle Tabellen in allen Datenbanken. Dies entspricht der Option --databases bei gleichzeitiger Nennung aller Datenbanken auf der Befehlszeile.

--all-in-1, -1

Statt eine Anweisung für jede Tabelle einzeln abzusetzen, wird eine einzelne Anweisung für jede Datenbank ausgeführt, die alle zu verarbeitenden Tabellen aus dieser Datenbank benennt.

--analyze, -a

Analysiert die Tabellen.

--auto-repair

Wenn eine überprüfte Tabelle beschädigt ist, wird sie automatisch repariert. Reparaturarbeiten werden erledigt, nachdem alle Tabellen überprüft wurden.

--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“.

--check, -c

Überprüft die Tabellen auf Fehler. Dies ist die Standardoperation.

--check-only-changed, -C

Überprüft nur solche Tabellen, die seit der letzten Überprüfung geändert oder aber nicht korrekt geschlossen wurden.

--compress

Komprimiert alle Daten, die zwischen Client und Server ausgetauscht werden, sofern beide die Komprimierung unterstützen.

--databases, -B

Verarbeitet alle Tabellen in den aufgeführten Datenbanken. Normalerweise betrachtet mysqlcheck das erste Namensargument auf der Befehlszeile als Datenbank- und alle nachfolgenden Argumente als Tabellennamen. Bei dieser Option hingegen werden alle Namensargumente als Datenbanknamen behandelt.

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

Schreibt ein Debuglog. Der String debug_options heißt häufig 'd:t:o,file_name'.

--default-character-set=charset_name

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

--extended, -e

Wenn Sie diese Option zur Überprüfung von Tabellen einsetzen, ist sichergestellt, dass diese hundertprozentig konsistent sind; der Vorgang dauert allerdings sehr lange.

Wenn Sie die Option bei der Reparatur von Tabellen einsetzen, wird eine erweiterte Reparatur durchgeführt, deren Ausführung nicht nur extrem lange dauert, sondern die auch eine Menge überflüssiger Datensätze erzeugt!

--fast, -F

Überprüft nur Tabellen, die nicht ordnungsgemäß geschlossen wurden.

--force, -f

Das Programm wird auch dann fortgesetzt, wenn ein SQL-Fehler auftritt.

--host=host_name, -h host_name

Stellt eine Verbindung zum MySQL Server auf dem angegebenen Host her.

--medium-check, -m

Führt eine Überprüfung durch, die schneller ist als eine --extended-Operation. Hierdurch werden nur 99,99 Prozent aller Fehler gefunden (dies sollte allerdings in den meisten Fällen ausreichend sein).

--optimize, -o

Optimiert die Tabellen.

--password[=password], -p[password]

Verwendet das angegebene Passwort zur Verbindung mit dem Server. Wenn Sie die Kurzform der Option (-p) verwenden, dürfen Sie kein Leerzeichen zwischen Option und Passwort setzen. Lassen Sie den Wert password auf die Option --password bzw. -p folgend weg, dann werden Sie zur Eingabe des Passworts aufgefordert.

Die Angabe eines Passworts direkt auf der Befehlszeile ist als nicht sicher einzuordnen. Siehe auch Abschnitt 5.9.6, „Wie Sie Ihre Kennwörter sicher halten“.

--port=port_num, -P port_num

Die TCP/IP-Portnummer, die für die Verbindung verwendet werden soll.

--protocol={TCP|SOCKET|PIPE|MEMORY}

Das zu verwendende Verbindungsprotokoll.

--quick, -q

Wenn Sie mit dieser Option Tabellen überprüfen, wird verhindert, dass die Datensätze auf falsche Verknüpfungen geprüft werden. Dies ist die schnellste Prüfmethode.

Wenn Sie die Option bei der Reparatur von Tabellen einsetzen, wird versucht, nur den Indexbaum zu reparieren. Dies ist die schnellste Reparaturmethode.

--repair, -r

Führt eine Reparatur durch, die fast alle Fehler beheben kann. Ausgenommen sind lediglich eindeutige Schlüssel, die nicht eindeutig sind.

--silent, -s

Stummer Modus. Gibt nur Fehlermeldungen aus.

--socket=path, -S path

Bei Verbindungen mit localhost ist dies die zu verwendende Unix-Socketdatei bzw. (unter Windows) der Name der zu verwendenden Named Pipe.

--tables

Setzt die Option --databases bzw. -B außer Kraft. Alle auf die Option folgenden Namensargumente werden als Tabellennamen betrachtet.

--user=user_name, -u user_name

Verwendet den angegebenen MySQL-Benutzernamen zur Verbindung mit dem Server.

--verbose, -v

Ausführlicher Modus. Gibt Informationen zu den verschiedenen Stufen des Programmablaufs aus.

--version, -V

Zeigt die Versionsinformation an und wird dann beendet.

--help, -?

Zeigt eine Hilfemeldung an und wird dann beendet.

--add-drop-database

Fügt eine DROP DATABASE-Anweisung vor jede CREATE DATABASE-Anweisung ein.

--add-drop-table

Fügt eine DROP TABLE-Anweisung vor jede CREATE TABLE-Anweisung ein.

--add-locks

Setzt jeden Tabellenspeicherauszug zwischen eine LOCK TABLES- und eine UNLOCK TABLES-Anweisung. Hierdurch werden die Einfügevorgänge beim Neuladen der Speicherauszugsdatei beschleunigt. Siehe auch Abschnitt 7.2.16, „Geschwindigkeit von INSERT-Anweisungen“.

--all-databases, -A

Erstellt einen Speicherauszug aller Tabellen in allen Datenbanken. Dies entspricht der Option --databases bei gleichzeitiger Nennung aller Datenbanken auf der Befehlszeile.

--all-tablespaces, -Y

Fügt zum Tabellenspeicherauszug alle SQL-Anweisungen hinzu, die zur Erstellung von Tablespaces für eine NDB Cluster-Tabelle erforderlich sind. Diese Informationen können nur auf diese Weise in der Ausgabe von mysqldump angegeben werden. Die Option ist derzeit nur für MySQL-Cluster-Tabellen relevant.

Diese Option wurde in MySQL 5.1.6 hinzugefügt.

--allow-keywords

Erlaubt die Erstellung von Spaltennamen, die Schlüsselwörter sind. Dies funktioniert, indem jedem Spaltennamen der Tabellenname vorangestellt wird.

--comments[={0|1}]

Wenn 0 angegeben wird, unterdrückt die Option zusätzliche Informationen in der Speicherauszugsdatei wie etwa Programmversion, Serverversion und Host. --skip-comments hat den gleichen Effekt wie --comments=0. Der Standardwert ist 1, d. h., die genannten Informationen sind enthalten.

--compact

Erzeugt eine weniger ausführliche Ausgabe. Die Option unterdrückt Kommentare und aktiviert die Optionen --skip-add-drop-table, --no-set-names, --skip-disable-keys und --skip-add-locks.

--compatible=name

Erzeugt eine Ausgabe, bei der die Kompatibilität mit anderen Datenbanksystemen oder älteren MySQL Servern höher ist. name kann folgende Werte annehmen: ansi, mysql323, mysql40, postgresql, oracle, mssql, db2, maxdb, no_key_options, no_table_options oder no_field_options. Um mehrere Werte zu verwenden, trennen Sie diese durch Kommata. Diese Werte haben dieselbe Bedeutung wie die entsprechenden Optionen zur Einstellung des SQL-Modus am Server. Siehe auch Abschnitt 5.2.5, „Der SQL-Modus des Servers“.

Die Option garantiert keine Kompatibilität mit anderen Servern. Vielmehr aktiviert sie nur diejenigen SQL-Moduswerte, die zum gegebenen Zeitpunkt verfügbar sind, um die Kompatibilität der Speicherauszugsausgabe zu erhöhen. So führt --compatible=oracle weder eine Zuordnung von Datentypen zu Oracle-Typen durch noch wird die Oracle-Kommentarsyntax verwendet.

--complete-insert, -c

Verwendet vollständige INSERT-Anweisungen, die auch Spaltennamen enthalten.

--compress, -C

Komprimiert alle Daten, die zwischen Client und Server ausgetauscht werden, sofern beide die Komprimierung unterstützen.

--create-options

Fügt alle MySQL-spezifischen Tabellenoptionen in die CREATE TABLE-Anweisungen ein.

--databases, -B

Erstellt einen Speicherauszug mehrerer Datenbanken. Normalerweise betrachtet mysqldump das erste Namensargument auf der Befehlszeile als Datenbank- und alle nachfolgenden Argumente als Tabellennamen. Bei dieser Option werden jedoch alle Namensargumente als Datenbanknamen betrachtet. CREATE DATABASE- und USE-Anweisungen werden für jede neue Datenbank in die Ausgabe eingefügt.

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

Schreibt ein Debuglog. Der String debug_options heißt häufig 'd:t:o,file_name'. Standardwert ist 'd:t:o,/tmp/mysqldump.trace'.

--default-character-set=charset_name

Verwendet charset_name als Standardzeichensatz. Siehe auch Abschnitt 5.11.1, „Der für Daten und zum Sortieren benutzte Zeichensatz“. Sofern nicht angegeben, verwendet mysqldump utf8.

--delayed-insert

Schreibt INSERT DELAYED- statt INSERT-Anweisungen.

--delete-master-logs

Löscht auf einem Master-Replikationsserver nach Erstellung des Speicherauszugs die Binärlogs. Diese Option aktiviert automatisch --master-data.

--disable-keys, -K

Setzt bei jeder Tabelle die INSERT-Anweisungen zwischen /*!40000 ALTER TABLE tbl_name DISABLE KEYS */;- und /*!40000 ALTER TABLE tbl_name ENABLE KEYS */;-Anweisungen. Dies beschleunigt das Laden der Speicherauszugsdatei, weil die Indizes nach Einfügen aller Datensätze erstellt werden. Diese Option ist nur bei MyISAM-Tabellen wirksam.

--extended-insert, -e

Verwendet die INSERT-Syntax für mehrere Datensätze (diese enthält verschiedene VALUES-Listen). Ergebnis sind eine kleinere Speicherauszugsdatei und beschleunigte Einfügeoperationen beim Neuladen der Datei.

--fields-terminated-by=…, --fields-enclosed-by=…, --fields-optionally-enclosed-by=…, --fields-escaped-by=…, --lines-terminated-by=…

Diese Optionen werden mit der Option -T verwendet und haben dieselben Bedeutungen wie die jeweiligen Klauseln für LOAD DATA INFILE. Siehe auch Abschnitt 13.2.5, „LOAD DATA INFILE“.

--first-slave, -x

Veraltet. Heißt jetzt --lock-all-tables.

--flush-logs, -F

Synchronisiert die Logdateien des MySQL Servers auf Festplatte, bevor der Speicherauszugsvorgang gestartet wird. Diese Option erfordert die Berechtigung RELOAD. Beachten Sie, dass, wenn Sie diese Option in Verbindung mit der Option --all-databases (bzw. -A) verwenden, die Logs für jede Datenbank, für die ein Speicherauszug erstellt wird, synchronisiert werden. Eine Ausnahme liegt vor, wenn Sie --lock-all-tables oder --master-data verwenden: In diesem Fall werden die Logs nur einmal geschrieben, und zwar in dem Augenblick, in dem alle Tabellen gesperrt sind. Wenn Sie wollen, dass Speicherauszug und Logsynchronisierung im exakt gleichen Moment erfolgen, sollten Sie --flush-logs wahlweise gemeinsam mit --lock-all-tables oder --master-data verwenden.

--force, -f

Setzt die Ausführung auch dann fort, wenn ein SQL-Fehler während eines Speicherauszugsvorgangs auftritt.

--host=host_name, -h host_name

Speichert den Speicherauszug der Daten vom MySQL Server auf den angegebenen Host. Der Standardhost ist localhost.

--hex-blob

Erstellt den Speicherauszug unter Verwendung der Hexadezimalnotation (z. B. wird aus 'abc' 0x616263). Betroffen sind die Datentypen BINARY, VARBINARY, BLOB und BIT.

--lock-all-tables, -x

Sperrt datenbankübergreifend alle Tabellen. Dieses wird erreicht, indem eine globale Lesesperre für die Gesamtdauer des Speicherauszugs erwirkt wird. Die Option schaltet --single-transaction und --lock-tables automatisch ab.

--lock-tables, -l

Sperrt alle Tabellen vor Beginn des Speicherauszugs. Die Tabellen werden im Falle von MyISAM-Tabellen mit READ LOCAL gesperrt, um nebenläufige Einfügeoperationen durchführen zu können. Bei transaktionssicheren Tabellen wie InnoDB und BDB ist --single-transaction eine wesentlich bessere Option, denn sie erfordert überhaupt kein Sperren der Tabellen.

Beachten Sie, dass, wenn Sie Speicherauszüge mehrerer Datenbanken erstellen, --lock-tables die Tabellen für jede Datenbank separat sperrt. Insofern stellt diese Option nicht sicher, dass die Tabellen in der Speicherauszugsdatei datenbankübergreifend logisch konsistent sind. Die Tabellen in verschiedenen Datenbanken, von denen ein Speicherauszug erstellt wird, befinden sich unter Umständen in vollkommen unterschiedlichen Zuständen.

--master-data[=value]

Schreibt Dateinamen und Position des Binärlogs in die Ausgabe. Diese Option erfordert die Berechtigung RELOAD, und das Binärlog muss aktiviert sein. Wenn der Optionswert 1 ist, werden Position und Dateiname in die Form einer CHANGE MASTER-Anweisung in die Ausgabe des Speicherauszugs geschrieben. Dies ermöglicht den Start eines Slave-Servers an der korrekten Position in den Binärlogs des Masters, wenn Sie diesen SQL-Speicherauszug des Masters zur Konfiguration eines Slaves einsetzen. Wenn der Optionswert 2 ist, dann wird die CHANGE MASTER-Anweisung als SQL-Kommentar geschrieben. Dies ist auch die Standardaktion, wenn value nicht angegeben wird.

Die Option --master-data aktiviert --lock-all-tables, sofern --single-transaction nicht ebenfalls angegeben ist (in diesem Fall wird eine globale Lesesperre nur für einen kurzen Zeitraum zum Beginn des Speicherauszugsvorgangs erwirkt). (Siehe auch die Beschreibung zu --single-transaction.) In allen Fällen erfolgen Vorgänge an Logs im exakten Moment des Speicherauszugs. Die Option schaltet --lock-tables automatisch ab.

--no-create-db, -n

Diese Option unterdrückt die CREATE DATABASE-Anweisungen, die andernfalls in der Ausgabe enthalten wären, wenn die Optionen --databases oder --all-databases angegeben wurden.

--no-create-info, -t

Es werden keine CREATE TABLE-Anweisungen geschrieben, die jede gespeicherte Tabelle neu erstellen.

--no-data, -d

Schreibt keine Datensatzinformationen für die Tabelle. Dies ist recht nützlich, wenn Sie einen Speicherauszug nur für die CREATE TABLE-Anweisung für die Tabelle erstellen wollen.

--opt

Dies ist eine Kurzform, die für folgende Option steht: --add-drop-table --add-locks --create-options --disable-keys --extended-insert --lock-tables --quick --set-charset. Ergebnis sollte ein schneller Speicherauszugsprozess sein, an dessen Ende eine Speicherauszugsdatei steht, die problemlos in einen MySQL Server eingeladen werden kann.

Standardmäßig ist diese Option aktiviert, kann aber mit --skip-opt deaktiviert werden. Um nur einige der mit --opt aktivierten Optionen zu deaktivieren, verwenden Sie die entsprechenden --skip-Optionen (z. B. --skip-add-drop-table oder --skip-quick).

--password[=password], -p[password]

Verwendet das angegebene Passwort zur Verbindung mit dem Server. Wenn Sie die Kurzform der Option (-p) verwenden, dürfen Sie kein Leerzeichen zwischen Option und Passwort setzen. Lassen Sie den Wert password auf die Option --password bzw. -p folgend weg, dann werden Sie zur Eingabe des Passworts aufgefordert.

Die Angabe eines Passworts direkt auf der Befehlszeile ist als nicht sicher einzuordnen. Siehe auch Abschnitt 5.9.6, „Wie Sie Ihre Kennwörter sicher halten“.

--port=port_num, -P port_num

Die TCP/IP-Portnummer, die für die Verbindung verwendet werden soll.

--protocol={TCP|SOCKET|PIPE|MEMORY}

Das zu verwendende Verbindungsprotokoll.

--quick, -q

Diese Option ist nützlich, um einen Speicherauszug großer Tabellen zu erstellen. Hier wird mysqldump gezwungen, die Datensätze für eine Tabelle datensatzweise vom Server abzurufen, statt vor dem Schreiben die gesamte Ergebnismenge zu holen und sie temporär im Speicher abzulegen.

--quote-names, -Q

Setzt Datenbank-, Tabellen- und Spaltennamen in ‘`’-Zeichen. Wenn der SQL-Modus ANSI_QUOTES aktiviert ist, werden die Namen in die ‘"’-Anführungszeichen gesetzt. Die Option ist standardmäßig aktiviert. Sie kann mit --skip-quote-names deaktiviert werden, aber diese Option sollte nach anderen Optionen wie etwa --compatible angegeben werden, mit denen --quote-names aktiviert werden könnte.

--replace

Schreibt REPLACE- statt INSERT-Anweisungen. Wurde in MySQL 5.1.3 hinzugefügt.

--result-file=file, -r file

Die Ausgabe erfolgt direkt in die angegebene Datei. Diese Option sollte unter Windows benutzt werden, um die Konvertierung von Zeilenumbrüchen (‘\n’) in Folgen von Absatzschaltung und Zeilenumbruch (‘\r\n’) zu verhindern.

--routines, -R

Erstellt einen Speicherauszug gespeicherter Routinen (Funktionen und Prozeduren) aus Datenbankspeicherauszügen. Die mit ---routines erzeugte Ausgabe enthält CREATE PROCEDURE- und CREATE FUNCTION-Anweisungen zur Neuerstellung der Routinen. Allerdings enthalten diese Anweisungen keine Attribute wie die Routinendefinition oder die Zeitstempel für Erstellung und Änderung. Das bedeutet, dass die Routinen, wenn sie neu geladen werden, mit dem Definitionssatz für den neu ladenden Benutzer und den Zeitstempeln für den Zeitpunkt des Neuladens erstellt werden.

Wenn Sie Routinen benötigen, die mit den Originalattributen für Definition und Zeitstempel neu erstellt wurden, verwenden Sie --routines nicht. Stattdessen erstellen Sie unter Verwendung eines MySQL-Kontos, das die erforderlichen Berechtigungen für die Datenbank mysql hat, direkt einen Speicherauszug des Inhalts der Tabelle mysql.proc und laden diesen Inhalt dann neu.

Diese Option wurde in MySQL 5.1.2 hinzugefügt. Zuvor war ein Speicherauszug gespeicherter Routinen nicht möglich.

--set-charset

Fügt SET NAMES default_character_set zur Ausgabe hinzu. Die Option ist standardmäßig aktiviert. Um die SET NAMES-Anweisung zu unterdrücken, verwenden Sie --skip-set-charset.

--single-transaction

Diese Option setzt eine SQL-Anweisung BEGIN ab, bevor der Speicherauszug vom Server durchgeführt wird. Sie ist nur bei transaktionssicheren Tabellen wie InnoDB und BDB nützlich, denn der Speicherauszug spiegelt den konsistenten Zustand der Datenbank zu dem Zeitpunkt wider, an dem BEGIN abgesetzt wurde, ohne dass Anwendungen gesperrt werden.

Wenn Sie diese Option verwenden, sollten Sie beachten, dass ein Speicherauszug nur von InnoDB-Tabellen in einem konsistenten Zustand erstellt werden kann. MyISAM- oder HEAP-Tabellen, für die unter Verwendung dieser Option ein Speicherauszug erstellt wird, können ihren Zustand trotzdem noch ändern.

Die Optionen --single-transaction und --lock-tables schließen sich gegenseitig aus, weil LOCK TABLES implizit das Schreiben anhängiger Transaktionen auslöst.

Um Speicherauszüge großer Tabellen zu erstellen, sollten Sie diese Option mit --quick kombinieren.

--socket=path, -S path

Bei Verbindungen mit localhost ist dies die zu verwendende Unix-Socketdatei bzw. (unter Windows) der Name der zu verwendenden Named Pipe.

--skip-comments

Siehe Beschreibung zu --comments.

--tab=path, -T path

Erzeugt tabulatorgetrennte Datendateien. Für jede Tabelle, für die ein Speicherauszug erstellt wurde, erzeugt mysqldump eine tbl_namesql-Datei, welche die CREATE TABLE-Anweisung, mit der die Tabelle erstellt wird, enthält, und eine tbl_name.txt mit den Daten dieser Tabelle. Der Optionswert ist das Verzeichnis, in das die Dateien geschrieben werden.

Standardmäßig werden die .txt-Datendateien mit Tabulatorzeichen zwischen den Spaltenwerten und einem Zeilenumbruch am Ende jeder Zeile formatiert. Das Format kann aber auch explizit mit den Optionen --fields-xxx und --lines--xxx angegeben werden.

Hinweis: Diese Option sollte nur dann verwendet werden, wenn mysqldump auf demselben Computer läuft wie der Server mysqld. Sie benötigen die Berechtigung FILE, und der Server muss eine Berechtigung zum Schreiben von Dateien in das von Ihnen angegebene Verzeichnis haben.

--tables

Setzt die Option --databases bzw. -B außer Kraft. Alle auf die Option folgenden Namensargumente werden als Tabellennamen betrachtet.

--triggers

Erstellt einen Speicherauszug für Trigger für jede Tabelle, für die ein Speicherauszug erstellt wurde. Die Option ist standardmäßig aktiviert. Sie können sie mithilfe von --skip-triggers deaktivieren.

--tz-utc

Fügt SET TIME_ZONE='+00:00' zur Speicherauszugsdatei hinzu, sodass TIMESTAMP-Spalten in den Speicherauszug integriert und dann auch auf Server in anderen Zeitzonen geladen werden können. Ohne diese Option werden TIMESTAMP-Spalten in den Zeitzonen gespeichert und geladen, die für den Quell- bzw. Zielserver lokal sind; dies kann Werteänderungen zur Folge haben. Außerdem schützt --tz-utc gegen sommerzeitbedingte Änderungen. --tz-utc ist standardmäßig aktiviert. Um es zu deaktivieren, verwenden Sie --skip-tz-utc. Diese Option wurde in MySQL 5.1.2 hinzugefügt.

--user=user_name, -u user_name

Verwendet den angegebenen MySQL-Benutzernamen zur Verbindung mit dem Server.

--verbose, -v

Ausführlicher Modus. Es werden zusätzliche Angaben zu den Aktivitäten des Programms ausgegeben.

--version, -V

Zeigt die Versionsinformation an und wird dann beendet.

--where='where_condition', -w 'where_condition'

Fügt nur diejenigen Datensätze in den Speicherauszug ein, die aufgrund der WHERE-Bedingung ausgewählt werden. Beachten Sie, dass die Bedingung zwingend in Anführungszeichen gesetzt werden muss, wenn sie Leerzeichen oder andere Zeichen enthält, die Ihr Befehls-Interpreter als Sonderzeichen interpretiert.

Ein paar Beispiele:

--where="user='jimf'"
-w"userid>1"
-w"userid<1"

--xml, -X

Schreibt die Ausgabe des Speicherauszugs als sauber formatiertes XML.

max_allowed_packet

Maximale Größe des Puffers für die Client/Server-Kommunikation. Der Maximalwert beträgt 1 Gbyte.

net_buffer_length

Ausgangsgröße des Puffers für die Client/Server-Kommunikation. Wenn Sie Einfügeanweisungen für mehrere Datensätze (wie etwa mit den Optionen --extended-insert oder --opt) erstellen, legt mysqldump Datensätze an, deren maximale Länge durch net_buffer_length festgelegt ist. Wenn Sie den Wert dieser Variablen erhöhen, sollten Sie auch sicherstellen, dass die Variable net_buffer_length am MySQL Server mindestens genauso groß ist.

--help, -?

Zeigt eine Hilfemeldung an und wird dann beendet.

--addtodest

Benennt das Zielverzeichnis (sofern vorhanden) nicht um, sondern fügt nur Dateien hinzu.

--allowold

Bricht nicht ab, wenn das Ziel vorhanden ist, sondern benennt es durch Anhängen des Suffix _old um.

--checkpoint=db_name.tbl_name

Fügt Prüfpunkteinträge in die angegebene Datenbank db_name und Tabelle tbl_name ein.

--chroot=path

Basisverzeichnis des chroot-Käfigs, auf dem mysqld läuft. Der Wert path sollte mit dem der Option --chroot übereinstimmen, die für mysqld angegeben wurde.

--debug

Aktiviert die Debugausgabe.

--dryrun, -n

Meldet Aktionen, ohne sie auszuführen.

--flushlog

Synchronisiert Logs, nachdem alle Tabellen gesperrt wurden.

--host=host_name, -h host_name

Hostname des lokalen Hosts, der zur Herstellung einer TCP/IP-Verbindung zum lokalen Server verwendet wird. Standardmäßig erfolgt die Verbindung zu localhost über eine Unix-Socketdatei.

--keepold

Gibt an, dass das vorherige (umbenannte) Ziel nach Abschluss nicht gelöscht wird.

--method=command

Methode zum Kopieren von Dateien (cp oder scp).

--noindices

Gibt an, dass vollständige Indexdateien nicht Bestandteil der Sicherung sind. Hierdurch wird die Sicherung beschleunigt, und die Backup-Datei wird kleiner. Die Indizes der neu geladenen Tabellen lassen sich später mit myisamchk -rq rekonstruieren.

--password=password, -ppassword

Verwendet das angegebene Passwort zur Verbindung mit dem Server. Beachten Sie, dass der Passwortwert – anders als bei anderen MySQL-Programmen – bei dieser Option nicht optional ist. Wenn Sie das Passwort nicht auf der Befehlszeile angeben wollen, können Sie auch eine Optionsdatei verwenden.

Die Angabe eines Passworts direkt auf der Befehlszeile ist als nicht sicher einzuordnen. Siehe auch Abschnitt 5.9.6, „Wie Sie Ihre Kennwörter sicher halten“.

--port=port_num, -P port_num

Die TCP/IP-Portnummer, die zur Verbindung mit dem lokalen Server verwendet werden soll.

--quiet, -q

Stummer Modus (außer bei Fehlern).

--record_log_pos=db_name.tbl_name

Zeichnet den Status von Master und Slave in der angegebenen Datenbank db_name und Tabelle tbl_name auf.

--regexp=expr

Kopiert alle Datenbanken, deren Namen dem angegebenen regulären Ausdruck entsprechen.

--resetmaster

Setzt das Binärlog nach Sperren aller Tabellen zurück.

--resetslave

Setzt die Datei master.info nach Sperren aller Tabellen zurück.

--socket=path, -S path

Unix-Socketdatei, die für die Verbindung verwendet werden soll.

--suffix=str

Suffix für Namen kopierter Datenbanken.

--tmpdir=path

Das Temporärverzeichnis. Vorgabe ist /tmp.

--user=user_name, -u user_name

Verwendet den angegebenen MySQL-Benutzernamen zur Verbindung mit dem Server.

--help, -?

Zeigt eine Hilfemeldung an und wird dann beendet.

--columns=column_list, -c column_list

Diese Option nimmt eine kommagetrennte Liste der Spaltennamen als Wert entgegen. Die Reihenfolge der Spaltennamen gibt an, wie die Spalten in der Datendatei den Tabellenspalten zuzuordnen sind.

--compress, -C

Komprimiert alle Daten, die zwischen Client und Server ausgetauscht werden, sofern beide die Komprimierung unterstützen.

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

Schreibt ein Debuglog. Der String debug_options heißt häufig 'd:t:o,file_name'.

--delete, -D

Leert die Tabelle vor dem Import der Textdatei.

--fields-terminated-by=…, --fields-enclosed-by=…, --fields-optionally-enclosed-by=…, --fields-escaped-by=…, --lines-terminated-by=…

Diese Optionen haben dieselbe Bedeutung wie die entsprechenden Klauseln für LOAD DATA INFILE. Siehe auch Abschnitt 13.2.5, „LOAD DATA INFILE“.

--force, -f

Ignoriert Fehler. Wenn beispielsweise eine Tabelle für eine Textdatei nicht vorhanden ist, wird ggf. mit der Verarbeitung weiterer vorhandener Dateien fortgefahren. Ohne --force wird mysqlimport beendet, wenn eine Tabelle nicht vorhanden ist.

--host=host_name, -h host_name

Importiert Daten in den MySQL Server auf dem angegebenen Host. Der Standardhost ist localhost.

--ignore, -i

Siehe Beschreibung zu --replace.

--ignore-lines=N

Ignoriert die ersten N Zeilen der Datendatei.

--local, -L

Liest die Eingabedateien lokal vom Clienthost.

--lock-tables, -l

Sperrt alle Tabellen für Schreiboperationen, bevor mit der Verarbeitung der Textdateien begonnen wird. Hierdurch ist sichergestellt, dass alle Tabellen auf dem Server synchronisiert sind.

--password[=password], -p[password]

Verwendet das angegebene Passwort zur Verbindung mit dem Server. Wenn Sie die Kurzform der Option (-p) verwenden, dürfen Sie kein Leerzeichen zwischen Option und Passwort setzen. Lassen Sie den Wert password auf die Option --password bzw. -p folgend weg, dann werden Sie zur Eingabe des Passworts aufgefordert.

Die Angabe eines Passworts direkt auf der Befehlszeile ist als nicht sicher einzuordnen. Siehe auch Abschnitt 5.9.6, „Wie Sie Ihre Kennwörter sicher halten“.

--port=port_num, -P port_num

Die TCP/IP-Portnummer, die für die Verbindung verwendet werden soll.

--protocol={TCP|SOCKET|PIPE|MEMORY}

Das zu verwendende Verbindungsprotokoll.

--replace, -r

Die Optionen --replace und --ignore steuern den Umgang mit eingegebenen Datensätzen, die Duplikate vorhandener Datensätze mit eindeutigen Schlüsselwerten darstellen. Wenn Sie --replace angeben, ersetzen die neuen die vorhandenen Datensätze, die denselben eindeutigen Schlüsselwert aufweisen. Bei Angabe von --ignore hingegen werden neue Datensätze, deren eindeutiger Schlüsselwert bereits einem vorhandenen Datensatz zugewiesen ist, ignoriert. Geben Sie keine Option an, dann tritt ein Fehler auf, wenn ein doppelter Schlüsselwert gefunden wird; in diesem Fall wird der Rest der Textdatei ignoriert.

--silent, -s

Stummer Modus. Eine Ausgabe erfolgt nur, wenn ein Fehler auftritt.

--socket=path, -S path

Bei Verbindungen mit localhost ist dies die zu verwendende Unix-Socketdatei bzw. (unter Windows) der Name der zu verwendenden Named Pipe.

--user=user_name, -u user_name

Verwendet den angegebenen MySQL-Benutzernamen zur Verbindung mit dem Server.

--verbose, -v

Ausführlicher Modus. Es werden zusätzliche Angaben zu den Aktivitäten des Programms ausgegeben.

--version, -V

Zeigt die Versionsinformation an und wird dann beendet.

Wenn keine Datenbank angegeben wird, erscheint eine Liste aller Datenbanknamen.

Wird keine Tabelle angegeben, dann werden alle passenden Tabellen in der Datenbank angezeigt.

Wird keine Spalte angegeben, dann werden alle passenden Spalten und Spaltentypen in der Tabelle angezeigt.

--help, -?

Zeigt eine Hilfemeldung an und wird dann beendet.

--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“.

--compress, -C

Komprimiert alle Daten, die zwischen Client und Server ausgetauscht werden, sofern beide die Komprimierung unterstützen.

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

Schreibt ein Debuglog. Der String debug_options heißt häufig 'd:t:o,file_name'.

--default-character-set=charset_name

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

--host=host_name, -h host_name

Stellt eine Verbindung zum MySQL Server auf dem angegebenen Host her.

--keys, -k

Zeigt die Tabellenindizes an.

--password[=password], -p[password]

Verwendet das angegebene Passwort zur Verbindung mit dem Server. Wenn Sie die Kurzform der Option (-p) verwenden, dürfen Sie kein Leerzeichen zwischen Option und Passwort setzen. Lassen Sie den Wert password auf die Option --password bzw. -p folgend weg, dann werden Sie zur Eingabe des Passworts aufgefordert.

Die Angabe eines Passworts direkt auf der Befehlszeile ist als nicht sicher einzuordnen. Siehe auch Abschnitt 5.9.6, „Wie Sie Ihre Kennwörter sicher halten“.

--port=port_num, -P port_num

Die TCP/IP-Portnummer, die für die Verbindung verwendet werden soll.

--protocol={TCP|SOCKET|PIPE|MEMORY}

Das zu verwendende Verbindungsprotokoll.

--show-table-type

Zeigt eine Spalte an, die den Tabellentyp angibt (wie bei SHOW FULL TABLES). Der Typ ist BASE TABLE oder VIEW.

--socket=path, -S path

Bei Verbindungen mit localhost ist dies die zu verwendende Unix-Socketdatei bzw. (unter Windows) der Name der zu verwendenden Named Pipe.

--status, -i

Zeigt zusätzliche Informationen zu jeder Tabelle an.

--user=user_name, -u user_name

Verwendet den angegebenen MySQL-Benutzernamen zur Verbindung mit dem Server.

--verbose, -v

Ausführlicher Modus. Es werden zusätzliche Angaben zu den Aktivitäten des Programms ausgegeben. Diese Option kann mehrfach verwendet werden, um den Umfang der angezeigten Informationen zu erhöhen.

--version, -V

Zeigt die Versionsinformation an und wird dann beendet.

--help, -?

Zeigt eine Hilfemeldung an und wird dann beendet.

--auto-generate-sql, -a

Erzeugt automatisch SQL-Anweisungen, wenn diese nicht in Dateien oder als Befehlsoptionen übergeben wurden.

--compress, -C

Komprimiert alle Daten, die zwischen Client und Server ausgetauscht werden, sofern beide die Komprimierung unterstützen.

--concurrency, -c

Anzahl der zu simulierenden Clients beim Absetzen der SELECT-Anweisung.

--create=value

Datei oder String, der bzw. die zur Erstellung der Tabelle verwendet wird.

--create-schema=value

Schema, in dem die Tests ausgeführt werden. Diese Option wurde in MySQL 5.1.5 hinzugefügt.

--csv[=file]

Erzeugt eine Ausgabe von Werten in kommagetrennter Form. Die Ausgabe erfolgt in die angegebene Datei oder, wenn keine Datei angegeben ist, in die Standardausgabe. Diese Option wurde in MySQL 5.1.5 hinzugefügt.

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

Schreibt ein Debuglog. Der String debug_options heißt häufig 'd:t:o,file_name'.

--delimiter=str, -F str

Trennzeichen, das in SQL-Anweisungen verwendet wird, die in Dateien oder über Befehlsoptionen angegeben werden.

--engine=engine_name, -e engine_name

Speicher-Engine, die zur Erstellung der Tabelle verwendet wird.

--host=host_name, -h host_name

Stellt eine Verbindung zum MySQL Server auf dem angegebenen Host her.

--iterations=N, -i N

Häufigkeit, mit der die Tests durchgeführt werden.

--lock-directory=path

Verzeichnis, das zur Speicherung von Sperren verwendet wird. Diese Option wurde in MySQL 5.1.5 hinzugefügt.

--number-char-cols=N, -x N

Anzahl der VARCHAR-Spalten, die verwendet werden, wenn --auto-generate-sql angegeben ist.

--number-int-cols=N, -y N

Anzahl der INT-Spalten, die verwendet werden, wenn --auto-generate-sql angegeben ist.

--number-of-queries=N

Anzahl der Abfragen, auf die jeder Client ungefähr beschränkt wird. Diese Option wurde in MySQL 5.1.5 hinzugefügt.

--only-print

Stellt keine Verbindung mit Datenbanken her. mysqlslap gibt dann nur aus, was es gemacht hätte. Diese Option wurde in MySQL 5.1.5 hinzugefügt.

--password[=password], -p[password]

Verwendet das angegebene Passwort zur Verbindung mit dem Server. Wenn Sie die Kurzform der Option (-p) verwenden, dürfen Sie kein Leerzeichen zwischen Option und Passwort setzen. Lassen Sie den Wert password auf die Option --password bzw. -p folgend weg, dann werden Sie zur Eingabe des Passworts aufgefordert.

Die Angabe eines Passworts direkt auf der Befehlszeile ist als nicht sicher einzuordnen. Siehe auch Abschnitt 5.9.6, „Wie Sie Ihre Kennwörter sicher halten“.

--port=port_num, -P port_num

Die TCP/IP-Portnummer, die für die Verbindung verwendet werden soll.

--protocol={TCP|SOCKET|PIPE|MEMORY}

Das zu verwendende Verbindungsprotokoll.

--preserve-schema

Behält das Schema der mysqlslap-Ausführung bei. Diese Option wurde in MySQL 5.1.5 hinzugefügt.

--query=value, -q value

Datei oder String, der bzw. die die SELECT-Anweisung enthält, die zum Abrufen von Daten verwendet wird.

--silent, -s

Stummer Modus. Es erfolgt keine Ausgabe.

--skip-query, -Q

Führt keine SELECT-Anweisungen aus.

--slave

Folgt den Master-Sperren für andere mysqlslap-Clients. Verwenden Sie diese Option, wenn Sie die Synchronisation zu einem Master-Server mit --lock-directory und NFS beabsichtigen. Diese Option wurde in MySQL 5.1.5 hinzugefügt.

--socket=path, -S path

Bei Verbindungen mit localhost ist dies die zu verwendende Unix-Socketdatei bzw. (unter Windows) der Name der zu verwendenden Named Pipe.

--use-threads

Unter Unix werden standardmäßig fork()-Aufrufe verwendet. Bei dieser Option werden stattdessen pthread-Aufrufe benutzt. Unter Windows werden pthread-Aufrufe ohnehin standardmäßig verwendet, d. h., die Option hat keine Auswirkungen. Diese Option wurde in MySQL 5.1.6 hinzugefügt.

--user=user_name, -u user_name

Verwendet den angegebenen MySQL-Benutzernamen zur Verbindung mit dem Server.

--verbose, -v

Ausführlicher Modus. Es werden zusätzliche Angaben zu den Aktivitäten des Programms ausgegeben.

--version, -V

Zeigt die Versionsinformation an und wird dann beendet.

--help, -?, -I

Zeigt eine Hilfemeldung an und wird dann beendet.

-f

Erzwingungsmodus. mysql_zap versucht, jeden Prozess zu terminieren, ohne eine Bestätigung anzufordern.

-t

Testmodus. Zeigt Informationen zu allen Prozessen an, terminiert sie aber nicht.

--help, --info, -I, -?

Zeigt eine Hilfemeldung an und wird dann beendet.

--ndb

Gibt die Fehlermeldung für einen MySQL-Cluster-Fehlercode aus.

--silent, -s

Stummer Modus. Gibt nur die Fehlermeldung aus.

--verbose, -v

Ausführlicher Modus. Gibt den Fehlercode und die Fehlermeldung aus. Dies ist das Standardverhalten.

--version, -V

Zeigt die Versionsinformation an und wird dann beendet.

-?, -I

Zeigt eine Hilfemeldung an und wird dann beendet.

-# debug_options

Schreibt ein Debuglog. Der String debug_options heißt häufig 'd:t:o,file_name'.

-s

Stummer Modus. Es werden weniger Angaben zu den Aktivitäten des Programms ausgegeben.

-v

Ausführlicher Modus. Es werden zusätzliche Angaben zu den Aktivitäten des Programms ausgegeben.

-V

Zeigt die Versionsinformation an und wird dann beendet.