CREATE CATALOG

A következőkre vonatkozik: jelölje be az igennel jelölt jelölőnégyzetet 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.

Important

Ha hitelesítő adatokat (például jelszót vagy jogkivonatot) tartalmazó katalógusbeállításokat ad meg a biztonság érdekében, adja meg az értéket a secret függvény használatával ahelyett, hogy közvetlenül a záradékba írja be a OPTIONS literális értéket. Ez lehetővé teszi, hogy a Databricks titkos szolgáltatásban tárolt titkos kódra hivatkozzon ahelyett, hogy belefogadja a hitelesítő adatokat az utasításba.

Szemantika

CREATE CATALOG [ IF NOT EXISTS ] catalog_name
    [ USING SHARE provider_name . share_name |
      MANAGED LOCATION location_path |
      RETAIN DROPPED FOR number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } |
      COMMENT comment |
      DEFAULT COLLATION default_collation_name |
      OPTIONS ( { option_name = option_value } [ , ... ] ) ] [...]

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.
catalog_name

A létrehozandó katalógus neve.
SHARE provider_name.share_name használata

Opcionálisan azt adja meg, hogy a katalógus egy OpenSharing-megosztáson alapul.
- provider_name
  
  A megosztást szolgáltató OpenSharing-szolgáltató neve.
- share_name
  
  A provider_name által megadott megosztás neve.
KEZELT HELYSZÍN 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 Unity Catalog által felügyelt táblákat a Delta Lake-hez és az Apache Iceberghez , és hozzon létre egy Unity Catalog-metaadattárat.
VISSZADOBOTT SZÁM MEGTARTÁSA { HOUR | ÓRA | NAP | NAPOK | HÉT | HETEK }

Érvényes: a Databricks Runtime 17.3-s és újabb verziója, és ellenőrizze, hogy csak igen Unity-katalógus

Important

Ez a funkció nyilvános előzetes verzióban van.

Igény szerint beállítja a katalógusban elvetett felügyelt táblák helyreállítási időszakát, azt az időszakot, amely alatt az elvetett táblák helyreállíthatók a UNDROP TABLE paranccsal. Ha nincs megadva, az alapértelmezett érték 7 nap. Az értéknek 0 óra (a helyreállítás letiltásához) vagy 7–30 napnak kell lennie, beleértve a következőt:

A helyreállítási időszak 0-ra állítása azt jelenti, hogy az elvetett táblák nem állíthatók helyre a használatával UNDROP , és az adatfájlok 48 órán belül törlődnek a felhőbeli tárolóból.

Ha egy helyreállítási időszak gyermeksémában is be van állítva, a sémaszintű beállítás elsőbbséget élvez a sémában lévő tábláknál. Ez a beállítás csak a helyreállítási időszak konfigurálása után elvetett táblákra vonatkozik. A helyreállítási időszak lejárta után a felügyelt táblák adatfájljai 48 órán belül törlődnek a felhőbeli tárolóból.

Nem támogatott a külföldi vagy megosztott katalógusok esetében. Lásd még: Felügyelt tábla elvetése.
KAPCSOLAT CONNECTION_NAME HASZNÁLATA

Megadja azt a kapcsolatot, ahol a forráskatalógus található.
megjegyzés

Nem kötelező STRING konstans. A katalógus leírása.
ALAPÉRTELMEZETT BETŰREND default_collation_name

A következőkre vonatkozik: Databricks SQL Databricks Runtime 17.1 és újabb

Opcionálisan meghatározza a katalógusban definiált objektumok alapértelmezett rendezést. Ha nincs megadva, az alapértelmezett rendezés: UTF8_BINARY.
BEÁLLÍTÁSOK

Beállítja a kapcsolattípus-specifikus paramétereket, amelyek szükségesek a katalógus azonosításához a kapcsolaton.
- option_name
  
  A beállításkulcs. A kulcs egy vagy több állhat.
  
  A beállításkulcsnak egyedinek kell lennie, és megkülönbözteti a kis- és nagybetűket.
- option_value
  
  A beállítás értéke. Az értéknek egy BOOLEAN, STRING, INTEGERvagy DECIMALállandó kifejezésnek kell lennie.

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 catalog with a case insesnitive and accent insensitive default collation.
> CREATE CATALOG customer_cat DEFAULT COLLATION UNICODE_CI_AI;

-- Create a catalog with a 30-day recovery period for dropped managed tables.
> CREATE CATALOG customer_cat RETAIN DROPPED FOR 30 DAYS;

-- Create a foreign catalog linked to postgresdb at postgresql_connection
> CREATE FOREIGN CATALOG postgresql_catalog
     USING CONNECTION postgresql_connection
     OPTIONS (database 'postgresdb');

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-07-14