sp_configure (Transact-SQL)
Gilt für: SQL Server
Azure SQL Managed Instance
Azure Synapse Analytics
Analytics Platform System (PDW)
Mit dieser Prozedur können globale Konfigurationseinstellungen für den aktuellen Server angezeigt oder geändert werden.
Hinweis
Konfigurationsoptionen auf Datenbankebene finden Sie unter ALTER DATABASE SCOPED CONFIGURATION. Informationen zum Konfigurieren von Soft-NUMA finden Sie unter Soft-NUMA (SQL Server).To configure Soft-NUMA, see Soft-NUMA (SQL Server).
Transact-SQL-Syntaxkonventionen
Syntax
Syntax für SQL Server.
sp_configure
[ [ @configname = ] 'configname' ]
[ , [ @configvalue = ] configvalue ]
[ ; ]
Syntax für Parallel Data Warehouse.
sp_configure
[ ; ]
Argumente
[ @configname = ] 'configname'
Der Name einer Konfigurationsoption. @configname ist varchar(35) mit einem Standardwert von NULL
. Die SQL Server-Datenbank-Engine erkennt jede eindeutige Zeichenfolge, die Teil des Konfigurationsnamens ist. Erfolgt keine Angabe, wird die gesamte Liste der Optionen zurückgegeben.
Informationen zu den verfügbaren Konfigurationsoptionen und deren Einstellungen finden Sie unter Serverkonfigurationsoptionen (SQL Server).
[ @configvalue = ] configvalue
Die neue Konfigurationseinstellung. @configvalue ist int mit einem Standardwert von NULL
.
Der Maximalwert kann je nach Option unterschiedlich sein. Informationen zum Anzeigen des Maximalwerts für jede Option finden Sie in der maximum
Spalte der sys.configurations
Katalogansicht.
Rückgabecodewerte
0
(erfolgreich) oder 1
Fehler.
Resultset
Wenn sie ohne Parameter ausgeführt wird, sp_configure
wird ein Resultset mit fünf Spalten zurückgegeben und die Optionen alphabetisch in aufsteigender Reihenfolge sortiert, wie in der folgenden Tabelle dargestellt.
Die Werte für config_value
und run_value
werden nicht automatisch gleichwertig. Nachdem Sie eine Konfigurationseinstellung mithilfe von sp_configure
"Update" aktualisiert haben, müssen Sie auch den ausgeführten Konfigurationswert mithilfe RECONFIGURE
einer oder einer der RECONFIGURE WITH OVERRIDE
folgenden Konfigurationen aktualisieren. Weitere Informationen finden Sie im Abschnitt Hinweise.
Spaltenname | Datentyp | Beschreibung |
---|---|---|
name |
nvarchar(35) | Der Name der Konfigurationsoption. |
minimum |
int | Der Mindestwert der Konfigurationsoption. |
maximum |
int | Der Höchstwert der Konfigurationsoption. |
config_value |
int | Wert, auf den die Konfigurationsoption mit sp_configure (Wert in sys.configurations.value ) festgelegt wurde.Weitere Informationen zu diesen Optionen finden Sie unter Serverkonfigurationsoptionen (SQL Server) und sys.configurations. |
run_value |
int | Zurzeit wird der Wert der Konfigurationsoption (Wert in sys.configurations.value_in_use ) ausgeführt.Weitere Informationen finden Sie unter "sys.configurations". |
Hinweise
Wird sp_configure
verwendet, um Einstellungen auf Serverebene anzuzeigen oder zu ändern. Verwenden Sie ALTER DATABASE
zum Ändern der Einstellungen auf Datenbankebene . Verwenden Sie die SET
Anweisung, um Einstellungen zu ändern, die sich nur auf die aktuelle Benutzersitzung auswirken.
Einige Serverkonfigurationsoptionen sind nur über ALTER SERVER CONFIGURATION verfügbar.
Big Data-Cluster für SQL Server
Bestimmte Vorgänge, einschließlich der Konfiguration von Servereinstellungen (Instanzebene) oder das manuelle Hinzufügen einer Datenbank zu einer Verfügbarkeitsgruppe, erfordern eine Verbindung mit der SQL Server-Instanz. Vorgänge wie sp_configure
, RESTORE DATABASE
oder ein beliebiger DDL-Befehl in einer Datenbank einer Verfügbarkeitsgruppe erfordern eine Verbindung mit der SQL Server-Instanz. Standardmäßig enthält ein Big Data-Cluster keinen Endpunkt, der eine Verbindung mit der Instanz ermöglicht. Sie müssen diesen Endpunkt manuell verfügbar machen.
Anweisungen finden Sie unter Herstellen einer Verbindung mit Datenbanken auf dem primären Replikat.
Aktualisieren des ausgeführten Konfigurationswerts
Wenn Sie eine neue @configvalue für einen @configname angeben, zeigt das Resultset diesen Wert in der config_value
Spalte an. Dieser Wert unterscheidet sich anfangs vom Wert in der run_value
Spalte, der den aktuell ausgeführten Konfigurationswert anzeigt. Um den ausgeführten Konfigurationswert in der run_value
Spalte zu aktualisieren, muss der Systemadministrator entweder RECONFIGURE
oder RECONFIGURE WITH OVERRIDE
.
Beides RECONFIGURE
und RECONFIGURE WITH OVERRIDE
arbeiten mit jeder Konfigurationsoption. Die grundlegende RECONFIGURE
Anweisung lehnt jedoch jeden Optionswert ab, der sich außerhalb eines angemessenen Bereichs befindet oder zu Konflikten zwischen Optionen führen kann. Generiert beispielsweise einen Fehler, RECONFIGURE
wenn der Wiederherstellungsintervallwert größer als 60 Minuten ist oder der Affinitätsformatwert mit dem Affinitäts-E /A-Maskenwert überlappt. RECONFIGURE WITH OVERRIDE
akzeptiert dagegen jeden Optionswert mit dem richtigen Datentyp und erzwingt die Neukonfiguration mit dem angegebenen Wert.
Achtung
Ein nicht geeigneter Optionswert kann negative Auswirkungen auf die Konfiguration der Serverinstanz haben. Verwenden Sie RECONFIGURE WITH OVERRIDE
vorsichtig.
Die RECONFIGURE
Anweisung aktualisiert einige Optionen dynamisch. Andere Optionen erfordern einen Serverstopp und einen Neustart. Beispielsweise werden die Min Serverspeicher- und max. Serverspeicherspeicheroptionen dynamisch im Datenbank-Engine aktualisiert. Daher können Sie sie ändern, ohne den Server neu zu starten. Die Neukonfiguration des ausgeführten Werts der Füllfaktoroption erfordert dagegen einen Neustart des Datenbank-Engine.
Nachdem Sie eine Konfigurationsoption ausgeführt RECONFIGURE
haben, können Sie sehen, ob die Option dynamisch aktualisiert wurde, indem Sie sie ausführen sp_configure '<configname>'
. Die Werte in den run_value
Und config_value
Spalten sollten für eine dynamisch aktualisierte Option übereinstimmen. Sie können auch überprüfen, welche Optionen dynamisch sind, indem Sie sich die is_dynamic
Spalte der sys.configurations
Katalogansicht ansehen.
Die Änderung wird auch in das SQL Server-Fehlerprotokoll geschrieben.
Wenn eine angegebene @configvalue für eine Option zu hoch ist, gibt die run_value
Spalte die Tatsache wieder, dass die Datenbank-Engine standardmäßig auf dynamischen Speicher festgelegt ist, anstatt eine ungültige Einstellung zu verwenden.
Weitere Informationen finden Sie unter RECONFIGURE.
Erweiterte Optionen
Einige Konfigurationsoptionen, z . B. Affinitätsmaske und Wiederherstellungsintervall, werden als erweiterte Optionen festgelegt. Diese Optionen stehen standardmäßig nicht zum Anzeigen und Ändern zur Verfügung. Um sie verfügbar zu machen, legen Sie die Konfigurationsoption "Erweiterte Optionen anzeigen" auf " fest 1
.
Achtung
Wenn die Option "Erweiterte Optionen anzeigen" auf "Erweitert" festgelegt 1
ist, gilt diese Einstellung für alle Benutzer. Es wird empfohlen, diesen Zustand nur vorübergehend zu verwenden und zurück zu dem Zeitpunkt zu 0
wechseln, zu dem die Aufgabe, die zum Anzeigen der erweiterten Optionen erforderlich ist.
Weitere Informationen zu den Konfigurationsoptionen und deren Einstellungen finden Sie unter Serverkonfigurationsoptionen (SQL Server).
Berechtigungen
Die Ausführungsberechtigungen für sp_configure
ohne Parameter oder nur mit dem ersten Parameter werden standardmäßig allen Benutzern erteilt. sp_configure
Um mit beiden Parametern auszuführen, um eine Konfigurationsoption zu ändern oder die RECONFIGURE
Anweisung auszuführen, müssen Sie der ALTER SETTINGS
Berechtigung auf Serverebene erteilt werden. Die ALTER SETTINGS
-Berechtigung ist implizit in den festen Serverrollen sysadmin und serveradmin enthalten.
Beispiele
A. Auflisten der erweiterten Konfigurationsoptionen
Im folgenden Beispiel wird das Festlegen und Auflisten aller Konfigurationsoptionen dargestellt. Sie können erweiterte Konfigurationsoptionen anzeigen, indem Sie zuerst auf show advanced options
1
. Nachdem diese Option geändert wurde, können Sie alle Konfigurationsoptionen anzeigen, indem Sie ohne Parameter ausführen sp_configure
.
USE master;
GO
EXEC sp_configure 'show advanced options', '1';
Hier ist das Resultset.
Configuration option 'show advanced options' changed from 0 to 1. Run the `RECONFIGURE` statement to install.
Führen Sie RECONFIGURE
aus, und zeigen Sie alle Konfigurationsoptionen an:
RECONFIGURE;
EXEC sp_configure;
B. Ändern einer Konfigurationsoption
Im folgenden Beispiel wird die Systemkonfigurationsoption recovery interval
auf 3
Minuten festgelegt.
USE master;
GO
EXEC sp_configure 'recovery interval', '3';
RECONFIGURE WITH OVERRIDE;
Beispiele: Analytics-Plattformsystem (PDW)
C. Auflisten aller verfügbaren Konfigurationseinstellungen
Im folgenden Beispiel wird dargestellt, wie alle Konfigurationsoptionen aufgelistet werden.
EXEC sp_configure;
Das Ergebnis gibt den Optionsnamen zurück, gefolgt von den minimalen und maximalen Werten für die Option. Der config_value
Wert, den Azure Synapse Analytics verwendet, wenn die Neukonfiguration abgeschlossen ist. Dies run_value
ist der Wert, der derzeit verwendet wird. Die config_value
und run_value
sind in der Regel identisch, es sei denn, der Wert befindet sich im Prozess der Änderung.
D: Auflisten der Konfigurationseinstellungen für einen Konfigurationsnamen
EXEC sp_configure @configname = 'hadoop connectivity';
E. Festlegen der Hadoop-Konnektivität
Das Festlegen der Hadoop-Konnektivität erfordert zusätzlich zur Ausführung sp_configure
einige weitere Schritte. Die vollständige Vorgehensweise finden Sie unter CREATE EXTERNAL DATA SOURCE.
sp_configure [ @configname = ] 'hadoop connectivity',
[ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }
[ ; ]
RECONFIGURE;
[ ; ]
Zugehöriger Inhalt
- ALTER SERVER CONFIGURATION (Transact-SQL)
- RECONFIGURE (Transact-SQL)
- SET-Anweisungen (Transact-SQL)
- Serverkonfigurationsoptionen (SQL Server)
- ALTER DATABASE (Transact-SQL)
- Gespeicherte Systemprozeduren (Transact-SQL)
- sys.configurations (Transact-SQL)
- ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL)
- Soft-NUMA (SQL Server)