Tabellenfunktionen¶
Eine Tabellenfunktion gibt für jede Eingabezeile eine Menge von Zeilen zurück. Die zurückgegebene Menge kann null, eine oder mehrere Zeilen enthalten, von denen jede eine oder mehrere Spalten enthalten kann.
Folgende Funktionen auf den Tabellen wären beispielsweise geeignet:
Eine Funktion, die ein Datum als Argument akzeptiert und eine Menge von Zeilen zurückgibt, in denen Orte aufgelistet sind, die an diesem Tag Rekordtemperaturen aufwiesen. (Mehrere Orte könnten am selben Tag Rekordtemperaturen erreichen.)
Eine Funktion, die eine Kontonummer und ein Datum akzeptiert und alle Gebühren zurückgibt, die diesem Konto an diesem Datum in Rechnung gestellt wurden. (Es kann sein, dass an einem bestimmten Datum mehr als eine Gebühr abgerechnet wurde).
In jedem dieser Beispiele könnte die Funktion null Zeilen zurückgeben (z. B. wenn es an diesem Tag keine Rekordtemperaturen gab), eine Zeile (wenn ein Ort an diesem Tag eine Rekordtemperatur erzielte) oder mehrere Zeilen (wenn viele Orte Rekordtemperaturen erreichten).
Jede Eingabezeile einer Tabellenfunktion besteht aus null, einem oder mehreren Argumenten. Jedes Argument muss ein skalarer Ausdruck sein.
Eine Tabellenfunktion wird in die FROM-Klausel einer SQL-Anweisung aufgenommen. Der Aufruf der Tabellenfunktion ist normalerweise in TABLE() eingeschlossen. Die folgende Anweisung ruft z. B. eine Tabellenfunktion namens record_high_temperatures() auf, die einen DATE-Wert als Argument erwartet:
SELECT city_name, temperature FROM TABLE(record_high_temperatures_for_date('2021-06-27'::DATE)) ORDER BY city_name;
Tabellenfunktionen können in zwei Unterkategorien eingeteilt werden:
1:N-Funktionen
M:N-Funktionen
In einer 1:N-Funktion generiert jede Eingabezeile n Ausgabezeilen (wobei N null, eins oder mehr sein kann). Die obigen Beispiele sind 1:N-Funktionen. Beispielsweise wird jedes Mal, wenn die Funktion RECORD_HIGH_TEMPERATURES_FOR_DATE() aufgerufen und ein Datum übergeben wird, von der Funktion eine Menge von Zeilen zurückgegeben. Die Zeilen für jedes Datum sind unabhängig von den Zeilen für jedes andere Datum. Die meisten Tabellenfunktionen sind 1:N-Funktionen.
Bei einer M:N-Funktion generiert eine Gruppe von m Eingabezeilen eine Gruppe von N Ausgabezeilen. M kann eine oder mehrere Zeilen sein. N kann null, eine oder mehrere Zeilen sein. Sie können zum Beispiel eine Funktion schreiben, die den gleitenden Durchschnitt einer Menge von M Zeilen zurückgibt. Angenommen, Sie möchten den 10-tägigen gleitenden Durchschnitt eines Aktienkurses wissen. Außerdem angenommen, dass Sie möchten, dass der gleitende 10-Tage-Durchschnitt erst dann Ausgabezeilen generiert, wenn die Funktion mindestens 10 Zeilen verarbeitet hat, und dass Sie nicht möchten, dass der Durchschnitt Zeilen aus verschiedenen Monaten verwendet. In diesem Beispiel würde die Funktion für Januar 31 Eingabezeilen haben (weil der Januar 31 Tage hat) und 22 Ausgabezeilen (die erste Ausgabezeile ist der 10. Januar und die letzte Ausgabezeile ist am 31. Januar). In diesem Beispiel variieren sowohl M als auch N, abhängig von der Länge des Monats.
Tabellenfunktionen können integriert oder benutzerdefiniert sein. Eingebaute Tabellenfunktionen sind in Liste der systemdefinierten Tabellenfunktionen aufgeführt. Informationen über benutzerdefinierte Funktionen, einschließlich benutzerdefinierter Tabellenfunktionen, finden Sie unter UDFs (Benutzerdefinierte Funktionen).
Tabellenfunktionen werden manchmal auch als „tabellarische Funktionen“ bezeichnet.
Unter diesem Thema:
Liste der systemdefinierten Tabellenfunktionen¶
Snowflake stellt die folgenden systemdefinierten Tabellenfunktionen bereit:
Unterkategorie |
Funktion |
Anmerkungen |
|---|---|---|
Laden von Daten |
Weitere Informationen dazu finden Sie unter Laden von Daten in Snowflake. |
|
Datengenerierung |
||
Datenkonvertierung |
||
Objektmodellierung |
||
Semistrukturierte Abfragen |
Weitere Informationen dazu finden Sie unter Abfragen von semistrukturierten Daten. |
|
Abfrageergebnisse |
Kann verwendet werden, um SQL-Operationen bei der Ausgabe einer anderen SQL-Operation auszuführen (z. B. SHOW) |
|
Verlaufs- und Nutzungsinformationen (Information Schema, Account Usage): |
||
Benutzeranmeldung
|
||
Abfragen
|
||
Warehouse- und Speichernutzung
|
||
Sicherheit auf Spaltenebene & auf Zeilenebene
|
||
Tags
|
Information Schema-Tabellenfunktion . Account Usage-Tabellenfunktion |
|
Datenbankreplikation
|
DATABASE_REFRESH_HISTORY DATABASE_REFRESH_PROGRESS , DATABASE_REFRESH_PROGRESS_BY_JOB REPLICATION_USAGE_HISTORY |
Weitere Informationen dazu finden Sie unter Replizieren von Datenbanken über mehrere Konten. |
Laden von Daten und Datenübertragung
|
||
Daten-Clustering (innerhalb von Tabellen)
|
Weitere Informationen dazu finden Sie unter Automatic Clustering. |
|
Externe Funktionen
|
Weitere Informationen dazu finden Sie unter Externe Funktionen. |
|
Externe Tabellen
|
Weitere Informationen dazu finden Sie unter Verwenden von externen Tabellen. |
|
Verwaltung materialisierter Ansichten
|
Weitere Informationen dazu finden Sie unter Verwenden von materialisierten Ansichten. |
|
SCIM-Verwaltung
|
Weitere Informationen dazu finden Sie unter Überwachen mit SCIM. |
|
Verwaltung der Suchoptimierung
|
Weitere Informationen dazu finden Sie unter Verwenden des Suchoptimierungsdienstes. |
|
Aufgabenverwaltung
|
Weitere Informationen dazu finden Sie unter Ausführen von SQL-Anweisungen für einen Zeitplan mithilfe von Aufgaben. |
|
Syntax¶
SELECT ...
FROM [ <input_table> [ [AS] <alias_1> ] ,
[ LATERAL ]
]
TABLE( <table_function>( [ <arg_1> [, ... ] ] ) ) [ [ AS ] <alias_2> ];
Informationen zur funktionsspezifischen Syntax finden Sie in der Dokumentation zu den einzelnen systemdefinierten Tabellenfunktionen.
Nutzungshinweise¶
Tabellenfunktionen können mit dem LATERAL-Konstrukt auch auf einen Satz von Zeilen angewendet werden.
Um die Verwendung von Tabellenausdrücken zu ermöglichen, unterstützt Snowflake die ANSI/ISO-Standardsyntax für Tabellenausdrücke in der FROM-Klausel von Abfragen und Unterabfragen. Diese Syntax wird verwendet, um anzugeben, dass ein Ausdruck eine Sammlung von Zeilen anstelle einer einzelnen Zeile zurückgibt.
Die ANSI/ISO-Syntax ist nur in der FROM-Klausel der SELECT-Liste gültig. Sie können diese Schlüsselwörter und Klammern in einer Spezifikation für eine Unterabfrage einer Sammlung in keinem anderen Kontext weglassen.