Condividi tramite

ALTER CATALOG

  • Articolo

Si applica a:selezionare sì contrassegnato come sì controllo sql di Databricks SQL contrassegnato come sì Databricks Runtime 10.4 LTS e versioni successive selezionare sì solo Unity Catalog

Trasferisce la proprietà di un catalog a un nuovo principale, applica i tag a un catalogoppure abilita o disabilita di ottimizzazione predittiva per un catalog.

Sintassi

ALTER CATALOG [ catalog_name ]
 { [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION }

Parameters

  • catalog_name

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

  • [ SET ] PROPRIETARIO A principale

    Trasferisce la proprietà del catalog 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.

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

    Applicare etichette al catalog. È necessario disporre dell'autorizzazione use_catalog per applicare un tag a un catalog. Vedere USE CATALOG.

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

  • UNSET TAGS ( tag_name [, ...] )

    Remove tag dal catalog. È necessario disporre dell'autorizzazione use_catalog per applicare un tag a un catalog.

    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. Il tag_name deve essere univoco all'interno del catalog.

  • 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

    Modifica il catalog all'impostazione di ottimizzazione predittiva desiderata. Per impostazione predefinita, quando vengono creati catalogs, il comportamento consiste nel INHERIT dall'account. Per impostazione predefinita, i nuovi oggetti creati nella catalog erediteranno l'impostazione dal catalog.

    Se il catalog 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 esplicitamente ENABLE o DISABLE l'ottimizzazione predittiva non sono interessati dall'impostazione catalog.

    Per set l'ottimizzazione predittiva per un catalog, l'utente deve avere l'autorizzazione CREATE su catalog.

    Solo la condivisione non Delta, le catalogs gestite in Unity Catalog sono idonee 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)