ALTER CATALOG

  • Cikk

A következőkre vonatkozik:jelölje be az igennel jelölt jelölőnégyzetet Databricks SQL jelölje be az igennel jelölt jelölőnégyzetet Databricks Runtime 10.4 LTS és a Unity Catalog felett csak jelölje be az igennel jelölt jelölőnégyzetet

Á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

  • [ Standard kiadás T ] TULAJDONOS– MEGBÍZÓ

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

    A következőkre vonatkozik:jelölje be az igennel jelölt jelölőnégyzetet Databricks SQL jelölje be az igennel jelölt jelölőnégyzetet Databricks Runtime 11.3 LTS és újabb

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

  • Standard kiadás T TAGS ( { 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: U Standard kiadás CATALOG.

    A következőkre vonatkozik:jelölje be az igennel jelölt jelölőnégyzetet Databricks SQL jelölje be az igennel jelölt jelölőnégyzetet Databricks Runtime 13.3 LTS és újabb

  • UN Standard kiadás T 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:jelölje be az igennel jelölt jelölőnégyzetet Databricks SQL jelölje be az igennel jelölt jelölőnégyzetet 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:jelölje be az igennel jelölt jelölőnégyzetet Databricks SQL jelölje be az igennel jelölt jelölőnégyzetet Databricks Runtime 12.2 LTS és újabb

    Fontos

    Ez a funkció a nyilvános előzetes verzióban érhető el.

    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)