SQL-Referenz

Dies ist eine SQL-Befehlsreferenz für Databricks SQL und Databricks Runtime.

Hinweis

Databricks SQL ist nicht in den Azure China-Regionen verfügbar.

Bezeichnung „Gilt für“

Die SQL-Referenz umfasst sowohl Databricks SQL als auch Databricks Runtime. Ganz oben in jedem Artikel befindet sich eine Bezeichnung, die angibt, für welche Produkte und Versionen dieser Artikel gilt.

Dieser Artikel gilt beispielsweise für alle Versionen sowohl von Databricks SQL als auch von Databricks Runtime:

Gilt für: Databricks SQL Databricks Runtime

In diesem Beispiel gilt dieser Artikel für alle Databricks SQL-Versionen und Databricks Runtime Version 11.1 und höher:

Gilt für: Databricks SQL Databricks Runtime 11.1 und höher

In diesem Beispiel gilt dieser Artikel nur für Databricks SQL und wird in Databricks Runtime nicht unterstützt:

Gilt für: Databricks SQL

In einigen Fällen gilt ein Artikel größtenteils für ein Produkt, aber bestimmte Parameter im Artikel werden nur von einem Produkt oder bestimmten Versionen eines Produkts unterstützt. In diesem Fall wurde die Bezeichnung Gilt für im Artikeltext beim entsprechenden Parameter hinzugefügt. Beispiel:

Am Anfang eines Artikels kann Folgendes angegeben sein: Gilt für: Databricks SQL Databricks Runtime

Für einen bestimmten Parameter im Artikel kann Folgendes angegeben sein: Gilt für: Databricks SQL Databricks Runtime 11.1 und höher. Das bedeutet, dass der Großteil des Dokuments für alle Versionen von Databricks SQL und Databricks Runtime gilt und dass dieser spezifische Parameter von allen Versionen von Databricks SQL, aber nur von der Databricks Runtime-Version 11.1 und höher unterstützt wird.

Für einen anderen Parameter im Artikel kann Folgendes angegeben sein: Gilt für: Databricks Runtime 11.1 und höher. Das bedeutet, dass der Großteil des Dokuments für alle Versionen von Databricks SQL und Databricks Runtime gilt, aber dieser spezifische Parameter von Databricks SQL gar nicht und für Databricks Runtime nur von Version 11.1 und höher unterstützt wird.

Allgemeine Referenz

In dieser allgemeinen Referenz werden Datentypen, Funktionen, Bezeichner, Literale und Semantik beschrieben:

• Lesen eines Syntaxdiagramms
• Konfigurationsparameter
• Databricks SQL: Datentypen
• Funktionen
• SQL-Datentypregeln
• datetime-Muster
• H3 geospatiale Funktionen
• Databricks SQL: Lambda-Funktionen
• Fensterfunktionen
• Identifiers (Bezeichner)
• Namen
• NULL-Semantik
• Ausdrücke
• Namensauflösung
• JSON-Pfadausdrücke
• Partitionen
• ANSI-Kompatibilität
• Apache Hive-Kompatibilität
• Principals
• Berechtigungen und sicherungsfähige Objekte in Unity Catalog
• Berechtigungen und sicherungsfähige Objekte im Hive-Metastore
• Externe Speicherorte
• Externe Tabellen
• Speicheranmeldeinformationen
• Delta Sharing
• Informationsschema
• Reservierte Wörter

DDL-Anweisungen

Sie verwenden Datendefinitionsanweisungen zum Erstellen oder Ändern der Struktur von Datenbankobjekten in einer Datenbank:

• ALTER CATALOG
• ALTER CREDENTIAL
• ALTER DATABASE
• ALTER LOCATION
• ALTER PROVIDER
• ALTER RECIPIENT
• ALTER TABLE
• ALTER SCHEMA
• ALTER SHARE
• ALTER VIEW
• COMMENT ON
• CREATE BLOOMFILTER INDEX
• CREATE CATALOG
• CREATE DATABASE
• CREATE FUNCTION (SQL)
• CREATE FUNCTION (Extern)
• CREATE LOCATION
• CREATE RECIPIENT
• CREATE SCHEMA
• CREATE SHARE
• CREATE TABLE
• CREATE VIEW
• DROP BLOOMFILTER INDEX
• DROP CATALOG
• DROP DATABASE
• DROP CREDENTIAL
• DROP FUNCTION
• DROP LOCATION
• DROP PROVIDER
• DROP RECIPIENT
• DROP SCHEMA
• DROP SHARE
• DROP TABLE
• DROP VIEW
• MSCK REPAIR TABLE
• SYNC
• TRUNCATE TABLE

