sp_configure (Transact-SQL)

Artikel
2025-01-02

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 Analytics Platform System (PDW).

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.

[ @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 OVERRIDEfolgenden 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 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 DATABASEzum Ä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 OVERRIDEakzeptiert 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 1ist, 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.

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 sehen Sie das Ergebnis.

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_configureeinige 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;
[ ; ]

Freigeben über