sp_configure (Transact-SQL)

2025-08-21

Van toepassing op: SQL Server Azure SQL Managed Instance Azure Synapse Analytics Platform System (PDW)

Hiermee worden globale configuratie-instellingen voor de huidige server weergegeven of gewijzigd.

Opmerking

Zie ALTER DATABASE SCOPED CONFIGURATION voor configuratieopties op databaseniveau. Zie Soft-NUMA (SQL Server) om Soft-NUMA te configureren.

Transact-SQL syntaxis-conventies

Syntaxis

Syntaxis voor SQL Server.

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

Syntaxis voor Analytics Platform System (PDW).

sp_configure
[ ; ]

Arguments

[ @configname = ] 'configname'

De naam van een configuratieoptie. @configname is varchar(35), met een standaardwaarde van NULL. De SQL Server Database Engine herkent elke unieke tekenreeks die deel uitmaakt van de configuratienaam. Als dit niet is opgegeven, wordt de volledige lijst met opties geretourneerd.

Zie Serverconfiguratieopties voor meer informatie over de beschikbare configuratieopties en de bijbehorende instellingen.

[ @configvalue = ] configvalue

De nieuwe configuratie-instelling. @configvalue is int, met een standaardwaarde van NULL.

De maximumwaarde is afhankelijk van de afzonderlijke optie. Als u de maximumwaarde voor elke optie wilt zien, raadpleegt u de maximum kolom van de sys.configurations catalogusweergave.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Resultatenset

Wanneer deze wordt uitgevoerd zonder parameters, sp_configure wordt een resultatenset geretourneerd met vijf kolommen en worden de opties alfabetisch in oplopende volgorde gesorteerd, zoals wordt weergegeven in de volgende tabel.

De waarden voor config_value en run_value zijn niet automatisch equivalent. Nadat u een configuratie-instelling hebt bijgewerkt met behulp van sp_configure, moet u ook de actieve configuratiewaarde bijwerken met behulp van RECONFIGURE of RECONFIGURE WITH OVERRIDE. Zie de sectie Opmerkingen voor meer informatie.

Kolomnaam	Gegevenstype	Description
`name`	nvarchar(35)	Naam van de configuratieoptie.
`minimum`	Int	Minimale waarde van de configuratieoptie.
`maximum`	Int	Maximumwaarde van de configuratieoptie.
`config_value`	Int	De waarde waarop de configuratieoptie is ingesteld met behulp van `sp_configure` (waarde in `sys.configurations.value`). Zie Serverconfiguratieopties en sys.configurations voor meer informatie over deze opties.
`run_value`	Int	Momenteel uitgevoerde waarde van de configuratieoptie (waarde in `sys.configurations.value_in_use`). Zie sys.configurations voor meer informatie.

Opmerkingen

Hiermee sp_configure kunt u instellingen op serverniveau weergeven of wijzigen. Als u de instellingen op databaseniveau wilt wijzigen, gebruikt u ALTER DATABASE. Als u instellingen wilt wijzigen die alleen van invloed zijn op de huidige gebruikerssessie, gebruikt u de SET instructie.

Sommige serverconfiguratieopties zijn alleen beschikbaar via ALTER SERVER CONFIGURATION.

De actieve configuratiewaarde bijwerken

Wanneer u een nieuwe @configvalue opgeeft voor een @configname, wordt deze waarde in de kolom weergegeven in de config_value resultatenset. Deze waarde wijkt in eerste instantie af van de waarde in de run_value kolom, waarin de huidige configuratiewaarde wordt weergegeven. Als u de actieve configuratiewaarde in de run_value kolom wilt bijwerken, moet de systeembeheerder deze RECONFIGURE uitvoeren of RECONFIGURE WITH OVERRIDE.

Beide RECONFIGURE en RECONFIGURE WITH OVERRIDE werken met elke configuratieoptie. De basisinstructie RECONFIGURE weigert echter elke optiewaarde die buiten een redelijk bereik valt of die conflicten tussen opties kan veroorzaken. Genereert bijvoorbeeld RECONFIGURE een fout als de herstelintervalwaarde groter is dan 60 minuten of als de waarde van het affiniteitsmasker overlapt met de affiniteits-I/O-maskerwaarde . RECONFIGURE WITH OVERRIDEaccepteert daarentegen elke optiewaarde met het juiste gegevenstype en dwingt herconfiguratie af met de opgegeven waarde.

Waarschuwing

Een ongepaste optiewaarde kan de configuratie van het serverexemplaren nadelig beïnvloeden. Gebruik RECONFIGURE WITH OVERRIDE voorzichtig.

