Udostępnij za pośrednictwem

CREATE CATALOG

  • Artykuł

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.

Składnia

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

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 wykaz 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_name.

    Opcjonalnie określa, że katalog jest oparty na części Delta Sharing .

  • 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 i musi 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ż Praca z tabelami zarządzanymi i Tworzenie magazynu metadanych Katalogu Unity.

  • UŻYWANIE CONNECTION_NAME POŁĄCZENIA

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

  • komentarz

    Opcjonalny STRING literał. Opis katalogu.

  • OPTIONS

    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ć wyrażeniem BOOLEANstałym , STRING, INTEGERlub DECIMAL . Wartość może być również wywołaniem SECRET funkcji SQL. Na przykład element value for password może zawierać secret('secrets.r.us', 'postgresPassword') zamiast wprowadzać hasło literału.

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 foreign catalog linked to postgresdb at postgresql_connection
> CREATE FOREIGN CATALOG postgresql_catalog
     USING CONNECTION postgresql_connection
     OPTIONS (database 'postgresdb');