Ein Name muss aus alphanumerischen Zeichen des aktuellen Zeichensatzes bestehen und darf darüber hinaus ‘_’ und ‘$’ enthalten. Der vorgabemäßige Zeichensatz ist ISO-8859-1 Latin1; dass kann durch die --default-character-set-Option für mysqld geändert werden. See Abschnitt 5.6.1, „Der für Daten und Sortieren benutzte Zeichensatz“.

Ein Name kann mit jedem Zeichen anfangen, das in einem Namen erlaubt ist. Insbesondere kann ein Name auch mit einer Zahl anfangen (das ist in vielen anderen Datenbanksystemen anders!). Jedoch kann ein Namen nicht nur aus Zahlen bestehen.

Sie können das ‘.’-Zeichen in Namen nicht benutzen, weil es benutzt wird, um das Format zu erweitern, mit dem man auf Spalten verweisen kann (siehe unten).

Einfache und doppelte Anführungszeichen werden genommen, um den Anfang einer Zeichenkette zu bestimmen, selbst innerhalb eines Kommentars. Wenn die Zeichenkette nicht durch ein zweites Anführungszeichen innerhalb des Kommentars abgeschlossen wird, bemerkt der Parser nicht, dass der Kommentar zuende ist. Wenn Sie mysql interaktiv ausführen, sehen Sie, dass mysql verwirrt ist, weil sich die Eingabeaufforderung von mysql> zu to '> oder "> ändert.

Ein Semikolon wird genommen, um das Ende des aktuellen SQL-Statements kenntlich zu machen. Alles Folgende wird als Anfang des nächsten Statements aufgefasst.

ACTION

BIT

DATE

ENUM

NO

TEXT

TIME

TIMESTAMP

MySQL ruft Werte für einen gegebenen Datums- oder Zeit-Typ in einem Standard-Format ab, versucht aber, eine Vielzahl von Formaten zu interpretieren, die Sie bereit stellen (wenn Sie zum Beispiel einen Wert angeben, der zugewiesen oder mit einem Datums- oder Zeit-Typ verglichen werden soll). Dennoch werden nur die in den folgenden Abschnitten beschriebenen Formate unterstützt. Es wird davon ausgegangen, dass Sie zulässige Werte bereitstellen; und es können unvorhersehbare Ergebnisse zustande kommen, wenn Sie Werte in anderen Formaten angeben.

Obwohl MySQL versucht, Werte in verschiedenen Formaten zu interpretieren, erwartet er immer, dass der Jahresanteil von Datumswerten ganz links steht. Datumsangaben müssen in der Reihenfolge Jahr - Monat - Tag gemacht werden (zum Beispiel '98-09-04') statt in der Reihenfolge Monat - Tag - Jahr oder Tag - Monat - Jahr, die anderswo häufig gebraucht werden (zum Beispiel '09-04-98', '04-09-98').

MySQL wandelt einen Datums- oder Zeitwert automatisch in eine Zahl um, wenn der Wert in einem numerischen Zusammenhang benutzt wird, und umgekehrt.

Wenn MySQL auf einen Datums- oder Zeitwert trifft, der ausserhalb des Wertebereichs oder in sonstiger Weise für den Typ nicht zulässig ist (siehe Anfang dieses Abschnitts), wird der Wert zum ``0''-Wert dieses Typs umgewandelt. (Die Ausnahme ist, dass TIME-Werte ausserhalb des Wertebereichs auf den entsprechenden Endpunkt des TIME-Wertebereichs abgeschnitten werden.) Die unten stehende Tabelle zeigt das Format des ``0''-Werts für jeden Typ:

Die ``0''-Werte sind speziell, aber Sie können diese explizit speichern oder auf sie verweisen, indem Sie die in der Tabelle dargestellten Werte benutzen. Sie können das auch mit den Werten '0' oder 0 machen, die leichter zu schreiben sind.

``0''-Datums- oder -Zeitwerte, die über MyODBC benutzt werden, werden in MyODBC-Version 2.50.12 und höher automatisch in NULL umgewandelt, weil ODBC solche Werte nicht handhaben kann.

ASCII(zeichenkette)

Gibt den ASCII-Code-Wert des äußersten linken Zeichens der Zeichenkette zeichenkette zurück. Gibt 0 zurück, wenn zeichenkette die leere Zeichenkette ist. Gibt NULL zurück, wenn zeichenkette NULL ist:

mysql> select ASCII('2');
        -> 50
mysql> select ASCII(2);
        -> 50
mysql> select ASCII('dx');
        -> 100

Siehe auch ORD()-Funktion.

ORD(zeichenkette)

Wenn das äußerste linke Zeichen der Zeichenkette zeichenkette ein Multi-Byte-Zeichen ist, gibt diese Funktion den Code des Multi-Byte-Zeichens zurück, indem der ASCII-Code-Wert des Zeichens in folgendem Format zurückgegeben wird: ((erstes byte ASCII code)*256+(zweites byte ASCII code))[*256+drittes byte ASCII code...]. Wenn das äußerste linke Zeichen kein Multi-Byte-Zeichen ist, wird derselbe Wert wie bei der ASCII()-Funktion zurückgegeben:

mysql> select ORD('2');
        -> 50

CONV(N,von_basis,zu_basis)

Wandelt Zahlen zwischen verschiedenen Zahlsystemen um. Gibt eine Zeichenkettendarstellung der Zahl N zurück, umgewandelt von Basis von_basis zu Basis zu_basis. Gibt NULL zurück, wenn irgend ein Argument NULL ist. Das Argument N wird als Ganzzahl interpretiert, kann aber als Ganzzahl oder Zeichenkette angegeben werden. Die kleinste Basis ist 2 und die größte Basis 36. Wenn zu_basis eine negative Zahl ist, wird N als vorzeichenbehaftete Zahl betrachtet. Ansonsten wird N als vorzeichenlos behandelt. CONV arbeitet mit 64-Bit-Genauigkeit:

mysql> select CONV("a",16,2);
        -> '1010'
mysql> select CONV("6E",18,8);
        -> '172'
mysql> select CONV(-17,10,-18);
        -> '-H'
mysql> select CONV(10+"10"+'10'+0xa,10,10);
        -> '40'

BIN(N)

Gibt eine Zeichenkettendarstellung des Binärwerts von N zurück, wobei N eine BIGINT-Zahl ist. Das ist äquivalent zu CONV(N,10,2). Gibt NULL zurück, wenn N NULL ist:

mysql> select BIN(12);
        -> '1100'

OCT(N)

Gibt eine Zeichenkettendarstellung des Oktalwerts von N zurück, wobei N eine BIGINT-Zahl ist. Das ist äquivalent zu CONV(N,10,8). Gibt NULL zurück, wenn N NULL ist:

mysql> select OCT(12);
        -> '14'

HEX(N)

Gibt eine Zeichenkettendarstellung des hexadezimalen Werts von N zurück, wobei N eine BIGINT-Zahl ist. Das ist äquivalent zu CONV(N,10,16). Gibt NULL zurück, wenn N NULL ist:

mysql> select HEX(255);
        -> 'FF'

CHAR(N,...)

CHAR() interpretiert die Argumente als Ganzzahlen und gibt eine Zeichenkette zurück, die aus den Zeichen besteht, die durch die ASCII-Code-Werte dieser Ganzzahlen gegeben sind. NULL-Werte werden übersprungen:

mysql> select CHAR(77,121,83,81,'76');
        -> 'MySQL'
mysql> select CHAR(77,77.3,'77.3');
        -> 'MMM'

CONCAT(zeichenkette1,zeichenkette2,...)

Gibt die Zeichenkette zurück, die durch die Verkettung der Argumente entsteht. Gibt NULL zurück, wenn irgend ein Argument NULL ist. Kann mehr als 2 Argumente haben. Ein numerisches Argument wird in die äquivalente Zeichenkettenform umgewandelt:

mysql> select CONCAT('My', 'S', 'QL');
        -> 'MySQL'
mysql> select CONCAT('My', NULL, 'QL');
        -> NULL
mysql> select CONCAT(14.3);
        -> '14.3'

CONCAT_WS(trennzeichen, zeichenkette1, zeichenkette2,...)

CONCAT_WS() steht für CONCAT mit Trennzeichen und ist eine spezielle Form von CONCAT(). Das erste Argument ist das Trennzeichen für die restlichen Argumente. Das Trennzeichen kann eine Zeichenkette sein, so wie die übrigen Argumente. Wenn das Trennzeichen NULL ist, ist das Ergebnis NULL. Die Funktion überspringt jegliche NULLs und leere Zeichenketten nach dem Trennzeichen-Argument. Das Trennzeichen wird zwischen den zu verknüpfenden Zeichenketten hinzugefügt:

