sp_attach_single_file_db (Transact-SQL)

Aktualisiert: 05. Dezember 2005

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:

Dieses Feature wird in einer zukünftigen Version von Microsoft SQL Server entfernt. Verwenden Sie dieses Feature 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 physikalischen 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.

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 physikalische 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).

  In Microsoft SQL Server 2005-Datenbankmodul werden alle Volltextdateien, die zur angefügten Datenbank gehören, mit der Datenbank angefügt. Zum Angeben eines neuen Pfades für den Volltextkatalog können Sie die Katalogdatei angeben, indem Sie einen Verzeichnisnamen ohne Dateinamen bereitstellen. Weitere Informationen finden Sie unter Anfügen und Trennen von Volltextkatalogen.

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

Siehe auch

Verweis

sp_detach_db (Transact-SQL)
sp_helpfile (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)

Andere Ressourcen

Trennen und Anfügen von Datenbanken
Anfügen und Trennen von Volltextkatalogen
Sichern von Daten- und Protokolldateien

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf