Artikel
09/24/2010

sp_attach_single_file_db (Transact-SQL)

Fügt eine Datenbank mit nur einer Datendatei an den aktuellen Server an. sp_attach_single_file_db kann nicht mit mehreren Datendateien verwendet werden.

Wichtig
Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird. Es empfiehlt sich, stattdessen CREATE DATABASE database_name FOR ATTACH zu verwenden. Weitere Informationen finden Sie unter CREATE DATABASE (Transact-SQL). Verwenden Sie diese Prozedur nicht für eine replizierte Datenbank.

Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird. Es empfiehlt sich, stattdessen CREATE DATABASE database_name FOR ATTACH zu verwenden. Weitere Informationen finden Sie unter CREATE DATABASE (Transact-SQL). Verwenden Sie diese Prozedur nicht für eine replizierte Datenbank.

Sicherheitshinweis
Das Anfügen oder Wiederherstellen von Datenbanken aus unbekannten oder nicht vertrauenswürdigen Quellen wird nicht empfohlen. Solche Datenbanken können bösartigen Code enthalten, der unbeabsichtigten Transact-SQL-Code ausführen oder Fehler durch Ändern des Schemas oder der physischen Datenbankstruktur erzeugen könnte. Bevor Sie eine Datenbank von einer unbekannten oder nicht vertrauenswürdigen Quelle verwenden, führen Sie DBCC CHECKDB auf der Datenbank auf einem Nichtproduktionsserver aus, und untersuchen Sie auch den Code, z. B. gespeicherte Prozeduren oder anderen benutzerdefinierten Code, in der Datenbank.

Das Anfügen oder Wiederherstellen von Datenbanken aus unbekannten oder nicht vertrauenswürdigen Quellen wird nicht empfohlen. Solche Datenbanken können bösartigen Code enthalten, der unbeabsichtigten Transact-SQL-Code ausführen oder Fehler durch Ändern des Schemas oder der physischen Datenbankstruktur erzeugen könnte. Bevor Sie eine Datenbank von einer unbekannten oder nicht vertrauenswürdigen Quelle verwenden, führen Sie DBCC CHECKDB auf der Datenbank auf einem Nichtproduktionsserver aus, und untersuchen Sie auch den Code, z. B. gespeicherte Prozeduren oder anderen benutzerdefinierten Code, in der Datenbank.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @dbname= ] 'dbname'
Der Name der Datenbank, die an den Server angefügt werden soll. Der Name muss eindeutig sein. dbname ist vom Datentyp sysname und hat den Standardwert NULL.
[ @physname= ] 'physical_name'
Der physische Name der Datenbankdatei (einschließlich des Pfades). physical_name ist vom Datentyp nvarchar(260) und hat den Standardwert NULL.

Hinweis

Dieses Argument ist dem FILENAME-Parameter der CREATE DATABASE-Anweisung zugeordnet. Weitere Informationen finden Sie unter CREATE DATABASE (Transact-SQL).

Wenn Sie eine SQL Server 2005-Datenbank mit Volltextkatalogdateien an eine SQL Server 2008-Serverinstanz anfügen, werden die Katalogdateien von ihrem vorherigen Speicherort aus zusammen mit den anderen Datenbankdateien angefügt. Dies entspricht der Vorgehensweise für SQL Server 2005. Weitere Informationen finden Sie unter Aktualisieren der Volltextsuche.

Hinweis
Dieses Argument ist dem FILENAME-Parameter der CREATE DATABASE-Anweisung zugeordnet. Weitere Informationen finden Sie unter CREATE DATABASE (Transact-SQL).

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Hinweise

sp_attach_single_file_db sollte nur für Datenbanken verwendet werden, die zuvor mithilfe eines expliziten sp_detach_db-Vorgangs vom Server getrennt wurden, oder für kopierte Datenbanken.

sp_attach_single_file_db kann nur für Datenbanken mit einer einzelnen Protokolldatei verwendet werden. Wenn sp_attach_single_file_db die Datenbank an den Server anfügt, wird eine neue Protokolldatei erstellt. Wenn die Datenbank schreibgeschützt ist, wird die Protokolldatei an ihrem bisherigen Speicherort erstellt.

Hinweis
Ein Datenbanksnapshot kann nicht getrennt oder angefügt werden.

Verwenden Sie diese Prozedur nicht für eine replizierte Datenbank.

Berechtigungen

Informationen zum Behandeln von Berechtigungen beim Anfügen von Datenbanken finden Sie unter CREATE DATABASE (Transact-SQL).

Beispiele

Im folgenden Beispiel wird AdventureWorks getrennt und eine Datei aus AdventureWorks an den aktuellen Server angefügt.

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\MSSQL10.MSSQLSERVER\MSSQL\Data\AdventureWorks_Data.mdf';