Condividi tramite

ALTER CATALOG

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 una nuova entità, modifica la posizione di archiviazione gestita di un catalogo, applica i tag a un catalogo o abilita o disabilita l'ottimizzazione predittiva per un catalogo.

Sintassi

ALTER CATALOG [ catalog_name ]
 { DEFAULT COLLATION default_collation_name |
   [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION |
   OPTIONS (option value [, ...] ) |
   SET MANAGED LOCATION location }

Parametri

  • catalog_name

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

  • COLLAZIONE PREDEFINITA nome_collazione_predefinita COLLAZIONE PREDEFINITA

    Si applica a:check contrassegnato come sì controllo SQL di Databricks contrassegnato come sì Databricks Runtime 17.1 e versioni successive

    Modifica le regole di confronto predefinite per i nuovi schemi definiti all'interno del catalogo. Le regole di confronto predefinite di schemi e oggetti esistenti all'interno del catalogo non vengono modificate.

  • [ 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.

  • OPZIONI

    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 sono case-sensitive.

    • valore

      Il valore per la proprietà. Il valore deve essere un'espressione BOOLEANSTRING , INTEGERDECIMAL, o .

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

  • SET POSIZIONE GESTITA

    Si applica a:check contrassegnato con il segno di spunta sì di Databricks SQL contrassegnato come sì Databricks Runtime 18.1 e versioni successive , il segno di spunta contrassegnato come Solo catalogo Unity

    Modifica il percorso di archiviazione gestito per il catalogo. Le nuove tabelle gestite e i volumi gestiti creati nel catalogo usano il percorso aggiornato. Databricks non sposta gli oggetti esistenti.

    • ubicazione

      Percorso di archiviazione cloud per la nuova posizione di archiviazione gestita. Deve essere contenuta all'interno di una posizione esterna.

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

-- Change the default collation of a catalog to case sensitive unicode
> ALTER CATALOG test DEFAULT COLLATION UNICODE_CS;

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

-- Change the managed storage location of a catalog
> ALTER CATALOG my_catalog SET MANAGED LOCATION 's3://my-bucket/managed/';
  • Last updated on