Condividi tramite

ALTER SCHEMA

  • Articolo

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

Modifica il proprietario di un schema, imposta il comportamento di ottimizzazione predittiva di o modifica i metadati associati a un schema impostando DBPROPERTIES. La proprietà specificata values sovrascriverà 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 } }

Parameters

  • schema_name

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

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

    Proprietà schema a set o non impostato.

  • [ SET ] PROPRIETARIO A principale

    Trasferisce la proprietà del 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 i tag sul schema. È necessario avere use_schema per applicare un tag al 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 [, ...] )

    Remove tag dal schema. È necessario avere use_schema per remove un tag dal 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 del schema.

  • tag_value

    Valore letterale STRING.

  • { ENABLE | DISABLE | INHERIT } OTTIMIZZAZIONE PREDITTIVA

    Si applica a:contrassegnato con segno di spunta SQL di Databricks contrassegnato con segno di spunta Databricks Runtime 12.2 LTS e versioni successive contrassegnato con segno di spunta solo Unity Catalog

    Modifica il schema nell'impostazione di ottimizzazione predittiva desiderata. Per impostazione predefinita, quando vengono creati gli schemi, il comportamento consiste nel INHERIT dal catalog. Per impostazione predefinita, i nuovi oggetti creati nella schema erediteranno l'impostazione dal schema.

    Se la schema viene modificata, il comportamento verrà propagato a tutti gli oggetti che ereditano l'ottimizzazione predittiva. Gli oggetti che eseguono ENABLE o DISABLE per l'ottimizzazione predittiva in modo esplicito non sono interessati dall'impostazione di schema.

    Per set'ottimizzazione predittiva per un schema, l'utente deve disporre dell'autorizzazione CREATE per l'schema.

    Solo gli schemi non in condivisione Delta, quelli gestiti come catalogs 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;