mysql> select CONCAT_WS(",","Vorname","Zweiter Vorname","Nachname");
       -> 'Vorname,Zweiter Vorname,Nachname'
mysql> select CONCAT_WS(",","Vorname",NULL,"Nachname");
       -> 'Vorname,Nachname'

LENGTH(zeichenkette) , OCTET_LENGTH(zeichenkette) , CHAR_LENGTH(zeichenkette) , CHARACTER_LENGTH(zeichenkette)

Gibt die Länge der Zeichenkette zeichenkette an:

mysql> select LENGTH('text');
        -> 4
mysql> select OCTET_LENGTH('text');
        -> 4

Beachten Sie, dass bei CHAR_LENGTH() Multi-Byte-Zeichen nur einmal gezählt werden.

LOCATE(teilzeichenfolge,zeichenkette) , POSITION(teilzeichenfolge IN zeichenkette)

Gibt die Position des ersten Auftretens der Teilzeichenfolge teilzeichenfolge in der Zeichenkette zeichenkette an. Gibt 0 zurück, wenn teilzeichenfolge nicht in zeichenkette enthalten ist:

mysql> select LOCATE('bar', 'foobarbar');
        -> 4
mysql> select LOCATE('xbar', 'foobar');
        -> 0

Diese Funktion ist Multi-Byte-sicher.

LOCATE(teilzeichenfolge,zeichenkette,position)

Gibt die Position des ersten Auftretens der Teilzeichenfolge teilzeichenfolge in der Zeichenkette zeichenkette ab Position position an. Gibt 0 zurück, wenn teilzeichenfolge nicht in zeichenkette enthalten ist:

mysql> select LOCATE('bar', 'foobarbar',5);
        -> 7

Diese Funktion ist Multi-Byte-sicher.

INSTR(zeichenkette,teilzeichenfolge)

Gibt die Position des ersten Auftretens der Teilzeichenfolge teilzeichenfolge in der Zeichenkette zeichenkette an. Das ist dasselbe wie LOCATE() mit zwei Argumenten, ausser dass die Argumente vertauscht sind:

mysql> select INSTR('foobarbar', 'bar');
        -> 4
mysql> select INSTR('xbar', 'foobar');
        -> 0

Diese Funktion ist Multi-Byte-sicher.

LPAD(zeichenkette,laenge,fuellzeichenkette)

Gibt die Zeichenkette zeichenkette zurück, links aufgefüllt mit der Zeichenkette fuellzeichenkette, bis zeichenkette laenge Zeichen lang ist. Wenn zeichenkette länger als laenge ist, wird sie auf laenge Zeichen verkürzt.

mysql> select LPAD('hi',4,'??');
        -> '??hi'

RPAD(zeichenkette,laenge,fuellzeichenkette)

Gibt die Zeichenkette zeichenkette zurück, rechts aufgefüllt mit der Zeichenkette fuellzeichenkette, bis zeichenkette laenge Zeichen lang ist. Wenn zeichenkette länger als laenge ist, wird sie auf laenge Zeichen verkürzt.

mysql> select RPAD('hi',5,'?');
        -> 'hi???'

LEFT(zeichenkette,laenge)

Gibt die äußersten linken laenge Zeichen der Zeichenkette zeichenkette zurück:

mysql> select LEFT('foobarbar', 5);
        -> 'fooba'

Diese Funktion ist Multi-Byte-sicher.

RIGHT(zeichenkette,laenge)

Gibt die äußersten rechten laenge Zeichen der Zeichenkette zeichenkette zurück:

mysql> select RIGHT('foobarbar', 4);
        -> 'rbar'

Diese Funktion ist Multi-Byte-sicher.

SUBSTRING(zeichenkette,position,laenge) , SUBSTRING(zeichenkette FROM position FOR laenge) , MID(zeichenkette,position,laenge)

Gibt eine laenge Zeichen lange Teilzeichenfolge der Zeichenkette zeichenkette ab Position position zurück. Die abweichende Form, die FROM benutzt, ist ANSI-SQL92-Syntax:

mysql> select SUBSTRING('Heinzholger',5,6);
        -> 'zholge'

Diese Funktion ist Multi-Byte-sicher.

SUBSTRING(zeichenkette,position) , SUBSTRING(zeichenkette FROM position)

Gibt eine Teilzeichenfolge der Zeichenkette zeichenkette ab Position position zurück:

mysql> select SUBSTRING('Heinzholger',5);
        -> 'zholger'
mysql> select SUBSTRING('foobarbar' FROM 4);
        -> 'barbar'

Diese Funktion ist Multi-Byte-sicher.

SUBSTRING_INDEX(zeichenkette,begrenzer,zaehler)

Gibt die Teilzeichenfolge von Zeichenkette zeichenkette vor zaehler Vorkommen des Begrenzers begrenzer zurück. Wenn zaehler positiv ist, wird alle links vom letzten Begrenzer zurückgegeben (von links gezählt). Wenn zaehler negativ ist, wird alles rechts vom letzten Begrenzer (von rechts gezählt) zurückgegeben:

mysql> select SUBSTRING_INDEX('www.mysql.com', '.', 2);
        -> 'www.mysql'
mysql> select SUBSTRING_INDEX('www.mysql.com', '.', -2);
        -> 'mysql.com'

Diese Funktion ist Multi-Byte-sicher.

LTRIM(zeichenkette)

Gibt die Zeichenkette zeichenkette zurück, bei der führende Leerzeichen entfernt wurden:

mysql> select LTRIM('  barbar');
        -> 'barbar'

RTRIM(zeichenkette)

Gibt die Zeichenkette zeichenkette zurück, bei der Leerzeichen am Ende entfernt wurden:

mysql> select RTRIM('barbar   ');
        -> 'barbar'

Diese Funktion ist Multi-Byte-sicher.

TRIM([[BOTH | LEADING | TRAILING] [entfernzeichenkette] FROM] zeichenkette)

Gibt die Zeichenkette zeichenkette zurück, bei der alle entfernzeichenkette-Präfixe und / oder -Suffixe entfernt wurden. Wenn keiner der Spezifizierer BOTH, LEADING oder TRAILING angegeben wird, wird BOTH angenommen. Wenn entfernzeichenkette nicht angegeben ist, werden Leerzeichen entfernt:

mysql> select TRIM('  bar   ');
        -> 'bar'
mysql> select TRIM(LEADING 'x' FROM 'xxxbarxxx');
        -> 'barxxx'
mysql> select TRIM(BOTH 'x' FROM 'xxxbarxxx');
        -> 'bar'
mysql> select TRIM(TRAILING 'xyz' FROM 'barxxyz');
        -> 'barx'

Diese Funktion ist Multi-Byte-sicher.

SOUNDEX(zeichenkette)

Gibt eine Soundex-Zeichenkette von zeichenkette zurück. Zwei Zeichenketten, die fast gleich klingen, sollten identische Soundex-Zeichenketten haben. Eine Standard-Soundex-Zeichenkette ist 4 Zeichen lang, aber die SOUNDEX()-Funktion gibt eine beliebig lange Zeichenkette zurück. Sie können SUBSTRING() auf das Ergebnis anwenden, um eine Standard-Soundex-Zeichenkette zu erhalten. Alle nicht alphanumerischen Zeichen in der angegebenen Zeichenkette werden ignoriert. Alle internationalen alphabetischen Zeichen ausserhalb des Wertebereichs A bis Z werden als Vokale behandelt:

mysql> select SOUNDEX('Hello');
        -> 'H400'
mysql> select SOUNDEX('Quadratically');
        -> 'Q36324'

SPACE(N)

Gibt eine Zeichenkette zurück, die aus N Leerzeichen besteht:

mysql> select SPACE(6);
        -> '      '

REPLACE(zeichenkette,von_zeichenkette,zu_zeichenkette)

Gibt die Zeichenkette zeichenkette zurück, bei der alle Vorkommen der Zeichenkette von_zeichenkette durch die Zeichenkette zu_zeichenkette ersetzt wurden:

mysql> select REPLACE('www.mysql.com', 'w', 'Ww');
        -> 'WwWwWw.mysql.com'

Diese Funktion ist Multi-Byte-sicher.

REPEAT(zeichenkette,zaehler)

