Udostępnij za pośrednictwem

ALTER CATALOG

  • Artykuł

Dotyczy:zaznaczone jako tak Databricks SQL zaznaczone jako tak Databricks Runtime 10.4 LTS i nowsze zaznaczone jako tak tylko katalog Unity

Przenosi własność katalogu do nowego podmiotu zabezpieczeń, stosuje tagi do katalogu lub umożliwia lub blokuje optymalizację predykcyjną dla katalogu.

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 }

Parametry

  • catalog_name

    Nazwa katalogu, który ma zostać zmieniony. Jeśli nie podasz nazwy, wartość domyślna to hive_metastore.

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

    Przenosi własność katalogu do 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 katalogu. Musisz mieć uprawnienia use_catalog, aby zastosować tag do katalogu. 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 [, ...] )

    Usuń tagi z wykazu. Musisz mieć uprawnienia use_catalog, aby zastosować tag do katalogu.

    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 katalogu.

  • 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 katalog na żądane ustawienie optymalizacji predykcyjnej. Domyślnie, gdy katalogi są tworzone, domyślnym działaniem jest INHERIT z konta. Domyślnie nowe obiekty utworzone w wykazie będą dziedziczyć ustawienie z wykazu.

    Jeśli wykaz zostanie zmieniony, zachowanie będzie kaskadowe dla wszystkich schematów i ich obiektów, które dziedziczą optymalizację predykcyjną. Obiekty w schematach, które nie dziedziczą optymalizacji predykcyjnej, ani obiekty, które jawnie definiują optymalizację predykcyjną jako ENABLE lub DISABLE, nie są zależne od ustawienia katalogu.

    Aby ustawić optymalizację predykcyjną katalogu, użytkownik musi mieć CREATE uprawnienia do katalogu.

    Do optymalizacji predykcyjnej kwalifikują się tylko zarządzane katalogi w Unity Catalog, które nie są katalogami Delta Sharing.

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)