ALTER DATABASE (Transact-SQL)

Modifie certaines options de configuration d’une base de données.

Cet article fournit la syntaxe, les arguments, les notes, les autorisations et des exemples associés au produit SQL que vous choisissez.

Pour plus d’informations sur les conventions de la syntaxe, consultez Conventions de la syntaxe Transact-SQL.

Sélectionner un produit

Sur la ligne suivante, sélectionnez le nom du produit qui vous intéresse afin d’afficher uniquement les informations qui le concernent.

* SQL Server *  

Base de données SQL

SQL Managed Instance

Azure Synapse
Analytics

Analytics Platform
System (PDW)

Microsoft Fabric

 

Présentation : SQL Server

Dans SQL Server, cette instruction modifie une base de données ou les fichiers et groupes de fichiers associés à la base de données. ALTER DATABASE ajoute ou supprime des fichiers et des groupes de fichiers d'une base de données, modifie ses attributs ou ses fichiers et groupes de fichiers, modifie le classement de la base de données et définit les options de celle-ci. Les instantanés de base de données ne peuvent pas être modifiés. Pour modifier les options de base de données associées à la réplication, utilisez sp_replicationdboption.

En raison de sa longueur, la syntaxe d’ALTER DATABASE est divisée en plusieurs articles.

Article	Description
ALTER DATABASE	Le présent article indique la syntaxe à utiliser et les informations associées pour modifier le nom et le classement d’une base de données.
Options de fichiers et de groupes de fichiers ALTER DATABASE	Indique la syntaxe à utiliser et les informations associées pour ajouter et supprimer des fichiers et groupes de fichiers d’une base de données, et pour modifier les attributs des fichiers et groupes de fichiers.
Options ALTER DATABASE SET	Indique la syntaxe à utiliser et les informations associées pour modifier les attributs d’une base de données à l’aide des options SET d’ALTER DATABASE.
Mise en miroir de bases de données ALTER DATABASE	Indique la syntaxe et les informations associées des options SET d’ALTER DATABASE relatives à la mise en miroir de bases de données.
ALTER DATABASE SET HADR	Indique la syntaxe et les informations associées des options Groupes de disponibilité Always On d’ALTER DATABASE pour configurer une base de données secondaire sur un réplica secondaire d’un groupe de disponibilité Always On.
Niveau de compatibilité ALTER DATABASE	Indique la syntaxe et les informations associées des options SET d’ALTER DATABASE relatives aux niveaux de compatibilité des bases de données.
MODIFIER LA CONFIGURATION DÉLIMITÉE À LA BASE DE DONNÉES	Indique la syntaxe associée aux configurations étendues à la base de données utilisées pour les paramètres individuels au niveau de la base de données, tels que l’optimisation des requêtes et les comportements associés à l’exécution des requêtes.

Syntaxe

syntaxsql

-- SQL Server Syntax
ALTER DATABASE { database_name | CURRENT }
{
    MODIFY NAME = new_database_name
  | COLLATE collation_name
  | <file_and_filegroup_options>
  | SET <option_spec> [ ,...n ] [ WITH <termination> ]
}
[;]

<file_and_filegroup_options>::=
  <add_or_modify_files>::=
  <filespec>::=
  <add_or_modify_filegroups>::=
  <filegroup_updatability_option>::=

<option_spec>::=
{
  | <auto_option>
  | <change_tracking_option>
  | <cursor_option>
  | <database_mirroring_option>
  | <date_correlation_optimization_option>
  | <db_encryption_option>
  | <db_state_option>
  | <db_update_option>
  | <db_user_access_option>
  | <delayed_durability_option>
  | <external_access_option>
  | <FILESTREAM_options>
  | <HADR_options>
  | <parameterization_option>
  | <query_store_options>
  | <recovery_option>
  | <service_broker_option>
  | <snapshot_option>
  | <sql_option>
  | <termination>
  | <temporal_history_retention>
  | <data_retention_policy>
  | <compatibility_level>
      { 160 | 150 | 140 | 130 | 120 | 110 | 100 | 90 }
}

