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.

Důležitý

Když nastavíte možnosti katalogu, které mají přihlašovací údaje, jako je heslo nebo token, aby byly zabezpečené, zadejte hodnotu pomocí secret funkce místo zadávání literálové hodnoty přímo do OPTIONS klauzule. To vám umožní odkazovat na tajný klíč uložený v tajné službě Databricks místo zahrnutí hodnoty přihlašovacích údajů do příkazu.

Syntaxe

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

  • 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é složce OpenSharing.

  • 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 pro Delta Lake a Apache Iceberg a vytvoření metastoru katalogu Unity.

  • ZACHOVAT VYŘAZENO PRO číslo { HODINA | HODINY | DEN | DNY | TÝDEN | TÝDNY }

    Platí pro:check označený jako ano Databricks Runtime 17.3 a vyšší kontrola označená pouze jako ano Unity Catalog

    Důležitý

    Tato funkce je ve verzi Public Preview.

    Volitelně nastaví období obnovení pro vyřazené spravované tabulky v katalogu, období, během kterého lze vyřazené tabulky obnovit pomocí UNDROP TABLE příkazu. Pokud není zadáno, výchozí hodnota je 7 dní. Hodnota musí být 0 hodin (k zakázání obnovení) nebo mezi 7 až 30 dny (včetně).

    Nastavení doby obnovení na 0 znamená, že vyřazené tabulky se nedají obnovit pomocí UNDROP a datové soubory se z cloudového úložiště odstraní do 48 hodin.

    Pokud je u podřízeného schématu nastavena také doba obnovení, má nastavení na úrovni schématu přednost pro tabulky v daném schématu. Toto nastavení platí jenom pro tabulky vyřazené po nakonfigurování období obnovení. Po skončení období obnovení se datové soubory spravovaných tabulek odstraní z cloudového úložiště do 48 hodin.

    Nepodporuje se pro cizí nebo sdílené katalogy. Viz také Vyřazení spravované tabulky.

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

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 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