TWORZENIE WYKAZU

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 10.4 LTS i nowszy zaznacz pole wyboru oznaczone jako tak tylko wykaz aparatu Unity

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

Po utworzeniu FOREIGN wykazu 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 ]

CREATE FOREIGN CATALOG [ IF NOT EXISTS ] catalog_name
    USING CONNECTION connection_name
    [ COMMENT comment ]
    OPTIONS ( { option_name = option_value } [ , ... ] )

Parametry

  • ZAGRANICZNYCH

    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 wykaz jest importowany z połączenia.

  • 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.PROVIDER_NAME SHARE

    Opcjonalnie określa, że wykaz jest oparty na udziale udostępniania różnicowego.

  • 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ż Artykuł Managed tables (Zarządzane tabele ) i Create a Unity Catalog metastore (Tworzenie magazynu metadanych wykazu aparatu 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 wykazu.

  • OPTIONS

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

    • Opcja

      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.

    • wartość

      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');