Gibt eine Zeichenkette zurück, die aus der Zeichenkette zeichenkette besteht, die zaehler mal wiederholt wurde. Wenn zaehler <= 0 ist, wird eine leere Zeichenkette zurückgegeben. Gibt NULL zurück, wenn zeichenkette oder zaehler NULL sind:

mysql> select REPEAT('MySQL', 3);
        -> 'MySQLMySQLMySQL'

REVERSE(zeichenkette)

Gibt die Zeichenkette zeichenkette in umgedrehter Reihenfolge der Zeichen zurück:

mysql> select REVERSE('abc');
        -> 'cba'

Diese Funktion ist Multi-Byte-sicher.

INSERT(zeichenkette,position,laenge,neue_zeichenkette)

Gibt die Zeichenkette zeichenkette zurück, wobei eine Teilzeichenfolge ab Position position mit laenge Zeichen Länge durch die Zeichenkette neue_zeichenkette ersetzt wurde:

mysql> select INSERT('Heinzholger', 6, 4, 'DIET');
        -> 'HeinzDIETer'

Diese Funktion ist Multi-Byte-sicher.

ELT(N,zeichenkette1,zeichenkette2,zeichenkette3,...)

Gibt zeichenkette1 zurück, wenn N = 1 ist, zeichenkette2, wenn N = 2 ist usw.. Gibt NULL zurück, wenn N kleiner als 1 oder größer als die Anzahl von Argumenten ist. ELT() ist das Komplement von FIELD():

mysql> select ELT(1, 'ej', 'Heja', 'hej', 'foo');
        -> 'ej'
mysql> select ELT(4, 'ej', 'Heja', 'hej', 'foo');
        -> 'foo'

FIELD(zeichenkette,zeichenkette1,zeichenkette2,zeichenkette3,...)

Gibt den Index von zeichenkette in der Liste zeichenkette1, zeichenkette2, zeichenkette3, ... zurück. Gibt 0 zurück, wenn zeichenkette nicht gefunden wird. FIELD() ist das Komplement von ELT():

mysql> select FIELD('ej', 'Hej', 'ej', 'Heja', 'hej', 'foo');
        -> 2
mysql> select FIELD('fo', 'Hej', 'ej', 'Heja', 'hej', 'foo');
        -> 0

FIND_IN_SET(zeichenkette,zeichenkettenliste)

Gibt einen Wert 1 bis N zurück, wenn die Zeichenkette zeichenkette in der Liste zeichenkettenliste ist, die aus N Teilzeichenfolgen besteht. Eine Zeichenkettenliste ist eine Zeichenkette, die aus Teilzeichenfolgen zusammen gesetzt ist, die durch ‘,’-Zeichen getrennt sind. Wenn das erste Argument eine Zeichenketten-Konstante ist und das zweite eine Spalte des Typs SET, wird die FIND_IN_SET()-Funktion optimiert, Bit-Arithmetik zu benutzen! Gibt 0 zurück, wenn zeichenkette nicht in zeichenkettenliste ist oder wenn zeichenkettenliste die leere Zeichenkette ist. Gibt NULL zurück, wenn eines oder beide Argumente NULL sind. Diese Funktion funktioniert nicht korrekt, wenn das erste Argument ein ‘,’ enthält:

mysql> SELECT FIND_IN_SET('b','a,b,c,d');
        -> 2

MAKE_SET(bits,zeichenkette1,zeichenkette2,...)

Gibt einen Satz (eine Zeichenkette, die Teilzeichenfolgen enthält, die durch ‘,’ getrennt sind) zurück, der aus Zeichenketten besteht, die das entsprechende Bit in bits gesetzt haben. zeichenkette1 entspricht Bit 0, zeichenkette2 Bit 1 usw. NULL-Zeichenketten in zeichenkette1, zeichenkette2 usw. werden nicht an das Ergebnis angehängt:

mysql> SELECT MAKE_SET(1,'a','b','c');
        -> 'a'
mysql> SELECT MAKE_SET(1 | 4,'hallo','liebe','welt');
        -> 'hallo,welt'
mysql> SELECT MAKE_SET(0,'a','b','c');
        -> ''

EXPORT_SET(bits,an,aus,[trennzeichen,[anzahl_bits]])

Gibt eine Zeichenkette zurück, in der Sie für jedes bit, das in 'bit' gesetzt ist, eine 'an'-Zeichenkette erhalten, und für jedes zurückgesetzte Bit eine 'aus'-Zeichenkette. Jede Zeichenkette wird mit 'trennzeichen' getrennt (vorgabemäßig ','), und nur die 'anzahl_bits' (vorgabemäßig 64) von 'bits' wird benutzt:

mysql> select EXPORT_SET(5,'Y','N',',',4)
        -> Y,N,Y,N

LCASE(zeichenkette) , LOWER(zeichenkette)

Gibt die Zeichenkette zeichenkette zurück, bei der alle Zeichen in Kleinschreibung gemäß dem aktuellen Zeichensatz-Mapping (Vorgabe ist ISO-8859-1 Latin1) umgewandelt wurden:

mysql> select LCASE('HEINZholger');
        -> 'heinzholger'

Diese Funktion ist Multi-Byte-sicher.

UCASE(zeichenkette) , UPPER(zeichenkette)

Gibt die Zeichenkette zeichenkette zurück, bei der alle Zeichen in Großschreibung gemäß dem aktuellen Zeichensatz-Mapping (Vorgabe ist ISO-8859-1 Latin1) umgewandelt wurden:

mysql> select UCASE('Hej');
        -> 'HEJ'

Diese Funktion ist Multi-Byte-sicher.

LOAD_FILE(datei)

Liest die Datei datei und gibt den Dateiinhalt als Zeichenkette zurück. Die Datei muss auf dem Server sein, Sie müssen den vollen Pfadnamen zur Datei angeben und Sie müssen die file-Berechtigung besitzen. Die Datei muss von allen lesbar sein und kleiner als max_allowed_packet.

Wenn die Datei nicht existiert oder aus den oben genannten Gründen nicht gelesen werden kann, gibt die Funktion NULL zurück:

mysql> UPDATE tabelle
           SET blob_spalte=LOAD_FILE("/tmp/bild")
           WHERE id=1;

DAYOFWEEK(datum)

Gibt den Wochentag-Index zurück.

Für datum gilt: 1 = Sonntag, 2 = Montag, ... 7 = Samstag). Diese Index-Werte entsprechen dem ODBC-Standard:

mysql> select DAYOFWEEK('1998-02-03');
        -> 3

WEEKDAY(datum)

Gibt den Wochentag-Index für datum zurück (0 = Montag, 1 = Dienstag, ... 6 = Sonntag):

mysql> select WEEKDAY('1997-10-04 22:23:00');
        -> 5
mysql> select WEEKDAY('1997-11-05');
        -> 2

DAYOFMONTH(datum)

Gibt den Tag des Monats für datum im Bereich 1 bis 31 zurück:

mysql> select DAYOFMONTH('1998-02-03');
        -> 3

DAYOFYEAR(datum)

Gibt den Tag des Jahres für datum im Bereich 1 bis 366 zurück:

mysql> select DAYOFYEAR('1998-02-03');
        -> 34

MONTH(datum)

Gibt den Monat für datum im Bereich 1 bis 12 zurück:

mysql> select MONTH('1998-02-03');
        -> 2

DAYNAME(datum)

Gibt den Namen des Wochentags für datum zurück (auf englisch):

mysql> select DAYNAME("1998-02-05");
        -> 'Thursday'

MONTHNAME(datum)

Gibt den Namen des Monats für datum zurück (auf englisch):

mysql> select MONTHNAME("1998-02-05");
        -> 'February'

QUARTER(datum)

Gibt das Quartal des Jahres für datum im Bereich 1 bis 4 zurück:

mysql> select QUARTER('98-04-01');
        -> 2

WEEK(datum) , WEEK(datum,erste)

Mit einem einzelnen Argument gibt diese Funktion die Woche für datum im Bereich 0 bis 53 zurück (ja, es kann Anfänge der Woche 53 geben), für Orte, in denen Sonntag der erste Wochentag ist. In der Form mit zwei Argumenten gestattet WEEK() es, festzulegen, ob die Woche am Sonntag oder am Montag beginnt. Die Woche beginnt am Sonntag, wenn das zweite Argument 0 ist, und am Montag, wenn das zweite Argument 1 ist:

mysql> select WEEK('1998-02-20');
        -> 7
mysql> select WEEK('1998-02-20',0);
        -> 7
mysql> select WEEK('1998-02-20',1);
        -> 8
