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.

Transact-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. 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 = ] 'value' Ist die neue Konfigurationseinstellung. value ist vom Datentyp int. Der Standardwert ist NULL. Der Maximalwert kann je nach Option unterschiedlich sein.

Informationen zum Anzeigen des Maximalwerts für jede Option finden Sie in der maximalen Spalte der Katalogansicht "sys.configurations ".

Rückgabecodewerte

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

Resultsets

Wenn sie ohne Parameter ausgeführt wird, gibt sp_configure ein Resultset mit fünf Spalten zurück und sortiert 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 Hinweise.

Hinweise

Verwenden Sie sp_configure , 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 (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 das Resultset diesen Wert in der Spalte config_value an. Dieser Wert unterscheidet sich anfangs vom Wert in der Spalte run_value , der den aktuell ausgeführten Konfigurationswert anzeigt. Um den ausgeführten Konfigurationswert in der Spalte run_value zu aktualisieren, muss der Systemadministrator entweder RECONFIGURE oder RECONFIGURE 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. Beispielsweise generiert RECONFIGURE einen Fehler, wenn der Wiederherstellungsintervallwert größer als 60 Minuten ist oder der Affinitätsformatwert mit dem Affinitätsformatwert überlappt. Von RECONFIGURE WITH OVERRIDE hingegen werden alle Optionswerte vom richtigen Datentyp akzeptiert. Eine Neukonfiguration mit dem angegebenen Wert wird dann erzwungen.

Mit der RECONFIGURE-Anweisung werden einige Optionen dynamisch aktualisiert. Für andere Optionen ist jedoch das Beenden und Neustarten des Servers erforderlich. Die Serverspeicheroptionen für min. und max. Serverspeicher werden beispielsweise 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 RECONFIGURE auf einer Konfigurationsoption ausgeführt haben, 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 is_dynamic Spalte der Katalogansicht "sys.configurations" ansehen.

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

Weitere Informationen finden Sie unter RECONFIGURE (Transact-SQL).For more information, see RECONFIGURE (Transact-SQL).

Erweiterte Optionen

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

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 auf Serverebene ALTER SETTINGS erhalten. 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 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 zusätzlich zum Ausführen von sp_configure einige weitere Schritte. Die vollständige Vorgehensweise finden Sie unter CREATE EXTERNAL DATA SOURCE (Transact-SQL).For the full procedure, see 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)