sp_detach_db (Transact-SQL)

Trennt eine zurzeit nicht verwendete Datenbank von einer Serverinstanz und führt optional vor dem Trennvorgang für alle Tabellen UPDATE STATISTICS aus.

Wichtig
Eine replizierte Datenbank kann nur getrennt werden, wenn sie nicht veröffentlicht ist. Weitere Informationen finden Sie im Abschnitt "Hinweise" weiter unten in diesem Thema.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

• [ @dbname = ] 'database_name'
  Der Name der Datenbank, die getrennt werden soll. database_name ist ein sysname-Wert. Der Standardwert ist NULL.

• [ @skipchecks = ] 'skipchecks'
  Gibt an, ob UPDATE STATISTIC übersprungen oder ausgeführt werden soll. skipchecks ist ein nvarchar(10)-Wert. Der Standardwert ist 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-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 Volltextindex-Datei, die der zu trennenden Datenbank zugeordnet ist, während des Trennvorgangs der Datenbank nicht gelöscht wird. KeepFulltextIndexFile ist ein nvarchar(10)-Wert 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 beim Entwickeln neuer Anwendungen nicht, und planen Sie so bald wie möglich das Ändern von Anwendungen, in denen er zurzeit verwendet wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

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

Eine Datenbank kann in folgenden Fällen nicht getrennt werden:

• Die Datenbank ist zurzeit in Verwendung. Weitere Informationen finden Sie im Abschnitt "Erhalten exklusiven Zugriffs" weiter unten in diesem Thema.

• Wenn die Datenbank repliziert ist, wird sie veröffentlicht.

  Bevor Sie die Datenbank trennen können, müssen Sie die Veröffentlichung deaktivieren, indem Sie sp_replicationdboption ausführen.

  Hinweis
  Wenn Sie sp_replicationdboption nicht verwenden können, können Sie die Replikation durch Ausführen von sp_removedbreplication entfernen.

• Eine Datenbankmomentaufnahme ist in der Datenbank vorhanden.

  Bevor Sie die Datenbank trennen können, müssen Sie alle Momentaufnahmen löschen. Weitere Informationen finden Sie unter Löschen einer Datenbankmomentaufnahme (Transact-SQL).

  Hinweis
  Eine Datenbankmomentaufnahme kann nicht getrennt oder angefügt werden.

• Die Datenbank ist gespiegelt.

  Die Datenbank kann nur getrennt werden, wenn die Datenbank-Spiegelungssitzung beendet wird. Weitere Informationen finden Sie unter Entfernen der Datenbankspiegelung (SQL Server).

• Die Datenbank ist fehlerverdächtig.

  In SQL Server 2005 und neueren Versionen müssen Sie für eine fehlerverdächtige Datenbank den Notfallmodus aktivieren, bevor Sie die Datenbank trennen können. Weitere Informationen zum Aktivieren des Notfallmodus für eine Datenbank finden Sie unter ALTER DATABASE (Transact-SQL).

• Die Datenbank ist eine Systemdatenbank.

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 AdventureWorks2012-Datenbank, nachdem alle aktuellen Benutzer von der Datenbank getrennt wurden.

USE master;
ALTER DATABASE AdventureWorks2012
SET SINGLE_USER;
GO

Hinweis
Wenn Sie die Trennung von aktuellen Benutzern 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

Die getrennten Dateien bleiben gespeichert und können mithilfe von CREATE DATABASE (mit der FOR ATTACH- oder FOR ATTACH_REBUILD_LOG-Option) erneut angefügt werden. Die Dateien können auf einen anderen Server verschoben und dort angefügt werden.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin.

Beispiele

Im folgenden Beispiel wird die AdventureWorks2012-Datenbank getrennt, wobei skipchecks auf TRUE festgelegt ist.

EXEC sp_detach_db 'AdventureWorks2012', 'true';

Im folgenden Beispiel wird die AdventureWorks2012-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='AdventureWorks2012'
    , @keepfulltextindexfile='true';

Siehe auch

Verweis

ALTER DATABASE (Transact-SQL)

CREATE DATABASE (Transact-SQL)

Konzepte

Anfügen und Trennen von Datenbanken (SQL Server)

Trennen einer Datenbank