CREATE CATALOG
gäller för: Databricks SQL
Databricks Runtime 10.4 LTS och senare
Unity Catalog
Skapar en catalog med det angivna namnet. Om det redan finns en catalog med samma namn genereras ett undantag.
När du skapar en FOREIGN
catalog kommer den att fyllas med alla scheman och deras tables som är synliga för den användare som autentiserar.
Syntax
CREATE CATALOG [ IF NOT EXISTS ] catalog_name
[ USING SHARE provider_name . share_name |
MANAGED LOCATION location_path |
COMMENT comment |
OPTIONS ( { option_name = option_value } [ , ... ] ) ] [...]
CREATE FOREIGN CATALOG [ IF NOT EXISTS ] catalog_name
USING CONNECTION connection_name
[ COMMENT comment ]
OPTIONS ( { option_name = option_value } [ , ... ] )
Parameters
FRÄMMANDE
Gäller för:
Databricks SQL
Databricks Runtime 13.3 LTS och senare
Anger att catalog importeras från en -anslutning.
OM INTE FINNS
Skapar en catalog med det angivna namnet om det inte finns. Om det redan finns en catalog med samma namn händer ingenting.
-
Namnet på den catalog som ska skapas.
ANVÄNDA SHARE provider_name
.
share_nameDu kan också ange att catalog baseras på en Delta-delningsresurs.
-
Namnet på deltadelningsprovidern som angav resursen.
-
Namnet på resursen som tillhandahålls av provider_name.
-
HANTERAD PLACERING location_path
Du kan också ange sökvägen till en hanterad lagringsplats för catalog som skiljer sig från metaarkivets rotlagringsplats. Den här sökvägen måste definieras i en extern platskonfiguration och du måste ha behörighet för konfigurationen
CREATE MANAGED STORAGE
av den externa platsen. Du kan använda sökvägen som definieras i konfigurationen av den externa platsen eller en undersökväg (med andra ord eller'abfss://container@storageaccount.dfs.core.windows.net/finance'
'abfss://container@storageaccount.dfs.core.windows.net/finance/product'
). Stöds i Databricks SQL eller i kluster som kör Databricks Runtime 11.3 LTS och senare.Se även Arbeta med hanterade tables och Skapa ett Unity Catalog-metaarkiv.
-
Anger anslutningen where källan catalog finns.
kommentar
En valfri
STRING
literal. Beskrivningen för catalog.ALTERNATIV
Anger anslutningstypsspecifik parameters som behövs för att identifiera catalog vid anslutningen.
option_name
Alternativnyckeln. Nyckeln kan bestå av en eller flera identifierare avgränsade med en punkt eller en
STRING
literal.Alternativnycklar måste vara unika och skiftlägeskänsliga.
option_value
Värdet för alternativet. Värdet måste vara ett
BOOLEAN
,STRING
,INTEGER
ellerDECIMAL
konstant uttryck. Värdet kan också vara ett anrop tillSECRET
SQL-funktionen. Till exempelvalue
kan för beståpassword
av i stället försecret('secrets.r.us', 'postgresPassword')
att ange literallösenordet.
Exempel
-- Create catalog `customer_cat`. This throws exception if catalog with name customer_cat
-- already exists.
> CREATE CATALOG customer_cat;
-- Create catalog `customer_cat` only if catalog with same name doesn't exist.
> CREATE CATALOG IF NOT EXISTS customer_cat;
-- Create catalog `customer_cat` only if catalog with same name doesn't exist, with a comment.
> CREATE CATALOG IF NOT EXISTS customer_cat COMMENT 'This is customer catalog';
-- Create a catalog from a Delta Sharing share.
> CREATE CATALOG customer_cat USING SHARE cdc.vaccinedata;
-- Create a catalog with a different managed storage location than the metastore's.
> CREATE CATALOG customer_cat MANAGED LOCATION 'abfss://container@storageaccount.dfs.core.windows.net/finance';
-- Create a foreign catalog linked to postgresdb at postgresql_connection
> CREATE FOREIGN CATALOG postgresql_catalog
USING CONNECTION postgresql_connection
OPTIONS (database 'postgresdb');