ALTER CATALOG

platí pro: Databricks Runtime 10.4 LTS a vyšší, katalogu Unity.

Převede vlastnictví katalogu na nový objekt zabezpečení, aplikuje značky na katalog nebo povolí či zakáže prediktivní optimalizaci pro katalog.

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 OBJEKTu zabezpečení

  Přenese vlastnictví katalogu na principal.

  Platí pro: Databricks SQL 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: Databricks SQL Databricks Runtime 13.3 LTS a vyšší

• ZNAČKY UNSET ( 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: Databricks SQL Databricks Runtime 13.3 LTS a vyšší

• tag_name

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

• tag_value

  Literál STRING.

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

  Platí pro: Databricks SQL 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.

  K prediktivní optimalizaci mají nárok pouze spravované katalogy, které jsou jiné než Delta Sharing, v Unity Catalogu.

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)

Související články

• CREATE CATALOG
• DESCRIBE CATALOG
• DROP CATALOG
• SHOW CATALOGS