Condividi tramite

ALTER CATALOG

  • Articolo

Si applica a:sì contrassegnato Databricks SQL sì contrassegnato Databricks Runtime 10.4 LTS e versioni successive sì contrassegnato 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 |
   OPTIONS (option value [, ...] )}

Parametri

  • catalog_name

    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: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 tag al catalogo. È necessario disporre dell'autorizzazione use_catalog per applicare un tag a un catalogo. Vedi 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 [, ...] )

    Rimuovere i tag dal catalogo. È necessario disporre dell'autorizzazione use_catalog 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. Il tag_name deve 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

    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 o DISABLE 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.

  • OPTIONS

    Configura i parametri specifici del catalogo. Sostituisce l'elenco di opzioni esistente con un nuovo elenco di opzioni.

    Usare OPTIONS per impostare authorized paths per i cataloghi esterni creati usando la federazione del metastore Hive.

    • opzione

      Chiave della proprietà. La chiave può essere costituita da uno o più identificatori separati da un punto o da un valore letterale STRING.

      Le chiavi delle proprietà devono essere univoche e fanno distinzione tra maiuscole e minuscole.

    • valore

      Valore per la proprietà. Il valore deve essere un'espressione costante BOOLEAN, STRING, INTEGER o DECIMAL.

      Ad esempio, un oggetto value for password può usare l'espressione secret('secrets.r.us', 'postgresPassword') costante anziché immettere la password letterale.

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');

-- Adds an authorized path to a foreign catalog created using :re[HMS] federation.
> ALTER CATALOG my_federated_catalog OPTIONS (authorized_paths 'path/to/dir1, path/to/dir2');

–– 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)