mysql> select WEEK('1998-12-31',1);
        -> 53

YEAR(datum)

Gibt das Jahr für datum im Bereich 1000 bis 9999 zurück:

mysql> select YEAR('98-02-03');
        -> 1998

YEARWEEK(datum) , YEARWEEK(datum,erste)

Gibt Jahr und Woche für ein Datum zurück. Das zweite Argument funktioniert genau wie das zweite Argument von WEEK(). Beachten Sie, dass das Jahr sich in der ersten und letzten Woche des Jahres vom Jahr im Datums-Argument unterscheiden kann:

mysql> select YEARWEEK('1987-01-01');
        -> 198653

HOUR(zeit)

Gibt die Stunde für zeit im Bereich 0 bis 23 zurück:

mysql> select HOUR('10:05:03');
        -> 10

MINUTE(zeit)

Gibt die Minute für zeit im Bereich 0 bis 59 zurück:

mysql> select MINUTE('98-02-03 10:05:03');
        -> 5

SECOND(zeit)

Gibt die Sekunde für zeit im Bereich 0 bis 59 zurück:

mysql> select SECOND('10:05:03');
        -> 3

PERIOD_ADD(P,N)

Zählt N Monate zur Periode P hinzu (im Format YYMM oder YYYYMM). Gibt einen Wert im Format YYYYMM zurück.

Beachten Sie, dass das Perioden-Argument P kein Datums-Wert ist:

mysql> select PERIOD_ADD(9801,2);
        -> 199803

PERIOD_DIFF(P1,P2)

Gibt die Anzahl von Monaten zwischen den Perioden P1 und P2 zurück. P1 und P2 sollten im Format YYMM oder YYYYMM sein.

Beachten Sie, dass die Perioden-Argumente P1 und P2 keine Datumswerte sind:

mysql> select PERIOD_DIFF(9802,199703);
        -> 11

DATE_ADD(datum,INTERVAL ausdruck typ) , DATE_SUB(datum,INTERVAL ausdruck typ) , ADDDATE(datum,INTERVAL ausdruck typ) , SUBDATE(datum,INTERVAL ausdruck typ)

Diese Funktionen führen Datumsberechnungen durch. Sie wurden in MySQL-Version 3.22 eingeführt. ADDDATE() und SUBDATE() sind Synonyme für DATE_ADD() und DATE_SUB().

In MySQL-Version 3.23 können Sie + und - anstelle von DATE_ADD() und DATE_SUB() benutzen, wenn der Ausdruck auf der rechten Seite eine DATE oder DATETIME-Spalte ist (siehe Beispiel).

datum ist ein DATETIME- oder DATE-Wert, der das Anfangsdatum festlegt. ausdruck ist ein Ausdruck, der den Intervallwert festlegt, der zum Anfangsdatum hinzugezählt oder von diesem abgezogen wird. ausdruck ist eine Zeichenkette; sie kann mit einem ‘-’ für negative Intervalle beginnen. typ ist ein Schlüsselwort, das angibt, wie der Ausdruck interpretiert werden soll.

Die verwandte Funktion EXTRACT(typ FROM datum) gibt das 'typ'-Intervall des Datums zurück.

Folgende Tabelle zeigt, in welchem Zusammenhang die typ- und ausdruck-Argumente stehen:

MySQL erlaubt beliebige Satzzeichen-Begrenzer im ausdruck-Format. Die in der Tabelle gezeigten Begrenzer sind Vorschläge. Wenn das datum-Argument ein DATE-Wert ist und Ihre Berechnungen nur YEAR, MONTH und DAY-Anteile beinhalten (also keine Zeit-Anteile), ist das Ergebnis ein DATE-Wert. Ansonsten ist das Ergebnis ein DATETIME-Wert:

mysql> SELECT "1997-12-31 23:59:59" + INTERVAL 1 SECOND;
        -> 1998-01-01 00:00:00
mysql> SELECT INTERVAL 1 DAY + "1997-12-31";
        -> 1998-01-01
mysql> SELECT "1998-01-01" - INTERVAL 1 SECOND;
       -> 1997-12-31 23:59:59
mysql> SELECT DATE_ADD("1997-12-31 23:59:59",
                       INTERVAL 1 SECOND);
        -> 1998-01-01 00:00:00
mysql> SELECT DATE_ADD("1997-12-31 23:59:59",
                       INTERVAL 1 DAY);
        -> 1998-01-01 23:59:59
mysql> SELECT DATE_ADD("1997-12-31 23:59:59",
                       INTERVAL "1:1" MINUTE_SECOND);
        -> 1998-01-01 00:01:00
mysql> SELECT DATE_SUB("1998-01-01 00:00:00",
                       INTERVAL "1 1:1:1" DAY_SECOND);
        -> 1997-12-30 22:58:59
mysql> SELECT DATE_ADD("1998-01-01 00:00:00",
                       INTERVAL "-1 10" DAY_HOUR);
        -> 1997-12-30 14:00:00
mysql> SELECT DATE_SUB("1998-01-02", INTERVAL 31 DAY);
        -> 1997-12-02

Wenn Sie einen Intervallwert angeben, der zu kurz ist (nicht alle Intervall-Anteile beinhaltet, die vom typ-Schlüsselwort erwartet werden), nimmt MySQL an, dass Sie den äußersten linken Teil des Intervallwerts ausgelassen haben. Wenn Sie beispielsweise einen typ DAY_SECOND angeben, wird vom Wert von ausdruck erwartet, dass dieser Tages-, Stunden-, Minuten- und Sekunden-Anteile enthält. Wenn Sie einen Wert wie "1:10" angeben, nimmt MySQL an, dass die Tages- und Stunden-Anteile fehlen und der Wert Minuten und Sekunden darstellt. Mit anderen Worten wird "1:10" DAY_SECOND so interpretiert, dass es äquivalent zu "1:10" MINUTE_SECOND ist. Das ist analog zur Weise, wie MySQL TIME-Werte interpretiert, die eher vergangene Zeit als Tageszeit darstellen.

Beachten Sie, dass ein Datumswert automatisch in einen DATETIME-Wert umgewandelt wird, wenn Sie einen DATE-Wert zu etwas hinzuzählen oder von etwas abziehen, das einen Zeit-Anteil hat:

mysql> select date_add("1999-01-01", interval 1 day);
       -> 1999-01-02
mysql> select date_add("1999-01-01", interval 1 hour);
       -> 1999-01-01 01:00:00

Wenn Sie wirklich falsche Datumsangaben benutzen, ist das Ergebnis NULL. Wenn Sie MONTH, YEAR_MONTH oder YEAR hinzuzählen und das Datumsergebnis einen Tag hat, der größer ist als der höchste Tag für den neuen Monat, wird der Tag auf den höchsten Tag des neuen Monats angepasst:

mysql> select DATE_ADD('1998-01-30', Interval 1 month);
        -> 1998-02-28

Beachten Sie, dass das Wort INTERVAL und das typ-Schlüsselwort in den vorstehenden Beispielen nicht von der verwendeten Groß-/Kleinschreibung abhängen.

EXTRACT(typ FROM datum)

Die EXTRACT()-Funktion benutzt dieselbe Art von Intervalltyp-Spezifikatoren wie DATE_ADD() oder DATE_SUB(), extrahiert aber Anteile aus dem Datum, statt Datumsberechnungen durchzuführen:

mysql> SELECT EXTRACT(YEAR FROM "1999-07-02");
       -> 1999
mysql> SELECT EXTRACT(YEAR_MONTH FROM "1999-07-02 01:02:03");
       -> 199907
mysql> SELECT EXTRACT(DAY_MINUTE FROM "1999-07-02 01:02:03");
       -> 20102

TO_DAYS(datum)

Gibt für ein Datum datum eine Tagesanzahl zurück (die Anzahl von Tagen seit dem Jahr 0):

mysql> select TO_DAYS(950501);
        -> 728779
mysql> select TO_DAYS('1997-10-07');
        -> 729669

TO_DAYS() ist nicht für die Benutzung mit Werten vor der Einführung des Gregorianischen Kalenders (1582) vorgesehen, weil es nicht die Tage berücksichtigt, die verloren gingen, als der Kalender geändert wurde.

FROM_DAYS(N)

Gibt für eine Tagesanzahl N einen DATE-Wert zurück:

mysql> select FROM_DAYS(729669);
        -> '1997-10-07'

FROM_DAYS() ist nicht für die Benutzung mit Werten vor der Einführung des Gregorianischen Kalenders (1582) vorgesehen, weil es nicht die Tage berücksichtigt, die verloren gingen, als der Kalender geändert wurde.

