ALTER SCHEMA

S’applique à :coché Databricks SQL coché Databricks Runtime

Modifie le propriétaire d’un schéma, modifie l’emplacement de stockage managé d’un schéma, définit le comportement d’optimisation prédictive , modifie les métadonnées associées à un schéma en définissant DBPROPERTIESou définit la période de récupération pour les tables managées supprimées. 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 |
      SET MANAGED LOCATION location |
      [ SET ] RETAIN DROPPED TO number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } }

Parameters

  • schema_name

    Nom du schéma à modifier. Si le schéma est introuvable, Azure Databricks déclenche 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 dans les catalogues non openSharing, gérés dans le catalogue Unity sont éligibles pour l’optimisation prédictive.

  • SET EMPLACEMENT MANAGÉ

    S’applique à :check marqué oui Databricks SQL coche marqué oui Databricks Runtime 18.1 et versions ultérieures , cochez oui catalogue Unity uniquement

    Modifie l’emplacement de stockage managé pour un schéma standard. Les nouvelles tables managées et les volumes managés créés dans le schéma utilisent l’emplacement mis à jour. Databricks ne déplace pas d’objets existants.

    • emplacement

      Chemin d’accès de stockage cloud pour le nouvel emplacement de stockage managé. Elle doit être contenue dans un emplacement externe.

  • [ SET ] CONSERVER LE NOMBRE { HEURE | HEURES | JOUR | JOURS | SEMAINE | WEEKS }

    S’applique à :check marqué oui Databricks Runtime 17.3 et versions ultérieures , cochez uniquement le catalogue Unity oui

    Important

    Cette fonctionnalité est disponible en préversion publique.

    Définit la période de récupération pour les tables gérées supprimées dans le schéma, la période pendant laquelle les tables supprimées peuvent être récupérées à l’aide de la UNDROP TABLE commande. La valeur par défaut hérite du catalogue parent (7 jours s’il n’est pas défini). La valeur doit être de 0 heures (pour désactiver la récupération) ou comprise entre 7 et 30 jours, inclus.

    La définition de la période de récupération sur 0 signifie que les tables supprimées ne sont pas récupérables à l’aide UNDROP et que les fichiers de données sont supprimés du stockage cloud dans les 48 heures.

    La période de récupération au niveau du schéma est prioritaire sur n’importe quel paramètre au niveau du catalogue pour les tables du schéma. Ce paramètre s’applique uniquement aux tables supprimées après la configuration de la période de récupération. Une fois la période de récupération terminée, les fichiers de données des tables managées sont supprimés de votre stockage cloud dans les 48 heures.

    SET est autorisé en tant que mot clé facultatif. Nécessite MANAGE un privilège ou une propriété sur le schéma. Voir aussi Supprimer une table managée.

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;

-- Change the managed storage location of a schema
> ALTER SCHEMA my_catalog.my_schema SET MANAGED LOCATION 's3://my-bucket/schemas/my_schema/';

-- Set a 14-day recovery period for dropped managed tables in a schema
> ALTER SCHEMA my_catalog.my_schema RETAIN DROPPED TO 14 DAYS;

-- Set a 7-day recovery period (overrides any catalog-level setting)
> ALTER SCHEMA my_catalog.my_schema SET RETAIN DROPPED TO 7 DAYS;
  • Last updated on