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

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

  • SET TAGS ( { 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

  • UNSET 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

    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;