sp_configure (Transact-SQL)sp_configure (Transact-SQL)

GILT FÜR: JaSQL Server JaAzure SQL-Datenbank (nur verwaltete Instanz) NeinAzure SQL Data Warehouse NeinParallel Data WarehouseAPPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse yesParallel Data Warehouse

Mit dieser Prozedur können globale Konfigurationseinstellungen für den aktuellen Server angezeigt oder geändert werden.Displays or changes global configuration settings for the current server.

Hinweis

Informationen zu den Konfigurationsoptionen auf Datenbankebene finden Sie unter Alter (Database scoped Configuration)Transact-SQL.For database-level configuration options, see ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL). Informationen zum Konfigurieren von Soft-NUMA finden Sie unter Soft (-)NUMA SQL Server.To configure Soft-NUMA, see Soft-NUMA (SQL Server).

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

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

ArgumenteArguments

[ @configname = ] 'option_name'Der Name einer Konfigurationsoption.[ @configname = ] 'option_name' Is the name of a configuration option. option_name ist vom Datentyp varchar(35) . Der Standardwert ist NULL.option_name is varchar(35), with a default of NULL. Von SQL Server-Datenbank-EngineSQL Server Database Engine wird jede eindeutige Zeichenfolge erkannt, die Teil des Konfigurationsnamens ist.The SQL Server-Datenbank-EngineSQL Server Database Engine recognizes any unique string that is part of the configuration name. Erfolgt keine Angabe, wird die gesamte Liste der Optionen zurückgegeben.If not specified, the complete list of options is returned.

Informationen zu den verfügbaren Konfigurationsoptionen und Ihren Einstellungen finden Sie unter Server Configuration (options)SQL Server.For information about the available configuration options and their settings, see Server Configuration Options (SQL Server).

[ @configvalue = ] 'value'Ist die neue Konfigurationseinstellung.[ @configvalue = ] 'value' Is the new configuration setting. value ist vom Datentyp int. Der Standardwert ist NULL.value is int, with a default of NULL. Der Maximalwert kann je nach Option unterschiedlich sein.The maximum value depends on the individual option.

Wenn Sie den maximalen Wert für die einzelnen Optionen anzeigen möchten, sehen Sie sich die Spalte Maximum der Katalog Sicht sys. Konfigurationen an.To see the maximum value for each option, see the maximum column of the sys.configurations catalog view.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

ResultsetsResult Sets

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 dargestellt.When executed with no parameters, sp_configure returns a result set with five columns and orders the options alphabetically in ascending order, as shown in the following table.

Die Werte für config_value und run_value sind nicht automatisch Äquivalent.The values for config_value and run_value are not automatically equivalent. Nachdem Sie eine Konfigurationseinstellung mithilfe von sp_configureaktualisiert haben, muss der Systemadministrator den Wert für die laufende Konfiguration entweder mithilfe von RECONFIGURE oder RECONFIGURE WITH OVERRIDE aktualisieren.After updating a configuration setting by using sp_configure, the system administrator must update the running configuration value by using either RECONFIGURE or RECONFIGURE WITH OVERRIDE. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.For more information, see the Remarks section.

SpaltennameColumn name DatentypData type BeschreibungDescription
namename nvarchar(35)nvarchar(35) Der Name der Konfigurationsoption.Name of the configuration option.
minimumminimum intint Der Mindestwert der Konfigurationsoption.Minimum value of the configuration option.
maximummaximum intint Der Höchstwert der Konfigurationsoption.Maximum value of the configuration option.
config_valueconfig_value intint Der Wert, mit dem die Konfigurationsoption mithilfe von sp_configure (Wert in sys. Konfigurationen. Value) festgelegt wurde.Value to which the configuration option was set using sp_configure (value in sys.configurations.value). Weitere Informationen zu diesen Optionen finden Sie unter Server Konfigurationsoptionen (SQL Server) und sys. Konfigurationen (Transact-SQL).For more information about these options, see Server Configuration Options (SQL Server) and sys.configurations (Transact-SQL).
run_valuerun_value intint Aktuell laufender Wert der Konfigurationsoption (Wert in sys. Konfigurationen. value_in_use).Currently running value of the configuration option (value in sys.configurations.value_in_use).

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

HinweiseRemarks

Verwenden Sie sp_configure , um Einstellungen auf Serverebene anzuzeigen oder zu ändern.Use sp_configure to display or change server-level settings. Zum Ändern von Einstellungen auf Datenbankebene können Sie ALTER DATABASE verwenden.To change database-level settings, use ALTER DATABASE. Wenn Einstellungen geändert werden sollen, die nur die aktuelle Benutzersitzung betreffen, verwenden Sie die SET-Anweisung.To change settings that affect only the current user session, use the SET statement.

Aktualisieren des ausgeführten KonfigurationswertsUpdating the Running Configuration Value

