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

Informationen zu Konfigurationsoptionen auf Datenbankebene finden Sie unter ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL). Informationen zum Konfigurieren von Soft-NUMA finden Sie unter Soft-NUMA (SQL Server).

Topic link iconTransact-SQL-Syntaxkonventionen

Syntax

-- Syntax for SQL Server  
  
sp_configure [ [ @configname = ] 'option_name'   
    [ , [ @configvalue = ] 'value' ] ]  
-- Syntax for Parallel Data Warehouse  
  
-- List all of the configuration options  
sp_configure  
[;]  
  
-- Configure Hadoop connectivity  
sp_configure [ @configname= ] 'hadoop connectivity',  
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }  
[;]  
RECONFIGURE  
[;]  

Argumente

[ @configname = ] 'option_name' Ist der Name einer Konfigurationsoption. option_name ist vom Datentyp varchar(35) . Der Standardwert ist NULL. Der 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 ihren Einstellungen finden Sie unter Serverkonfigurationsoptionen (SQL Server).

[ @configvalue = ] 'value' Ist die neue Konfigurationseinstellung. value ist vom Datentyp int. Der Standardwert ist NULL. Der Maximalwert kann je nach Option unterschiedlich sein.

Um den maximalen Wert für jede Option anzuzeigen, lesen Sie die maximale Spalte der Katalogansicht "sys.konfiguration ".

Rückgabecodewerte

„0“ (erfolgreich) oder „1“ (fehlerhaft)

Resultsets

Wenn sie ohne Parameter ausgeführt werden, gibt sp_configure eine Ergebnismenge mit fünf Spalten zurück und bestellt die Optionen alphabetisch in aufsteigender Reihenfolge, wie in der folgenden Tabelle dargestellt.

Die Werte für config_value und run_value entsprechen nicht automatisch. Nach dem Aktualisieren einer Konfigurationseinstellung mithilfe von sp_configure muss der Systemadministrator den ausgeführten Konfigurationswert mithilfe von RECONFIGURE oder RECONFIGURE WITH OVERRIDE aktualisieren. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

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.configuration.value) festgelegt wurde. Weitere Informationen zu diesen Optionen finden Sie unter Serverkonfigurationsoptionen (SQL Server) und sys.configuration (Transact-SQL).
run_value int Derzeit wird der Wert der Konfigurationsoption (Wert in sys.configurations.value_in_use) ausgeführt.

Weitere Informationen finden Sie unter sys.config (Transact-SQL).

Hinweise

Verwenden Sie sp_configure , um Einstellungen auf Serverebene anzuzeigen oder zu ändern. Um Die Einstellungen auf Datenbankebene zu ändern, verwenden Sie ALTER DATABASE. Um Einstellungen zu ändern, die sich nur auf die aktuelle Benutzersitzung auswirken, verwenden Sie die SET Anweisung.

Einige Serverkonfigurationsoptionen sind nur über ALTER SERVER CONFIGURATION (Transact-SQL) verfügbar.

Big Data-Cluster für SQL Server

Bestimmte Vorgänge, einschließlich der Konfiguration von Servereinstellungen (auf Instanzebene) oder manuelles 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 einen neuen Wert für eine Option angeben, zeigt der Ergebnissatz diesen Wert in der Spalte config_value an. Dieser Wert unterscheidet sich zunächst vom Wert in der Spalte run_value , die den aktuell ausgeführten Konfigurationswert anzeigt. Um den ausgeführten Konfigurationswert in der Spalte run_value zu aktualisieren, muss der Systemadministrator entweder REFIGURE oder REFIGURE WITH OVERRIDE ausführen.

RECONFIGURE und RECONFIGURE WITH OVERRIDE können für jede Konfigurationsoption verwendet werden. Die einfache RECONFIGURE-Anweisung weist jedoch Optionswerte zurück, die außerhalb eines angemessenen Bereichs liegen oder die zu Konflikten bei den Optionen führen. So generiert RECONFIGURE z. B. einen Fehler, wenn der Wiederherstellungsintervallwert größer als 60 Minuten ist oder wenn sich der Affinitätsmaskenwert mit dem Affinity-I/O-Maskenwert überlappen. Von RECONFIGURE WITH OVERRIDE hingegen werden alle Optionswerte vom richtigen Datentyp akzeptiert. Eine Neukonfiguration mit dem angegebenen Wert wird dann erzwungen.

