RECONFIGURE (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL Managed Instance

Aktualisiert den derzeit konfigurierten Wert (die config_value-Spalte im sp_configure-Resultset) einer Konfigurationsoption, die mit der gespeicherten Systemprozedur sp_configure geändert wurde. Da einige Konfigurationsoptionen einen Serverstopp und -neustart erfordern, um den derzeit wirksamen Wert zu aktualisieren, aktualisiert RECONFIGURE nicht immer den derzeit wirksamen Wert (die run_value-Spalte im sp_configure-Resultset) mit einem geänderten Konfigurationswert.

Transact-SQL-Syntaxkonventionen

Syntax

RECONFIGURE [ WITH OVERRIDE ]

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

RECONFIGURE
Gibt an, dass der derzeit wirksame Wert aktualisiert werden soll, wenn die Konfigurationseinstellung keinen Serverstopp und Neustart erfordert. RECONFIGURE überprüft darüber hinaus die neuen Konfigurationswerte entweder auf ungültige Werte (z.B. einen Sortierreihenfolgenwert, der nicht in syscharsets vorhanden ist) oder auf nicht empfohlene Werte. Bei den Konfigurationsoptionen, die keinen Serverstopp und -neustart erfordern, sollten der derzeit wirksame Wert und der derzeit konfigurierte Wert der Konfigurationsoption nach Angabe von RECONFIGURE identisch sein.

WITH OVERRIDE
Deaktiviert die Überprüfung des Konfigurationswerts (auf ungültige oder nicht empfohlene Werte) für die erweiterte Konfigurationsoption recovery interval.

Fast alle Konfigurationsoptionen können mithilfe der Option WITH OVERRIDE neu konfiguriert werden. Einige schwerwiegende Fehler werden jedoch weiterhin verhindert. So kann beispielsweise der Wert der Konfigurationsoption min server memory nicht mit einem höheren Wert konfiguriert werden als der in der Konfigurationsoption max server memory angegebene Wert.

Hinweise

sp_configure akzeptiert keine neuen Werte für eine Konfigurationsoption, die für diese Konfigurationsoption außerhalb der dokumentierten gültigen Bereiche liegen.

RECONFIGURE ist in einer expliziten oder impliziten Transaktion nicht zulässig. Wenn Sie mehrere Optionen gleichzeitig neu konfigurieren und bei einem der Neukonfigurierungsvorgänge ein Fehler auftritt, wird keine der Neukonfigurierungen wirksam.

Beachten Sie beim Neukonfigurieren des Resource Governors die Option RECONFIGURE von ALTER RESOURCE GOVERNOR (Transact-SQL).

Berechtigungen

RECONFIGURE-Berechtigungen erhalten standardmäßig ALTER SETTINGS-Berechtigte. Diese Berechtigung erhalten implizit die festen Serverrollen sysadmin und serveradmin.

Beispiele

Im folgenden Beispiel wird der obere Grenzwert für die Konfigurationsoption recovery interval auf 75 Minuten festgelegt und mithilfe von RECONFIGURE WITH OVERRIDE installiert. Wiederherstellungsintervalle über 60 Minuten werden nicht empfohlen und sind standardmäßig nicht zulässig. Da jedoch die Option WITH OVERRIDE angegeben wurde, wird von SQL Server nicht überprüft, ob es sich beim angegebenen Wert (75) um einen gültigen Wert für die Konfigurationsoption recovery interval handelt.

EXEC sp_configure 'recovery interval', 75    
RECONFIGURE WITH OVERRIDE;    
GO

Weitere Informationen

Serverkonfigurationsoptionen (SQL Server)
sp_configure (Transact-SQL)