sp_detach_db (Transact-SQL)

  • Article

S’applique à :SQL Server

Détache d'une instance de serveur une base de données qui n'est pas en cours d'utilisation, et exécute accessoirement UPDATE STATISTICS sur toutes les tables avant de détacher la base de données.

Important

Pour détacher une base de données répliquée, celle-ci ne doit pas être publiée. Pour plus d'informations, consultez la section « Notes », plus loin dans cette rubrique.

Conventions de la syntaxe Transact-SQL

Syntaxe

  
sp_detach_db [ @dbname= ] 'database_name'   
    [ , [ @skipchecks= ] 'skipchecks' ]   
    [ , [ @keepfulltextindexfile = ] 'KeepFulltextIndexFile' ]

Arguments

[ @dbname = ] 'database_name' Nom de la base de données à détacher. database_name est une valeur sysname , avec la valeur par défaut NULL.

[ @skipchecks = ] 'skipchecks' Spécifie s’il faut ignorer ou exécuter UPDATE STATISTIC. skipchecks est une valeur nvarchar(10), avec une valeur par défaut NULL. Pour ignorer UPDATE STATISTICS, spécifiez true. Pour exécuter explicitement UPDATE STATISTICS, spécifiez false.

Par défaut, UPDATE STATISTICS est exécuté pour mettre à jour les informations relatives aux données des tables et des index. L'exécution de UPDATE STATISTICS est utile pour les bases de données qui doivent être placées sur des supports en lecture seule.

[ @keepfulltextindexfile = ] 'KeepFulltextIndexFile' Spécifie que le fichier d’index de texte intégral associé à la base de données en cours de détachement ne sera pas supprimé pendant l’opération de détachement de base de données. KeepFulltextIndexFile est une valeur nvarchar(10) avec la valeur par défaut true. Si KeepFulltextIndexFile a la valeur false, tous les fichiers d’index de texte intégral associés à la base de données et les métadonnées de l’index de texte intégral sont supprimés, sauf si la base de données est en lecture seule. Si la valeur est NULL ou true, les métadonnées associées au texte intégral sont conservées.

Important

Le paramètre @keepfulltextindexfile sera supprimé dans une version ultérieure de SQL Server. Évitez d'utiliser ce paramètre dans de nouveaux travaux de développement, et modifiez dès que possible les applications qui utilisent actuellement ce paramètre.

Codet de retour

0 (réussite) ou 1 (échec)

Jeux de résultats

None

Remarques

Lorsqu'une base de données est détachée, toutes ses métadonnées sont supprimées. Si la base de données était la base de données par défaut de tous les comptes de connexion, master devient leur base de données par défaut.

Notes

Pour plus d’informations sur l’affichage de la base de données par défaut de tous les comptes de connexion, consultez sp_helplogins (Transact-SQL). Si vous disposez des autorisations requises, vous pouvez utiliser ALTER LOGIN pour affecter une nouvelle base de données par défaut à une connexion.

Restrictions

Une base de données ne peut pas être détachée si l’une des conditions suivantes est vraie :

  • La base de données est en cours d'utilisation. Pour plus d'informations, consultez « Obtention d'un accès exclusif », plus loin dans cette rubrique.

  • Si la base de données est répliquée, elle est publiée.

    Avant de pouvoir détacher la base de données, vous devez désactiver la publication en exécutant sp_replicationdboption.

    Notes

    Si vous ne pouvez pas utiliser sp_replicationdboption, vous pouvez supprimer la réplication en exécutant sp_removedbreplication.

  • Un instantané existe sur la base de données.

    Avant de pouvoir détacher la base de données, vous devez supprimer tous ses instantanés. Pour plus d’informations, consultez Supprimer un instantané de base de données (Transact-SQL).

    Remarque

    Un instantané de base de données ne peut pas être détaché ni attaché.

  • La base de données fait l'objet d'une mise en miroir.

    La base de données ne peut pas être détachée tant que la session de mise en miroir de la base de données n'a pas été interrompue. Pour plus d’informations, consultez Suppression de la mise en miroir des bases de données (SQL Server).

  • La base de données est suspecte.

    Vous devez placer une base de données suspecte en mode urgence avant de pouvoir la détacher. Pour plus d’informations sur la façon de mettre une base de données en mode d’urgence, consultez ALTER DATABASE (Transact-SQL).

  • La base de données est une base de données système.

Obtention d'un accès exclusif

Un accès exclusif à la base de données est nécessaire pour procéder au détachement de la base de données. Si la base de données que vous voulez détacher est en cours d'utilisation, avant de procéder à son détachement, passez-la en mode SINGLE_USER pour obtenir un accès exclusif.

Avant d'affecter la valeur SINGLE_USER à la base de données, vérifiez que l'option AUTO_UPDATE_STATISTICS_ASYNC a la valeur OFF. Si la valeur de cette option est ON, le thread d'arrière-plan utilisé pour mettre à jour les statistiques se connecte à la base de données et vous ne pourrez pas accéder à celle-ci en mode mono-utilisateur. Pour plus d’informations, consultez Définir une base de données en mode utilisateur unique.

Par exemple, l’instruction suivante ALTER DATABASE obtient un accès exclusif à la base de données AdventureWorks2022 une fois que tous les utilisateurs actuels se déconnectent de la base de données.

USE master;  
ALTER DATABASE AdventureWorks2022  
SET SINGLE_USER;  
GO

Remarque

Pour forcer les utilisateurs actuels à sortir immédiatement de la base de données ou dans un certain nombre de secondes, utilisez également l’option ROLLBACK : ALTER DATABASE database_name SET SINGLE_USER WITH ROLLBACK rollback_option. Pour plus d’informations, consultez ALTER DATABASE (Transact-SQL).

Rattachement d'une base de données

Les fichiers détachés restent et peuvent être rattachés à l'aide de CREATE DATABASE (avec l'option FOR ATTACH ou FOR ATTACH_REBUILD_LOG). Vous pouvez les déplacer sur un autre serveur et les y attacher.

Autorisations

Nécessite l’appartenance au rôle serveur fixe sysadmin ou l’appartenance au rôle db_owner de la base de données.

Exemples

L’exemple suivant détache la base de données AdventureWorks2022 avec des cases d’erreur définies sur true.

EXEC sp_detach_db 'AdventureWorks2022', 'true';

L’exemple suivant détache la base de données AdventureWorks2022 et conserve les fichiers d’index de texte intégral et les métadonnées de l’index de texte intégral. Cette commande exécute UPDATE STATISTICS, ce qui correspond au comportement par défaut.

exec sp_detach_db @dbname='AdventureWorks2022'  
    , @keepfulltextindexfile='true';

Voir aussi

ALTER DATABASE (Transact-SQL)
Attacher et détacher une base de données (SQL Server)
CREATE DATABASE (SQL Server Transact-SQL)
Détacher une base de données