DATE_FORMAT(datum,format)

Formatiert den datum-Wert gemäß der format-Zeichenkette. Folgende Spezifikatoren können in der format-Zeichenkette benutzt werden:

Alle anderen Zeichen werden einfach ohne Interpretation ins Ergebnis kopiert:

mysql> select DATE_FORMAT('1997-10-04 22:23:00', '%W%M%Y');
        -> 'Saturday October 1997'
mysql> select DATE_FORMAT('1997-10-04 22:23:00', '%H:%i:%s');
        -> '22:23:00'
mysql> select DATE_FORMAT('1997-10-04 22:23:00',
                          '%D%y%a%d%m%b%j');
        -> '4th 97 Sat 04 10 Oct 277'
mysql> select DATE_FORMAT('1997-10-04 22:23:00',
                          '%H%k%I%r%T%S%w');
        -> '22 22 10 10:23:00 PM 22:23:00 00 6'
mysql> select DATE_FORMAT('1999-01-01', '%X%V');
        -> '1998 52'

Ab MySQL-Version 3.23 ist das ‘%’-Zeichen vor Format-Spezifikator-Zeichen erforderlich. In früheren Versionen von MySQL war ‘%’ optional.

TIME_FORMAT(zeit,format)

Dieses wird benutzt wie die obige DATE_FORMAT()-Funktion, aber die format-Zeichenkette darf nur die Spezifikatoren enthalten, die Stunden, Minuten und Sekunden handhaben. Andere Spezifikatoren erzeugen einen NULL-Wert oder 0.

CURDATE() , CURRENT_DATE

Gibt das Datum von heute im 'YYYY-MM-DD'- oder YYYYMMDD-format zurück, abhängig davon, ob die Funktion in einem Zeichenketten- oder in einem numerischen Zusammenhang benutzt wird:

mysql> select CURDATE();
        -> '1997-12-15'
mysql> select CURDATE() + 0;
        -> 19971215

CURTIME() , CURRENT_TIME

Gibt die aktuelle Zeit als einen Wert im 'HH:MM:SS'- oder HHMMSS-format zurück, abhängig davon, ob die Funktion in einem Zeichenketten- oder in einem numerischen Zusammenhang benutzt wird:

mysql> select CURTIME();
        -> '23:50:26'
mysql> select CURTIME() + 0;
        -> 235026

NOW() , SYSDATE() , CURRENT_TIMESTAMP

Gibt das aktuelle Datum und die aktuelle Zeit als einen Wert im 'YYYY-MM-DD HH:MM:SS'- oder YYYYMMDDHHMMSS-Format zurück, abhängig davon, ob die Funktion in einem Zeichenketten- oder in einem numerischen Zusammenhang benutzt wird:

mysql> select NOW();
        -> '1997-12-15 23:50:26'
mysql> select NOW() + 0;
        -> 19971215235026

UNIX_TIMESTAMP() , UNIX_TIMESTAMP(datum)

Ohne Argument aufgerufen gibt die Funktion einen Unix-Zeitstempel zurück (Sekunden seit '1970-01-01 00:00:00' GMT). Wenn UNIX_TIMESTAMP() mit einem datum-Argument aufgerufen wird, gibt sie den Wert des Arguments als Sekunden seit '1970-01-01 00:00:00' GMT zurück. datum kann eine DATE-Zeichenkette, eine DATETIME-Zeichenkette, ein TIMESTAMP oder eine Zahl im Format YYMMDD oder YYYYMMDD in lokaler Zeit sein:

mysql> select UNIX_TIMESTAMP();
        -> 882226357
mysql> select UNIX_TIMESTAMP('1997-10-04 22:23:00');
        -> 875996580

Wenn UNIX_TIMESTAMP auf einer TIMESTAMP-Spalte benutzt wird, erhält die Funktion den Wert direkt, ohne implizite ``zeichenkette-zu-unix-zeitstempel''-Umwandlung. Wenn Sie UNIX_TIMESTAMP() einen falschen Wert oder einen Wert ausserhalb des Wertebereichs angeben, gibt sie 0 zurück.

FROM_UNIXTIME(unix_zeitstempel)

Gibt das unix_timestamp-Argument als Wert im 'YYYY-MM-DD HH:MM:SS'- oder YYYYMMDDHHMMSS-Format zurück, abhängig davon, ob die Funktion in einem Zeichenketten- oder in einem numerischen Zusammenhang benutzt wird:

mysql> select FROM_UNIXTIME(875996580);
        -> '1997-10-04 22:23:00'
mysql> select FROM_UNIXTIME(875996580) + 0;
        -> 19971004222300

FROM_UNIXTIME(unix_zeitstempel,format)

Gibt das unix_timestamp-Argument als Wert zurück, der wie mit der format-Zeichenkette angegeben formatiert ist. format kann dieselben Spezifikatoren wie die DATE_FORMAT()-Funktion enthalten:

mysql> select FROM_UNIXTIME(UNIX_TIMESTAMP(),
                            '%Y%D%M%h:%i:%s%x');
        -> '1997 23rd December 03:43:30 x'

SEC_TO_TIME(sekunden)

Gibt das sekunden-Argument, umgewandelt in Stunden, Minuten und Sekunden, als Wert im 'HH:MM:SS'- oder HHMMSS-Format zurück, abhängig davon, ob die Funktion in einem Zeichenketten- oder in einem numerischen Zusammenhang benutzt wird:

mysql> select SEC_TO_TIME(2378);
        -> '00:39:38'
mysql> select SEC_TO_TIME(2378) + 0;
        -> 3938

TIME_TO_SEC(zeit)

Gibt das zeit-Argument, umgewandelt in Sekunden, zurück:

mysql> select TIME_TO_SEC('22:23:00');
        -> 80580
mysql> select TIME_TO_SEC('00:39:38');
        -> 2378

COUNT(ausdruck)

Gibt die Anzahl der Zeilen mit Nicht-NULL-Werten zurück, die durch ein SELECT-Statement abgerufen werden:

mysql> select student.student_name,COUNT(*)
           from student,kurs
           where student.student_id=kurs.student_id
           GROUP BY student_name;

COUNT(*) ist insofern anders, als es die Anzahl der abgerufenen Zeilen zurückgibt, egal ob sie NULL-Werte enthalten oder nicht.

COUNT(*) ist darauf optimiert, das Ergebnis sehr schnell zurückzugeben, wenn es mittels eines SELECT von einer Tabelle abruft, wenn keine weiteren Spalten abgerufen werden und es keine WHERE-Klausel gibt. Beispiel:

mysql> select COUNT(*) from student;

COUNT(DISTINCT ausdruck,[ausdruck...])

Gibt die Anzahl unterschiedlicher Nich-NULL-Werte zurück:

mysql> select COUNT(DISTINCT ergebnisse) from student;

Bei MySQL erhalten Sie die Anzahl unterschiedlicher Ausdruckskombinationen, die nicht NULL enthalten, indem Sie eine Liste von Ausdrücken angeben. In ANSI-SQL müssten Sie eine Verkettung aller Ausdrücke innerhalb von CODE(DISTINCT ..) angeben.

AVG(ausdruck)

Gibt den Durchschnittswert von ausdruck zurück:

mysql> select student_name, AVG(test_ergebnis)
           from student
           GROUP BY student_name;

MIN(ausdruck) , MAX(ausdruck)

Gibt den kleinsten oder größten Wert von ausdruck zurück. MIN() und MAX() können Zeichenketten-Argumente aufnehmen und geben in solchen Fällen den kleinsten oder größten Zeichenketten- Wert zurück. See Abschnitt 6.4.3, „Wie MySQL Indexe benutzt“.

mysql> select student_name, MIN(test_ergebnis), MAX(test_ergebnis)
           from student
           GROUP BY student_name;

SUM(ausdruck)

Gibt die Summe von ausdruck zurück. Beachten Sie, dass der Rückgabewert NULL ist, wenn die Ergebnismenge keine Zeilen hat!

STD(ausdruck) , STDDEV(ausdruck)

Gibt die Standardabweichung von ausdruck zurück. Das ist eine Erweiterung zu ANSI-SQL. Die STDDEV()-Form dieser Funktion wird aus Gründen der Oracle-Kompatibilität zur Verfügung gestellt.

BIT_OR(ausdruck)

Gibt das bitweise OR aller Bits in ausdruck zurück. Die Berechnung wird mit 64-Bit-(BIGINT)-Genauigkeit durchgeführt.

