ALTER DATABASE (Transact-SQL)

Ändern bestimmter Konfigurationsoptionen einer Datenbank

Dieser Artikel stellt die Syntax, Argumente, Anweisungen, Berechtigungen und Beispiele für das SQL-Produkt Ihrer Wahl bereit.

Weitere Informationen zu Syntaxkonventionen finden Sie unter Transact-SQL-Syntaxkonventionen.

Auswählen eines Produkts

Wählen Sie in der folgenden Zeile den Namen des Produkts aus, an dem Sie interessiert sind. Dann werden nur Informationen zu diesem Produkt angezeigt.

* SQL Server *  

SQL-Datenbank

SQL Managed Instance

Azure Synapse
Analytics

Analytics Platform
System (PDW)

Microsoft Fabric

 

Übersicht: SQL Server

In SQL Server ändert diese Anweisung eine Datenbank bzw. die zu dieser Datenbank gehörenden Dateien und Dateigruppen. „ALTER DATABASE“ fügt einer Datenbank Dateien und Dateigruppen hinzu oder entfernt diese, ändert die Attribute einer Datenbank oder ihrer Dateien und Dateigruppen, ändert die Datenbanksortierung und legt Datenbankoptionen fest. Datenbankmomentaufnahmen können nicht geändert werden. Verwenden Sie zum Ändern von Datenbankoptionen für die Replikation sp_replicationdboption.

Aufgrund ihrer Länge wird die ALTER DATABASE-Syntax in mehrere Artikel aufgeteilt.

Artikel	Beschreibung
ALTER DATABASE	Der aktuelle Artikel behandelt die Syntax und weitere Informationen zum Ändern des Namens und der Sortierung einer Datenbank.
ALTER DATABASE-Optionen für Dateien und Dateigruppen	Stellt die Syntax und weitere Informationen zum Hinzufügen und Entfernen von Dateien und Dateigruppen in einer Datenbank sowie zum Ändern der Datei- und Dateigruppenattribute bereit.
ALTER DATABASE SET-Optionen	Stellt die Syntax und weitere Informationen zum Ändern der Datenbankattribute mithilfe der SET-Optionen von ALTER DATABASE bereit.
ALTER DATABASE-Datenbankspiegelung	Stellt die Syntax und weitere Informationen für die SET-Optionen von ALTER DATABASE bereit, die sich auf die Datenbankspiegelung beziehen.
ALTER DATABASE SET HADR	Stellt die Syntax und weitere Informationen zu den ALTER DATABASE-Optionen für Always On-Verfügbarkeitsgruppen zum Konfigurieren einer sekundären Datenbank auf einem sekundären Replikat einer Always On-Verfügbarkeitsgruppe bereit.
ALTER DATABASE-Kompatibilitätsstufe	Stellt die Syntax und weitere Informationen für die SET-Optionen von ALTER DATABASE bereit, die sich auf die Datenbank-Kompatibilitätsgrade beziehen.
ALTER DATABASE SCOPED CONFIGURATION	Stellt die Syntax für datenbankweit gültige Konfigurationen bereit, die für einzelne Einstellungen auf Datenbankebene wie Abfrageoptimierung und Abfrageausführung verwendet werden.

Syntax

-- SQL Server Syntax
ALTER DATABASE { database_name | CURRENT }
{
    MODIFY NAME = new_database_name
  | COLLATE collation_name
  | <file_and_filegroup_options>
  | SET <option_spec> [ ,...n ] [ WITH <termination> ]
}
[;]

<file_and_filegroup_options>::=
  <add_or_modify_files>::=
  <filespec>::=
  <add_or_modify_filegroups>::=
  <filegroup_updatability_option>::=

<option_spec>::=
{
  | <auto_option>
  | <change_tracking_option>
  | <cursor_option>
  | <database_mirroring_option>
  | <date_correlation_optimization_option>
  | <db_encryption_option>
  | <db_state_option>
  | <db_update_option>
  | <db_user_access_option>
  | <delayed_durability_option>
  | <external_access_option>
  | <FILESTREAM_options>
  | <HADR_options>
  | <parameterization_option>
  | <query_store_options>
  | <recovery_option>
  | <service_broker_option>
  | <snapshot_option>
  | <sql_option>
  | <termination>
  | <temporal_history_retention>
  | <data_retention_policy>
  | <compatibility_level>
      { 160 | 150 | 140 | 130 | 120 | 110 | 100 | 90 }
}

Argumente

database_name

Der Name der Datenbank, die geändert werden soll.

Hinweis

Diese Option ist in einer enthaltenen Datenbank nicht verfügbar.

CURRENT
Gilt für: SQL Server 2012 (11.x) und höher.