Arguments

database_name

Nom de la base de données à modifier.

Notes

Cette option n’est pas disponible dans une base de données autonome.

CURRENT
S’applique à : SQL Server 2012 (11.x) et versions ultérieures.

Indique que la base de données actuelle en cours d'utilisation doit être modifiée.

MODIFY NAME = new_database_name

Renomme la base de données avec le nom spécifié nouveau_nom_base_de_données.

COLLATE collation_name

Spécifie le classement par défaut de la base de données. collation_name peut être un nom de classement Windows ou SQL. S'il n'est pas spécifié, le classement par défaut de l'instance de SQL Server sera appliqué à la base de données.

Notes

Le classement ne peut pas être modifié une fois la base de données créée sur Azure SQL Database.

Lors de la création de bases de données autrement qu'avec le classement par défaut, les données dans la base de données respectent toujours le classement spécifié. Pour SQL Server, quand vous créez une base de données autonome, les informations de catalogue interne sont conservées à l'aide du classement par défaut SQL Server, Latin1_General_100_CI_AS_WS_KS_SC.

Pour plus d’informations sur les noms de classements Windows et SQL, voir COLLATE.

<delayed_durability_option> ::=

S’applique à : SQL Server 2014 (12.x) et versions ultérieures.

Pour plus d’informations, consultez les options ALTER DATABASE SET et la durabilité des transactions de contrôle.

<file_and_filegroup_options>::=

Pour plus d’informations, voir Options de fichiers et de groupes de fichiers d’ALTER DATABASE.

Notes

Pour supprimer une base de données, utilisez DROP DATABASE.

Pour diminuer la taille d'une base de données, utilisez DBCC SHRINKDATABASE.

L’instruction ALTER DATABASE doit s’exécuter en mode de validation automatique (mode de gestion des transactions par défaut) et n’est pas autorisée dans une transaction explicite ou implicite.

L'état d'un fichier de base de données (par exemple, en ligne ou hors connexion) est préservé indépendamment de l'état de la base de données. Pour plus d’informations, consultez États des fichiers. L'état des fichiers dans un groupe de fichiers détermine la disponibilité de tout le groupe de fichiers. Pour qu'un groupe de fichiers soit disponible, tous ses fichiers doivent être en ligne. Si un groupe de fichiers est hors connexion, toute tentative d’accès au groupe de fichiers par une instruction SQL échoue avec une erreur. Lorsque vous créez des plans de requête pour les instructions SELECT, l'optimiseur de requête évite les index non cluster et les vues indexées qui résident dans les groupes de fichiers hors connexion. Cela permet aux instructions de s'exécuter correctement. Cependant, si le groupe de fichiers hors connexion contient le segment ou l'index cluster d'une table cible, les instructions SELECT échouent. En outre, toute INSERTinstruction ou toute UPDATEDELETEinstruction qui modifie une table avec n’importe quel index dans un groupe de fichiers hors connexion échoue.

Lorsqu’une base de données est dans l’état RESTOREING, la plupart des ALTER DATABASE instructions échouent. La définition des options de mise en miroir de bases de données fait exception. Une base de données peut être dans l’état RESTOREING pendant une opération de restauration active ou lorsqu’une opération de restauration d’une base de données ou d’un fichier journal échoue en raison d’un fichier de sauvegarde endommagé.

Le cache du plan pour l'instance de SQL Server est effacé par la définition de l'une des options suivantes :

• COLLATE
• MODIFY FILEGROUP DEFAULT
• MODIFY FILEGROUP READ_ONLY
• MODIFY FILEGROUP READ_WRITE
• MODIFY_NAME
• OFFLINE
• ONLINE
• PAGE_VERIFY
• READ_ONLY
• READ_WRITE

Cette opération entraîne la recompilation de tous les plans d'exécution ultérieurs et peut entraîner une baisse temporaire et brutale des performances des requêtes. Pour chaque mémoire cache effacée du cache du plan, le journal des erreurs de SQL Server contient le message d'information suivant : SQL Server has encountered %d occurrence(s) of cachestore flush for the '%s' cachestore (part of plan cache) due to some database maintenance or reconfigure operations. Ce message est enregistré toutes les cinq minutes si le cache est vidé au cours de cet intervalle de temps.

