Odniesienie do języka SQL

Jest to dokumentacja poleceń SQL dla usług Databricks SQL i Databricks Runtime.

Aby uzyskać informacje na temat sposobu interpretowania i używania notacji składni i symboli w tej dokumentacji, zobacz How to use the SQL reference (Jak używać dokumentacji SQL).

Aby uzyskać informacje na temat używania języka SQL z potokami deklaratywnymi Lakeflow Spark, zobacz Referencja języka SQL potoku.

Note

Usługa Databricks SQL Serverless nie jest dostępna na platformie Azure w Chinach. Usługa Databricks SQL nie jest dostępna w regionach usługi Azure Government.

Ogólne informacje

W tym ogólnym dokumentacji opisano typy danych, funkcje, identyfikatory, literały i semantyka.

Podstawy języka

Reference	Opis
Dodawanie komentarzy do instrukcji SQL	Dodawanie komentarzy do kodu SQL
Zastrzeżone wyrazy i schematy	Słowa kluczowe zarezerwowane przez analizator SQL
Identifiers	Reguły nazewnictwa obiektów bazy danych
Names	Konwencje nazewnictwa obiektów
IDENTIFIER klauzuli	Rozpoznawanie identyfikatora dynamicznego
Wyrażenie SQL	Składnia i ocena wyrażeń SQL
Semantyka NULL	Sposób obsługi wartości NULL
Znaczniki parametrów	Sparametryzowane symbole zastępcze zapytania
Variables	Zmienne sesji i tymczasowe
Rozpoznawanie nazw	Jak nazwy obiektów są rozpoznawane
Wyrażenie ścieżki JSON	Nawigowanie po strukturach danych JSON
Collation	Porównanie ciągów i reguły sortowania
Partitions	Pojęcia dotyczące partycjonowania tabel

Typy danych

Reference	Opis
Typy danych	Omówienie wszystkich obsługiwanych typów danych
Reguły typów danych SQL	Wymuszanie typów i reguły konwersji
Wzorce daty/godziny	Formatowanie wzorców dat i godzin

Parametry konfiguracji

Reference	Opis
Parametry konfiguracji	Omówienie konfiguracji sql
ANSI_MODE	Tryb zgodności USŁUGI ANSI SQL
LEGACY_TIME_PARSER_POLICY	Zachowanie analizy czasu
MAX_FILE_PARTITION_BYTES	Limit rozmiaru partycji pliku
READ_ONLY_EXTERNAL_METASTORE	Tryb dostępu do zewnętrznego magazynu metadanych
STATEMENT_TIMEOUT	Ustawienie limitu czasu zapytania
TIMEZONE	Strefa czasowa sesji
USE_CACHED_RESULT	Buforowanie wyników zapytania

Functions

Reference	Opis
Functions	Omówienie funkcji SQL
Wbudowane funkcje	Wszystkie wbudowane funkcje
Alfabetyczna lista wbudowanych funkcji	Kompletna dokumentacja funkcji A-Z
Funkcje okna	Funkcje analityczne i rankingowe
Funkcje lambda	Wyrażenia funkcji anonimowej
Funkcje geoprzestrzenne H3	Sześciokątny hierarchiczny indeks przestrzenny
ST funkcje geoprzestrzenne	Standardowe funkcje geoprzestrzenne
Funkcje agregujące zdefiniowane przez użytkownika (UDAFs)	Niestandardowe funkcje agregacji
Funkcje skalarne zdefiniowane przez użytkownika zewnętrznego (UDF)	Niestandardowe funkcje skalarne
Integracja z funkcjami UDF, UDAF i UDTF w Hive	Zgodność funkcji Hive
Wywołanie funkcji	Jak wywoływać funkcje

Pojęcia dotyczące wykazu aparatu Unity

Reference	Opis
Główny	Użytkownicy, grupy i jednostki usługi
Uprawnienia i obiekty zabezpieczalne w Unity Catalog	Kontrola dostępu w Unity Catalog
Uprawnienia i zabezpieczane obiekty w magazynie metadanych Hive	Starsza kontrola dostępu do magazynu metadanych
Lokalizacje zewnętrzne	Lokalizacje magazynu w chmurze
tabele zewnętrzne	Tabele wspierane przez dane zewnętrzne
Credentials	Poświadczenia dostępu do magazynu
Volumes	Zarządzany i zewnętrzny magazyn plików

Tematy specjalne

Reference	Opis
Zgodność ANSI w środowisku Databricks Runtime	Zgodność ze standardem SQL ANSI
Zgodność z technologią Apache Hive	Zgodność programu Hive SQL
Skrypty SQL	Proceduralna logika SQL
Udostępnianie różnicowe	Udostępnianie danych między organizacjami
Zapytania federacyjne (Federacja Lakehouse)	Wykonywanie zapytań względem zewnętrznych baz danych
Schemat informacji	Tabele systemu metadanych

