ALTER CATALOG

Platí pro:označeno jako ano Databricks SQL označeno jako ano Databricks Runtime 10.4 LTS a vyšší označeno jako ano pouze pro Unity Catalog.

Přenese vlastnictví katalogu na nový objekt zabezpečení, změní umístění spravovaného úložiště katalogu, použije značky v katalogu, povolí nebo zakáže prediktivní optimalizaci katalogu nebo nastaví dobu obnovení pro vyřazené spravované tabulky.

Syntaxe

ALTER CATALOG [ catalog_name ]
 { DEFAULT COLLATION default_collation_name |
   [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION |
   OPTIONS (option value [, ...] ) |
   SET MANAGED LOCATION location |
   [ SET ] RETAIN DROPPED TO number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } }

Parametry

  • catalog_name

    Název katalogu, který má být změněn. Pokud zadáte žádný název, výchozí hodnota je hive_metastore.

  • výchozí kolace default_collation_name

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

    Změní výchozí kolaci pro nová schémata definovaná v katalogu. Výchozí kolace existujících schémat a objektů v katalogu se nezmění.

  • [ SET ] VLASTNÍK principal

    Přenese vlastnictví katalogu na principal.

    Platí pro:Ano Databricks SQL Ano Databricks Runtime 11.3 LTS a vyšší

    SET je povolený jako volitelné klíčové slovo.

  • SET TAGS ( { tag_name = tag_value } [, ...] )

    Aplikujte značky na katalog. Abyste mohli použít značku v katalogu, musíte mít oprávnění k USE CATALOG. Viz USE CATALOG.

    Platí pro:označeno jako ano Databricks SQL označeno jako ano Databricks Runtime 13.3 LTS a novější

  • ODEBRAT ZNAČKY ( tag_name [, ...] )

    Odeberte značky z katalogu. Abyste mohli použít značku v katalogu, musíte mít oprávnění k USE CATALOG.

    Platí pro:označeno jako ano Databricks SQL označeno jako ano Databricks Runtime 13.3 LTS a novější

  • tag_name

    Literál STRING. tag_name musí být v katalogu jedinečný.

  • tag_value

    Literál STRING.

  • { POVOLIT | DEAKTIVOVAT | PŘEVZÍT } PREDIKTIVNÍ OPTIMALIZACE

    Platí pro:označeno jako zaškrtnuté Databricks SQL označeno jako zaškrtnuté Databricks Runtime 12.2 LTS a vyšší

    Změní katalog na požadované nastavení prediktivní optimalizace. Při vytváření katalogů je ve výchozím nastavení chování INHERIT z účtu. Ve výchozím nastavení nové objekty vytvořené v katalogu zdědí nastavení z katalogu.

    Pokud se katalog změní, chování se kaskádově změní na všechna schémata a jejich objekty, které dědí prediktivní optimalizaci. Objekty ve schématech, které nedědí prediktivní optimalizaci nebo objekty, které explicitně ENABLE nebo DISABLE prediktivní optimalizaci, nejsou nastavením katalogu ovlivněny.

    Aby uživatel mohl nastavit prediktivní optimalizaci katalogu, musí mít k katalogu oprávnění CREATE.

    Pro prediktivní optimalizaci jsou způsobilé pouze neotevřené spravované katalogy v katalogu Unity.

  • MOŽNOSTI

    Nastaví parametry specifické pro katalog. Nahradí existující seznam možností novým seznamem možností.

    Pomocí OPTIONS můžete nastavit authorized paths pro cizí katalogy vytvořené pomocí federace metastoru Hive.

    • možnost

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

      Klíče vlastností musí být jedinečné a jsou citlivé na velikost písmen.

    • hodnota

      Hodnota vlastnosti. Hodnota musí být výraz BOOLEAN, STRING, INTEGERnebo DECIMALkonstanta.

      Například valuepassword může používat konstantní výrazsecret('secrets.r.us', 'postgresPassword') na rozdíl od zadání doslovného hesla.

  • SET UMÍSTĚNÍ SPRAVOVANÉHO UMÍSTĚNÍ

    Platí pro:check marked yes Databricks SQL check marked yes Databricks Runtime 18.1 and above check marked yes Unity Catalog only

    Změní umístění spravovaného úložiště pro katalog. Nové spravované tabulky a spravované svazky vytvořené v katalogu používají aktualizované umístění. Databricks nepřesune existující objekty.

    • umístění

      Cesta cloudového úložiště pro nové spravované umístění úložiště. Musí být obsažen v externím umístění.

  • [ SET ] ZACHOVAT VYŘAZENO NA ČÍ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

    Important

    Tato funkce je ve verzi Public Preview.

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

    SET je povolený jako volitelné klíčové slovo. Vyžaduje MANAGE oprávnění nebo vlastnictví katalogu. Viz také Vyřazení spravované tabulky.

Příklady

-- Creates a catalog named `some_cat`.
> CREATE CATALOG some_cat;

-- Transfer ownership of the catalog to another user
> ALTER CATALOG some_cat OWNER TO `alf@melmak.et`;

-- Applies three tags to the catalog named `test`.
> ALTER CATALOG test SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');

-- Removes three tags from the catalog named `test`.
> ALTER CATALOG test UNSET TAGS ('tag1', 'tag2', 'tag3');

-- Change the default collation of a catalog to case sensitive unicode
> ALTER CATALOG test DEFAULT COLLATION UNICODE_CS;

-- Adds an authorized path to a foreign catalog created using :re[HMS] federation.
> ALTER CATALOG my_federated_catalog OPTIONS (authorized_paths 'path/to/dir1, path/to/dir2');

–– Enables predictive optimization for catalog main
> ALTER CATALOG main ENABLE PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                        value
  ------------------------    ---------
  < other rows of describe extended >
  Predictive Optimization    ENABLE

-- Sets catalog main to inherit setting from parent object (metastore)
> ALTER CATALOG main INHERIT PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                         value
  ------------------------    ----------------------------------------
  < other rows of describe extended >
  Predictive Optimization     ENABLE (inherited from METASTORE metastore_name)

-- Change the managed storage location of a catalog
> ALTER CATALOG my_catalog SET MANAGED LOCATION 's3://my-bucket/managed/';

-- Set a 30-day recovery period for dropped managed tables in a catalog
> ALTER CATALOG my_catalog RETAIN DROPPED TO 30 DAYS;

-- Set the recovery period to 0 (tables are not recoverable after drop)
> ALTER CATALOG my_catalog SET RETAIN DROPPED TO 0 DAYS;
  • Last updated on