ALTER CATALOG
Dotyczy: Databricks SQL Databricks Runtime 10.4 LTS i nowszy 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
-
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: Databricks SQL 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: Databricks SQL 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: Databricks SQL Databricks Runtime 13.3 LTS i nowsze
tag_name
Literał
STRING
. Elementtag_name
musi być unikatowy w katalogu.tag_value
Literał
STRING
.{ WŁĄCZ | WYŁĄCZ | DZIEDZICZ } OPTYMALIZACJĘ PREDYKCYJNĄ
Dotyczy: Databricks SQL Databricks Runtime 12.2 LTS i nowsze
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
aniDISABLE
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)