Udostępnij za pośrednictwem

ALTER CATALOG

  • Artykuł

Dotyczy:zaznaczone jako tak Databricks SQL zaznaczone jako tak Databricks Runtime 10.4 LTS i nowszych zaznaczone jako tak Unity tylko Catalog

Przenosi własność catalog do nowego podmiotu zabezpieczeń, stosuje tagi do cataloglub włącza lub wyłącza optymalizacji predykcyjnej dla catalog.

Składnia

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

Parameters

  • catalog_name

    Nazwa catalog, która ma zostać zmieniona. Jeśli nie podasz nazwy, wartość domyślna to hive_metastore.

  • [ SET ] WŁAŚCICIEL DO głównego

    Przenosi własność catalog na principal.

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

    SET jest dozwolone jako opcjonalne słowo kluczowe.

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

    Zastosuj tagi do catalog. Musisz mieć uprawnienia use_catalog, aby zastosować tag do catalog. Zobacz USE CATALOG.

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 13.3 LTS i nowsze

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

    Remove tagów z catalog. Musisz mieć uprawnienia use_catalog, aby zastosować tag do catalog.

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 13.3 LTS i nowsze

  • tag_name

    Literał STRING. tag_name musi być unikatowa w catalog.

  • tag_value

    Literał STRING.

  • { WŁĄCZ | WYŁĄCZ | DZIEDZICZ } OPTYMALIZACJĘ PREDYKCYJNĄ

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 12.2 LTS i nowsze

    Zmienia catalog na żądane ustawienie optymalizacji predykcyjnej. Domyślnie po utworzeniu catalogs zachowanie polega na INHERIT z konta. Domyślnie nowe obiekty utworzone w catalog będą dziedziczyć ustawienie z catalog.

    Jeśli catalog zostanie zmieniona, zachowanie będzie mieć efekt kaskadowy dla wszystkich schematów i ich obiektów, dziedziczących optymalizację predykcyjną. Obiekty w schematach, które nie dziedziczą optymalizacji predykcyjnej lub te, które jawnie mają optymalizację predykcyjną ENABLE lub DISABLE, są nienaruszone przez ustawienie catalog.

    Aby dokonać set optymalizacji predykcyjnej dla catalog, użytkownik musi mieć uprawnienia CREATE na catalog.

    Tylko zarządzane catalogs w środowisku Unity Catalog bez Delta Sharing kwalifikują się do optymalizacji predykcyjnej.

Przykłady

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