sp_configure (Transact-SQL)

GILT FÜR: SQL Server Azure SQL Managed Instance Azure Synapse Analytics Parallel Data Warehouse

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).

Symbol für Themenlink 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' Der Name einer Konfigurationsoption. option_name ist vom Datentyp varchar(35) . Der Standardwert ist NULL. Von SQL Server-Datenbank-Engine wird jede eindeutige Zeichenfolge erkannt, 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' Die neue Konfigurationseinstellung. value ist vom Datentyp int. Der Standardwert ist NULL. Der Maximalwert kann je nach Option unterschiedlich sein.

Den Maximalwert für jede Option finden Sie in der Spalte Maximum der sys.configurations-Katalogsicht.

Rückgabecodewerte

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

Resultsets

Bei der Ausführung ohne Parameter gibt sp_configure ein Resultset mit fünf Spalten zurück und sortiert die Optionen alphabetisch in aufsteigender Reihenfolge, wie in der folgenden Tabelle gezeigt.

Die Werte für config_value und run_value sind nicht automatisch gleichwertig. Nach dem Aktualisieren einer Konfigurationseinstellung mithilfe von sp_configure muss der Systemadministrator den ausgeführten Konfigurationswert mit RECONFIGURE oder RECONFIGURE WITH OVERRIDE 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 Der Wert, auf den die Konfigurationsoption mithilfe von sp_configure (Wert in sys.configurations.value) festgelegt wurde. Weitere Informationen zu diesen Optionen finden Sie unter Serverkonfigurationsoptionen (SQL Server) und sys.configurations (Transact-SQL).
run_value int Derzeit wird der Wert der Konfigurationsoption ausgeführt (Wert in sys.configurations.value_in_use).

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

Bemerkungen

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

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

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, wird dieser Wert im config_value angezeigt. Dieser Wert unterscheidet sich anfänglich vom Wert in der spalte run_value, der den aktuell ausgeführten Konfigurationswert zeigt. Um den ausgeführten Konfigurationswert in der Spalte run_value aktualisieren zu können, 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 Wert für das Wiederherstellungsintervall größer als 60 Minuten ist oder wenn sich der Wert der Affinitätsmaske mit dem Wert der Affinitäts-E/A-Maske überlappt. 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 min server memory und max server memory server memory dynamisch in aktualisiert. Daher können Sie sie ändern, ohne den Server neu Datenbank-Engine zu starten. Im Gegensatz dazu erfordert das Neukonfigurieren des Ausführungswerts der Füllfaktoroption einen Neustart von Datenbank-Engine .

Nachdem Sie RECONFIGURE für eine 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 mit einer dynamisch aktualisierten Option übereinstimmen. Sie können auch überprüfen, welche Optionen dynamisch sind, indem Sie sich die spalte is_dynamic sys.configurations-Katalogsicht anzeigen lassen.

Die Änderung wird auch in das SQL Server geschrieben.

Hinweis

Wenn ein angegebener Wert für eine Option zu hoch ist, spiegelt die spalte run_value wider, dass standardmäßig dynamischer Arbeitsspeicher verwendet wurde, anstatt eine ungültige Einstellung Datenbank-Engine zu verwenden.

Weitere Informationen finden Sie unter 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. Legen Sie die Konfigurationsoption Erweiterte Optionen anzeigen auf 1 fest, um sie verfügbar zu machen.

Achtung

Wenn die Option Erweiterte Optionen anzeigen auf 1 festgelegt ist, gilt diese Einstellung für alle Benutzer. Es wird empfohlen, diesen Zustand nur vorübergehend zu verwenden und zu 0 zurück zu wechseln, wenn sie mit der Aufgabe fertig ist, für die das Anzeigen der erweiterten Optionen erforderlich war.

Weitere Informationen zu den Konfigurationsoptionen und ihren 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. Zum Ausführen sp_configure mit beiden Parametern, um eine Konfigurationsoption zu ändern oder die RECONFIGURE-Anweisung auszuführen, muss Ihnen die ALTER SETTINGS-Berechtigung auf Serverebene erteilt werden. 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, der Microsoft Azure Synapse Analytics verwendet wird, 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 sp_configure. Das vollständige Verfahren 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)