sp_configure (Transact-SQL)
Si applica a: SQL Server
Istanza gestita di SQL di Azure
Azure Synapse Analytics
Piattaforma di strumenti analitici (PDW)
Visualizza o modifica le impostazioni di configurazione globali per il server corrente.
Nota
Per le opzioni di configurazione a livello di database, vedere ALTER DATABASE SCOPED CONFIGURATION. Per configurare Soft-NUMA, vedere Soft-NUMA (SQL Server).
Convenzioni relative alla sintassi Transact-SQL
Sintassi
Sintassi per SQL Server.
sp_configure
[ [ @configname = ] 'configname' ]
[ , [ @configvalue = ] configvalue ]
[ ; ]
Sintassi per Parallel Data Warehouse.
sp_configure
[ ; ]
Argomenti
[ @configname = ] 'configname'
Nome di un'opzione di configurazione. @configname è varchar(35), con il valore predefinito NULL
. Sql Server motore di database riconosce qualsiasi stringa univoca che fa parte del nome di configurazione. Se non si specifica alcun nome di opzione, viene restituito l'elenco completo delle opzioni.
Per informazioni sulle opzioni di configurazione disponibili e sulle relative impostazioni, vedere Opzioni di configurazione del server (SQL Server).
[ @configvalue = ] configvalue
Nuova impostazione di configurazione. @configvalue è int, con il valore predefinito NULL
.
Il valore massimo dipende dalla singola opzione. Per visualizzare il valore massimo per ogni opzione, vedere la maximum
colonna della vista del sys.configurations
catalogo.
Valori del codice restituito
0
(esito positivo) o 1
(errore).
Set di risultati
Quando viene eseguito senza parametri, sp_configure
restituisce un set di risultati con cinque colonne e ordina le opzioni alfabeticamente in ordine crescente, come illustrato nella tabella seguente.
I valori per config_value
e run_value
non sono automaticamente equivalenti. Dopo aver aggiornato un'impostazione di configurazione usando sp_configure
, è necessario aggiornare anche il valore di configurazione in esecuzione usando RECONFIGURE
o RECONFIGURE WITH OVERRIDE
. Per altre informazioni, vedere la sezione Osservazioni.
Nome colonna | Tipo di dati | Descrizione |
---|---|---|
name |
nvarchar(35) | Nome dell'opzione di configurazione. |
minimum |
int | Valore minimo dell'opzione di configurazione. |
maximum |
int | Valore massimo dell'opzione di configurazione. |
config_value |
int | Valore a cui è stata impostata l'opzione di configurazione usando sp_configure (valore in sys.configurations.value ).Per altre informazioni su queste opzioni, vedere Opzioni di configurazione del server (SQL Server) e sys.configurations. |
run_value |
int | Valore attualmente in esecuzione dell'opzione di configurazione (valore in sys.configurations.value_in_use ).Per altre informazioni, vedere sys.configurations. |
Osservazioni:
Usare sp_configure
per visualizzare o modificare le impostazioni a livello di server. Per modificare le impostazioni a livello di database, usare ALTER DATABASE
. Per modificare le impostazioni che influiscono solo sulla sessione utente corrente, usare l'istruzione SET
.
Alcune opzioni di configurazione del server sono disponibili solo tramite ALTER SERVER CONFIGURATION.
Cluster Big Data di SQL Server
Alcune operazioni, inclusa la configurazione delle impostazioni del server (livello di istanza) o l'aggiunta manuale di un database a un gruppo di disponibilità, richiedono una connessione all'istanza di SQL Server. Per operazioni come sp_configure
, RESTORE DATABASE
o per qualsiasi comando DDL in un database appartenente a un gruppo di disponibilità è necessaria una connessione all'istanza di SQL Server. Per impostazione predefinita, un cluster Big Data non include un endpoint che abilita una connessione all'istanza. È necessario esporre questo endpoint manualmente.
Per istruzioni, vedere Connessione ai database nella replica primaria.
Aggiornare il valore di configurazione in esecuzione
Quando si specifica un nuovo @configvalue per un @configname, il set di risultati mostra questo valore nella config_value
colonna . Questo valore inizialmente è diverso dal valore nella run_value
colonna, che mostra il valore di configurazione attualmente in esecuzione. Per aggiornare il valore di configurazione in esecuzione nella run_value
colonna, l'amministratore di sistema deve eseguire RECONFIGURE
o RECONFIGURE WITH OVERRIDE
.
Sia RECONFIGURE
che RECONFIGURE WITH OVERRIDE
funzionano con ogni opzione di configurazione. Tuttavia, l'istruzione di base RECONFIGURE
rifiuta qualsiasi valore di opzione non compreso in un intervallo ragionevole o che potrebbe causare conflitti tra le opzioni. Ad esempio, RECONFIGURE
genera un errore se il valore dell'intervallo di recupero è maggiore di 60 minuti o se il valore affinity mask si sovrappone al valore di affinity I/O mask. RECONFIGURE WITH OVERRIDE
, al contrario, accetta qualsiasi valore di opzione con il tipo di dati corretto e forza la riconfigurazione con il valore specificato.
Attenzione
Un valore non corretto può compromettere la configurazione dell'istanza del server. Usare RECONFIGURE WITH OVERRIDE
con cautela.
L'istruzione RECONFIGURE
aggiorna alcune opzioni in modo dinamico. Altre opzioni richiedono l'arresto e il riavvio del server. Ad esempio, le opzioni min server memory e max server memory server memory vengono aggiornate in modo dinamico nella motore di database. Pertanto, è possibile modificarli senza riavviare il server. Al contrario, la riconfigurazione del valore in esecuzione dell'opzione del fattore di riempimento richiede il riavvio del motore di database.
Dopo l'esecuzione RECONFIGURE
in un'opzione di configurazione, è possibile verificare se l'opzione è stata aggiornata in modo dinamico eseguendo sp_configure '<configname>'
. I valori nelle run_value
colonne e config_value
devono corrispondere a un'opzione aggiornata dinamicamente. È anche possibile verificare quali opzioni sono dinamiche esaminando la is_dynamic
colonna della vista del sys.configurations
catalogo.
La modifica viene scritta anche nel log degli errori di SQL Server.
Se un @configvalue specificato è troppo elevato per un'opzione, la run_value
colonna riflette il fatto che per impostazione predefinita la memoria dinamica motore di database anziché usare un'impostazione non valida.
Per altre informazioni, vedere RECONFIGURE.
Opzioni avanzate
Alcune opzioni di configurazione, ad esempio affinity mask e intervallo di recupero, sono designate come opzioni avanzate. Per impostazione predefinita, queste opzioni non sono disponibili per la visualizzazione e la modifica. Per renderli disponibili, impostare l'opzione di configurazione Mostra opzioni avanzate su 1
.
Attenzione
Quando l'opzione Mostra opzioni avanzate è impostata su 1
, questa impostazione si applica a tutti gli utenti. È consigliabile usare questo stato temporaneamente e tornare a 0
quando è stata eseguita con l'attività che richiede la visualizzazione delle opzioni avanzate.
Per altre informazioni sulle opzioni di configurazione e sulle relative impostazioni, vedere Opzioni di configurazione del server (SQL Server).
Autorizzazioni
Le autorizzazioni di esecuzione per sp_configure
senza alcun parametro o solo con il primo parametro vengono assegnate per impostazione predefinita a tutti gli utenti. Per eseguire sp_configure
con entrambi i parametri per modificare un'opzione di configurazione o per eseguire l'istruzione RECONFIGURE
, è necessario disporre dell'autorizzazione ALTER SETTINGS
a livello di server. L'autorizzazione ALTER SETTINGS
è assegnata implicitamente ai ruoli predefiniti del serversysadmin e serveradmin.
Esempi
R. Elencare le opzioni di configurazione avanzate
Nell'esempio seguente viene illustrato come impostare ed elencare tutte le opzioni di configurazione. È possibile visualizzare le opzioni di configurazione avanzate impostando show advanced options
prima su 1
. Dopo aver modificato questa opzione, è possibile visualizzare tutte le opzioni di configurazione eseguendo sp_configure
senza parametri.
USE master;
GO
EXEC sp_configure 'show advanced options', '1';
Questo è il set di risultati.
Configuration option 'show advanced options' changed from 0 to 1. Run the `RECONFIGURE` statement to install.
Eseguire RECONFIGURE
e visualizzare tutte le opzioni di configurazione:
RECONFIGURE;
EXEC sp_configure;
B. Modificare un'opzione di configurazione
Nell'esempio seguente l'opzione di configurazione del sistema recovery interval
viene impostata su 3
minuti.
USE master;
GO
EXEC sp_configure 'recovery interval', '3';
RECONFIGURE WITH OVERRIDE;
Esempi: Piattaforma di strumenti analitici (PDW)
C. Elencare tutte le impostazioni di configurazione disponibili
L'esempio seguente mostra come impostare ed elencare tutte le opzioni di configurazione.
EXEC sp_configure;
Il risultato restituisce il nome dell'opzione seguito dai valori minimi e massimo per l'opzione. config_value
è il valore usato da Azure Synapse Analytics al termine della riconfigurazione. run_value
è il valore attualmente in uso. e config_value
run_value
sono in genere uguali, a meno che il valore non sia in corso di modifica.
D. Elencare le impostazioni di configurazione per un nome di configurazione
EXEC sp_configure @configname = 'hadoop connectivity';
E. Impostare la connettività Hadoop
L'impostazione della connettività Hadoop richiede alcuni passaggi aggiuntivi oltre all'esecuzione sp_configure
di . Per la procedura completa, vedere CREATE EXTERNAL DATA SOURCE.
sp_configure [ @configname = ] 'hadoop connectivity',
[ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }
[ ; ]
RECONFIGURE;
[ ; ]
Contenuto correlato
- ALTER SERVER CONFIGURATION (Transact-SQL)
- RECONFIGURE (Transact-SQL)
- Istruzioni SET (Transact-SQL)
- Opzioni di configurazione del server (SQL Server)
- ALTER DATABASE (Transact-SQL)
- Stored procedure di sistema (Transact-SQL)
- sys.configurations (Transact-SQL)
- ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL)
- Soft-NUMA (SQL Server)