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

Dieses Thema gilt für: JaSQL Server (ab 2008)JaAzure SQL-Datenbank (nur verwaltete Instanz)keineAzure SQL Data Warehouse JaParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2008)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.

Wichtig

Auf Azure SQL-Datenbank verwaltete Instanz, diese T-SQL-Funktion hat bestimmte verhaltensänderungen.On Azure SQL Database Managed Instance, this T-SQL feature has certain behavior changes. Finden Sie unter Azure SQL-Datenbank verwaltet Instanz T-SQL-Unterschiede zu SQL Server Details für alle T-SQL-verhaltensänderungen.See Azure SQL Database Managed Instance T-SQL differences from SQL Server for details for all T-SQL behavior changes.

Hinweis

Auf Datenbankebene-Konfigurationsoptionen finden Sie unter ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL).For database-level configuration options, see ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL). 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= ] 'Optionsname'[ @configname= ] 'option_name'
Der Name einer Konfigurationsoption.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-DatenbankmodulSQL Server Database Engine wird jede eindeutige Zeichenfolge erkannt, die Teil des Konfigurationsnamens ist.The SQL Server-DatenbankmodulSQL 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 Serverkonfigurationsoptionen (SQL Server).For information about the available configuration options and their settings, see Server Configuration Options (SQL Server).

[ @configvalue= ] 'Wert'[ @configvalue= ] 'value'
Die neue Konfigurationseinstellung.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.

Der maximale Wert für die einzelnen Optionen finden Sie unter der maximale Spalte die sys.configurations -Katalogsicht angezeigt.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 Sp_configure gibt ein Resultset mit fünf Spalten und die Optionen in aufsteigender Reihenfolge alphabetisch sortiert, wie in der folgenden Tabelle gezeigt.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 gleich.The values for config_value and run_value are not automatically equivalent. Nach dem Update einer Konfigurationseinstellung mit Sp_configure, der Systemadministrator muss den ausgeführten Konfigurationswert mit 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 DescriptionDescription
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 Wert, dem Festlegen der Konfigurationsoption wurde mit Sp_configure (Wert in sysconfigures.Value).Value to which the configuration option was set using sp_configure (value in sys.configurations.value). Weitere Informationen zu diesen Optionen finden Sie unter Serverkonfigurationsoptionen (SQL Server) und sys.configurations (Transact-SQL).For more information about these options, see Server Configuration Options (SQL Server) and sys.configurations (Transact-SQL).
run_valuerun_value intint Aktuell ausgeführter Wert der Konfigurationsoption (Wert in value_in_use).Currently running value of the configuration option (value in sys.configurations.value_in_use).

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

HinweiseRemarks

Verwendung Sp_configure anzeigen oder Ändern von Einstellungen auf Serverebene.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 ein neues angeben Wert für eine Option, das Resultset zeigt diesen Wert in der Config_value Spalte.When you specify a new value for an option, the result set shows this value in the config_value column. Dieser Wert zunächst unterscheidet sich vom Wert in der Run_value Spalte, die die aktuell ausgeführte Konfigurationswert angezeigt wird.This value initially differs from the value in the run_value column, which shows the currently running configuration value. Beim Aktualisieren des ausgeführten Konfigurationswerts in der Run_value Spalte der Systemadministrator muss 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. Angenommen, ein Fehler generiert, wenn die Wiederherstellungsintervall Wert ist größer als 60 Minuten oder, wenn die Affinitätsmaske Wert überschneidet sich mit der Affinity i/o MaskWert.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. Z. B. die Min. Serverarbeitsspeicher und Max. Serverarbeitsspeicher Serverarbeitsspeicher-Optionen werden dynamisch aktualisiert die DatenbankmodulDatabase Engine; aus diesem Grund können ohne Neustarten des Servers geändert werden.For example, the min server memory and max server memory server memory options are updated dynamically in the DatenbankmodulDatabase Engine; therefore, you can change them without restarting the server. Neukonfiguration des laufenden Werts für die Füllfaktor Option erfordert einen Neustart der DatenbankmodulDatabase Engine.By contrast, reconfiguring the running value of the fill factor option requires restarting the DatenbankmodulDatabase Engine.

Nach dem Ausführen von RECONFIGURE für eine Konfigurationsoption, sehen Sie, ob die Option dazu dynamisch aktualisiert wurde Sp_configure'Option_name".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 der Run_value und Config_value Spalten sollten für eine dynamisch aktualisierten Option entsprechen.The values in the run_value and config_value columns should match for a dynamically updated option. Sie können auch überprüfen, um festzustellen, welche Optionen dynamische sind durch einen Blick auf die Is_dynamic Spalte die sys.configurations -Katalogsicht angezeigt.You can also check to see which options are dynamic by looking at the is_dynamic column of the sys.configurations catalog view.

Hinweis

Wenn ein angegebener Wert ist zu hoch für eine Option der Run_value Spalte gibt die Tatsache wieder, die die DatenbankmodulDatabase Engine hat standardmäßig dynamischer Arbeitsspeicher statt verwenden Sie eine Einstellung, die nicht gültig ist.If a specified value is too high for an option, the run_value column reflects the fact that the DatenbankmodulDatabase 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, z. B. Affinitätsmaske und Wiederherstellungsintervall, 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. Um sie verfügbar machen, legen Sie die ShowAdvancedOptions Konfigurationsoption auf 1.To make them available, set the ShowAdvancedOptions configuration option to 1.

Weitere Informationen zu den Konfigurationsoptionen und ihren Einstellungen finden Sie unter Serverkonfigurationsoptionen (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. Auszuführende Sp_configure mit beiden Parametern zum Ändern einer Konfigurationsoption oder zum Ausführen der RECONFIGURE-Anweisung, Sie müssen die Berechtigung ALTER SETTINGS auf Serverebene.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';  

Im Folgenden wird die Meldung aufgeführt: "Die Konfigurationsoption 'show advanced options' 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. Die Config_value ist der Wert, der SQL Data WarehouseSQL Data Warehouse verwenden, wenn die Neukonfiguration abgeschlossen 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

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

Siehe auchSee Also

RECONFIGURE & #40; Transact-SQL & #41; 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)