Instrukcje DDL

Instrukcje definicji danych tworzą lub modyfikują strukturę obiektów bazy danych.

Instrukcje ALTER

Statement	Opis
ALTER CATALOG	Modyfikowanie właściwości wykazu
ALTER CONNECTION	Modyfikowanie ustawień połączenia
ALTER CREDENTIAL	Modyfikowanie właściwości poświadczeń
ALTER DATABASE	Modyfikowanie właściwości bazy danych
ALTER EXTERNAL LOCATION	Modyfikowanie lokalizacji zewnętrznej
ALTER MATERIALIZED VIEW	Modyfikowanie zmaterializowanego widoku
ALTER PROVIDER	Modyfikowanie dostawcy danych
ALTER RECIPIENT	Modyfikowanie adresata udziału
ALTER SCHEMA	Modyfikowanie właściwości schematu
ALTER SHARE	Modyfikowanie konfiguracji udziału
ALTER STREAMING TABLE	Modyfikowanie tabeli przesyłania strumieniowego
ALTER TABLE	Modyfikowanie struktury tabeli
ALTER VIEW	Modyfikowanie definicji widoku
ALTER VOLUME	Modyfikowanie właściwości woluminu

Instrukcje CREATE

Statement	Opis
CREATE BLOOM FILTER INDEX	Tworzenie indeksu filtru blooma
CREATE CATALOG	Tworzenie nowego wykazu
CREATE CONNECTION	Tworzenie połączenia zewnętrznego
CREATE DATABASE	Tworzenie nowej bazy danych
CREATE FUNCTION (SQL i Python)	Tworzenie funkcji SQL
CREATE FUNCTION (zewnętrzne)	Tworzenie funkcji zewnętrznej
CREATE EXTERNAL LOCATION	Tworzenie lokalizacji zewnętrznej
CREATE MATERIALIZED VIEW	Tworzenie zmaterializowanego widoku
TWORZENIE ZASAD	Tworzenie zasad filtrowania wierszy lub maski kolumn
TWORZENIE PROCEDURY	Tworzenie procedury składowanej
CREATE RECIPIENT	Tworzenie adresata udziału
CREATE SCHEMA	Tworzenie nowego schematu
CREATE SERVER	Tworzenie serwera obcego
CREATE SHARE	Tworzenie udziału danych
CREATE STREAMING TABLE	Tworzenie tabeli przesyłania strumieniowego
CREATE TABLE	Tworzenie nowej tabeli
CREATE VIEW	Utwórz widok
CREATE VOLUME	Utwórz wolumin

Instrukcje DROP

Statement	Opis
DROP BLOOM FILTER INDEX	Usuwanie indeksu filtru blooma
DROP CATALOG	Usuwanie wykazu
DROP CONNECTION	Usuwanie połączenia zewnętrznego
DROP CREDENTIAL	Usuwanie poświadczeń magazynu
DROP DATABASE	Usuwanie bazy danych
DROP FUNCTION	Usuwanie funkcji
DROP EXTERNAL LOCATION	Usuwanie lokalizacji zewnętrznej
UPUSZCZANIE ZASAD	Usuwanie zasad filtru wiersza lub maski kolumn
PROCEDURA UPUSZCZANIA	Usuwanie procedury składowanej
DROP PROVIDER	Usuwanie dostawcy udziału
DROP RECIPIENT	Usuwanie adresata udziału
DROP SCHEMA	Usuwanie schematu
DROP SHARE	Usuwanie udziału danych
DROP TABLE	Usuwanie tabeli
DROP VARIABLE	Usuwanie zmiennej sesji
DROP VIEW	Usuwanie widoku
DROP VOLUME	Usuwanie woluminu

Instrukcje analizy

Inne instrukcje DDL

Statement	Opis
COMMENT ON	Dodawanie komentarzy do obiektów
DECLARE VARIABLE	Deklarowanie zmiennej sesji
REPAIR TABLE	Odzyskiwanie partycji tabeli
REFRESH FOREIGN (CATALOG, SCHEMA, i TABLE)	Odświeżanie metadanych obcych
REFRESH (MATERIALIZED VIEW lub STREAMING TABLE)	Odświeżanie zmaterializowanych danych
SET ZNACZNIK	Dodawanie tagów do obiektów
`SYNC`	Synchronizowanie metadanych
TRUNCATE TABLE	Usuń wszystkie dane tabeli
PRZYWRÓĆ	Przywracanie usuniętej tabeli
UNSET TAG	Usuwanie tagów z obiektów

Instrukcje DML