BIT_AND(ausdruck)

Gibt das bitweise AND aller Bits in ausdruck zurück. Die Berechnung wird mit 64-Bit-(BIGINT)-Genauigkeit durchgeführt.

Einem SELECT-Ausdruck kann mit AS ein Alias zugewiesen werden. Der Alias wird als Spaltenname verwendet und kann bei ORDER BY- oder HAVING-Klauseln benutzt werden. Beispiel:

mysql> select concat(nachname,', ',vorname) AS voller_name
    from tabelle ORDER BY voller_name;

The FROM tabellenreferenz-Klausel gibt die Tabellen an, aus denen Zeilen abgerufen werden sollen. Wenn Sie mehr als eine Tabelle aufführen, führen Sie einen Join durch. Informationen über die Join-Syntax finden Sie unter Abschnitt 7.4.1.1, „JOIN-Syntax“.

Sie können auf eine Spalte als spalten_name verweisen, als tabelle.spalten_name oder als datenbank.tabelle.spalten_name. Sie müssen das tabelle- oder datenbank.tabelle-Präfix für einen Spaltenverweis in einem SELECT-Statement nicht angeben, es sei denn, der Verweis wäre ansonsten mehrdeutig. Sie Abschnitt 7.1.2, „Datenbank-, Tabellen-, Index-, Spalten- und Alias-Namen“; hier finden sich Beispiele von Mehrdeutigkeit, die erfordern, dass Sie ausführlichere Spaltenverweis-Formen benutzen.

Einem Tabellenverweis kann mit tabelle [AS] alias_name ein Tabellen-Alias zugewiesen werden:

mysql> select t1.name, t2.gehalt from angestellte AS t1, info AS t2
           where t1.name = t2.name;
mysql> select t1.name, t2.gehalt from angestellte t1, info t2
           where t1.name = t2.name;

Auf Spalten, die für die Ausgabe ausgewählt wurden, kann in ORDER BY- und GROUP BY-Klauseln mit Spaltennamen, Spalten-Aliasen oder Spaltenpositionen verwiesen werden. Spaltenpositionen fangen mit 1 an:

mysql> select hochschule, region, seed von tournament
           ORDER BY region, seed;
mysql> select hochschule, region AS r, seed AS s from turnier
           ORDER BY r, s;
mysql> select hochschule, region, seed from turnier
           ORDER BY 2, 3;

Um in absteigender Reihenfolge zu sortieren, fügen Sie dem Namen der Spalte das DESC-Schlüsselwort in the ORDER BY-Klausel hinzu (descending, absteigend), nach der Sie sortieren. Die Vorgabe ist aufsteigende Reihenfolge. Das können Sie auch explizit angeben, indem Sie das ASC-Schlüsselwort verwenden.

In der WHERE-Klausel können Sie beliebige Funktionen verwenden, die MySQL unterstützt. See Abschnitt 7.3, „Funktionen für die Benutzung in SELECT- und WHERE-Klauseln“.

Die HAVING-Klausel kann auf jede Spalte oder jeden Alias verweisen, die bzw. der im select_ausdruck genannt wurde. Die Klausel wird zuletzt angewandt, direkt bevor Ergebnisse an den Client geschickt werden, ohne jede Optimierung. Benutzen Sie kein HAVING für Dinge, die in der WHERE-Klausel stehen sollten. Schreiben Sie beispielsweise nicht folgendes:

mysql> select spalten_name from tabelle HAVING spalten_name > 0;

Sondern statt dessen:

mysql> select spalten_name from tabelle WHERE spalten_name > 0;

Ab MySQL-Version 3.22.5 können Sie Anfragen auch wie folgt schreiben:

mysql> select user,max(gehalt) from benutzer
           group by benutzer HAVING max(gehalt)>10;

In älteren MySQL-Versionen schreiben Sie statt dessen:

mysql> select benutzer,max(gehalt) AS summe from benutzer
           group by benutzer HAVING summe>10;

SQL_SMALL_RESULT, SQL_BIG_RESULT, SQL_BUFFER_RESULT, STRAIGHT_JOIN und HIGH_PRIORITY sind MySQL Erweiterungen zu ANSI-SQL92.

HIGH_PRIORITY gibt dem SELECT höhere Priorität als einem Statement, das eine Tabelle aktualisiert. Sie sollten das nur für Anfragen benutzen, die sehr schnell sind und sofort durchgeführt werden müssen. Eine SELECT HIGH_PRIORITY-Anfrage läuft, wenn die Tabelle eine Lese-Sperre hat, selbst wenn es ein Update-Statement gibt, das darauf wartet, dass die Tabelle freigegeben wird.

SQL_BIG_RESULT kann bei GROUP BY oder DISTINCT benutzt werden, um dem Optimierer mitzuteilen, dass das Ergebnis sehr viele Zeilen haben wird. In diesem Fall benutzt MySQL bei Bedarf direkt Festplatten-basierende temporäre Tabellen. Ausserdem bevorzugt MySQL in diesem Fall Sortieren vor dem Anlegen einer temporären Tabelle mit einem Schlüssel auf den GROUP BY-Elementen.

Wenn Sie GROUP BY benutzen, werden die Ausgabe-Zeilen gemäß dem GROUP BY sortiert, als hätten Sie ein ORDER BY für alle Felder im GROUP BY angegeben. MySQL hat GROUP BY erweitert, so dass Sie dafür auch ASC und DESC angeben können:

SELECT a,COUNT(b) FROM tabelle GROUP BY a DESC

MySQL hat die Benutzung von GROUP BY erweitert, um es Ihnen zu gestatten, auch Felder auszuwählen, die nicht in der GROUP BY-Klausel erwähnt wurden. Wenn Sie nicht die Ergebnisse erhalten, die Sie von Ihrer Anfrage erwarten, lesen Sie bitte die GROUP BY-Beschreibung.

SQL_BUFFER_RESULT erzwingt, dass das Ergebnis in eine temporäre Tabelle geschrieben wird. Das hilft MySQL, frühzeitig Tabellensperren aufzuheben, und hilft in Fällen, in denen es lange dauert, das Ergebnis an den Client zu senden.

SQL_SMALL_RESULT, eine MySQL-spezifische Option, kann bei GROUP BY oder DISTINCT benutzt werden, um dem Optimierer mitzuteilen, dass der Ergebnissatz klein sein wird. In diesem Fall benutzt MySQL schnelle temporäre Tabellen, um die Ergebnistabelle zu speichern, anstatt Sortieren zu benutzen. In MySQL-Version 3.23 sollte das normalerweise nicht benötigt werden.

STRAIGHT_JOIN zwingt den Optimierer, Tabellen in der Reihenfolge zu verknüpfen, in der sie in der FROM-Klausel aufgelistet sind. Sie können das benutzen, um die Geschwindigkeit einer Anfrage zu erhöhen, wenn der Optimierer Tabellen in nicht optimaler Reihenfolge verknüpft. See Abschnitt 6.2.1, „EXPLAIN-Syntax (Informationen über ein SELECT erhalten)“.

Die LIMIT-Klausel wird benutzt, um die Anzahl von Zeilen, die vom SELECT-Statement zurückgegeben werden, zu beschränken. LIMIT erwartet ein oder zwei numerische Argumente.

Wenn zwei Argumente angegeben sind, legt das erste den Offset der ersten Zeile fest, die zurückgegeben wird, und das zweite gibt die maximale Anzahl von Zeilen an, die zurückgegeben werden. Der Offset der anfänglichen Zeile ist 0 (nicht 1):

mysql> select * from tabelle LIMIT 5,10;  # Zeilen 6 bis 15 zurückgeben

Wenn ein Argument angegeben wird, stellt es die maximale Anzahl von Zeilen dar, die zurückgegeben werden:

mysql> select * from tabelle LIMIT 5;     # Die ersten 5 Zeilen zurückgeben

Mit anderen Worten ist LIMIT n äquivalent zu LIMIT 0,n.

Die SELECT ... INTO OUTFILE 'datei'-Form von SELECT schreibt die ausgewählten Zeilen in eine Datei. Die Datei wird auf dem Server-Host erzeugt und darf nicht bereits bestehen (das verhindert unter anderem, dass Datenbanktabellen und Dateien wie /etc/passwd zerstört werden). Sie benötigen die file-Berechtigung auf dem Server-Host, um diese Form von SELECT auszuführen.

