ALTER SCHEMA

  • Article

S’applique à :case marquée oui Databricks SQL oui coché Databricks Runtime

Modifie le propriétaire d’un schéma, définit le comportement d’optimisation prédictive ou modifie les métadonnées associées à un schéma en définissant DBPROPERTIES. Les valeurs de propriété spécifiées remplacent toute valeur existante portant le même nom de propriété.

Bien que SCHEMA et DATABASE soient interchangeables, il est préférable d’utiliser SCHEMA.

Syntaxe

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

Paramètres

  • schema_name

    Nom du schéma à modifier. Si le schéma est introuvable, Azure Databricks génère une erreur SCHEMA_NOT_FOUND.

  • DBPROPERTIES ( key = val [, …] )

    Propriétés de schéma à définir ou à annuler.

  • [ SET ] PROPRIÉTAIRE DU principal

    Transfère la propriété du schéma vers principal.

    S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 11.3 LTS et versions ultérieures

    SET est autorisé en tant que mot clé facultatif.

  • SET TAGS ( { tag_name = tag_value } [, …] )

    Appliquer des balises au schéma. Vous devez avoir use_schema pour appliquer une balise au schéma.

    S’applique à :coche marquée oui Databricks SQL oui coché Databricks Runtime 13.3 LTS et versions ultérieures

  • UNSET TAGS ( tag_name [, …] )

    Supprimer des balises du schéma. Vous devez avoir use_schema pour supprimer une balise du schéma.

    S’applique à :coche marquée oui Databricks SQL oui coché Databricks Runtime 13.3 LTS et versions ultérieures

  • tag_name

    Un STRING littéral. Le tag_name doit être unique dans le schéma.

  • tag_value

    Un STRING littéral.

  • { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION

    S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 12.2 LTS et versions ultérieures case marquée oui Unity Catalog uniquement

    Important

    Cette fonctionnalité est disponible en préversion publique.

    Modifie le schéma au paramètre d’optimisation prédictive souhaité. Par défaut, lorsque des schémas sont créés, le comportement est INHERIT sur le catalogue. Par défaut, les nouveaux objets créés dans le schéma héritent du paramètre du schéma.

    Si le schéma est modifié, le comportement se cascade sur tous les objets qui héritent de l’optimisation prédictive. Les objets dont le comportement d’optimisation prédictive est explicitement ENABLE ou DISABLE ne sont pas affectés par le paramètre de schéma.

    Pour définir l’optimisation prédictive d’un schéma, l’utilisateur doit avoir l’autorisation CREATE sur le schéma.

    Seuls les schémas dans des catalogues managés dans Unity Catalog qui ne sont pas en Partage Delta sont éligibles pour l’optimisation prédictive.

Exemples

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