ALTER CATALOG

A következőkre vonatkozik: Databricks SQL Databricks Runtime 10.4 LTS és a Unity Catalog felett csak

Átviszi a katalógus tulajdonjogát egy új tagra, címkéket alkalmaz egy katalógusra, vagy engedélyezi vagy letiltja a katalógus prediktív optimalizálását .

Syntax

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

Paraméterek

• catalog_name

  A módosítani kívánt katalógus neve. Ha nem ad meg nevet, az alapértelmezett érték.hive_metastore

• [ SET ] TULAJDONOS – FŐ

  A katalógus tulajdonjogát a következőre principaltovábbítja: .

  A következőkre vonatkozik: Databricks SQL Databricks Runtime 11.3 LTS és újabb

  SET választható kulcsszóként engedélyezett.

• CÍMKÉK BEÁLLÍTÁSA ( { tag_name = tag_value } [, ...] )

  Címkék alkalmazása a katalógusra. Rendelkeznie use_catalog kell engedéllyel ahhoz, hogy címkét alkalmazzon egy katalógusra. Lásd: HASZNÁLATI KATALÓGUS.

  A következőkre vonatkozik: Databricks SQL Databricks Runtime 13.3 LTS és újabb

• UNSET TAGS ( tag_name [, ...] )

  Távolítsa el a címkéket a katalógusból. Rendelkeznie use_catalog kell engedéllyel ahhoz, hogy címkét alkalmazzon egy katalógusra.

  A következőkre vonatkozik: Databricks SQL Databricks Runtime 13.3 LTS és újabb

• tag_name

  Egy literál STRING. A tag_name katalógusban egyedinek kell lennie.

• tag_value

  Egy literál STRING.

• { ENABLE | LETILTÁS | INHERIT } PREDIKTÍV OPTIMALIZÁLÁS

  A következőkre vonatkozik: Databricks SQL Databricks Runtime 12.2 LTS és újabb

  Módosítja a katalógust a kívánt prediktív optimalizálási beállításra. Alapértelmezés szerint a katalógusok létrehozásakor a viselkedés a fióktól származik INHERIT . Alapértelmezés szerint a katalógusban létrehozott új objektumok öröklik a beállítást a katalógusból.

  Ha a katalógus módosul, a viselkedés kaszkádolt lesz az összes sémára és azok objektumára, amelyek öröklik a prediktív optimalizálást. A katalógusbeállítás nem befolyásolja a sémák olyan objektumait, amelyek nem öröklik a prediktív optimalizálást, illetve azokat az objektumokat, amelyek kifejezetten ENABLE vagy DISABLE prediktív optimalizálást végeznek.

  A katalógus prediktív optimalizálásának beállításához a felhasználónak engedéllyel kell rendelkeznie CREATE a katalógusban.

  Csak a Nem Delta-megosztás, a Unity Katalógusban felügyelt katalógusok jogosultak a prediktív optimalizálásra.

Példák

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

Kapcsolódó cikkek

• KATALÓGUS LÉTREHOZÁSA
• KATALÓGUS LEÍRÁSA
• DROP CATALOG
• KATALÓGUSOK MEGJELENÍTÉSE