Achtung

Ein nicht geeigneter Optionswert kann negative Auswirkungen auf die Konfiguration der Serverinstanz haben. Verwenden Sie RECONFIGURE WITH OVERRIDE mit Sorgfalt.

Mit der RECONFIGURE-Anweisung werden einige Optionen dynamisch aktualisiert. Für andere Optionen ist jedoch das Beenden und Neustarten des Servers erforderlich. Beispielsweise werden die Optionen für den Min-Serverspeicherund den maximalen Serverspeicher in den Datenbank-Engine dynamisch aktualisiert. Daher können Sie sie ändern, ohne den Server neu zu starten. Im Gegensatz dazu erfordert die Neukonfiguration des ausgeführten Werts der Füllfaktoroption einen Neustart des Datenbank-Engine.

Nach dem Ausführen von REFIGURE auf einer Konfigurationsoption können Sie sehen, ob die Option dynamisch aktualisiert wurde, indem sie sp_configure 'option_name' ausführen. Die Werte in den spalten run_value und config_value sollten für eine dynamisch aktualisierte Option übereinstimmen. Sie können auch überprüfen, welche Optionen dynamisch sind, indem Sie sich die spalte is_dynamic der Katalogansicht "sys.konfiguration " ansehen.

Die Änderung wird auch in das SQL Server Fehlerprotokoll geschrieben.

Hinweis

Wenn ein angegebener Wert für eine Option zu hoch ist, spiegelt die run_value Spalte die Tatsache wider, dass die Datenbank-Engine standardmäßig auf dynamischen Arbeitsspeicher festgelegt ist, anstatt eine Einstellung zu verwenden, die ungültig ist.

Weitere Informationen finden Sie unter RECONFIGURE (Transact-SQL).

Erweiterte Optionen

Einige Konfigurationsoptionen, z. B. Affinitätsmaske und Wiederherstellungsintervall, werden als erweiterte Optionen bezeichnet. Diese Optionen stehen zum Anzeigen und Ändern nicht zur Verfügung. Um sie verfügbar zu machen, legen Sie die Option "Erweiterte Optionen anzeigen " auf 1 fest.

Achtung

Wenn die Option "Erweiterte Optionen anzeigen " auf 1 festgelegt ist, gilt diese Einstellung für alle Benutzer. Es wird empfohlen, diesen Zustand vorübergehend zu verwenden und beim Anzeigen der erweiterten Optionen auf 0 zurück zu wechseln.

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. Um sp_configure mit beiden Parametern auszuführen, um eine Konfigurationsoption zu ändern oder die RECONFIGURE-Anweisung auszuführen, müssen Sie die BERECHTIGUNG ALTER SETTINGS auf Serverebene erteilen. Die ALTER SETTINGS-Berechtigung ist in den festen Serverrollen sysadmin und serveradmin eingeschlossen.

Beispiele

A. Auflisten der erweiterten Konfigurationsoptionen

Im folgenden Beispiel wird das Festlegen und Auflisten aller Konfigurationsoptionen dargestellt. Erweiterte Konfigurationsoptionen werden angezeigt, indem zunächst show advanced options auf 1 festgelegt wird. Nachdem diese Option geändert wurde, werden beim Ausführen von sp_configure ohne Parameter alle Konfigurationsoptionen angezeigt.

USE master;  
GO  
EXEC sp_configure 'show advanced options', '1';  

Im Folgenden wird die Meldung aufgeführt: "Die Konfigurationsoption 'show advanced options' wurde von 0 in 1 geändert. Führen Sie zum Installieren die RECONFIGURE-Anweisung aus."

Führen Sie RECONFIGURE aus, und zeigen Sie alle Konfigurationsoptionen an:

RECONFIGURE;  
EXEC sp_configure;  

B. Ändern einer Konfigurationsoption

Im folgenden Beispiel wird recovery interval für das System 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 ist der Wert, den Microsoft Azure Synapse Analytics verwendet, wenn die Neukonfiguration abgeschlossen ist. run_value ist der Wert, der gerade verwendet wird. config_value und run_value sind in der Regel gleich, sofern der Wert nicht gerade geändert wird.

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 einige weitere Schritte, zusätzlich zum Ausführen von sp_configure. Eine vollständige Prozedur finden Sie unter CREATE EXTERNAL DATA SOURCE (Transact-SQL).

Weitere Informationen

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)