Legt fest, dass die zurzeit verwendete Datenbank geändert werden soll.

MODIFY NAME = new_database_name

Benennt die Datenbank in den angegebenen Namen new_database_name um.

COLLATE collation_name

Gibt die Sortierung für die Datenbank an. collation_name kann entweder der Name einer Windows-Sortierreihenfolge oder ein SQL-Sortierungsname sein. Wenn keine Sortierung angegeben ist, wird der Datenbank die Sortierung der Instanz von SQL Server zugewiesen.

Hinweis

Die Sortierung kann nicht geändert werden, nachdem die Datenbank auf Azure SQL-Datenbank erstellt wurde.

Beim Erstellen von Datenbanken mit einer von der Standardsortierung abweichenden Sortierung folgen die Daten in der Datenbank immer der angegebenen Sortierung. Bei der Erstellung einer eigenständigen Datenbank in SQL Server werden die internen Kataloginformationen mit der SQL Server-Standardsortierung Latin1_General_100_CI_AS_WS_KS_SC verwaltet.

Weitere Informationen zu den Namen von Windows- und SQL-Sortierungen finden Sie unter COLLATE.

<delayed_durability_option> ::=

Gilt für: SQL Server 2014 (12.x) und höher.

Weitere Informationen finden Sie unter ALTER DATABASE SET options and Control Transaction Durability.

<file_and_filegroup_options>::=

Weitere Informationen finden Sie unter ALTER DATABASE-Optionen für Dateien und Dateigruppen.

Bemerkungen

Verwenden Sie DROP DATABASE, um eine Datenbank zu entfernen.

Verwenden Sie DBCC SHRINKDATABASE, um die Größe einer Datenbank zu reduzieren.

Die ALTER DATABASE Anweisung muss im Automatischen Commit-Modus (standardtransaktionsverwaltungsmodus) ausgeführt werden und ist in einer expliziten oder impliziten Transaktion nicht zulässig.

Der Status einer Datenbankdatei (z. B. online oder offline) wird unabhängig vom Status der Datenbank verwaltet. Weitere Informationen finden Sie im Abschnitt Dateistatus. Der Status der Dateien in einer Dateigruppe bestimmt die Verfügbarkeit der gesamten Dateigruppe. Damit eine Dateigruppe verfügbar ist, müssen alle Dateien in der Dateigruppe online sein. Wenn eine Dateigruppe offline ist, tritt bei jedem Versuch, über eine SQL-Anweisung auf die Dateigruppe zuzugreifen, ein Fehler auf. Wenn Sie Abfragepläne für SELECT-Anweisungen erstellen, vermeidet der Abfrageoptimierer nicht gruppierte Indizes und indizierte Sichten, die sich in Offlinedateigruppen befinden. Dadurch wird ein erfolgreiches Ausführen der Anweisungen ermöglicht. Enthält die Offlinedateigruppe jedoch den Heap oder gruppierten Index der Zieltabelle, schlagen die SELECT-Anweisungen fehl. Darüber hinaus schlägt jede INSERT, UPDATEoder Anweisung, DELETE die eine Tabelle mit einem beliebigen Index in einer Offlinedateigruppe ändert, fehl.

Wenn sich eine Datenbank im RESTOREING-Zustand befindet, schlagen die meisten ALTER DATABASE Anweisungen fehl. Eine Ausnahme bildet das Festlegen von Datenbank-Spiegelungsoptionen. Eine Datenbank befindet sich möglicherweise während eines aktiven Wiederherstellungsvorgangs im WIEDERHERSTELLEN-Zustand oder wenn ein Wiederherstellungsvorgang einer Datenbank oder Protokolldatei aufgrund einer beschädigten Sicherungsdatei fehlschlägt.

Der Plancache für die Instanz von SQL Server wird gelöscht, indem eine der folgenden Optionen festgelegt wird.

• COLLATE
• MODIFY FILEGROUP DEFAULT
• MODIFY FILEGROUP READ_ONLY
• MODIFY FILEGROUP READ_WRITE
• MODIFY_NAME
• OFFLINE
• ONLINE
• PAGE_VERIFY
• READ_ONLY
• READ_WRITE

Durch das Löschen des Plancaches wird eine Neukompilierung aller nachfolgenden Ausführungspläne verursacht, und möglicherweise entsteht plötzlich eine temporäre Verringerung der Abfrageleistung. Das SQL Server-Fehlerprotokoll enthält für jeden geleerten Cachespeicher im Plancache folgende informative Meldung: SQL Server has encountered %d occurrence(s) of cachestore flush for the '%s' cachestore (part of plan cache) due to some database maintenance or reconfigure operations. Diese Meldung wird alle fünf Minuten protokolliert, solange der Cache innerhalb dieses Zeitintervalls geleert wird.

