VYTVOŘIT KATALOG

  • Článek

Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 10.4 LTS a vyšší zaškrtnutí označeného ano pouze katalog Unity

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

Když vytvoříte FOREIGN katalog, 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 ]

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

Parametry

  • ZAHRANIČNÍ

    Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 13.3 LTS a vyšší

    Určuje, že se katalog importuje z připojení.

  • 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_NAME SHARE provider_name.

    Volitelně určuje, že katalog je založený na sdílené složce Sdílení delta.

  • 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'). Podporuje se v Databricks SQL nebo v clusterech s Modulem Databricks Runtime 11.3 LTS a novějším.

    Viz také Práce se spravovanými tabulkami a vytvoření metastoru katalogu Unity.

  • POUŽITÍ CONNECTION_NAME PŘIPOJENÍ

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

  • komentář

    Volitelný STRING literál. Popis katalogu.

  • OPTIONS

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

    • option

      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ávesy možností musí být jedinečné a rozlišují malá a velká písmena.

    • value

      Hodnota pro možnost. Hodnota musí být výraz BOOLEAN, STRING, INTEGERnebo DECIMAL konstanta. Hodnota může být také voláním SECRET funkce SQL. For může například value password obsahovat secret('secrets.r.us', 'postgresPassword') místo zadávání literálové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 foreign catalog linked to postgresdb at postgresql_connection
> CREATE FOREIGN CATALOG postgresql_catalog
     USING CONNECTION postgresql_connection
     OPTIONS (database 'postgresdb');