Sdílet prostřednictvím

CREATE CATALOG

platí pro:zaškrtněte políčko Ano Databricks SQL zaškrtněte políčko Ano Databricks Runtime 10.4 LTS a vyšší zaškrtněte políčko Ano pouze Unity Catalog.

Vytvoří katalog se zadaným názvem. Pokud katalog se stejným názvem již existuje, vyvolá se výjimka.

Když vytvoříte katalog FOREIGN, naplní se všemi schématy a jejich tabulkami viditelnými pro ověřovacího uživatele.

Syntaxe

CREATE CATALOG [ IF NOT EXISTS ] catalog_name
    [ USING SHARE provider_name . share_name |
      MANAGED LOCATION location_path |
      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

  • ZAHRANIČNÍ

    Platí pro:označeno zaškrtnutím Databricks SQL označeno zaškrtnutím Databricks Runtime 13.3 LTS a vyšší

    Určuje, že katalog je importován z připojení CONNECTION.

  • POKUD NEEXISTUJE

    Vytvoří katalog s daným názvem, pokud neexistuje. Pokud katalog se stejným názvem již existuje, nic se nestane.

  • catalog_name

    Název katalogu, který se má vytvořit.

  • POUŽITÍ SHARE provider_name.share_name

    Volitelně určuje, že katalog je založen na sdílení Delta Sharing.

  • spravované umístění location_path

    Volitelně určuje cestu ke spravovanému umístění úložiště pro katalog, který se liší od umístění kořenového úložiště metastoru. Tato cesta musí být definována v konfiguraci externího umístění a musíte mít CREATE MANAGED STORAGE oprávnění ke konfiguraci externího umístění. Můžete použít cestu definovanou v konfiguraci externího umístění nebo dílčí cestu (jinými slovy, 'abfss://container@storageaccount.dfs.core.windows.net/finance' nebo 'abfss://container@storageaccount.dfs.core.windows.net/finance/product'). Je podporováno v Databricks SQL nebo na clusterech běžících na Databricks Runtime 11.3 LTS a výše.

    Viz také tabulky spravované službou Unity Catalog v Azure Databricks pro Delta Lake a Apache Iceberg a vytvoření metastoru katalogu Unity.

  • PŘIPOJENÍ connection_name POUŽÍVÁNÍ

    Určuje připojení, ve kterém se nachází zdrojový katalog.

  • komentář

    Volitelný STRING literál. Popis katalogu.

  • výchozí kolace default_collation_name

    Platí pro:Kontrola označená jako ano Kontrola SQL Databricks označená jako ano Databricks Runtime 17.1 a vyšší

    Volitelně definuje výchozí kolaci pro objekty definované v katalogu. Pokud není zadána výchozí kolace je UTF8_BINARY.

  • VOLBY

    Nastaví parametry specifické pro typ připojení potřebné k identifikaci katalogu v připojení.

    • option_name

      Klávesa option. Klíč se může skládat z jednoho nebo více identifikátorů oddělených tečkou nebo literálem STRING .

      Klíče možností musí být jedinečné a rozlišují malá a velká písmena.

    • option_value

      Hodnota pro možnost. Hodnota musí být výraz BOOLEAN, STRING, INTEGERnebo DECIMALkonstanta. Hodnota může být také voláním SECRET funkce SQL. Například může valuepassword obsahovat secret('secrets.r.us', 'postgresPassword') místo zadávání doslovného hesla.

Příklady

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