ALTER CATALOG

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

Přenese vlastnictví katalogu na nový objekt zabezpečení, použije značky v katalogu nebo povolí nebo zakáže prediktivní optimalizaci katalogu.

Syntaxe

ALTER CATALOG [ catalog_name ]
 { [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) } |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION }

Parametry

  • catalog_name

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

  • [ SET ] VLASTNÍK K objektu zabezpečení

    Přenese vlastnictví katalogu do principal.

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

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

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

    Použijte značky v katalogu. Musíte mít use_catalog oprávnění k použití značky v katalogu. Viz POUŽITÍ KATALOGU.

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

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

    Odeberte značky z katalogu. Musíte mít use_catalog oprávnění k použití značky v katalogu.

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

  • tag_name

    Literál STRING. Musí tag_name být jedinečný v rámci katalogu.

  • tag_value

    Literál STRING.

  • { ENABLE | ZAKÁZAT | DĚDIT } PREDIKTIVNÍ OPTIMALIZACE

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

    Důležité

    Tato funkce je ve verzi Public Preview.

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

    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í optimalizace nejsou nastavením katalogu ovlivněny.

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

    K prediktivní optimalizaci mají nárok pouze ne delta sdílení, spravované katalogy v katalogu Unity.

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

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