sp_attach_single_file_db (Transact-SQL)

Mis à jour : 5 décembre 2005

Associe au serveur actif une base de données qui ne possède qu'un seul fichier de données. La procédure stockée sp_attach_single_file_db ne peut pas être utilisée avec plusieurs fichiers de données.

Important :

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Nous vous recommandons d'utiliser plutôt CREATE DATABASE database_name FOR ATTACH. Pour plus d'informations, consultez CREATE DATABASE (Transact-SQL). N'utilisez pas cette procédure sur une base de données répliquée.

Remarque relative à la sécurité :

Nous vous recommandons de ne pas attacher ou restaurer de bases de données provenant de sources inconnues ou non approuvées. Ces bases de données peuvent contenir du code malveillant susceptible d'exécuter du code Transact-SQL indésirable ou de provoquer des erreurs en modifiant le schéma ou la structure physique des bases de données. Avant d'utiliser une base de données provenant d'une source inconnue ou non approuvée, exécutez DBCC CHECKDB sur la base de données sur un serveur autre qu'un serveur de production et examinez également le code (par exemple les procédures stockées ou tout autre code défini par l'utilisateur) contenu dans la base de données.

Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_attach_single_file_db [ @dbname= ] 'dbname'
        , [ @physname= ] 'physical_name'

Arguments

• [ @dbname= ] 'dbname'
  Nom de la base de données à attacher au serveur. Ce nom doit être unique. dbname est de type sysname, avec NULL comme valeur par défaut.

• [ @physname= ] 'physical_name'
  Nom physique, chemin d'accès compris, du fichier de base de données. physical_name est de type nvarchar(260), avec NULL comme valeur par défaut.

  Remarque :
  Cet argument correspond au paramètre FILENAME de l'instruction CREATE DATABASE. Pour plus d'informations, consultez CREATE DATABASE (Transact-SQL).

  Dans moteur de base de données SQL Server 2005 de Microsoft, tous les fichiers de texte intégral qui font partie de la base de données seront attachés en même temps que celle-ci. Pour spécifier un nouveau chemin d'accès au catalogue de texte intégral, vous pouvez spécifier le fichier du catalogue en fournissant un nom de répertoire sans nom de fichier. Pour plus d'informations, consultez Attacher et détacher des catalogues de texte intégral.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

N'utilisez sp_attach_single_file_db que sur les bases de données préalablement détachées du serveur par une opération sp_detach_db explicite ou sur des bases de données copiées.

sp_attach_single_file_db ne fonctionne que sur les bases de données qui possède un seul fichier journal. Lorsque sp_attach_single_file_db attache la base de données au serveur, elle crée un nouveau fichier journal. Si la base de données est en lecture seule, le journal est créé au même endroit que le précédent.

Remarque :
Il n'est pas possible de détacher ni d'attacher une capture instantanée de base de données.

N'utilisez pas cette procédure sur une base de données répliquée.

Autorisations

Pour plus d'informations sur la gestion des autorisations lors de l'attachement d'une base de données, consultez CREATE DATABASE (Transact-SQL).

Ensembles de résultats

Aucun

Exemples

Dans l'exemple suivant, AdventureWorks est détaché, puis un de ses fichiers est attaché au serveur actif.

USE master;
GO
EXEC sp_detach_db @dbname = 'AdventureWorks';
EXEC sp_attach_single_file_db @dbname = 'AdventureWorks', 
    @physname = N'C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Data\AdventureWorks_Data.mdf';

Voir aussi

Référence

sp_detach_db (Transact-SQL)
sp_helpfile (Transact-SQL)
Procédures stockées système (Transact-SQL)

Autres ressources

Attachement et détachement des bases de données
Attacher et détacher des catalogues de texte intégral
Sécurisation des fichiers de données et des fichiers journaux

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications