sp_detach_db (Transact-SQL)

Syntax

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

Argumente

• [ @dbname = ] 'database_name'
  Der Name der zu trennenden Datenbank. database_name ist vom Datentyp sysname und hat den Standardwert NULL.

• [ @skipchecks = ] 'skipchecks'
  Gibt an, ob UPDATE STATISTIC ausgelassen oder ausgeführt werden soll. skipchecks ist vom Datentyp nvarchar(10) und hat den Standardwert NULL. Geben Sie true an, um UPDATE STATISTICS auszulassen. Geben Sie false an, um UPDATE STATISTICS explizit auszuführen.

  UPDATE STATISTICS wird standardmäßig ausgeführt, um Informationen zu den Daten in den Tabellen und Indizes in SQL Server 2005 Database Engine (Datenbankmodul) und neueren Versionen zu aktualisieren. Das Ausführen von UPDATE STATISTICS ist nützlich für Datenbanken, die auf Nur-Lese-Medien verschoben werden sollen.

• [ @keepfulltextindexfile= ] 'KeepFulltextIndexFile'
  Gibt an, dass die Volltext-Indexdatei, die der zu trennenden Datenbank zugeordnet ist, während des Trennvorgangs der Datenbank nicht gelöscht wird. KeepFulltextIndexFile ist vom Datentyp nvarchar(10) und hat den Standardwert true. Wenn KeepFulltextIndexFile den Wert false aufweist, werden alle Volltextindexdateien, die der Datenbank und den Metadaten zugeordnet sind, gelöscht, es sei denn, die Datenbank ist schreibgeschützt. Wenn der Wert NULL oder true lautet, werden volltextbezogene Metadaten beibehalten.

  Wichtig
  Der @keepfulltextindexfile-Parameter wird in einer künftigen Version von SQL Server entfernt. Verwenden Sie diesen Parameter nicht für Neuentwicklungen, und ändern Sie Anwendungen baldmöglichst, in denen dieser Parameter derzeit verwendet wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keins

Hinweise

Wenn eine Datenbank getrennt wird, werden alle Metadaten darin gelöscht. Falls es sich bei der Datenbank um die Standarddatenbank von Anmeldekonten gehandelt hat, wird master als Standarddatenbank für diese Anmeldekonten festgelegt.

Hinweis
Informationen zum Anzeigen der Standarddatenbank aller Anmeldekonten finden Sie unter sp_helplogins (Transact-SQL). Sofern Sie über die erforderlichen Berechtigungen verfügen, können Sie einer Anmeldung mithilfe der ALTER LOGIN-Anweisung eine neue Standarddatenbank zuweisen.

Einschränkungen

Erhalten exklusiven Zugriffs

Das Trennen einer Datenbank erfordert den exklusiven Zugriff auf die Datenbank. Wenn die zu trennende Datenbank gerade verwendet wird, müssen Sie vor dem Trennen für die Datenbank den SINGLE_USER-Modus festlegen, um exklusiven Zugriff zu erhalten.

Mit der folgenden ALTER DATABASE-Anweisung erhalten Sie beispielsweise exklusiven Zugriff auf die AdventureWorks-Datenbank, nachdem alle aktuellen Benutzer von der Datenbank getrennt wurden.

USE master;
ALTER DATABASE AdventureWorks
SET SINGLE_USER;
GO

Hinweis
Wenn Sie die Trennung der aktuellen Benutzer sofort oder innerhalb einer angegebenen Anzahl von Sekunden erzwingen möchten, verwenden Sie auch die Option ROLLBACK: ALTER DATABASE database_name SET SINGLE_USER WITH ROLLBACK rollback_option. Weitere Informationen finden Sie unter ALTER DATABASE (Transact-SQL).

Erneutes Anfügen einer Datenbank

Berechtigungen

Erfordert die Mitgliedschaft in der festen Datenbankrolle db_owner.

Beispiele

Im folgenden Beispiel wird die AdventureWorks-Datenbank getrennt, wobei skipchecks auf True festgelegt ist.

EXEC sp_detach_db 'AdventureWorks', 'true';

Im folgenden Beispiel wird die AdventureWorks-Datenbank getrennt, wobei die Dateien für den Volltextindex und die Metadaten des Volltextindexes beibehalten werden. Durch diesen Befehl wird UPDATE STATISTICS ausgeführt. Dies entspricht dem Standardverhalten.

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

Siehe auch

Aufgaben

Verweis

Konzepte