ALTER CATALOG

  • Articolo

Si applica a:segno di spunta sì Solo databricks SQL segno di spunta sì Databricks Runtime 10.4 LTS e versioni successive segno di spunta sì al catalogo Unity

Trasferisce la proprietà di un catalogo a una nuova entità, 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

  • catalog_name

    Nome del catalogo da modificare. Se non si specifica alcun nome, il valore predefinito è hive_metastore.

  • [ edizione Standard T ] OWNER TO principal

    Trasferisce la proprietà del catalogo a principal.

    Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 11.3 LTS e versioni successive

    SET è consentito come parola chiave facoltativa.

  • tag edizione Standard T ( { tag_name = tag_value } [, ...] )

    Applicare tag al catalogo. È necessario disporre use_catalog dell'autorizzazione per applicare un tag a un catalogo. Vedere U edizione Standard CATALOG.

    Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 13.3 LTS e versioni successive

  • UN edizione Standard T TAGS ( tag_name [, ...] )

    Rimuovere i tag dal catalogo. È necessario disporre use_catalog dell'autorizzazione per applicare un tag a un catalogo.

    Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 13.3 LTS e versioni successive

  • tag_name

    Valore letterale STRING. Deve tag_name essere univoco all'interno del catalogo.

  • tag_value

    Valore letterale STRING.

  • { ENABLE | DISABLE | INHERIT } OTTIMIZZAZIONE PREDITTIVA

    Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 12.2 LTS e versioni successive

    Importante

    Questa funzionalità è disponibile in anteprima pubblica.

    Modifica il catalogo con l'impostazione di ottimizzazione predittiva desiderata. Per impostazione predefinita, quando vengono creati i cataloghi, il comportamento è quello INHERIT dell'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 ottimizzazione esplicitamente ENABLE o DISABLE predittiva non sono interessati dall'impostazione del catalogo.

    Per impostare l'ottimizzazione predittiva per un catalogo, l'utente deve disporre CREATE dell'autorizzazione per il catalogo.

    Solo la condivisione non differenziale, i cataloghi gestiti nel catalogo Unity 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)