Partager via

ALTER SCHEMA

S’applique à :coché Databricks SQL 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 l’utilisation de SCHEMA et DATABASE soit interchangeable, il est préférable d’utiliser SCHEMA.

Syntaxe

ALTER SCHEMA schema_name
    { DEFAULT COLLATION default_collation_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

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

  • COLLATION PAR DÉFAUT default_collation_name

    S’applique à :check marqué oui Databricks SQL vérifié marqué oui Databricks Runtime 17.1 et versions ultérieures

    Modifie le classement par défaut pour les nouveaux objets définis dans le schéma. Le classement par défaut des objets existants dans le schéma n’est pas modifié.

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

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

  • [ SET ] PROPRIÉTAIRE À principal

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

    S’applique à :coché Databricks SQL coché Databricks Runtime 11.3 LTS et version ultérieure

    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 à :coché Databricks SQL coché Databricks Runtime 13.3 LTS et version ultérieure

  • BALISES UNSET ( tag_name [, ...] )

    Supprimer des étiquettes du schéma. Vous devez avoir USE SCHEMA pour supprimer une balise du schéma.

    S’applique à :coché Databricks SQL coché Databricks Runtime 13.3 LTS et version ultérieure

  • tag_name

    Une STRING littérale. tag_name doit être unique dans le schéma.

  • tag_value

    Une STRING littérale.

  • { ENABLE | DISABLE | HÉRITER } OPTIMISATION PRÉDICTIVE

    S’applique à :coché Databricks SQL coché Databricks Runtime 12.2 LTS et versions ultérieures coché Unity Catalog uniquement

    Modifie le schéma en lui attribuant le paramètre d’optimisation prédictive voulu. Par défaut, lors de la création de schémas, le comportement consiste à INHERIT du 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 est répercuté sur tous les objets qui héritent de l’optimisation prédictive. Les objets qui ENABLE ou DISABLE explicitement l'optimisation prédictive 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 non-Delta Sharing gérés dans Unity Catalog sont éligibles à 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;

-- Alter the default collation of a schema
> ALTER SCHEMA my_schema DEFAULT COLLATION UNICODE_CI_AI;
  • Last updated on