KATALÓGUS LÉTREHOZÁSA
A következőkre vonatkozik: Databricks SQL Databricks Runtime 10.4 LTS és a Unity Catalog felett csak
Létrehoz egy katalógust a megadott névvel. Ha már létezik azonos nevű katalógus, kivételt jelent.
Katalógus létrehozásakor FOREIGN
a rendszer feltölti az összes sémát és azok tábláit, amelyeket a hitelesítést végző felhasználó láthat.
Syntax
CREATE CATALOG [ IF NOT EXISTS ] catalog_name
[ USING SHARE provider_name . share_name ]
[ MANAGED LOCATION 'location_path' ]
[ COMMENT comment ]
CREATE FOREIGN CATALOG [ IF NOT EXISTS ] catalog_name
USING CONNECTION connection_name
[ COMMENT comment ]
OPTIONS ( { option_name = option_value } [ , ... ] )
Paraméterek
KÜLFÖLDI
A következőkre vonatkozik: Databricks SQL Databricks Runtime 13.3 LTS és újabb
Megadja, hogy a katalógus importálva legyen egy KAPCSOLATból.
HA NEM LÉTEZIK
Létrehoz egy katalógust a megadott névvel, ha nem létezik. Ha már létezik azonos nevű katalógus, semmi sem fog történni.
-
A létrehozandó katalógus neve.
SHARE provider_name
.
share_name használataOpcionálisan azt adja meg, hogy a katalógus egy Delta-megosztási megosztáson alapul.
-
A megosztást szolgáltató Delta Sharing-szolgáltató neve.
-
A provider_name által megadott megosztás neve.
-
FELÜGYELT HELY
'location_path'
Opcionálisan megadja a katalógus felügyelt tárolási helyének elérési útját, amely eltér a metaadattár gyökértárolójának helyétől. Ezt az elérési utat egy külső helykonfigurációban kell meghatározni, és rendelkeznie kell a
CREATE MANAGED STORAGE
külső hely konfigurációjára vonatkozó jogosultsággal. Használhatja a külső hely konfigurációjában definiált elérési utat vagy egy segédútvonalat (más szóval,'abfss://container@storageaccount.dfs.core.windows.net/finance'
vagy'abfss://container@storageaccount.dfs.core.windows.net/finance/product'
). A Databricks SQL-ben vagy a Databricks Runtime 11.3 LTS-t és újabb verziót futtató fürtökön támogatott.Lásd még a felügyelt táblákat , és hozzon létre egy Unity Catalog-metaadattárat.
KAPCSOLAT CONNECTION_NAME HASZNÁLATA
Megadja azt a kapcsolatot, ahol a forráskatalógus található.
Megjegyzést
Nem kötelező
STRING
konstans. A katalógus leírása.LEHETŐSÉGEK
Beállítja a kapcsolattípus-specifikus paramétereket, amelyek szükségesek a katalógus azonosításához a kapcsolaton.
Lehetőség
A beállításkulcs. A kulcs egy vagy több, ponttal vagy
STRING
literálokkal elválasztott azonosítóból állhat.A beállításkulcsnak egyedinek kell lennie, és megkülönbözteti a kis- és nagybetűket.
value
A beállítás értéke. Az értéknek egy
BOOLEAN
,STRING
,INTEGER
vagyDECIMAL
állandó kifejezésnek kell lennie. Az érték lehet az SQL-függvény hívásaSECRET
is. A forpassword
például avalue
literális jelszó megadása helyett állhatsecret('secrets.r.us', 'postgresPassword')
.
Példák
-- 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');