CREATE CATALOG

Dotyczy:oznaczone jako Databricks SQL oznaczone jako Databricks Runtime 10.4 LTS i nowsze oznaczone jako Unity Catalog

Tworzy wykaz o określonej nazwie. Jeśli katalog o tej samej nazwie już istnieje, zgłaszany jest wyjątek.

Po utworzeniu katalogu FOREIGN zostanie on wypełniony wszystkimi schematami i tabelami widocznymi dla uwierzytelniającego użytkownika.

Ważna

Po ustawieniu opcji wykazu, które zawierają poświadczenia, takie jak hasło lub token, aby zachować ich bezpieczeństwo, podaj wartość przy użyciu secret funkcji zamiast wprowadzać wartość literału bezpośrednio w klauzuli OPTIONS . Dzięki temu można odwoływać się do wpisu tajnego przechowywanego w usłudze wpisów tajnych usługi Databricks zamiast dołączać wartość poświadczeń w instrukcji .

Składnia

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 } [ , ... ] )

Parametry

  • ZAGRANICZNY

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 13.3 LTS i nowsze

    Określa, że katalog jest importowany z CONNECTION.

  • JEŚLI NIE ISTNIEJE

    Tworzy katalog o podanej nazwie, jeśli nie istnieje. Jeśli wykaz o tej samej nazwie już istnieje, nic się nie stanie.

  • catalog_name

    Nazwa katalogu do utworzenia.

  • UŻYWANIE SHARE provider_name.share_name

    Opcjonalnie określa, że wykaz jest oparty na udziale OpenSharing.

  • ZARZĄDZANA LOKALIZACJA LOCATION_PATH

    Opcjonalnie określa ścieżkę do zarządzanej lokalizacji magazynu katalogu, która różni się od głównej lokalizacji magazynu metadanych. Ta ścieżka musi być zdefiniowana w konfiguracji lokalizacji zewnętrznej, a Ty musisz mieć CREATE MANAGED STORAGE uprawnienia do konfiguracji lokalizacji zewnętrznej. Możesz użyć ścieżki zdefiniowanej w konfiguracji lokalizacji zewnętrznej lub ścieżki podrzędnej (innymi słowy 'abfss://container@storageaccount.dfs.core.windows.net/finance' lub 'abfss://container@storageaccount.dfs.core.windows.net/finance/product'). Obsługiwane w usłudze Databricks SQL lub w klastrach z uruchomionym środowiskiem Databricks Runtime 11.3 LTS lub nowszym.

    Zobacz również tabele zarządzane wykazu aparatu Unity dla usług Delta Lake i Apache Iceberg oraz Tworzenie magazynu metadanych wykazu aparatu Unity.

  • ZACHOWAJ PORZUCONĄ LICZBĘ { HOUR | GODZINY | DZIEŃ | DNI | TYDZIEŃ | TYGODNIE }

    Dotyczy:sprawdź, czy oznaczono tak , że środowisko Databricks Runtime 17.3 lub nowsze zaznaczono jako tak tylko wykaz aparatu Unity

    Ważna

    Ta funkcja jest dostępna w publicznej wersji testowej.

    Opcjonalnie ustawia okres odzyskiwania dla usuniętych tabel zarządzanych w wykazie, okres, w którym można odzyskać usunięte tabele przy użyciu UNDROP TABLE polecenia . Jeśli nie zostanie określony, wartość domyślna to 7 dni. Wartość musi być 0 godzin (aby wyłączyć odzyskiwanie) lub od 7 do 30 dni włącznie.

    Ustawienie okresu odzyskiwania na 0 oznacza, że usunięte tabele nie są możliwe do odzyskania przy użyciu, UNDROP a pliki danych są usuwane z magazynu w chmurze w ciągu 48 godzin.

    Jeśli okres odzyskiwania jest również ustawiony w schemacie podrzędnym, ustawienie na poziomie schematu ma pierwszeństwo dla tabel w tym schemacie. To ustawienie dotyczy tylko tabel porzuconych po skonfigurowaniu okresu odzyskiwania. Po zakończeniu okresu odzyskiwania pliki danych dla tabel zarządzanych są usuwane z magazynu w chmurze w ciągu 48 godzin.

    Nieobsługiwane w przypadku katalogów obcych lub udostępnionych. Zobacz też Usuwanie zarządzanej tabeli.

  • UŻYWANIE POŁĄCZENIA connection_name

    Określa połączenie, w którym znajduje się katalog źródłowy.

  • komentarz

    To jest opcjonalny STRING literał. Opis katalogu.

  • DOMYŚLNE SORTOWANIE default_collation_name

    Dotyczy:zaznaczone jako tak Databricks SQL zaznaczone jako tak Databricks Runtime 17.1 lub nowsze

    Opcjonalnie definiuje domyślne sortowanie obiektów zdefiniowanych w wykazie. Jeśli nie określono, domyślne sortowanie to UTF8_BINARY.

  • OPCJE

    Ustawia parametry specyficzne dla typu połączenia potrzebne do zidentyfikowania wykazu w połączeniu.

    • option_name

      Klucz opcji. Klucz może składać się z co najmniej jednego identyfikatora oddzielonego kropką lub literałem STRING .

      Klucze opcji muszą być unikatowe i uwzględniane są wielkość liter.

    • option_value

      Wartość opcji. Wartość musi być BOOLEANSTRING stałym , INTEGER, DECIMALlub .

Przykłady

-- 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');
  • Last updated on