Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dies ist eine SQL-Befehlsreferenz für Databricks SQL und Databricks Runtime.
Informationen zum Verstehen und Verwenden der Syntaxnotation und der Symbole in dieser Referenz finden Sie unter Verwendung der SQL-Referenz.
Informationen zur Verwendung von SQL mit Lakeflow Spark Declarative Pipelines finden Sie in der SQL-Sprachreferenz für Pipelines.
Note
Databricks SQL Serverless ist in Azure China nicht verfügbar. Databricks SQL ist in Azure Government-Regionen nicht verfügbar.
Allgemeine Referenz
In dieser allgemeinen Referenz werden Datentypen, Funktionen, Bezeichner, Literale und Semantik beschrieben.
Grundlagen der Sprache
| Reference | Description |
|---|---|
| Hinzufügen von Kommentaren zu SQL-Anweisungen | Hinzufügen von Kommentaren zu Ihrem SQL-Code |
| Reservierte Wörter und Schemas | Vom SQL-Parser reservierte Schlüsselwörter |
| Identifiers | Regeln zum Benennen von Datenbankobjekten |
| Names | Namenskonventionen für Objekte |
| IDENTIFIER-Klausel | Dynamische Bezeichnerauflösung |
| SQL-Ausdruck | Syntax und Auswertung von SQL-Ausdrücken |
| NULL-Semantik | Behandlung von NULL-Werten |
| Parametermarker | Parametrisierte Abfrageplatzhalter |
| Variables | Sitzungs- und temporäre Variablen |
| Namensauflösung | Wie Objektnamen aufgelöst werden |
| JSON-Pfadausdruck | Navigieren in JSON-Datenstrukturen |
| Collation | Zeichenfolgenvergleichs- und Sortierregeln |
| Partitions | Konzepte für die Tabellenpartitionierung |
Datentypen
| Reference | Description |
|---|---|
| Datentypen | Übersicht über alle unterstützten Datentypen |
| SQL-Datentypregeln | Typkoersions- und Konvertierungsregeln |
| Datetime-Muster | Formatvorlagen für Datums- und Uhrzeitangaben |
Konfigurationsparameter
| Reference | Description |
|---|---|
| Konfigurationsparameter | Übersicht über die SQL-Konfiguration |
| ANSI_MODE | ANSI SQL-Kompatibilitätsmodus |
| LEGACY_TIME_PARSER_POLICY | Zeitanalyseverhalten |
| MAX_FILE_PARTITION_BYTES | Grenzwert für die Dateigröße der Dateipartition |
| READ_ONLY_EXTERNAL_METASTORE | Zugriffsmodus für externen Metastore |
| STATEMENT_TIMEOUT | Abfragetimeouteinstellung |
| TIMEZONE | Sitzungszeitzone |
| USE_CACHED_RESULT | Zwischenspeichern von Abfrageergebnissen |
Funktionen
| Reference | Description |
|---|---|
| Functions | Übersicht über SQL-Funktionen |
| Integrierte Funktionen | Alle integrierten Funktionen |
| Alphabetische Liste der integrierten Funktionen | Vollständige A-Z-Funktionsreferenz |
| Fensterfunktionen | Analyse- und Bewertungsfunktionen |
| Lambda-Funktionen | Anonyme Funktionsausdrücke |
| H3 Geodaten-Funktionen | Sechseckiger hierarchischer räumlicher Index |
| ST-Geospatialfunktionen | Standard-Geospatialfunktionen |
| Benutzerdefinierte Aggregatfunktionen (User-Defined Aggregate Functions, UDAFs) | Benutzerdefinierte Aggregationsfunktionen |
| Externe benutzerdefinierte Skalarfunktionen (User Defined Functions, UDFs) | Benutzerdefinierte Skalarfunktionen |
| Integration in Hive-UDFs, -UDAFs und -UDTFs | Kompatibilität der Strukturfunktion |
| Funktionsaufruf | Aufrufen von Funktionen |
Unity-Katalogkonzepte
| Reference | Description |
|---|---|
| Prinzipal | Benutzer, Gruppen und Dienstprinzipale |
| Privilegien und sichere Objekte im Unity Catalog | Zugriffssteuerung im Unity-Katalog |
| Privilegien und sichere Objekte im Hive-Metastore | Legacy-Metastore-Zugriffssteuerung |
| Externe Speicherorte | Cloudspeicherorte |
| externe Tabellen | Tabellen, die von externen Daten gesichert werden |
| Credentials | Anmeldeinformationen für den Speicherzugriff |
| Volumes | Verwalteter und externer Dateispeicher |
Spezielle Themen
| Reference | Description |
|---|---|
| ANSI Compliance in Databricks Runtime | ANSI SQL-Standardkompatibilität |
| Apache Hive Kompatibilität | Sql-Kompatibilität der Struktur |
| SQL-Skripting | Prozedurale SQL-Logik |
| Delta-Freigabe | Organisationsübergreifende Datenfreigabe |
| Verbundabfragen (Lakehouse-Verbund) | Abfragen externer Datenbanken |
| Informationsschema | Metadatensystemtabellen |
DDL-Anweisungen
Datendefinitionsanweisungen erstellen oder ändern die Struktur von Datenbankobjekten.
ALTER-Anweisungen
| Erklärung | Description |
|---|---|
| ALTER CATALOG | Ändern von Katalogeigenschaften |
| ALTER CONNECTION | Ändern von Verbindungseinstellungen |
| ALTER CREDENTIAL | Ändern von Anmeldeinformationseigenschaften |
| ALTER DATABASE | Ändern von Datenbankeigenschaften |
| ALTER EXTERNAL LOCATION | Ändern des externen Speicherorts |
| ALTER MATERIALIZED VIEW | Materialisierte Ansicht ändern |
| ALTER PROVIDER | Ändern des Datenanbieters |
| ALTER RECIPIENT | Ändern des Freigabeempfängers |
| ALTER SCHEMA | Ändern von Schemaeigenschaften |
| ALTER SHARE | Ändern der Freigabekonfiguration |
| ALTER STREAMING TABLE | Streamingtabelle ändern |
| ALTER TABLE | Ändern der Tabellenstruktur |
| ALTER VIEW | Ansichtsdefinition ändern |
| ALTER VOLUME | Ändern von Volumeeigenschaften |
CREATE-Anweisungen
| Erklärung | Description |
|---|---|
| CREATE BLOOM FILTER INDEX | Erstellen des Bloom-Filterindex |
| CREATE CATALOG | Erstellen eines neuen Katalogs |
| CREATE CONNECTION | Erstellen einer externen Verbindung |
| CREATE DATABASE | Erstellen einer neuen Datenbank |
| CREATE FUNCTION (SQL und Python) | SQL-Funktion erstellen |
| CREATE FUNCTION (Extern) | Externe Funktion erstellen |
| CREATE EXTERNAL LOCATION | Erstellen eines externen Speicherorts |
| CREATE MATERIALIZED VIEW | Materialisierte Ansicht erstellen |
| PROZEDUR ERSTELLEN | Erstellen einer gespeicherten Prozedur |
| CREATE RECIPIENT | Erstellen eines Freigabeempfängers |
| CREATE SCHEMA | Erstellen eines neuen Schemas |
| CREATE SERVER | Erstellen eines Fremdservers |
| CREATE SHARE | Erstellen einer Datenfreigabe |
| CREATE STREAMING TABLE | Erstellen einer Streamingtabelle |
| CREATE TABLE | Erstellen einer neuen Tabelle |
| CREATE VIEW | Erstellen einer Ansicht |
| CREATE VOLUME | Erstellen Sie ein Volumen |
DROP-Anweisungen
Analysieren von Anweisungen
Andere DDL-Anweisungen
| Erklärung | Description |
|---|---|
| COMMENT ON | Hinzufügen von Kommentaren zu Objekten |
| DECLARE VARIABLE | Deklarieren der Sitzungsvariable |
| REPAIR TABLE | Wiederherstellen von Tabellenpartitionen |
| REFRESH FOREIGN (CATALOG, SCHEMAund TABLE) | Aktualisieren von Fremdmetadaten |
| REFRESH (MATERIALIZED VIEW oder STREAMING TABLE) | Aktualisieren materialisierter Daten |
| SET ETIKETT | Hinzufügen von Tags zu Objekten |
SYNC |
Synchronisieren von Metadaten |
| TRUNCATE TABLE | Entfernen aller Tabellendaten |
| UNDROP | Verworfene Tabelle wiederherstellen |
| UNET-TAG | Entfernen von Tags aus Objekten |
DML-Anweisungen
Datenmanipulationsanweisungen fügen Daten in Delta Lake-Tabellen hinzu, ändern oder löschen.
| Erklärung | Description |
|---|---|
COPY INTO |
Laden von Daten aus Dateien in eine Tabelle |
| DELETE FROM | Löschen von Zeilen aus einer Tabelle |
| INSERT | Einfügen von Zeilen in eine Tabelle |
| INSERT OVERWRITE DIRECTORY | Schreiben von Abfrageergebnissen in das Verzeichnis |
| INSERT OVERWRITE DIRECTORY mit Hive-Format | Schreiben von Ergebnissen im Hive-Format |
| LOAD DATA | Laden von Daten aus Dateien |
| MERGE INTO | Upsert-Daten in eine Tabelle |
| UPDATE | Aktualisieren von Zeilen in einer Tabelle |
Datenabrufsanweisungen
Dient zum Abrufen von Zeilen aus Tabellen gemäß den angegebenen Klauseln. Azure Databricks unterstützt sowohl die Standardsyntax SELECT als auch die SQL-Pipelinesyntax.
Abfrageanweisungen
| Erklärung | Description |
|---|---|
| Query | Vollständige Abfragesyntaxreferenz |
| SELECT (einzeln auswählen) | Auswählen von Daten aus Tabellen |
| VALUES-Klausel | Inlinetabelle erstellen |
| SQL-Pipeline-Syntax | Pipe-basierte Abfragekomposition |
| EXPLAIN | Abfrageausführungsplan anzeigen |
Abfrageklauseln
| Klausel | Description |
|---|---|
| SELECT-Klausel | Spaltenauswahl |
| * (Sternchen)-Klausel | Alle Spalten auswählen |
| Tabellenverweis | Tabellen- und Unterabfragequellen |
| JOIN | Kombinieren von Zeilen aus Tabellen |
| WHERE-Klausel | Filterzeilen |
| GROUP BY-Klausel | Gruppieren von Zeilen für Aggregation |
| HAVING-Klausel | Filtern gruppierter Zeilen |
| QUALIFY-Klausel | Ergebnisse der Filterfensterfunktion |
| ORDER BY-Klausel | Sortieren von Ergebniszeilen |
| SORT BY-Klausel | Sortieren innerhalb von Partitionen |
| CLUSTER BY Klausel (SELECT) | Verteilen und Sortieren von Daten |
| DISTRIBUTE BY-Klausel | Verteilen von Daten über Partitionen hinweg |
| LIMIT-Klausel | Einschränken von Ergebniszeilen |
| OFFSET-Klausel | Ergebniszeilen überspringen |
| PIVOT-Klausel | Drehen von Zeilen in Spalten |
| UNPIVOT-Klausel | Spalten in Zeilen drehen |
| LATERAL VIEW-Klausel | Anwenden einer Tabellengenerierungsfunktion |
| TABLESAMPLE-Klausel | Beispieltabellenzeilen |
| TvF-Aufruf (Table-Valued Function) | Funktionen, die Tabellen zurückgeben |
| Gemeinsamer Tabellenausdruck (CTE) | Benannte Unterabfragen |
| Festlegen von Operatoren | UNION, ÜBERSCHNEIDEN, AUßER |
| WINDOW-Klausel | Benannte Fensterdefinitionen |
| Hinweise | Hinweise zum Abfrageoptimierer |
Delta Lake-Anweisungen
Verwalten von Tabellen, die im Delta Lake-Format gespeichert sind. Ausführliche Informationen finden Sie unter "Was ist Delta Lake in Azure Databricks?"
| Erklärung | Description |
|---|---|
| CACHE SELECT | Cacheabfrageergebnisse |
| CONVERT TO DELTA | Wandeln Sie Parkett in Delta um. |
| DESCRIBE HISTORY | Tabellenverlauf anzeigen |
| FSCK REPAIR TABLE | Reparieren von Tabellenmetadaten |
| GENERATE | Tabellenmanifest generieren |
| OPTIMIZE | Komprimen von Tabellendateien |
| REORG TABLE | Neuorganisieren von Tabellendaten |
| RESTORE | Tabelle in früherer Version wiederherstellen |
| VACUUM | Entfernen alter Tabellendateien |
SQL-Skriptinganweisungen
Führen Sie die prozedurale Logik in SQL aus. Eine Übersicht finden Sie unter SQL-Skripting .
| Erklärung | Description |
|---|---|
| BEGIN END-Verbundanweisung | Gruppieren von Anweisungen in einem Block |
| CASE-Anweisung | Bedingungsverzweigung |
| FOR-Anweisung | Schleife über einen Bereich oder Cursor |
| GET DIAGNOSTICS-Anweisung | Abrufen von Ausführungsinformationen |
| IF THEN ELSE-Anweisung | Bedingte Ausführung |
| ITERATE-Anweisung | Weiter zur nächsten Schleifeniteration |
| LEAVE-Anweisung | Beenden einer Schleife oder eines Blocks |
| LOOP-Anweisung | Bedingungsschleife |
| REPEAT-Anweisung | Schleife, bis die Bedingung wahr ist |
| RESIGNAL-Anweisung | Erneutes Auslösen einer Ausnahme |
| SIGNAL-Anweisung | Auslösen einer Ausnahme |
| WHILE-Anweisung | Schleife, während die Bedingung wahr ist |
Zusatzangaben
Sammeln Von Statistiken, Verwalten des Zwischenspeicherns, Erkunden von Metadaten, Festlegen von Konfigurationen und Verwalten von Ressourcen.
ANALYZE-Anweisungen
| Erklärung | Description |
|---|---|
| ANALYZE TABLE … BERECHNEN VON STATISTIKEN | Berechnen von Tabellenspaltenstatistiken |
| ANALYZE TABLE … COMPUTESPEICHERMETRIKEN | Berechnen von Tabellenspeichermetriken |
Cacheanweisungen
Gilt für: Databricks Runtime
| Erklärung | Description |
|---|---|
| CACHE TABLE | Cachetabelle im Arbeitsspeicher |
| CLEAR CACHE | Entfernen aller zwischengespeicherten Daten |
| REFRESH CACHE | Aktualisieren zwischengespeicherter Daten |
| REFRESH FUNCTION | Aktualisieren von Funktionsmetadaten |
| REFRESH TABLE | Aktualisieren von Tabellenmetadaten |
| UNCACHE TABLE | Tabelle aus dem Cache entfernen |
DESCRIBE-Anweisungen
| Erklärung | Description |
|---|---|
| DESCRIBE CATALOG | Katalogdetails anzeigen |
| DESCRIBE CONNECTION | Verbindungsdetails anzeigen |
| DESCRIBE CREDENTIAL | Anzeigen von Anmeldeinformationen |
| DESCRIBE DATABASE | Datenbankdetails anzeigen |
| DESCRIBE FUNCTION | Funktionsdetails anzeigen |
| DESCRIBE EXTERNAL LOCATION | Anzeigen von Standortdetails |
| BESCHREIBEN DER PROZEDUR | Prozedurdetails anzeigen |
| DESCRIBE PROVIDER | Anbieterdetails anzeigen |
| DESCRIBE QUERY | Abfrageausgabeschema anzeigen |
| DESCRIBE RECIPIENT | Empfängerdetails anzeigen |
| DESCRIBE SCHEMA | Schemadetails anzeigen |
| DESCRIBE SHARE | Teilendetails anzeigen |
| DESCRIBE TABLE | Tabellendetails anzeigen |
| DESCRIBE VOLUME | Anzeigen von Volumendetails |
SHOW-Anweisungen
| Erklärung | Description |
|---|---|
| LIST | Auflisten von Dateien in einem Pfad |
| SHOW ALL IN SHARE | Alle Freigegebenen Objekte anzeigen |
| SHOW CATALOGS | Kataloge auflisten |
| SHOW COLUMNS | Listentabellenspalten |
| SHOW CONNECTIONS | Verbindungen auflisten |
| SHOW CREATE TABLE | Tabellen-DDL anzeigen |
| SHOW CREDENTIALS | Anmeldeinformationen auflisten |
| SHOW DATABASES | Datenbanken auflisten |
| SHOW FUNCTIONS | Listenfunktionen |
| SHOW GROUPS | Gruppen auflisten |
| SHOW EXTERNAL LOCATIONS | Externe Speicherorte auflisten |
| SHOW PARTITIONS | Listentabellenpartitionen |
| VERFAHREN ANZEIGEN | Auflisten von Prozeduren |
| SHOW PROVIDERS | Anbieter auflisten |
| SHOW RECIPIENTS | Empfänger auflisten |
| SHOW SCHEMAS | Listenschemas |
| SHOW SHARES | Freigaben auflisten |
| SHOW SHARES IN PROVIDER | Auflisten von Freigaben vom Anbieter |
| SHOW TABLE EXTENDED | Tabelleninformationen anzeigen |
| SHOW TABLES | Tabellen auflisten |
| SHOW TABLES DROPPED | Abgelegte Tabellen auflisten |
| SHOW TBLPROPERTIES | Tabelleneigenschaften anzeigen |
| SHOW USERS | Benutzer auflisten |
| SHOW VIEWS | Listenansichten |
| SHOW VOLUMES | Volumes auflisten |
Konfigurations- und Variablenverwaltung
| Erklärung | Description |
|---|---|
| CALL | Aufrufen einer gespeicherten Prozedur |
| EXECUTE IMMEDIATE | Ausführen dynamischer SQL-Dateien |
| RESET | Konfiguration auf Standard zurücksetzen |
| SET | Konfigurationsparameter festlegen |
| SET RECIPIENT | Festlegen des Freigabeempfängerkontexts |
| SET TIME ZONE | Festlegen der Sitzungszeitzone |
| SET Variable | Festlegen des Variablenwerts |
| USE CATALOG | Aktueller Katalog festlegen |
| USE DATABASE | Festlegen der aktuellen Datenbank |
| USE SCHEMA | Festlegen des aktuellen Schemas |
Ressourcenverwaltung
Gilt für: Databricks Runtime
| Erklärung | Description |
|---|---|
| ADD ARCHIVE | Hinzufügen eines Archivs zur Sitzung |
| ADD FILE | Hinzufügen einer Datei zur Sitzung |
| ADD JAR | Hinzufügen von JAR zur Sitzung |
| LIST ARCHIVE | Sitzungsarchive auflisten |
| LIST FILE | Sitzungsdateien auflisten |
| LIST JAR | Sitzungs-JARs auflisten |
Gilt für: Databricks SQL Connector
| Erklärung | Description |
|---|---|
| GET | Datei vom Volume herunterladen |
| PUT INTO | Datei auf Volume hochladen |
| REMOVE | Datei aus Volume löschen |
Sicherheitsanweisungen
Verwalten des Zugriffs auf Daten. Ausführliche Informationen finden Sie unter Hive-Metaspeicherberechtigungen und sicherungsfähige Objekte (Legacy).
| Erklärung | Description |
|---|---|
| ALTER GROUP | Ändern der Gruppenmitgliedschaft |
| CREATE GROUP | Erstellen einer neuen Gruppe |
| DENY | Berechtigungen verweigern |
| DROP GROUP | Löschen einer Gruppe |
| GRANT | Gewähren von Berechtigungen |
| GRANT ON SHARE | Gewähren des Freigabezugriffs |
| MSCK REPAIR PRIVILEGES | Reparieren von Berechtigungsmetadaten |
| REVOKE | Widerrufen von Berechtigungen |
| REVOKE ON SHARE | Freigabezugriff widerrufen |
| SHOW GRANTS | Anzeigen gewährter Berechtigungen |
| SHOW GRANTS ON SHARE | Anzeigen von Freigaberechten |
| SHOW GRANTS TO RECIPIENT | Empfängerberechtigungen anzeigen |