Wenn Sie einen neuen Wert für eine Optionangeben, wird dieser Wert im Resultset in der config_value -Spalte angezeigt.When you specify a new value for an option, the result set shows this value in the config_value column. Dieser Wert unterscheidet sich anfänglich von dem Wert in der run_value -Spalte, in der der aktuell laufende Konfigurations Wert angezeigt wird.This value initially differs from the value in the run_value column, which shows the currently running configuration value. Zum Aktualisieren des laufenden Konfigurations Werts in der run_value -Spalte muss der Systemadministrator entweder RECONFIGURE oder RECONFIGURE WITH OVERRIDE ausführen.To update the running configuration value in the run_value column, the system administrator must run either RECONFIGURE or RECONFIGURE WITH OVERRIDE.

RECONFIGURE und RECONFIGURE WITH OVERRIDE können für jede Konfigurationsoption verwendet werden.Both RECONFIGURE and RECONFIGURE WITH OVERRIDE work with every configuration option. 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.However, the basic RECONFIGURE statement rejects any option value that is outside a reasonable range or that may cause conflicts among options. Beispielsweise generiert RECONFIGURE einen Fehler, wenn der Wert des Wiederherstellungs Intervalls größer als 60 Minuten ist oder wenn sich der Affinitäts Masken Wert mit dem Wert der Affinitäts-e/a-Maske überlappt.For example, RECONFIGURE generates an error if the recovery interval value is larger than 60 minutes or if the affinity mask value overlaps with the affinity I/O mask value. Von RECONFIGURE WITH OVERRIDE hingegen werden alle Optionswerte vom richtigen Datentyp akzeptiert. Eine Neukonfiguration mit dem angegebenen Wert wird dann erzwungen.RECONFIGURE WITH OVERRIDE, in contrast, accepts any option value with the correct data type and forces reconfiguration with the specified value.

Achtung

Ein nicht geeigneter Optionswert kann negative Auswirkungen auf die Konfiguration der Serverinstanz haben.An inappropriate option value can adversely affect the configuration of the server instance. Verwenden Sie RECONFIGURE WITH OVERRIDE mit Sorgfalt.Use RECONFIGURE WITH OVERRIDE cautiously.

Mit der RECONFIGURE-Anweisung werden einige Optionen dynamisch aktualisiert. Für andere Optionen ist jedoch das Beenden und Neustarten des Servers erforderlich.The RECONFIGURE statement updates some options dynamically; other options require a server stop and restart. So werden z Datenbank-EngineDatabase Engine. b. die Arbeitsspeicher Optionen Min. Server Arbeitsspeicher und Max. Server Arbeitsspeicher dynamisch in aktualisiert. Daher können Sie Sie ändern, ohne den Server neu zu starten.For example, the min server memory and max server memory server memory options are updated dynamically in the Datenbank-EngineDatabase Engine; therefore, you can change them without restarting the server. Im Gegensatz dazu erfordert das erneute Konfigurieren des laufenden Werts der Option Füllfaktor das Datenbank-EngineDatabase EngineNeustarten von.By contrast, reconfiguring the running value of the fill factor option requires restarting the Datenbank-EngineDatabase Engine.

Nachdem Sie RECONFIGURE für eine Konfigurationsoption ausgeführt haben, können Sie erkennen, ob die Option durch Ausführen von sp_configure 'option_name' dynamisch aktualisiert wurde.After running RECONFIGURE on a configuration option, you can see whether the option has been updated dynamically by executing sp_configure'option_name'. Die Werte in den Spalten run_value und config_value sollten mit einer dynamisch aktualisierten Option verglichen werden.The values in the run_value and config_value columns should match for a dynamically updated option. Sie können auch überprüfen, welche Optionen dynamisch sind, indem Sie die is_dynamic -Spalte der Katalog Sicht sys. Konfigurationen betrachten.You can also check to see which options are dynamic by looking at the is_dynamic column of the sys.configurations catalog view.

Die Änderung wird auch in das SQL Server-Fehlerprotokoll geschrieben.The change is also written to the SQL Server error log.

Hinweis

Wenn ein angegebener Wert für eine Option zu hoch ist, wird in der run_value -Spalte Datenbank-EngineDatabase Engine die Tatsache angegeben, dass der standardmäßig auf dynamischer Arbeitsspeicher festgelegt ist, anstatt eine Einstellung zu verwenden, die ungültig ist.If a specified value is too high for an option, the run_value column reflects the fact that the Datenbank-EngineDatabase Engine has defaulted to dynamic memory rather than use a setting that is not valid.

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

Erweiterte OptionenAdvanced Options

Einige Konfigurationsoptionen, wie z. b. Affinitäts Maske und Wiederherstellungs Intervall, werden als erweiterte Optionen bezeichnet.Some configuration options, such as affinity mask and recovery interval, are designated as advanced options. Diese Optionen stehen zum Anzeigen und Ändern nicht zur Verfügung.By default, these options are not available for viewing and changing. Legen Sie die Konfigurationsoption ShowAdvancedOptions auf 1 fest, um Sie verfügbar zu machen.To make them available, set the ShowAdvancedOptions configuration option to 1.

