Hilfsfunktionen

Skalare Hilfsfunktionen

Die folgenden Funktionen lassen sich schwer einzelnen Funktionstypen zuordnen und sind allgemein nützlich.

Name	Beschreibung
`alias(column)`	Gibt den Namen der Spalte zurück.
`can_cast_implicitly(source_value, target_value)`	Ob wir implizit vom Typ des Quellwerts auf den Zielwert casten können.
`checkpoint(database)`	Synchronisiert das WAL mit der Datei für die (optionale) Datenbank, ohne Transaktionen zu unterbrechen.
`coalesce(expr, ...)`	Gibt den ersten Ausdruck zurück, der zu einem Nicht-`NULL`-Wert auswertet. Nimmt 1 oder mehr Parameter entgegen. Jeder Ausdruck kann eine Spalte, ein Literal, ein Funktionsergebnis oder vieles andere sein.
`constant_or_null(arg1, arg2)`	Ist `arg2` `NULL`, wird `NULL` zurückgegeben. Sonst wird `arg1` zurückgegeben.
`count_if(x)`	Aggregatfunktion; Zeilen tragen 1 bei, wenn `x` `true` oder eine Zahl ungleich null ist, sonst 0.
`create_sort_key(parameters...)`	Konstruiert einen binär vergleichbaren Sortierschlüssel aus einer Menge von Eingabeparametern und Sortierqualifizierern.
`current_catalog()`	Gibt den Namen des derzeit aktiven Katalogs zurück. Standard ist memory.
`current_database()`	Gibt den Namen der derzeit aktiven Datenbank zurück.
`current_query()`	Gibt die aktuelle Abfrage als Zeichenkette zurück.
`current_schema()`	Gibt den Namen des derzeit aktiven Schemas zurück. Standard ist main.
`current_schemas(boolean)`	Gibt die Liste der Schemata zurück. Übergeben Sie den Parameter `true`, um implizite Schemata einzuschließen.
`current_setting('setting_name')`	Gibt den aktuellen Wert der Konfigurationseinstellung zurück.
`currval('sequence_name')`	Gibt den aktuellen Wert der Sequenz zurück. Beachten Sie, dass `nextval` mindestens einmal vor dem Aufruf von `currval` aufgerufen worden sein muss.
`error(message)`	Wirft die angegebene Fehlermeldung `message`.
`equi_width_bins(min, max, bincount, nice := false)`	Gibt die oberen Grenzen einer Partition des Intervalls `[min, max]` in `bin_count` gleich große Teilintervalle zurück (zur Verwendung z. B. mit `histogram`). Ist `nice = true`, können `min`, `max` und `bincount` angepasst werden, um ästhetisch gefälligere Ergebnisse zu erzeugen.
`force_checkpoint(database)`	Synchronisiert das WAL mit der Datei für die (optionale) Datenbank und unterbricht Transaktionen.
`gen_random_uuid()`	Gibt eine zufällige UUID ähnlich dieser zurück: `eeccb8c5-9943-b2bb-bb5e-222f4e14b687`.
`getenv(var)`	Gibt den Wert der Umgebungsvariable `var` zurück. Nur im Kommandozeilen-Client verfügbar.
`getvariable('variable_name')`	Gibt den Wert der SQL-Variable namens `variable_name` zurück oder `NULL`, wenn sie nicht gesetzt ist.
`hash(value)`	Gibt ein `UBIGINT` mit einem Hash von `value` zurück. Die verwendete Hashfunktion kann sich zwischen DuckDB-Versionen ändern.
`icu_sort_key(string, collator)`	Surrogat-Sortierschlüssel zum Sortieren von Sonderzeichen gemäß der jeweiligen Locale. Der Collator-Parameter ist optional. Nur verfügbar, wenn die ICU-Erweiterung installiert ist.
`if(a, b, c)`	Ternärer bedingter Operator.
`ifnull(expr, other)`	Eine zweiargumentige Variante von coalesce.
`is_histogram_other_bin(arg)`	Gibt `true` zurück, wenn `arg` das „Auffangelement“ seines Datentyps für die Funktion `histogram_exact` ist, das der „rechtesten Grenze“ seines Datentyps für die Funktion `histogram` entspricht.
`md5(string)`	Gibt den MD5-Hash der `string` als `VARCHAR` zurück.
`md5_number(string)`	Gibt den MD5-Hash der `string` als `UHUGEINT` zurück.
`md5_number_lower(string)`	Gibt das untere 64-Bit-Segment des MD5-Hash der `string` als `UBIGINT` zurück.
`md5_number_upper(string)`	Gibt das obere 64-Bit-Segment des MD5-Hash der `string` als `UBIGINT` zurück.
`nextval('sequence_name')`	Gibt den folgenden Wert der Sequenz zurück.
`nullif(a, b)`	Gibt `NULL` zurück, wenn `a = b`, sonst `a`. Entspricht `CASE WHEN a = b THEN NULL ELSE a END`.
`parse_formatted_bytes(string)`	Parst eine menschenlesbare Bytegrößen-Zeichenkette (z. B. `'16 KiB'`) in eine `UBIGINT`-Anzahl von Bytes. Wirft bei ungültiger Eingabe einen Fehler.
`pg_typeof(expression)`	Gibt den kleingeschriebenen Namen des Datentyps des Ausdrucksergebnisses zurück. Für PostgreSQL-Kompatibilität.
`query(``query_string``)`	Tabellenfunktion, die die in `query_string` definierte Abfrage parst und ausführt. Nur konstante Zeichenketten sind erlaubt. Warnung: Diese Funktion erlaubt das Ausführen beliebiger Abfragen und kann den Datenbankzustand ändern.
`query_table(``tbl_name``)`	Tabellenfunktion, die die in `tbl_name` angegebene Tabelle zurückgibt.
`query_table(``tbl_names``, [``by_name``])`	Tabellenfunktion, die die Vereinigung der in `tbl_names` angegebenen Tabellen zurückgibt. Ist der optionale Parameter `by_name` auf `true` gesetzt, wird die Semantik von `UNION ALL BY NAME` verwendet.
`read_blob(source)`	Gibt den Inhalt von `source` (ein Dateiname, eine Liste von Dateinamen oder ein Glob-Muster) als `BLOB` zurück. Details finden Sie im Leitfaden zu `read_blob`.
`read_text(source)`	Gibt den Inhalt von `source` (ein Dateiname, eine Liste von Dateinamen oder ein Glob-Muster) als `VARCHAR` zurück. Der Dateiinhalt wird zuerst auf gültiges UTF-8 geprüft. Versucht `read_text`, eine Datei mit ungültigem UTF-8 zu lesen, wird ein Fehler ausgelöst, der vorschlägt, stattdessen `read_blob` zu verwenden. Details finden Sie im Leitfaden zu `read_text`.
`replace_type(value, source_type, target_type)`	Castet rekursiv jedes Feld von `value`, das den Typ `source_type` hat, nach `target_type`. Die Typen werden als `NULL`-typisierte Werte angegeben, z. B. `NULL::VARCHAR`.
`sha1(string)`	Gibt ein `VARCHAR` mit dem SHA-1-Hash der `string` zurück.
`sha256(string)`	Gibt ein `VARCHAR` mit dem SHA-256-Hash der `string` zurück.
`sleep_ms(milliseconds)`	Pausiert die Ausführung für die angegebene Anzahl von Millisekunden. Gibt `NULL` zurück.
`stats(expression)`	Gibt eine Zeichenkette mit Statistiken zum Ausdruck zurück. Der Ausdruck kann eine Spalte, eine Konstante oder ein SQL-Ausdruck sein.
`txid_current()`	Gibt die Kennung der aktuellen Transaktion als `BIGINT` zurück. Weist eine neue zu, wenn die aktuelle Transaktion noch keine hat.
`typeof(expression)`	Gibt den Namen des Datentyps des Ausdrucksergebnisses zurück.
`uuid()`	Gibt eine zufällige UUID (UUIDv4) ähnlich dieser zurück: `eeccb8c5-9943-b2bb-bb5e-222f4e14b687`.
`uuidv4()`	Gibt eine zufällige UUID (UUIDv4) ähnlich dieser zurück: `eeccb8c5-9943-b2bb-bb5e-222f4e14b687`.
`uuidv7()`	Gibt eine zufällige UUIDv7 ähnlich dieser zurück: `81964ebe-00b1-7e1d-b0f9-43c29b6fb8f5`.
`uuid_extract_timestamp(uuidv7)`	Extrahiert `TIMESTAMP WITH TIME ZONE` aus einem UUIDv7-Wert.
`uuid_extract_version(uuid)`	Extrahiert die UUID-Version (`4` oder `7`).
`version()`	Gibt die derzeit aktive Version von DuckDB in diesem Format zurück.