Instrukcje manipulowania danymi dodają, zmień lub usuń dane w tabelach usługi Delta Lake.

Statement	Opis
`COPY INTO`	Ładowanie danych z plików do tabeli
DELETE FROM	Usuwanie wierszy z tabeli
INSERT	Wstawianie wierszy do tabeli
INSERT OVERWRITE DIRECTORY	Zapisywanie wyników zapytania w katalogu
INSERT OVERWRITE DIRECTORY w formacie Hive	Zapisywanie wyników w formacie Hive
LOAD DATA	Ładowanie danych z plików
MERGE INTO	Dane upsert do tabeli
UPDATE	Aktualizowanie wierszy w tabeli

Instrukcje pobierania danych

Pobieranie wierszy z tabel zgodnie z określonymi klauzulami. Usługa Azure Databricks obsługuje zarówno standardową SELECT składnię, jak i składnię potoku SQL.

Instrukcje zapytania

Statement	Opis
Query	Pełna dokumentacja składni zapytań
SELECT (podwybierz)	Wybieranie danych z tabel
VALUES klauzuli	Konstruowanie tabeli wbudowanej
składnia rurociągu SQL	Kompozycja zapytań oparta na potokach
EXPLAIN	Pokaż plan wykonywania zapytań

Klauzule zapytania

Klauzula	Opis
SELECT klauzuli	Wybór kolumny
* (gwiazdka) — klauzula	Zaznacz wszystkie kolumny
odniesienie do tabeli	Źródła tabel i podzapytania
JOIN	Łączenie wierszy z tabel
WHERE klauzuli	Filtrowanie wierszy
GROUP BY klauzuli	Grupowanie wierszy na potrzeby agregacji
HAVING klauzuli	Filtrowanie pogrupowanych wierszy
QUALIFY klauzuli	Wyniki funkcji okna filtru
ORDER BY klauzuli	Sortowanie wierszy wyników
SORT BY klauzuli	Sortowanie w ramach partycji
CLUSTER BY, klauzula (SELECT)	Dystrybuowanie i sortowanie danych
DISTRIBUTE BY klauzuli	Dystrybuowanie danych między partycjami
LIMIT klauzuli	Ogranicz wiersze wyników
OFFSET klauzuli	Pomiń wiersze wyników
PIVOT klauzuli	Obracanie wierszy do kolumn
UNPIVOT klauzuli	Obracanie kolumn na wiersze
LATERAL VIEW klauzuli	Stosowanie funkcji generowania tabel
TABLESAMPLE klauzuli	Przykładowe wiersze tabeli
Wywołanie funkcji o wartości tabeli (TVF)	Funkcje zwracające tabele
typowe wyrażenie tabeli (CTE)	Nazwane podzapytania
Ustawianie operatorów	UNION, INTERSECT, Z WYJĄTKIEM
WINDOW klauzuli	Nazwane definicje okien
Wskazówki	Wskazówki optymalizatora zapytań

Instrukcje usługi Delta Lake

Zarządzanie tabelami przechowywanymi w formacie usługi Delta Lake. Aby uzyskać szczegółowe informacje, zobacz Co to jest usługa Delta Lake w usłudze Azure Databricks?.

Statement	Opis
CACHE SELECT	Wyniki zapytania pamięci podręcznej
CONVERT TO DELTA	Konwertowanie formatu Parquet na różnicę
DESCRIBE HISTORY	Pokaż historię tabel
FSCK REPAIR TABLE	Naprawianie metadanych tabeli
GENERATE	Generowanie manifestu tabeli
OPTIMIZE	Kompaktowanie plików tabeli
REORG TABLE	Reorganizacja danych tabeli
RESTORE	Przywracanie tabeli do poprzedniej wersji
VACUUM	Usuwanie starych plików tabeli

Instrukcje skryptów SQL

Wykonywanie logiki proceduralnej w języku SQL. Zobacz Tworzenie skryptów SQL , aby zapoznać się z omówieniem.

Statement	Opis
instrukcja złożona BEGIN END	Grupowanie instrukcji w bloku
INSTRUKCJA CASE	Rozgałęzianie warunkowe
INSTRUKCJA FOR	Pętla nad zakresem lub kursorem
GET instrukcja diagnostyczna	Pobieranie informacji o wykonaniu
instrukcja IF THEN ELSE	Wykonywanie warunkowe
Instrukcja ITERATE	Przejdź do następnej iteracji pętli
Instrukcja LEAVE	Zamykanie pętli lub bloku
Instrukcja LOOP	Pętla bezwarunkowa
Instrukcja REPEAT	Pętla do momentu, gdy warunek ma wartość true
Instrukcja RESIGNAL	Ponowne zgłaszanie wyjątku
INSTRUKCJA SIGNAL	Zgłaszanie wyjątku
instrukcja WHILE	Pętla, gdy warunek ma wartość true