Weitere Informationen zu den Konfigurationsoptionen und Ihren Einstellungen finden Sie unter Server Configuration options (SQL Server).For more information about the configuration options and their settings, see Server Configuration Options (SQL Server).

BerechtigungenPermissions

Die Ausführungsberechtigungen für sp_configure ohne Parameter oder nur mit dem ersten Parameter werden standardmäßig allen Benutzern erteilt.Execute permissions on sp_configure with no parameters or with only the first parameter are granted to all users by default. Zum Ausführen von sp_configure mit beiden Parametern zum Ändern einer Konfigurationsoption oder zum Ausführen der RECONFIGURE-Anweisung muss Ihnen die ALTER SETTINGS-Berechtigung auf Serverebene erteilt werden.To execute sp_configure with both parameters to change a configuration option or to run the RECONFIGURE statement, you must be granted the ALTER SETTINGS server-level permission. Die ALTER SETTINGS-Berechtigung ist in den festen Serverrollen sysadmin und serveradmin eingeschlossen.The ALTER SETTINGS permission is implicitly held by the sysadmin and serveradmin fixed server roles.

BeispieleExamples

A.A. Auflisten der erweiterten KonfigurationsoptionenListing the advanced configuration options

Im folgenden Beispiel wird das Festlegen und Auflisten aller Konfigurationsoptionen dargestellt.The following example shows how to set and list all configuration options. Erweiterte Konfigurationsoptionen werden angezeigt, indem zunächst show advanced option auf 1 festgelegt wird.Advanced configuration options are displayed by first setting show advanced option to 1. Nachdem diese Option geändert wurde, werden beim Ausführen von sp_configure ohne Parameter alle Konfigurationsoptionen angezeigt.After this option has been changed, executing sp_configure with no parameters displays all configuration options.

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

Hier ist die Meldung: "Die Konfigurationsoption ' Erweiterte Optionen anzeigen ' wurde von 0 in 1 geändert.Here is the message: "Configuration option 'show advanced options' changed from 0 to 1. Führen Sie zum Installieren die RECONFIGURE-Anweisung aus."Run the RECONFIGURE statement to install."

Führen Sie RECONFIGURE aus, und zeigen Sie alle Konfigurationsoptionen an:Run RECONFIGURE and show all configuration options:

RECONFIGURE;  
EXEC sp_configure;  

B.B. Ändern einer KonfigurationsoptionChanging a configuration option

Im folgenden Beispiel wird recovery interval für das System auf 3 Minuten festgelegt.The following example sets the system recovery interval to 3 minutes.

USE master;  
GO  
EXEC sp_configure 'recovery interval', '3';  
RECONFIGURE WITH OVERRIDE;  

Beispiele: Parallel Data WarehouseParallel Data WarehouseExamples: Parallel Data WarehouseParallel Data Warehouse

C.C. Auflisten aller verfügbaren KonfigurationseinstellungenList all available configuration settings

Im folgenden Beispiel wird dargestellt, wie alle Konfigurationsoptionen aufgelistet werden.The following example shows how to list all configuration options.

EXEC sp_configure;  

Das Ergebnis gibt den Optionsnamen zurück, gefolgt von den minimalen und maximalen Werten für die Option.The result returns the option name followed by the minimum and maximum values for the option. Config_value ist der Wert, der SQL Data WarehouseSQL Data Warehouse verwendet wird, wenn die Neukonfiguration beendet ist.The config_value is the value that SQL Data WarehouseSQL Data Warehouse will use when reconfiguration is complete. run_value ist der Wert, der gerade verwendet wird.The run_value is the value that is currently being used. config_value und run_value sind in der Regel gleich, sofern der Wert nicht gerade geändert wird.The config_value and run_value are usually the same unless the value is in the process of being changed.

D.D. Auflisten der Konfigurationseinstellungen für einen KonfigurationsnamenList the configuration settings for one configuration name

EXEC sp_configure @configname='hadoop connectivity';  

E.E. Festlegen der Hadoop-KonnektivitätSet Hadoop connectivity

Das Festlegen der Hadoop-Konnektivität erfordert zusätzlich zum Ausführen von sp_configure weitere Schritte.Setting Hadoop connectivity requires a few more steps in addition to running sp_configure. Das vollständige Verfahren finden Sie unter Erstellen einer externen (Datenquelle Transact)-SQL.For the full procedure, see CREATE EXTERNAL DATA SOURCE (Transact-SQL).

Siehe auchSee Also

RECONFIGURE (Transact-SQL) RECONFIGURE (Transact-SQL)
SET-Anweisungen (Transact-SQL) SET Statements (Transact-SQL)
Serverkonfigurationsoptionen (SQL Server) Server Configuration Options (SQL Server)
ALTER DATABASE (Transact-SQL) ALTER DATABASE (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL) System Stored Procedures (Transact-SQL)
sys.configurations (Transact-SQL) sys.configurations (Transact-SQL)
ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL) ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL)
Soft-NUMA (SQL Server)Soft-NUMA (SQL Server)