`alias(column)`

`can_cast_implicitly(source_value, target_value)`

`checkpoint(database)`

`coalesce(expr, ...)`

| Beschreibung | Gibt den ersten Ausdruck zurück, der zu einem Nicht-NULL-Wert auswertet. Nimmt 1 oder mehr Parameter entgegen. Jeder Ausdruck kann eine Spalte, ein Literal, ein Funktionsergebnis oder vieles andere sein. | | Beispiel | coalesce(NULL, NULL, 'default_string') | | Ergebnis | default_string |

`constant_or_null(arg1, arg2)`

`count_if(x)`

`create_sort_key(parameters...)`

`current_catalog()`

`current_database()`

`current_query()`

`current_schema()`

`current_schemas(boolean)`

`current_setting('setting_name')`

`currval('sequence_name')`

`error(message)`

`equi_width_bins(min, max, bincount, nice := false)`

| Beschreibung | Gibt die oberen Grenzen einer Partition des Intervalls [min, max] in bin_count gleich große Teilintervalle zurück (zur Verwendung z. B. mit histogram). Ist nice = true, können min, max und bincount angepasst werden, um ästhetisch gefälligere Ergebnisse zu erzeugen. | | Beispiel | equi_width_bins(0.1, 2.7, 4, true) | | Ergebnis | [0.5, 1.0, 1.5, 2.0, 2.5, 3.0] |