Le cache de plan est également vidé dans les scénarios suivants :

• L'option de base de données AUTO_CLOSE est activée (ON). Lorsqu'aucune connexion utilisateur ne fait référence ou n'utilise la base de données, la tâche en arrière-plan essaie de fermer et d'arrêter la base de données automatiquement.
• Vous exécutez plusieurs requêtes sur une base de données dont les options par défaut sont activées. Puis, la base de données est supprimée.
• Un instantané de base de données pour une base de données source est supprimé.
• Vous reconstruisez avec succès le journal des transactions d'une base de données.
• Vous restaurez une sauvegarde de base de données.
• Vous détachez une base de données.

Modifier le classement de la base de données

Avant d'appliquer un autre classement à une base de données, veillez à ce que les conditions suivantes soient remplies :

• Vous êtes actuellement le seul à utiliser la base de données.
• Aucun objet lié à un schéma ne dépend du classement de la base de données.

Si les objets suivants, qui dépendent du classement de base de données, existent dans la base de données, l’instruction ALTER DATABASE database_name COLLATE échoue. SQL Server retourne un message d’erreur pour chaque objet bloquant l’action ALTER :

• Fonctions et vues définies par l’utilisateur créées avec SCHEMABINDING
• Colonnes calculées
• Contraintes CHECK
• Fonctions table qui renvoient des tables comportant des colonnes de caractères avec des classements hérités du classement par défaut de la base de données

Les informations de dépendance des entités non liées au schéma sont mises à jour automatiquement lorsque le classement de la base de données est modifié.

La modification du classement de la base de données ne crée pas de doublons parmi les noms système des objets de la base de données. Si les noms en double résultent du classement modifié, les espaces de noms suivants peuvent entraîner l’échec d’un changement de classement de base de données :

• Noms d’objets tels qu’une procédure, une table, un déclencheur ou une vue
• Noms de schémas
• Principaux, tels qu’un groupe, un rôle ou un utilisateur
• Noms de types scalaires, comme les types système ou définis par l’utilisateur
• Noms de catalogues de texte intégral
• Noms de colonnes ou de paramètres dans un objet
• Noms d’index dans une table

Les noms en double résultant du nouveau classement provoquent l’échec de l’action de modification et SQL Server retourne un message d’erreur spécifiant l’espace de noms où le doublon a été trouvé.

Afficher les informations de base de données

Vous pouvez utiliser les affichages catalogue, les fonctions système et les procédures stockées du système pour retourner des informations sur les bases de données, les fichiers et les groupes de fichiers.

Autorisations

Requiert l'autorisation ALTER sur la base de données.

Exemples

R. Changer le nom d’une base de données

L'exemple suivant modifie le nom de la base de données AdventureWorks2022 en Northwind.

SQL

USE master;
GO
ALTER DATABASE AdventureWorks2022
Modify Name = Northwind ;
GO

B. Modifier le classement d'une base de données

L’exemple suivant crée une base de données nommée testdb qui utilise le classement SQL_Latin1_General_CP1_CI_AS, puis modifie le classement de la base de données testdb en COLLATE French_CI_AI.

S’applique à : SQL Server 2008 (10.0.x) et versions ultérieures.

SQL

USE master;
GO

CREATE DATABASE testdb
COLLATE SQL_Latin1_General_CP1_CI_AS ;
GO

ALTER DATABASE testDB
COLLATE French_CI_AI ;
GO

Contenu connexe

• CREATE DATABASE
• DATABASEPROPERTYEX
• DROP DATABASE
• SET TRANSACTION ISOLATION LEVEL
• EVENTDATA
• sp_configure
• sp_spaceused
• sys.databases
• sys.database_files
• sys.data_spaces
• sys.filegroups
• sys.master_files
• Bases de données système