Freigeben über


SQL-Referenz

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