Der Plancache wird auch in den folgenden Szenarien geleert:

• Die Datenbankoption AUTO_CLOSE ist für eine Datenbank auf ON festgelegt. Wenn die Datenbank von keiner Benutzerverbindung verwendet wird bzw. keine Benutzerverbindung darauf verweist, versucht der Hintergrundtask, die Datenbank automatisch zu schließen und herunterzufahren.
• Sie führen mehrere Abfragen für eine Datenbank aus, die über Standardoptionen verfügt. Anschließend wird die Datenbank gelöscht.
• Eine Datenbank-Momentaufnahme für eine Quelldatenbank wird gelöscht.
• Sie erstellen das Transaktionsprotokoll für eine Datenbank erfolgreich neu.
• Sie stellen eine Datenbanksicherung wieder her.
• Sie trennen eine Datenbank.

Ändern der Datenbanksortierung

Bevor Sie auf eine Datenbank eine andere Sortierung anwenden, stellen Sie sicher, dass die folgenden Bedingungen erfüllt sind:

• Die Datenbank wird derzeit nur von Ihnen verwendet.
• Von der Sortierung der Datenbank hängt kein schemagebundenes Objekt ab.

Wenn die folgenden Objekte, die von der Datenbanksortierung abhängen, in der Datenbank vorhanden sind, schlägt die ALTER DATABASE database_name COLLATE Anweisung fehl. SQL Server gibt eine Fehlermeldung für jedes Objekt zurück, das die ALTER Aktion blockiert:

• Benutzerdefinierte Funktionen und Sichten, die mit SCHEMABINDING erstellt wurden
• Berechnete Spalten
• CHECK-Einschränkungen
• Tabellenwertfunktionen, die Tabellen mit Zeichenspalten zurückgeben, deren Sortierungen von der Standardsortierung der Datenbank geerbt wurden

Abhängigkeitsinformationen für nicht schemagebundene Entitäten werden automatisch aktualisiert, wenn die Sortierung der Datenbank geändert wird.

Durch das Ändern der Sortierung der Datenbank werden keine Duplikate von Systemnamen für die Datenbankobjekte erstellt. Wenn doppelte Namen aus der geänderten Sortierung resultieren, können die folgenden Namespaces den Fehler einer Datenbanksortierungsänderung verursachen:

• Objektnamen wie z.B. der Name einer Prozedur, Tabelle, Sicht oder eines Triggers
• Schemanamen
• Prinzipale wie z.B. eine Gruppe, Rolle oder ein Benutzer
• Namen skalarer Typen wie z.B. der Name eines vom System oder Benutzer definierten Typs
• Namen von Volltextkatalogen
• Spalten- oder Parameternamen in einem Objekt
• Indexnamen in einer Tabelle

Doppelte Namen, die sich aus der neuen Sortierung ergeben, führen dazu, dass die Änderungsaktion fehlschlägt, und SQL Server gibt eine Fehlermeldung zurück, die den Namespace angibt, in dem das Duplikat gefunden wurde.

Anzeigen von Datenbankinformationen

Sie können Katalogsichten, Systemfunktionen und gespeicherte Systemprozeduren verwenden, um Informationen zu Datenbanken, Dateien und Dateigruppen zurückzugeben.

Berechtigungen

Erfordert die ALTER-Berechtigung für die Datenbank.

Beispiele

A. Ändern des Namens einer Datenbank

Im folgenden Beispiel wird der Name der Datenbank AdventureWorks2022 in Northwind geändert.

USE master;
GO
ALTER DATABASE AdventureWorks2022
Modify Name = Northwind ;
GO

B. Ändern der Sortierung einer Datenbank

Im folgenden Beispiel wird die Datenbank testdb mit der SQL_Latin1_General_CP1_CI_AS-Sortierung erstellt. Danach wird die Sortierung der Datenbank testdb in COLLATE French_CI_AI geändert.

Gilt für: SQL Server 2008 (10.0.x) und höher.

USE master;
GO

CREATE DATABASE testdb
COLLATE SQL_Latin1_General_CP1_CI_AS ;
GO

ALTER DATABASE testDB
COLLATE French_CI_AI ;
GO

Zugehöriger Inhalt

• CREATE DATABASE
• DATABASEPROPERTYEX
• DROP DATABASE
• SET TRANSACTION ISOLATION LEVEL
• EVENTDATA
• sp_configure
• sp_spaceused
• sys.databases
• sys.database_files
• sys.data_spaces
• sys.filegroups
• sys.master_files
• Systemdatenbanken