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 il comportamento di ottimizzazione predittiva o modifica i metadati associati a uno schema impostando DBPROPERTIES. I valori di proprietà specificati eseguono l'override di 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 annullare l'impostazione.

  • [ edizione Standard T ] OWNER TO principal

    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 edizione Standard T ( { tag_name = tag_value } [, ...] )

    Applicare tag allo schema. È necessario use_schema 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

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

    Rimuovere i tag dallo schema. È necessario use_schema 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. Deve tag_name essere univoco all'interno dello schema.

  • tag_value

    Valore letterale STRING.

  • { ENABLE | DISABLE | INHERIT } OTTIMIZZAZIONE PREDITTIVA

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

    Importante

    Questa funzionalità è disponibile in anteprima pubblica.

    Modifica lo schema con l'impostazione di ottimizzazione predittiva desiderata. Per impostazione predefinita, quando vengono creati gli schemi, il comportamento proviene 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 in modo esplicito ENABLE o DISABLE predittivo non sono interessati dall'impostazione dello schema.

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

    Solo gli schemi in condivisione non Delta, i cataloghi gestiti nel catalogo Unity 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;