Instrukcje pomocnicze

Zbieranie statystyk, zarządzanie buforowaniem, eksplorowanie metadanych, ustawianie konfiguracji i zarządzanie zasobami.

Instrukcje ANALYZE

Statement	Opis
ANALYZE TABLE ... STATYSTYKI OBLICZENIOWE	Obliczanie statystyk kolumn tabeli
ANALYZE TABLE ... METRYKI MAGAZYNU OBLICZENIOWEGO	Metryki magazynu tabel obliczeniowych

Instrukcje pamięci podręcznej

Dotyczy: Databricks Runtime

Statement	Opis
CACHE TABLE	Tabela pamięci podręcznej w pamięci
CLEAR CACHE	Usuń wszystkie buforowane dane
REFRESH CACHE	Odświeżanie buforowanych danych
REFRESH FUNCTION	Odświeżanie metadanych funkcji
REFRESH TABLE	Odświeżanie metadanych tabeli
UNCACHE TABLE	Usuwanie tabeli z pamięci podręcznej

Instrukcje DESCRIBE

Statement	Opis
DESCRIBE CATALOG	Pokaż szczegóły wykazu
DESCRIBE CONNECTION	Pokaż szczegóły połączenia
DESCRIBE CREDENTIAL	Pokaż szczegóły poświadczeń
DESCRIBE DATABASE	Pokaż szczegóły bazy danych
DESCRIBE FUNCTION	Pokaż szczegóły funkcji
DESCRIBE EXTERNAL LOCATION	Pokaż szczegóły lokalizacji
OPIS ZASAD	Pokaż szczegóły zasad
OPISZ PROCEDURĘ	Pokaż szczegóły procedury
DESCRIBE PROVIDER	Pokaż szczegóły dostawcy
DESCRIBE QUERY	Pokaż schemat danych wyjściowych zapytania
DESCRIBE RECIPIENT	Pokaż szczegóły adresata
DESCRIBE SCHEMA	Pokaż szczegóły schematu
DESCRIBE SHARE	Pokaż szczegóły udziału
DESCRIBE TABLE	Pokaż szczegóły tabeli
DESCRIBE VOLUME	Pokaż szczegóły woluminu

Instrukcje SHOW

Statement	Opis
LIST	Wyświetlanie listy plików w ścieżce
SHOW ALL IN SHARE	Pokaż wszystkie obiekty w udziale
SHOW CATALOGS	Wyświetlanie listy wykazów
SHOW COLUMNS	Wyświetlanie listy kolumn tabeli
SHOW CONNECTIONS	Lista połączeń
SHOW CREATE TABLE	Pokaż tabelę DDL
SHOW CREDENTIALS	Wyświetlanie listy poświadczeń
SHOW DATABASES	Lista baz danych
SHOW FUNCTIONS	Lista funkcji
SHOW GROUPS	Lista grup
SHOW EXTERNAL LOCATIONS	Wyświetlanie listy lokalizacji zewnętrznych
SHOW PARTITIONS	Wyświetlanie listy partycji tabeli
POKAŻ ZASADY	Wyświetlanie listy zasad zabezpieczanych
POKAŻ PROCEDURY	Procedury listy
SHOW PROVIDERS	Lista dostawców
SHOW RECIPIENTS	Wyświetlanie listy adresatów
SHOW SCHEMAS	Lista schematów
SHOW SHARES	Wyświetlanie listy udziałów
SHOW SHARES IN PROVIDER	Wyświetlanie listy udziałów od dostawcy
SHOW TABLE EXTENDED	Pokaż informacje o tabeli
SHOW TABLES	Lista tabel
SHOW TABLES DROPPED	Wyświetlanie listy porzuconych tabel
SHOW TBLPROPERTIES	Pokaż właściwości tabeli
SHOW USERS	Wyświetlanie użytkowników
SHOW VIEWS	Wyświetlanie listy widoków
SHOW VOLUMES	Wyświetlanie listy woluminów

Zarządzanie konfiguracją i zmienną

Statement	Opis
CALL	Wywoływanie procedury składowanej
EXECUTE IMMEDIATE	Wykonywanie dynamicznego kodu SQL
RESET	Resetuj konfigurację do domyślnej
SET	Ustawianie parametru konfiguracji
SET RECIPIENT	Ustawianie kontekstu adresata udziału
SET TIME ZONE	Ustawianie strefy czasowej sesji
SET zmienna	Ustawianie wartości zmiennej
USE CATALOG	Ustawianie bieżącego wykazu
USE DATABASE	Ustawianie bieżącej bazy danych
USE SCHEMA	Ustawianie bieżącego schematu

Zarządzanie zasobami