sp_configure (Transact-SQL)

2025-08-21

Gäller för: SQL Server Azure SQL Managed Instance Azure Synapse Analytics Platform System (PDW)

Visar eller ändrar globala konfigurationsinställningar för den aktuella servern.

Anmärkning

Information om konfigurationsalternativ på databasnivå finns i ALTER DATABASE SCOPED CONFIGURATION (ÄNDRA DATABASOMFATTNINGSKONFIGURATION). Information om hur du konfigurerar Soft-NUMA finns iSoft-NUMA (SQL Server).

Transact-SQL syntaxkonventioner

Syntax

Syntax för SQL Server.

sp_configure
    [ [ @configname = ] 'configname' ]
    [ , [ @configvalue = ] configvalue ]
[ ; ]

Syntax för Analytics Platform System (PDW).

sp_configure
[ ; ]

Arguments

[ @configname = ] 'configname'

Namnet på ett konfigurationsalternativ. @configname är varchar(35), med standardvärdet NULL. SQL Server Database Engine identifierar alla unika strängar som ingår i konfigurationsnamnet. Om det inte anges returneras den fullständiga listan med alternativ.

Information om tillgängliga konfigurationsalternativ och deras inställningar finns i Serverkonfigurationsalternativ.

[ @configvalue = ] configvalue

Den nya konfigurationsinställningen. @configvalue är int, med standardvärdet NULL.

Det maximala värdet beror på det enskilda alternativet. Om du vill se det maximala värdet för varje alternativ läser maximum du kolumnen i sys.configurations katalogvyn.

Returnera kodvärden

0 (lyckades) eller 1 (misslyckades).

Resultatuppsättning

När det körs utan parametrar sp_configure returnerar en resultatuppsättning med fem kolumner och beställer alternativen alfabetiskt i stigande ordning, enligt följande tabell.

Värdena för config_value och run_value är inte automatiskt likvärdiga. När du har uppdaterat en konfigurationsinställning med hjälp sp_configureav måste du också uppdatera konfigurationsvärdet som körs med hjälp av antingen RECONFIGURE eller RECONFIGURE WITH OVERRIDE. Mer information finns i avsnittet Anmärkningar .

Kolumnnamn	Datatyp	Description
`name`	nvarchar(35)	Namn på konfigurationsalternativet.
`minimum`	Int	Minsta värde för konfigurationsalternativet.
`maximum`	Int	Maximalt värde för konfigurationsalternativet.
`config_value`	Int	Värde som konfigurationsalternativet angavs till med ( `sp_configure` värde i `sys.configurations.value`). Mer information om dessa alternativ finns i Serverkonfigurationsalternativ och sys.configurations.
`run_value`	Int	För närvarande körs värdet för konfigurationsalternativet (värde i `sys.configurations.value_in_use`). Mer information finns i sys.configurations.

Anmärkningar

Använd sp_configure för att visa eller ändra inställningar på servernivå. Om du vill ändra inställningar på databasnivå använder du ALTER DATABASE. Om du vill ändra inställningar som endast påverkar den aktuella användarsessionen använder du -instruktionen SET .

Vissa serverkonfigurationsalternativ är endast tillgängliga via ALTER SERVER CONFIGURATION.

Uppdatera konfigurationsvärdet som körs

När du anger en ny @configvalue för en @configname visar resultatuppsättningen det här värdet i config_value kolumnen. Det här värdet skiljer sig ursprungligen från värdet i run_value kolumnen, som visar det konfigurationsvärde som körs. Om du vill uppdatera konfigurationsvärdet som körs i run_value kolumnen måste systemadministratören köra antingen RECONFIGURE eller RECONFIGURE WITH OVERRIDE.

Både RECONFIGURE och RECONFIGURE WITH OVERRIDE fungerar med varje konfigurationsalternativ. Den grundläggande RECONFIGURE instruktionen avvisar dock alla alternativvärden som ligger utanför ett rimligt intervall eller som kan orsaka konflikter mellan alternativen. Till exempel RECONFIGURE genererar ett fel om återställningsintervallvärdet är större än 60 minuter eller om värdet för tillhörighetsmask överlappar värdet för tillhörighets-I/O-masken . RECONFIGURE WITH OVERRIDEdäremot accepterar valfritt alternativvärde med rätt datatyp och tvingar fram omkonfiguration med det angivna värdet.

Försiktighet