Met de RECONFIGURE instructie worden sommige opties dynamisch bijgewerkt. Voor andere opties is een serverstop en opnieuw opstarten vereist. Zo worden de geheugenopties voor de minimale servergeheugen en het maximum aantal servergeheugenservers dynamisch bijgewerkt in de database-engine. Daarom kunt u deze wijzigen zonder de server opnieuw op te starten. Als u daarentegen de actieve waarde van de opvulfactoroptie opnieuw configureert, moet de database-engine opnieuw worden opgestart.

Nadat u een configuratieoptie hebt uitgevoerd RECONFIGURE , kunt u zien of de optie dynamisch is bijgewerkt door deze uit te sp_configure '<configname>'voeren. De waarden in de run_value en config_value kolommen moeten overeenkomen met een dynamisch bijgewerkte optie. U kunt ook controleren welke opties dynamisch zijn door de is_dynamic kolom van de sys.configurations catalogusweergave te bekijken.

De wijziging wordt ook geschreven naar het SQL Server-foutenlogboek.

Als een opgegeven @configvalue te hoog is voor een optie, weerspiegelt de run_value kolom het feit dat de database-engine standaard is ingesteld op dynamisch geheugen, in plaats van een instelling te gebruiken die niet geldig is.

Zie OPNIEUW CONFIGUREREN voor meer informatie.

Geavanceerde opties

Sommige configuratieopties, zoals affiniteitsmasker en herstelinterval, worden aangeduid als geavanceerde opties. Deze opties zijn standaard niet beschikbaar voor weergave en wijziging. Als u deze beschikbaar wilt maken, stelt u de configuratieoptie geavanceerde opties in op 1.

Waarschuwing

Wanneer de optie geavanceerde opties weergeeft is ingesteld 1op, is deze instelling van toepassing op alle gebruikers. Het is raadzaam om deze status alleen tijdelijk te gebruiken en terug te schakelen naar 0 wanneer u klaar bent met de taak waarvoor de geavanceerde opties moeten worden weergegeven.

Zie Serverconfiguratieopties voor meer informatie over de configuratieopties en de bijbehorende instellingen.

Permissions

Voer machtigingen sp_configure uit voor zonder parameters of met alleen de eerste parameter worden standaard aan alle gebruikers verleend. Als u wilt uitvoeren sp_configure met beide parameters om een configuratieoptie te wijzigen of om de RECONFIGURE instructie uit te voeren, moet u de ALTER SETTINGS machtiging op serverniveau krijgen. De ALTER SETTINGS machtiging wordt impliciet bewaard door de vaste serverfuncties sysadmin en serveradmin .

Voorbeelden

Eén. De geavanceerde configuratieopties weergeven

In het volgende voorbeeld ziet u hoe u alle configuratieopties instelt en weergeeft. U kunt geavanceerde configuratieopties weergeven door eerst in te stellen show advanced options op 1. Nadat deze optie is gewijzigd, kunt u alle configuratieopties weergeven door zonder parameters uit te sp_configure voeren.

USE master;
GO

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

Hier is het resultatenoverzicht.

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

Voer alle configuratieopties uit RECONFIGURE en geef deze weer:

RECONFIGURE;

EXECUTE sp_configure;

B. Een configuratieoptie wijzigen

In het volgende voorbeeld wordt de systeemconfiguratieoptie recovery interval ingesteld op 3 minuten.

USE master;
GO

EXECUTE sp_configure 'recovery interval', '3';

RECONFIGURE WITH OVERRIDE;

Voorbeelden: Analytics Platform System (PDW)

C. Alle beschikbare configuratie-instellingen weergeven

In het volgende voorbeeld ziet u hoe u alle configuratieopties weergeeft.

EXECUTE sp_configure;

Het resultaat retourneert de naam van de optie, gevolgd door de minimum- en maximumwaarden voor de optie. Dit config_value is de waarde die Azure Synapse Analytics gebruikt wanneer de configuratie is voltooid. Dit run_value is de waarde die momenteel wordt gebruikt. De config_value en run_value zijn meestal hetzelfde, tenzij de waarde wordt gewijzigd.

D. De configuratie-instellingen voor één configuratienaam weergeven

EXECUTE sp_configure @configname = 'hadoop connectivity';

E. Hadoop-connectiviteit instellen

Voor het instellen van Hadoop-connectiviteit zijn nog enkele stappen vereist naast het uitvoeren sp_configure. Zie CREATE EXTERNAL DATA SOURCE voor de volledige procedure.

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

Feedback

Is deze pagina nuttig?