DML-Anweisungen

Sie verwenden Datenbearbeitungsanweisungen zum Hinzufügen, Ändern oder Löschen von Daten aus einer Delta Lake-Tabelle:

• COPY INTO
• DELETE FROM
• INSERT INTO
• INSERT OVERWRITE DIRECTORY
• INSERT OVERWRITE DIRECTORY mit Hive-Format
• LOAD DATA
• MERGE INTO
• UPDATE

Datenabrufsanweisungen

Mit einer Abfrage können Sie Zeilen aus Tabellen gemäß den angegebenen Klauseln abrufen. Die vollständige Syntax und eine kurze Beschreibung der unterstützten Klauseln werden im Artikel Abfrage erläutert. Die zugehörigen SQL-Anweisungen SELECT und VALUES sind ebenfalls in diesem Abschnitt enthalten.

• Abfrage
• SELECT
• VALUES

Databricks SQL bietet außerdem die Möglichkeit, mithilfe der Anweisung EXPLAIN einen logischen und physischen Plan für eine Abfrage zu generieren.

• EXPLAIN

Delta Lake-Anweisungen

Mithilfe von Delta Lake SQL-Anweisungen können Sie im Delta Lake-Format gespeicherte Tabellen verwalten:

• CACHE SELECT
• CONVERT TO DELTA
• DESCRIBE HISTORY
• FSCK REPAIR TABLE
• GENERATE
• OPTIMIZE
• REORG TABLE
• RESTORE
• VACUUM

Ausführliche Informationen zur Verwendung von Delta Lake-Anweisungen finden Sie unter Was ist Delta Lake?.

Hilfsanweisungen

Hilfsanweisungen ermöglichen es Ihnen, Statistiken zu erfassen, Zwischenspeicherung zu verwalten, Metadaten untersuchen, Konfigurationen festzulegen und Ressourcen zu verwalten:

• Analyseanweisung
• Apache Spark-Cacheanweisungen
• Beschreibungsanweisungen
• Anzeigeanweisungen
• Konfigurationsverwaltung
• Ressourcenverwaltung

Analyseanweisung

• ANALYZE TABLE

Apache Spark-Cacheanweisungen

Gilt für: Databricks Runtime

• CACHE TABLE
• CLEAR CACHE
• REFRESH
• REFRESH FUNCTION
• REFRESH TABLE
• UNCACHE TABLE

Beschreibungsanweisungen

• DESCRIBE CATALOG
• DESCRIBE CREDENTIAL
• DESCRIBE DATABASE
• DESCRIBE FUNCTION
• DESCRIBE LOCATION
• DESCRIBE PROVIDER
• DESCRIBE QUERY
• DESCRIBE RECIPIENT
• DESCRIBE SCHEMA
• DESCRIBE SHARE
• DESCRIBE TABLE

Anzeigeanweisungen

• LIST
• SHOW ALL IN SHARE
• SHOW CATALOGS
• SHOW COLUMNS
• SHOW CREATE TABLE
• SHOW CREDENTIALS
• SHOW DATABASES
• SHOW FUNCTIONS
• SHOW GROUPS
• SHOW LOCATIONS
• SHOW PARTITIONS
• SHOW PROVIDERS
• SHOW RECIPIENTS
• SHOW SCHEMAS
• SHOW SHARES
• SHOW SHARES IN PROVIDER
• SHOW TABLE
• SHOW TABLES
• SHOW TBLPROPERTIES
• SHOW USERS
• SHOW VIEWS

Konfigurationsverwaltung

• RESET
• SET
• SET TIMEZONE
• USE CATALOG
• USE DATABASE
• USE SCHEMA

Ressourcenverwaltung

Gilt für: Databricks Runtime

• ADD ARCHIVE
• ADD FILE
• ADD JAR
• LIST ARCHIVE
• LIST FILE
• LIST JAR

Sicherheitsanweisungen

Zum Verwalten des Zugriffs auf Daten verwenden Sie SQL-Sicherheitsanweisungen:

• ALTER GROUP
• CREATE GROUP
• DENY
• DROP GROUP
• GRANT
• GRANT SHARE
• REPAIR PRIVILEGES
• REVOKE
• REVOKE SHARE
• SHOW GRANTS
• SHOW GRANTS ON SHARE
• SHOW GRANTS TO RECIPIENT

Ausführliche Informationen zur Verwendung dieser Anweisungen finden Sie unter Berechtigungen für Datenobjekte.