Ett olämpligt alternativvärde kan påverka konfigurationen av serverinstansen negativt. Använd RECONFIGURE WITH OVERRIDE försiktigt.

Instruktionen RECONFIGURE uppdaterar vissa alternativ dynamiskt. Andra alternativ kräver ett serverstopp och en omstart. Till exempel uppdateras alternativen minsta serverminne och maximalt minne för serverminne dynamiskt i databasmotorn. Därför kan du ändra dem utan att starta om servern. Om du däremot konfigurerar om körningsvärdet för fyllningsfaktoralternativet måste databasmotorn startas om.

När du har kört RECONFIGURE ett konfigurationsalternativ kan du se om alternativet uppdaterades dynamiskt genom att sp_configure '<configname>'köra . Värdena i kolumnerna run_value och config_value ska matcha för ett dynamiskt uppdaterat alternativ. Du kan också kontrollera vilka alternativ som är dynamiska genom att titta på is_dynamic kolumnen i sys.configurations katalogvyn.

Ändringen skrivs också till SQL Server-felloggen.

Om en angiven @configvalue är för hög för ett alternativ run_value återspeglar kolumnen det faktum att databasmotorn som standard använder dynamiskt minne i stället för att använda en inställning som inte är giltig.

Mer information finns i REKONFIGURERA.

Avancerade alternativ

Vissa konfigurationsalternativ, till exempel tillhörighetsmask och återställningsintervall, anges som avancerade alternativ. Som standard är de här alternativen inte tillgängliga för visning och ändring. Om du vill göra dem tillgängliga anger du konfigurationsalternativet visa avancerade alternativ till 1.

Försiktighet

När alternativet visa avancerade alternativ är inställt på 1gäller den här inställningen för alla användare. Vi rekommenderar att du endast använder det här tillståndet tillfälligt och växlar tillbaka till 0 när du är klar med den uppgift som krävs för att visa de avancerade alternativen.

Mer information om konfigurationsalternativen och deras inställningar finns i Serverkonfigurationsalternativ.

Permissions

Kör behörigheter på sp_configure utan parametrar eller med endast den första parametern beviljas alla användare som standard. Om du vill köra sp_configure med båda parametrarna för att ändra ett konfigurationsalternativ eller för att köra -instruktionen RECONFIGURE måste du beviljas behörighet på ALTER SETTINGS servernivå. Behörigheten ALTER SETTINGS innehas implicit av de fasta serverrollerna sysadmin och serveradmin .

Examples

A. Visa en lista över avancerade konfigurationsalternativ

I följande exempel visas hur du anger och listar alla konfigurationsalternativ. Du kan visa avancerade konfigurationsalternativ genom att först ange show advanced options till 1. När det här alternativet har ändrats kan du visa alla konfigurationsalternativ genom att sp_configure köra utan parametrar.

USE master;
GO

EXECUTE sp_configure 'show advanced options', '1';

Här är resultatet.

Configuration option 'show advanced options' changed from 0 to 1. Run the `RECONFIGURE` statement to install.

Kör RECONFIGURE och visa alla konfigurationsalternativ:

RECONFIGURE;

EXECUTE sp_configure;

B. Ändra ett konfigurationsalternativ

I följande exempel anges alternativet för systemkonfiguration recovery interval till 3 minuter.

USE master;
GO

EXECUTE sp_configure 'recovery interval', '3';

RECONFIGURE WITH OVERRIDE;

Exempel: Analysplattformssystem (PDW)

C. Visa en lista över alla tillgängliga konfigurationsinställningar

I följande exempel visas hur du listar alla konfigurationsalternativ.

EXECUTE sp_configure;

Resultatet returnerar alternativnamnet följt av lägsta och högsta värden för alternativet. config_value Är det värde som Azure Synapse Analytics använder när omkonfigurationen är klar. run_value är det värde som används för närvarande. Och config_valuerun_value är vanligtvis samma om inte värdet håller på att ändras.

D. Ange konfigurationsinställningarna för ett konfigurationsnamn

EXECUTE sp_configure @configname = 'hadoop connectivity';

E. Ange Hadoop-anslutning

Att ställa in Hadoop-anslutning kräver ytterligare några steg utöver att köra sp_configure. Fullständig procedur finns i SKAPA EXTERN DATAKÄLLA.

sp_configure [ @configname = ] 'hadoop connectivity',
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }
[ ; ]
RECONFIGURE;
[ ; ]

Feedback

Var den här sidan till hjälp?