Not
Åtkomst till denna sida kräver auktorisation. Du kan prova att logga in eller byta katalog.
Åtkomst till denna sida kräver auktorisation. Du kan prova att byta katalog.
Det här är en SQL-kommandoreferens för Databricks SQL och Databricks Runtime.
Information om hur du förstår och använder syntax notation och symboler i den här referensen finns i Använda SQL-referensen.
Information om hur du använder SQL med Lakeflow Spark Deklarativa pipelines finns i Referens för SQL-pipelinespråk.
Note
Databricks SQL Serverless är inte tillgängligt i Azure Kina. Databricks SQL är inte tillgängligt i Azure Government-regioner.
Allmän referens
Den här allmänna referensen beskriver datatyper, funktioner, identifierare, literaler och semantik.
Grunderna i språk
| Hänvisning | Description |
|---|---|
| Lägga till kommentarer i SQL-instruktioner | Lägga till kommentarer i DIN SQL-kod |
| Reserverade ord och scheman | Nyckelord som reserverats av SQL-parsern |
| Identifiers | Regler för namngivning av databasobjekt |
| Names | Namngivningskonventioner för objekt |
| IDENTIFIER-sats | Dynamisk identifierarmatchning |
| SQL-uttryck | SQL-uttryckssyntax och utvärdering |
| NULL-semantik | Så här hanteras NULL-värden |
| Parametermarkörer | Parametriserade frågeplatshållare |
| Variables | Sessionsvariabler och tillfälliga variabler |
| Namnupplösning | Så här matchas objektnamn |
| JSON-sökvägsuttryck | Navigera i JSON-datastrukturer |
| Collation | Strängjämförelse och sorteringsregler |
| Partitions | Begrepp för tabellpartitionering |
Datatyper
| Hänvisning | Description |
|---|---|
| Datatyper | Översikt över alla datatyper som stöds |
| REGLER FÖR SQL-datatyp | Ange tvång och konverteringsregler |
| Datetime-mönster | Formatera mönster för datum och tider |
Konfigurationsparametrar
| Hänvisning | Description |
|---|---|
| Konfigurationsparametrar | Översikt över SQL-konfiguration |
| ANSI_MODE | ANSI SQL-efterlevnadsläge |
| LEGACY_TIME_PARSER_POLICY | Tidsparsningsbeteende |
| MAX_FILE_PARTITION_BYTES | Storleksgräns för filpartition |
| READ_ONLY_EXTERNAL_METASTORE | Åtkomstläge för externt metaarkiv |
| STATEMENT_TIMEOUT | Tidsgränsinställning för frågor |
| TIMEZONE | Sessionstidszon |
| USE_CACHED_RESULT | Cachelagring av frågeresultat |
Functions
| Hänvisning | Description |
|---|---|
| Functions | Översikt över SQL-funktioner |
| Inbyggda funktioner | Alla inbyggda funktioner |
| Alfabetisk lista över inbyggda funktioner | Fullständig A-Z-funktionsreferens |
| Fönsterfunktioner | Analys- och rangordningsfunktioner |
| Lambda-funktioner | Anonyma funktionsuttryck |
| Geospatiala H3-funktioner | Sexhörningshierarkiskt rumsligt index |
| ST-geospatiala funktioner | Geospatiala standardfunktioner |
| Användardefinierade aggregeringsfunktioner (UDAF:er) | Anpassade sammansättningsfunktioner |
| Externa användardefinierade skalärfunktioner (UDF: er) | Anpassade skalärfunktioner |
| Integrering med Hive UDF:er, UDAF:er och UDTF:er | Hive-funktionskompatibilitet |
| Funktionsanrop | Anropa funktioner |
Begrepp i Unity-katalogen
| Hänvisning | Description |
|---|---|
| Rektor | Användare, grupper och tjänstens huvudnamn |
| Privilegier och skyddsbara objekt i Unity Catalog | Åtkomstkontroll i Unity Catalog |
| Privilegier och skyddsbara objekt i Hive-metaarkivet | Åtkomstkontroll för äldre metaarkiv |
| Externa platser | Molnlagringsplatser |
| externa tabeller | Tabeller som backas upp av externa data |
| Credentials | Autentiseringsuppgifter för lagringsåtkomst |
| Volumes | Hanterad och extern fillagring |
Specialavsnitt
| Hänvisning | Description |
|---|---|
| ANSI-efterlevnad i Databricks Runtime | ANSI SQL-standardkompatibilitet |
| Kompatibilitet med Apache Hive | Hive SQL-kompatibilitet |
| SQL-skript | Procedurmässig SQL-logik |
| Deltadelning | Datadelning mellan organisationer |
| Federerade frågor (Lakehouse Federation) | Köra frågor mot externa databaser |
| Informationsschema | Metadatasystemtabeller |
DDL-instruktioner
Datadefinitionsuttryck skapar eller ändrar strukturen för databasobjekt.
ALTER-instruktioner
| Statement | Description |
|---|---|
| ALTER CATALOG | Ändra katalogegenskaper |
| ALTER CONNECTION | Ändra anslutningsinställningar |
| ALTER CREDENTIAL | Ändra egenskaper för autentiseringsuppgifter |
| ALTER DATABASE | Ändra databasegenskaper |
| ALTER EXTERNAL LOCATION | Ändra extern plats |
| ALTER MATERIALIZED VIEW | Ändra materialiserad vy |
| ALTER PROVIDER | Ändra dataprovider |
| ALTER RECIPIENT | Ändra resursmottagare |
| ALTER SCHEMA | Ändra schemaegenskaper |
| ALTER SHARE | Ändra delningskonfiguration |
| ALTER STREAMING TABLE | Ändra strömningstabell |
| ALTER TABLE | Ändra tabellstruktur |
| ALTER VIEW | Ändra vydefinition |
| ALTER VOLUME | Ändra volymegenskaper |
CREATE-instruktioner
| Statement | Description |
|---|---|
| CREATE BLOOM FILTER INDEX | Skapa bloom-filterindex |
| CREATE CATALOG | Skapa en ny katalog |
| CREATE CONNECTION | Skapa extern anslutning |
| CREATE DATABASE | Skapa en ny databas |
| CREATE FUNCTION (SQL och Python) | Skapa SQL-funktion |
| CREATE FUNCTION (extern) | Skapa extern funktion |
| CREATE EXTERNAL LOCATION | Skapa extern plats |
| CREATE MATERIALIZED VIEW | Skapa materialiserad vy |
| SKAPA PROCEDUR | Skapa lagrad procedur |
| CREATE RECIPIENT | Skapa resursmottagare |
| CREATE SCHEMA | Skapa ett nytt schema |
| CREATE SERVER | Skapa sekundär server |
| CREATE SHARE | Skapa dataresurs |
| CREATE STREAMING TABLE | Skapa en direktuppspelningstabell |
| CREATE TABLE | Skapa en ny tabell |
| CREATE VIEW | Skapa en vy |
| CREATE VOLUME | Skapa en volym |
DROP-instruktioner
Analysera instruktioner
Andra DDL-instruktioner
| Statement | Description |
|---|---|
| COMMENT ON | Lägga till kommentarer i objekt |
| DECLARE VARIABLE | Deklarera sessionsvariabel |
| REPAIR TABLE | Återställa tabellpartitioner |
| REFRESH FOREIGN (CATALOG, SCHEMA, och TABLE) | Uppdatera externa metadata |
| REFRESH (MATERIALIZED VIEW eller STREAMING TABLE) | Uppdatera materialiserade data |
| SET TAGG | Lägga till taggar i objekt |
SYNC |
Synkronisera metadata |
| TRUNCATE TABLE | Ta bort alla tabelldata |
| UNDROP | Återställa borttagen tabell |
| ÅTERSTÄLL TAGG | Ta bort taggar från objekt |
DML-instruktioner
Instruktioner för datamanipulering lägger till, ändrar eller tar bort data i Delta Lake-tabeller.
| Statement | Description |
|---|---|
COPY INTO |
Läsa in data från filer till en tabell |
| DELETE FROM | Ta bort rader från en tabell |
| INSERT | Infoga rader i en tabell |
| INSERT OVERWRITE DIRECTORY | Skriva frågeresultat till katalog |
| INSERT OVERWRITE DIRECTORY med Hive-format | Skriva resultat i Hive-format |
| LOAD DATA | Läsa in data från filer |
| MERGE INTO | Upsert-data till en tabell |
| UPDATE | Uppdatera rader i en tabell |
Uttalanden för datahämtning
Hämta rader från tabeller enligt angivna satser. Azure Databricks stöder både standardsyntax SELECT och SQL Pipeline-syntax.
Frågeuttryck
| Statement | Description |
|---|---|
| Query | Fullständig referens för frågesyntax |
| SELECT (delselektera) | Välj data från tabeller |
| VALUES-sats | Skapa infogad tabell |
| SQL-pipelinesyntax | Rörbaserad frågesammansättning |
| EXPLAIN | Visa frågekörningsplan |
Frågesatser
| Klausul | Description |
|---|---|
| SELECT-sats | Kolumnmarkering |
| * (stjärn)-klausul | Markera alla kolumner |
| tabellreferens | Tabell- och underfrågor |
| JOIN | Kombinera rader från tabeller |
| WHERE-sats | Filtrera rader |
| GROUP BY-sats | Gruppera rader för aggregering |
| HAVING-sats | Filtrera grupperade rader |
| QUALIFY-sats | Filterfönsterfunktionsresultat |
| ORDER BY-sats | Sortera resultatrader |
| SORT BY-sats | Sortera inom partitioner |
| CLUSTER BY-sats (SELECT) | Distribuera och sortera data |
| DISTRIBUTE BY-sats | Distribuera data mellan partitioner |
| LIMIT-sats | Begränsa resultatrader |
| OFFSET-sats | Hoppa över resultatrader |
| PIVOT-sats | Rotera rader till kolumner |
| UNPIVOT-sats | Rotera kolumner till rader |
| LATERAL VIEW-sats | Använda tabellgenererande funktion |
| TABLESAMPLE-sats | Exempeltabellrader |
| Anrop av tabellvärd funktion (TVF) | Funktioner som returnerar tabeller |
| Vanlig tabelluttryck (CTE) | Namngivna underfrågor |
| Ange operatorer | UNION, INTERSECT, UTOM |
| WINDOW-sats | Namngivna fönsterdefinitioner |
| Tips | Tips för frågeoptimerare |
Delta Lake-instruktioner
Hantera tabeller som lagras i Delta Lake-format. Mer information finns i Vad är Delta Lake i Azure Databricks?.
| Statement | Description |
|---|---|
| CACHE SELECT | Cachelagra frågeresultat |
| CONVERT TO DELTA | Konvertera Parquet till Delta |
| DESCRIBE HISTORY | Visa tabellhistorik |
| FSCK REPAIR TABLE | Reparera tabellmetadata |
| GENERATE | Generera tabellmanifest |
| OPTIMIZE | Kompakta tabellfiler |
| REORG TABLE | Omorganisera tabelldata |
| RESTORE | Återställa tabellen till tidigare version |
| VACUUM | Ta bort gamla tabellfiler |
SQL-skriptinstruktioner
Kör procedurlogik i SQL. En översikt finns i SQL-skript .
| Statement | Description |
|---|---|
| BEGIN END-sammansatt sats | Gruppera uttryck i ett block |
| CASE-instruktion | Villkorlig grenning |
| FOR-instruktion | Loopa över ett intervall eller en markör |
| GET DIAGNOSTICS-uttalande | Hämta körningsinformation |
| IF THEN ELSE-instruktionen | Villkorsstyrd körning |
| ITERATE-instruktion | Fortsätt till nästa loop-iteration |
| LEAVE-instruktion | Avsluta en loop eller ett block |
| LOOP-instruktion | Ovillkorlig loop |
| REPEAT-instruktion | Loopa tills villkoret är sant |
| RESIGNAL-instruktion | Återskapa ett undantag |
| SIGNAL-instruktion | Skapa ett undantag |
| WHILE-instruktion | Loop medan villkoret är sant |
Hjälputtalanden
Samla in statistik, hantera cachelagring, utforska metadata, ange konfigurationer och hantera resurser.
ANALYZE-instruktioner
| Statement | Description |
|---|---|
| ANALYZE TABLE ... BERÄKNINGSSTATISTIK | Statistik för beräkningstabellkolumner |
| ANALYZE TABLE ... BERÄKNINGSLAGRINGSMÅTT | Beräkningstabelllagringsmått |
Cacheinstruktioner
Gäller för: Databricks Runtime
| Statement | Description |
|---|---|
| CACHE TABLE | Cachetabell i minnet |
| CLEAR CACHE | Ta bort alla cachelagrade data |
| REFRESH CACHE | Uppdatera cachelagrade data |
| REFRESH FUNCTION | Uppdatera funktionsmetadata |
| REFRESH TABLE | Uppdatera tabellmetadata |
| UNCACHE TABLE | Ta bort tabellen från cacheminnet |
DESCRIBE-instruktioner
| Statement | Description |
|---|---|
| DESCRIBE CATALOG | Visa kataloginformation |
| DESCRIBE CONNECTION | Visa anslutningsinformation |
| DESCRIBE CREDENTIAL | Visa information om autentiseringsuppgifter |
| DESCRIBE DATABASE | Visa databasinformation |
| DESCRIBE FUNCTION | Visa funktionsinformation |
| DESCRIBE EXTERNAL LOCATION | Visa platsinformation |
| BESKRIVA PROCEDUR | Visa procedurinformation |
| DESCRIBE PROVIDER | Visa providerinformation |
| DESCRIBE QUERY | Visa frågeutdataschema |
| DESCRIBE RECIPIENT | Visa mottagarinformation |
| DESCRIBE SCHEMA | Visa schemainformation |
| DESCRIBE SHARE | Visa resursinformation |
| DESCRIBE TABLE | Visa tabellinformation |
| DESCRIBE VOLUME | Visa volyminformation |
SHOW-instruktioner
| Statement | Description |
|---|---|
| LIST | Visa en lista över filer i en sökväg |
| SHOW ALL IN SHARE | Visa alla objekt i resursen |
| SHOW CATALOGS | Lista kataloger |
| SHOW COLUMNS | Lista tabellkolumner |
| SHOW CONNECTIONS | Lista anslutningar |
| SHOW CREATE TABLE | Visa tabell-DDL |
| SHOW CREDENTIALS | Lista autentiseringsuppgifter |
| SHOW DATABASES | Lista databaser |
| SHOW FUNCTIONS | Lista över funktioner |
| SHOW GROUPS | Lista grupper |
| SHOW EXTERNAL LOCATIONS | Visa en lista över externa platser |
| SHOW PARTITIONS | Lista tabellpartitioner |
| VISA PROCEDURER | Listprocedurer |
| SHOW PROVIDERS | Lista providers |
| SHOW RECIPIENTS | Lista mottagare |
| SHOW SCHEMAS | Lista över scheman |
| SHOW SHARES | Lista resurser |
| SHOW SHARES IN PROVIDER | Visa en lista över resurser från providern |
| SHOW TABLE EXTENDED | Visa tabellinformation |
| SHOW TABLES | Lista tabeller |
| SHOW TABLES DROPPED | Lista borttagna tabeller |
| SHOW TBLPROPERTIES | Visa tabellegenskaper |
| SHOW USERS | Visa användare |
| SHOW VIEWS | Listvyer |
| SHOW VOLUMES | Lista volymer |
Konfiguration och variabelhantering
| Statement | Description |
|---|---|
| CALL | Anropa en lagrad procedur |
| EXECUTE IMMEDIATE | Köra dynamisk SQL |
| RESET | Återställ konfigurationen till standard |
| SET | Ange konfigurationsparameter |
| SET RECIPIENT | Ange mottagarkontext för resurs |
| SET TIME ZONE | Ange sessionstidszon |
| SET variabel | Ange variabelvärde |
| USE CATALOG | Ange aktuell katalog |
| USE DATABASE | Ange aktuell databas |
| USE SCHEMA | Ange aktuellt schema |
Resurshantering
Gäller för: Databricks Runtime
| Statement | Description |
|---|---|
| ADD ARCHIVE | Lägga till arkiv i sessionen |
| ADD FILE | Lägga till fil i sessionen |
| ADD JAR | Lägg till JAR i sessionen |
| LIST ARCHIVE | Lista sessionsarkiv |
| LIST FILE | Lista sessionsfiler |
| LIST JAR | Lista sessions-JAR:er |
Gäller för: Databricks SQL Connector
| Statement | Description |
|---|---|
| GET | Ladda ned filen från volymen |
| PUT INTO | Ladda upp fil till volym |
| REMOVE | Ta bort filen från volymen |
Säkerhetsinstruktioner
Hantera åtkomst till data. Mer information finns i Behörigheter för Hive-metaarkiv och skyddsbara objekt (äldre).
| Statement | Description |
|---|---|
| ALTER GROUP | Ändra gruppmedlemskap |
| CREATE GROUP | Skapa en ny grupp |
| DENY | Neka behörigheter |
| DROP GROUP | Ta bort en grupp |
| GRANT | Bevilja behörigheter |
| GRANT ON SHARE | Bevilja resursåtkomst |
| MSCK REPAIR PRIVILEGES | Reparera metadata för privilegier |
| REVOKE | Återkalla behörigheter |
| REVOKE ON SHARE | Återkalla resursåtkomst |
| SHOW GRANTS | Visa beviljade privilegier |
| SHOW GRANTS ON SHARE | Visa delningsprivilegier |
| SHOW GRANTS TO RECIPIENT | Visa mottagarbehörigheter |