`force_checkpoint(database)`

`gen_random_uuid()`

`getenv(var)`

`getvariable('variable_name')`

`hash(value)`

`icu_sort_key(string, collator)`

| Beschreibung | Surrogat-Sortierschlüssel zum Sortieren von Sonderzeichen gemäß der jeweiligen Locale. Der Collator-Parameter ist optional. Nur verfügbar, wenn die ICU-Erweiterung installiert ist. | | Beispiel | icu_sort_key('ö', 'DE') | | Ergebnis | 460145960106 |

`if(a, b, c)`

`ifnull(expr, other)`

`is_histogram_other_bin(arg)`

| Beschreibung | Gibt true zurück, wenn arg das „Auffangelement“ seines Datentyps für die Funktion histogram_exact ist, das der „rechtesten Grenze“ seines Datentyps für die Funktion histogram entspricht. | | Beispiel | is_histogram_other_bin('') | | Ergebnis | true |

`md5(string)`

`md5_number(string)`

`md5_number_lower(string)`

`md5_number_upper(string)`

`nextval('sequence_name')`

`nullif(a, b)`

`parse_formatted_bytes(string)`

`pg_typeof(expression)`

`query(query_string)`

| Beschreibung | Tabellenfunktion, die die in query_string definierte Abfrage parst und ausführt. Nur konstante Zeichenketten sind erlaubt. Warnung: Diese Funktion erlaubt das Ausführen beliebiger Abfragen und kann den Datenbankzustand ändern. | | Beispiel | query('SELECT 42 AS x') | | Ergebnis | 42 |

`query_table(tbl_name)`

`query_table(tbl_names, [by_name])`

| Beschreibung | Tabellenfunktion, die die Vereinigung der in tbl_names angegebenen Tabellen zurückgibt. Ist der optionale Parameter by_name auf true gesetzt, wird die Semantik von UNION ALL BY NAME verwendet. | | Beispiel | query_table(['t1', 't2']) | | Ergebnis | (die Vereinigung der beiden Tabellen) |

`read_blob(source)`

`read_text(source)`

| Beschreibung | Gibt den Inhalt von source (ein Dateiname, eine Liste von Dateinamen oder ein Glob-Muster) als VARCHAR zurück. Der Dateiinhalt wird zuerst auf gültiges UTF-8 geprüft. Versucht read_text, eine Datei mit ungültigem UTF-8 zu lesen, wird ein Fehler ausgelöst, der vorschlägt, stattdessen read_blob zu verwenden. Details finden Sie im Leitfaden zu read_text. | | Beispiel | read_text('hello.txt') | | Ergebnis | hello\n |

`replace_type(value, source_type, target_type)`

| Beschreibung | Castet rekursiv jedes Feld von value, das den Typ source_type hat, nach target_type. Quell- und Zieltyp werden als NULL-typisierte Werte angegeben, z. B. NULL::VARCHAR. Nützlich, um die Feldtypen eines tief verschachtelten Werts (z. B. eines STRUCT oder einer LIST) in einem Aufruf umzuwandeln. | | Beispiel | replace_type([{'a': '42'}], NULL::VARCHAR, NULL::INTEGER) | | Ergebnis | [{'a': 42}] |

`sha1(string)`

`sha256(string)`

`sleep_ms(milliseconds)`

`stats(expression)`

`txid_current()`

`typeof(expression)`

`uuid()`

`uuidv4()`

`uuidv7()`

`uuid_extract_timestamp(uuidv7)`

`uuid_extract_version(uuid)`

`version()`

Hilfs-Tabellenfunktionen

Eine Tabellenfunktion wird anstelle einer Tabelle in einer FROM-Klausel verwendet.

Name	Beschreibung
`glob(search_path)`	Gibt Dateinamen am durch search_path angegebenen Ort in einer einzelnen Spalte namens `file` zurück. Der search_path kann Glob-Muster-Syntax enthalten.
`repeat_row(varargs, num_rows)`	Gibt eine Tabelle mit `num_rows` Zeilen zurück, die jeweils die in `varargs` definierten Felder enthalten.

`glob(search_path)`

`repeat_row(varargs, num_rows)`