Condividi tramite

ALTER SCHEMA

  • Articolo

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime

Modifica il proprietario di uno schema, imposta comportamento di ottimizzazione predittiva o modifica i metadati associati a uno schema impostando DBPROPERTIES. I valori di proprietà specificati sostituiscono qualsiasi valore esistente con lo stesso nome di proprietà.

Sebbene l'utilizzo di SCHEMA e DATABASE sia intercambiabile, SCHEMA è preferibile.

Sintassi

ALTER SCHEMA schema_name
   { SET DBPROPERTIES ( { key = val } [, ...] ) |
    [ SET ] OWNER TO principal
    SET TAGS ( { tag_name = tag_value } [, ...] ) |
    UNSET TAGS ( tag_name [, ...] ) |
    { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION } }

Parametri

  • schema_name

    Nome dello schema da modificare. Se non è possibile trovare lo schema, Azure Databricks genera un errore di SCHEMA_NOT_FOUND.

  • DBPROPERTIES ( key = val [, ...] )

    Proprietà dello schema da impostare o disattivare.

  • [ SET ] PROPRIETARIO A principale

    Trasferisce la proprietà dello schema 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 SET ( { tag_name = tag_value } [, ...] )

    Applicare tag allo schema. È necessario avere use_schema per applicare un tag allo schema.

    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 dallo schema. È necessario disporre di use_schema per rimuovere un tag dallo schema.

    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 dello schema.

  • tag_value

    Valore letterale STRING.

  • { ENABLE | DISABLE | INHERIT } OTTIMIZZAZIONE PREDITTIVA

    Si applica a:contrassegnato sì Databricks SQL contrassegnato sì Databricks Runtime 12.2 LTS e versioni successive contrassegnato sì Solo Catalogo Unity

    Modifica lo schema con l'impostazione di ottimizzazione predittiva desiderata. Per impostazione predefinita, quando vengono creati gli schemi, il comportamento consiste nel INHERIT dal catalogo. Per impostazione predefinita, i nuovi oggetti creati nello schema erediteranno l'impostazione dallo schema.

    Se lo schema viene modificato, il comportamento verrà propagato a tutti gli oggetti che ereditano l'ottimizzazione predittiva. Gli oggetti che eseguono in modo esplicito l'ottimizzazione predittiva ENABLE o DISABLE non sono influenzati dall'impostazione dello schema.

    Per impostare l'ottimizzazione predittiva per uno schema, l'utente deve disporre dell'autorizzazione CREATE per lo schema.

    Solo gli schemi nei cataloghi gestiti, non appartenenti alla condivisione Delta, in Unity Catalog sono idonei per l'ottimizzazione predittiva.

Esempi

-- Creates a schema named `inventory`.
> CREATE SCHEMA inventory;

-- Alters the schema to set properties `Edited-by` and `Edit-date`.
> ALTER SCHEMA inventory SET DBPROPERTIES ('Edited-by' = 'John', 'Edit-date' = '01/01/2001');

-- Verify that properties are set.
> DESCRIBE SCHEMA EXTENDED inventory;
 database_description_item                 database_description_value
 ------------------------- ------------------------------------------
             Database Name                                  inventory
               Description
                  Location    file:/temp/spark-warehouse/inventory.db
                Properties ((Edit-date,01/01/2001), (Edited-by,John))

-- Transfer ownership of the schema to another user
> ALTER SCHEMA inventory OWNER TO `alf@melmak.et`

-- Applies three tags to the schema named `test`.
> ALTER SCHEMA test SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');

-- Removes three tags from the schema named `test`.
> ALTER SCHEMA test UNSET TAGS ('tag1', 'tag2', 'tag3');

-- Enables predictive optimization for objects in schema my_schema
> ALTER SCHEMA my_schema ENABLE PREDICTIVE OPTIMIZATION;