SELECT ... INTO OUTFILE ist hauptsächlich dafür vorgesehen, um eine Tabelle auf der Server-Maschine schnell zu dumpen. Wenn Sie die resultierende Datei auf einem anderen Host als dem Server-Host haben wollen, können Sie SELECT ... INTO OUTFILE nicht benutzen. In diesem Fall sollten Sie statt dessen ein Client-Programm wie mysqldump --tab oder mysql -e "SELECT ..." > outfile benutzen, um die Datei zu erzeugen.

SELECT ... INTO OUTFILE ist das Komplement von LOAD DATA INFILE; die Syntax für den export_optionen-Teil des Statements besteht aus denselben FIELDS- und LINES-Klauseln, die beim LOAD DATA INFILE-Statement benutzt werden. See Abschnitt 7.4.9, „LOAD DATA INFILE-Syntax“.

In der resultierenden Textdatei werden nur folgende Zeichen durch das ESCAPED BY-Zeichen escapet:

Zusätzlich wird ASCII 0 in ESCAPED BY, gefolgt von 0 (ASCII 48), umgewandelt.

Der Grund hierfür ist, dass Sie jegliche FIELDS TERMINATED BY-, ESCAPED BY- oder LINES TERMINATED BY-Zeichen escapen MÜSSEN, um die Datei zuverlässig wieder einlesen zu können. ASCII 0 wird escapet, um das Lesen mit einigen Pagern zu erleichtern.

Weil sich die resultierende Datei nicht nach der SQL-Syntax richten muss, muss nicht weiter escapet werden.

Im Folgenden ein Beispiel, wie man eine Datei in einem Format erhält, das von vielen alten Programmen benutzt wird:

SELECT a,b,a+b INTO OUTFILE "/tmp/resultat.text"
FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY "\n"
FROM tabelle;

Wenn Sie INTO DUMPFILE anstelle von INTO OUTFILE benutzen, schreibt MySQL nur eine Zeile in die Datei, ohne jede Spalten- oder Zeilen-Begrenzer und ohne jedes Escapen. Das ist nützlich, wenn Sie ein Blob in eine Datei speichern wollen.

Beachten Sie, dass jede Datei, die von INTO OUTFILE und INTO DUMPFILE erzeugt wird, für alle Benutzer lesbar ist! Der Grund liegt darin, dass der MySQL-Server keine Datei erzeugen kann, die jemandem anderen gehört als dem Benutzer, unter dem er läuft (Sie sollten mysqld nie als Root laufen lassen), daher muss die Datei für jedermann lesbar sein, damit Sie die Zeilen abrufen können.

Wenn Sie FOR UPDATE bei einem Tabellen-Handler mit Seiten-/Zeilen-Sperren benutzen, werden die untersuchten Zeilen schreib-gesperrt.

Wenn Sie keine Spaltenliste für INSERT ... VALUES oder INSERT ... SELECT angeben, müssen für alle Spalten Werte in der VALUES()-Liste oder vom SELECT bereit stehen. Wenn Sie die Reihenfolge der Tabellenspalten nicht kennen, benutzen Sie DESCRIBE tabelle, um sie herauszufinden.

Jede Spalte, die nicht explizit in einer Werteliste angegeben wird, wird auf ihren Vorgabewert gesetzt. Wenn Sie beispielsweise eine Spaltenliste angeben, die nicht alle Tabellenspalten nennt, werden unbenannte Spalten auf ihre Vorgabewerte gesetzt. Die Zuweisung von Vorgabewerten ist in Abschnitt 7.5.3, „CREATE TABLE-Syntax“ beschrieben.

Ein ausdruck kann sich auf jede Spalte beziehen, die vorher in einer Werteliste angegeben wurde. Beispielsweise können Sie folgendes eingeben:

mysql> INSERT INTO tabelle (spalte1,spalte2) VALUES(15,spalte1*2);

Aber nicht das hier:

mysql> INSERT INTO tabelle (spalte1,spalte2) VALUES(spalte2*2,15);

Wenn Sie das Schlüsselwort LOW_PRIORITY angeben, wird die Ausführung von INSERT verzögert, bis kein anderer Client mehr aus der Tabelle liest. In diesem Fall muss der Client warten, bis das INSERT-Statement fertig ist, was lange Zeit dauern kann, wenn die Tabelle stark benutzt wird. Das ist im Gegensatz zu INSERT DELAYED, was den Client sofort weitermachen läßt. See Abschnitt 7.4.4, „INSERT DELAYED-Syntax“. Beachten Sie, dass LOW_PRIORITY normalerweise nicht bei MyISAM-Tabellen benutzt werden sollte, weil dadurch gleichzeitige Einfügeoperationen verhindert werden. See Abschnitt 8.1, „MyISAM-Tabellen“.

Wenn Sie das Schlüsselwort IGNORE in einem INSERT mit vielen Wertezeilen angeben, werden alle Zeilen, die einen bestehenden PRIMARY- oder UNIQUE-Schlüssel duplizieren würden, ignoriert und nicht eingefügt. Wenn Sie IGNORE nicht angeben, wird die Einfügeoperation abgebrochen, wenn es eine Zeile gibt, die einen bestehenden Schlüsselwert duplizieren würde. Mit der C-API-Funktion mysql_info() können Sie feststellen, wie viele Zeilen in die Tabelle eingefügt wurden.

Wenn MySQL mit der DONT_USE_DEFAULT_FIELDS-Option konfiguriert wurde, erzeugen INSERT-Statements einen Fehler, wenn Sie nicht explizit Werte für alle Spalten angeben, die einen Nicht-NULL-Wert erfordern. See Abschnitt 3.3.3, „Typische configure-Optionen“.

Den Wert, der für eine AUTO_INCREMENT-Spalte benutzt wurde, finden Sie mit der mysql_insert_id-Funktion heraus. See Abschnitt 9.4.3.30, „mysql_insert_id()“.

Wenn NULL in eine Spalte eingefügt wird, die als NOT NULL deklariert ist. Die Spalte wird auf ihren Vorgabewert gesetzt.

Wenn eine numerische Spalte auf einen Wert ausserhalb des Wertebereichs der Spalte gesetzt wird. Der Wert wird auf den entsprechenden Endpunkt des Bereichs abgeschnitten.

Wenn eine numerische Spalte auf einen Wert wie '10.34 a' gesetzt wird. Die unsinnigen Zeichen am Ende werden entfernt und der verbleibende numerische Anteil eingefügt. Wenn der Wert als Zahl überhaupt keinen Sinn ergibt, wird die Spalte auf 0 gesetzt.

Wenn eine Zeichenkette in eine CHAR-, VARCHAR-, TEXT- oder BLOB-Spalte eingefügt wird, die die maximale Länge der Spalte überschreitet. Der Wert wird auf die maximale Spaltenlänge beschnitten.

Wenn ein Wert in eine DATE- oder TIME-Spalte eingefügt wird, der für den Spaltentyp nicht zulässig ist. Die Spalte wird auf den entsprechenden 0-Wert für diesen Typ gesetzt.

When ein Thread ein DELAYED-Statement für eine Tabelle ausführt, wird ein Handler-Thread erzeugt, um alle DELAYED-Statements für die Tabelle auszuführen, wenn ein solcher Handler nicht schon existiert.

Der Thread prüft, ob der Handler bereit eine DELAYED-Sperre erhalten hat oder nicht. Wenn nicht, weist es den Handler-Thread an, das zu tun. Die DELAYED-Sperre kann selbst dann erlangt werden, wenn ein anderer Thread eine READ- oder WRITE-Sperre auf der Tabelle hat. Der Handler wartet jedoch auf alle ALTER TABLE-Sperren oder FLUSH TABLES, um sicherzustellen, dass die Tabellenstruktur aktuell ist.

Der Thread führt das INSERT-Statement aus, aber statt die Zeile in die Tabelle zu schreiben stellt er eine Kopie der endgültigen Zeile in eine Warteschlange, die vom Handler-Thread verwaltet wird. Alle Syntaxfehler werden vom Thread erkannt und dem Client-Programm mitgeteilt.

Der Client kann die Anzahl von Duplikaten oder den AUTO_INCREMENT-Wert für die resultierende Zeile nicht mitteilen. Er kann Sie vom Server nicht erhalten, weil das INSERT zurückkehrt, bevor die Einfügeoperation fertig ist. Wenn Sie die C-API benutzen, gibt die mysql_info()-Funktion aus demselben Grund nichts Sinnvolles zurück.

