ALTER CATALOG

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 10.4 LTS i nowszy zaznacz pole wyboru oznaczone jako tak tylko wykaz aparatu Unity

Przenosi własność wykazu do nowego podmiotu zabezpieczeń, stosuje tagi do wykazu lub włącza lub wyłącza optymalizację predykcyjną 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 wykazu, który ma zostać zmieniony. Jeśli nie podasz nazwy, wartość domyślna to hive_metastore.

  • [ SET ] WŁAŚCICIEL DO podmiotu zabezpieczeń

    Przenosi własność katalogu 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.

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

    Zastosuj tagi do wykazu. Musisz mieć use_catalog uprawnienia do stosowania tagu do katalogu. Zobacz USE CATALOG (UŻYWANIE WYKAZU).

    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ć use_catalog uprawnienia do stosowania tagu 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. Element tag_name musi być unikatowy 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

    Ważne

    Ta funkcja jest dostępna w publicznej wersji zapoznawczej.

    Zmienia katalog na żądane ustawienie optymalizacji predykcyjnej. Domyślnie po utworzeniu katalogów zachowanie to 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 obiektów jawnie ENABLE ani DISABLE optymalizacji predykcyjnej, nie mają wpływu na ustawienie wykazu.

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

    Do optymalizacji predykcyjnej kwalifikują się tylko wykazy zarządzane w wykazie aparatu Unity, które nie są udostępnianiem różnicowym.

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)