ALTER CATALOG
Si applica a: Databricks SQL
Databricks Runtime 10.4 LTS e versioni successive
solo Catalogo Unity
Trasferisce la proprietà di un catalogo a un nuovo titolare, applica tag a un catalogo o abilita o disabilita l'ottimizzazione predittiva per un catalogo.
Sintassi
ALTER CATALOG [ catalog_name ]
{ [ SET ] OWNER TO principal
SET TAGS ( { tag_name = tag_value } [, ...] ) |
UNSET TAGS ( tag_name [, ...] ) |
{ ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION }
Parametri
-
Nome del catalogo da modificare. Se non si specifica alcun nome, il valore predefinito è
hive_metastore
. [ SET ] PROPRIETARIO A principale
Trasferisce la proprietà del catalogo a
principal
.Si applica a:
Databricks SQL
Databricks Runtime 11.3 LTS e versioni successive
SET
è consentito come parola chiave facoltativa.TAGS SET ( { tag_name = tag_value } [, ...] )
Applicare tag al catalogo. È necessario disporre dell'autorizzazione
use_catalog
per applicare un tag a un catalogo. Vedere USE CATALOG.Si applica a:
Databricks SQL
Databricks Runtime 13.3 LTS e versioni successive
UNSET TAGS ( tag_name [, ...] )
Rimuovere i tag dal catalogo. È necessario disporre dell'autorizzazione
use_catalog
per applicare un tag a un catalogo.Si applica a:
Databricks SQL
Databricks Runtime 13.3 LTS e versioni successive
tag_name
Valore letterale
STRING
. Iltag_name
deve essere univoco all'interno del catalogo.tag_value
Valore letterale
STRING
.{ ENABLE | DISABLE | INHERIT } OTTIMIZZAZIONE PREDITTIVA
Si applica a:
Databricks SQL
Databricks Runtime 12.2 LTS e versioni successive
Modifica il catalogo con l'impostazione di ottimizzazione predittiva desiderata. Per impostazione predefinita, quando vengono creati i cataloghi, il comportamento consiste nel
INHERIT
dall'account. Per impostazione predefinita, i nuovi oggetti creati nel catalogo erediteranno l'impostazione dal catalogo.Se il catalogo viene modificato, il comportamento verrà propagato a tutti gli schemi e ai relativi oggetti, che ereditano l'ottimizzazione predittiva. Gli oggetti negli schemi che non ereditano l'ottimizzazione predittiva o gli oggetti che eseguono l'ottimizzazione predittiva
ENABLE
oDISABLE
non sono influenzati dall'impostazione del catalogo.Per impostare l'ottimizzazione predittiva per un catalogo, l'utente deve disporre dell'autorizzazione
CREATE
per il catalogo.Solo i cataloghi gestiti in Unity Catalog che non utilizzano Delta Sharing sono idonei per l'ottimizzazione predittiva.
Esempi
-- 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)