Die Update-Log-Datei wird vom Handler-Thread aktualisiert, wenn die Zeile in die Tabelle eingefügt wird. Im Falle des Einfügens mehrerer Zeilen wird die Update-Log-Datei aktualisiert, wenn die erste Zeile eingefügt wird.

Nachdem alle delayed_insert_limit Zeilen geschrieben wurden, prüft der Handler, ob noch irgend welche SELECT-Statements anhängig sind oder nicht. Falls ja, gestattet er diesen, ausgeführt zu werden, bevor weiter gemacht wird.

Wenn der Handler keine Zeilen mehr in seiner Warteschlange hat, wird die Tabellensperre aufgehoben. Wenn innerhalb von delayed_insert_timeout Sekunden keine neuen INSERT DELAYED-Befehle mehr empfangen werden, beendet sich der Handler.

Wenn mehr als delayed_queue_size Zeilen bereits in einer bestimmten Handler-Warteschlange anhängig sind, wartet der Thread, der nach INSERT DELAYED anfragt, bis es wieder Platz in der Warteschlange gibt. Damit wird sichergestellt, dass der mysqld-Server nicht den gesamten Arbeitsspeicher für die DELAYED-Warteschlange verbraucht.

Der Handler-Thread zeigt sich in der MySQL-Prozessliste mit delayed_insert in der Command-Spalte. Er wird gekillt, wenn Sie einen FLUSH TABLES-Befehl ausführen oder ihn mit KILL Thread_id killen. Er wird jedoch zuerst alle Zeilen in der Warteschlange in die Tabelle schreiben, bevor er sich beendet. Während dieser Zeit akzeptiert er keine neuen INSERT-Befehle von anderen Threads mehr. Wenn Sie danach einen INSERT DELAYED-Befehl ausführen, wird ein neuer Handler-Thread erzeugt.

Beachten Sie, dass oben Gesagtes bedeutet, dass INSERT DELAYED-Befehle höhere Priorität haben als normale INSERT-Befehle, wenn es einen INSERT DELAYED-Handler gibt, der bereits läuft! Andere Aktualisierungsbefehle müssen warten, bis die INSERT DELAYED-Warteschlange leer ist, jemand den Handler-Thread killt (mit KILL Thread_id) oder jemand FLUSH TABLES ausführt.

Die folgenden Status-Variablen stellen Informationen über INSERT DELAYED-Befehle bereits:

Sie können diese Variablen betrachten, wenn Sie ein SHOW STATUS-Statement oder einen mysqladmin extended-status-Befehl ausführen.

TRUNCATE führt ein Löschen und Neuerzeugen der Tabelle durch, was viel schneller sit, als Zeilen eine nach der anderen zu löschen.

Nicht transaktionssicher. Sie erhalten einen Fehler, wenn Sie eine aktive Transaktion haben oder eine aktive Tabellensperre.

Gibt die Anzahl gelöschter Zeilen nicht zurück.

Solange die Tabellendefinitionsdatei tabelle.frm gültig ist, kann die Tabelle auf diese Weise neu erzeugt werden, selbst wenn die Daten- oder Index-Dateien beschädigt wurden.

Wenn ein absoluter Pfadname angegeben wird, benutzt der Server den Pfadnamen so, wie er ist.

Wenn ein relativer Pfadname mit einer oder mehreren führenden Bestandteilen angegeben wird, sucht der Server die Datei relativ zum Daten-Verzeichnis des Servers.

Wenn ein Dateiname ohne führende Bestandteile angegeben wird, sucht der Server die Datei im Datenbank-Verzeichnis der aktuellen Datenbank.

Zeilenbegrenzungen werden an Neue-Zeile-Zeichen gesucht (\n).

Zeilen werden an Tabulatoren (\t) in Felder aufgeteilt.

Es wird nicht davon ausgegangen, dass Felder in Anführungszeichen eingeschlossen sind.

Tabulatoren, Neue-Zeile-Zeichen oder ‘\’, denen ein ‘\’-Zeichen voran gestellt ist, werden als Literale interpretiert, die Teil des Feldwerts sind.

Zwischen Felder werden Tabulatoren (\t) geschrieben.

Felder werden nicht in Anführungsstriche geschrieben.

‘\’ wird benutzt, um Tabulator, Neue-Zeile-Zeichen oder ‘\’ innerhalb von Feldwerten zu escapen.

Am Ende von Zeilen werden Neue-Zeile-Zeichen (\n) geschrieben.

Dem FIELDS ESCAPED BY-Zeichen

Dem FIELDS [OPTIONALLY] ENCLOSED BY-Zeichen

Dem ersten Zeichen von FIELDS TERMINATED BY- und LINES TERMINATED BY-Werten

ASCII 0 (was tatsächlich nach dem Fluchtzeichen (Escape-Zeichen) als ASCII '0' geschrieben wird, nicht ein Byte mit Wert 0)

Wenn LINES TERMINATED BY eine leere Zeichenkette ist und FIELDS TERMINATED BY nicht leer ist, werden Zeile auch durch FIELDS TERMINATED BY begrenzt.

Wenn die FIELDS TERMINATED BY- und FIELDS ENCLOSED BY-Werte beide leer sind (''), wird ein Festzeilen- (nicht begrenztes) Format benutzt. Beim Festzeilenformat werden keine Begrenzer zwischen Feldern benutzt. Statt dessen werden Spaltenwerte geschrieben und gelesen, indem die Anzeigebreite der Spalten benutzt wird. Wenn eine Spalte zum Beispiel als INT(7) deklariert ist, werden Werte für die Spalte mit 7-Zeichen-Feldern geschrieben. Bei der Eingabe werden Werte für die Spalte mit 7-Zeichen-Feldern bezogen. Festzeilenformate beeinflussen auch die Handhabung von NULL-Werten (siehe unten). Beachten Sie, dass Festgrößenformate nicht funktionieren, wenn Sie einen Multi-Byte-Zeichensatz benutzen.

Bei den vorgabemäßigen FIELDS- und LINES-Werten wird NULL für die Ausgabe als \N geschrieben und \N als NULL für die Eingabe gelesen (unter der Annahme, dass das ESCAPED BY-Zeichen ‘\’ ist).

Wenn FIELDS ENCLOSED BY nicht leer ist, wird ein Feld, das das Literalwort NULL als seinen Wert enthält, als NULL-Wert gelesen (das weicht ab vom Wort NULL, begrenzt durch FIELDS ENCLOSED BY-Zeichen, was als die Zeichenkette 'NULL' gelesen wird).

Wenn FIELDS ESCAPED BY leer ist, wird NULL als das Wort NULL gelesen.

Beim Festzeilenformat (was auftritt, wenn sowohl FIELDS TERMINATED BY als auch FIELDS ENCLOSED BY leer sind), wird NULL als leere Zeichenkette geschrieben. Beachten Sie, dass das dazu führt, dass NULL-Werte und leere Zeichenketten in der Tabelle nicht mehr unterscheidbar sind, wenn in die Datei geschrieben wird, weil sie beide als leere Zeichenketten geschrieben werden. Wenn Sie in der Lage sein müssen, diese zu unterscheiden, wenn Sie die Datei wieder einlesen, sollten Sie kein Festzeilenformat benutzen.

Festgrößenzeilen (FIELDS TERMINATED BY und FIELDS ENCLOSED BY sind beide leer) und BLOB- oder TEXT-Spalten.

Wenn Sie ein Trennzeichen angeben, das dasselbe wie ein anderes ist oder einem anderen vorangestellt ist. LOAD DATA INFILE kann in diesem Fall die Eingabe nicht korrekt interpretieren. Folgende FIELDS-Klausel zum Beispiel würde Probleme bereiten:

FIELDS TERMINATED BY '"' ENCLOSED BY '"'

Wenn FIELDS ESCAPED BY leer ist, führt ein Feldwert, der ein Vorkommen von FIELDS ENCLOSED BY oder LINES TERMINATED BY gefolgt vom FIELDS TERMINATED BY-Wert enthält, dazu, dass LOAD DATA INFILE mit dem Einlesen eines Feldes oder einer Zeile zu früh aufhört. Das passiert, weil LOAD DATA INFILE nicht korrekt festlegen kann, wo der Feld- oder Zeilenwert endet.

Bei Zeichenketten-Typen wird die Spalte auf die leere Zeichenkette gesetzt.

Bei numerischen Typen wird die Spalte auf 0 gesetzt.

Bei Datums- und Zeit-Typen wird die Spalte auf den entsprechenden ``0''-Wert für den Typ gesetzt. See Abschnitt 7.2.2, „Datums- und Zeit-Typen“.