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 DATABA edizione Standard SCOPED CONFIGURATION (Transact-SQL). Per configurare Soft-NUMA, vedere Soft-NUMA (SQL Server).

Convenzioni di sintassi Transact-SQL

Sintassi

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

Argomenti

[ @configname = ] 'option_name' Nome di un'opzione di configurazione. option_name è varchar(35)e 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 = ] 'value' Nuova impostazione di configurazione. value è inte il valore predefinito è NULL. Il valore massimo dipende dalla singola opzione.

Per visualizzare il valore massimo per ogni opzione, vedere la colonna massima della vista del catalogo sys.configurations .

Valori del codice restituito

0 (operazione completata) o 1 (operazione non riuscita)

Set di risultati

Quando viene eseguito senza parametri, sp_configure restituisce un set di risultati con cinque colonne e ordina le opzioni in ordine alfabetico 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, l'amministratore di sistema deve aggiornare 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 (Transact-SQL).For more information about these options, see Server Configuration Options (SQL Server) and sys.configurations (Transact-SQL).
run_value	int	Valore attualmente in esecuzione dell'opzione di configurazione (valore in sys.configurations.value_in_use). Per altre informazioni, vedere sys.configurations (Transact-SQL).

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 edizione Standard RVER CONFIGURATION (Transact-SQL).

Cluster Big Data di SQL Server

Per alcune operazioni, inclusa la configurazione delle impostazioni del server (a livello di istanza) o l'aggiunta manuale di un database a un gruppo di disponibilità, è necessaria 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.

Aggiornamento del valore di configurazione corrente

Quando si specifica un nuovo valore per un'opzione, il set di risultati mostra questo valore nella colonna config_value. Questo valore è inizialmente diverso dal valore nella colonna run_value , che mostra il valore di configurazione attualmente in esecuzione. Per aggiornare il valore di configurazione in esecuzione nella colonna run_value , l'amministratore di sistema deve eseguire RECONFIGURE o RECONFIGURE WITH OVERRIDE.

Sia RECONFIGURE che RECONFIGURE WITH OVERRIDE funzionano con tutte le opzioni di configurazione. L'istruzione RECONFIGURE, tuttavia, non accetta i valori di opzione che non rientrano in un intervallo ragionevole o che possono 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, invece, accetta qualsiasi valore di opzione con il tipo di dati corretto e impone la riconfigurazione utilizzando il valore specificato.

Attenzione

Un valore non corretto può compromettere la configurazione dell'istanza del server. Utilizzare RECONFIGURE WITH OVERRIDE con cautela.

L'istruzione RECONFIGURE aggiorna alcune opzioni in modo dinamico. Per altre è necessario arrestare e riavviare il server. Ad esempio, le opzioni min server memory e max server memory server vengono aggiornate in modo dinamico nella motore di database, pertanto è possibile modificarle 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 aver eseguito RECONFIGURE in un'opzione di configurazione, è possibile verificare se l'opzione è stata aggiornata dinamicamente eseguendo sp_configure'option_name'. I valori nelle colonne run_value e config_value devono corrispondere a un'opzione aggiornata in modo dinamico. È anche possibile controllare quali opzioni sono dinamiche esaminando la colonna is_dynamic della vista del catalogo sys.configurations .

La modifica viene scritta anche nel log degli errori di SQL Server.

Nota

Se un valore specificato è troppo elevato per un'opzione, la colonna run_value riflette il fatto che l'motore di database ha impostato per impostazione predefinita la memoria dinamica anziché usare un'impostazione non valida.

Per altre informazioni, vedere RECONFIGURE (Transact-SQL).

Opzioni avanzate

Alcune opzioni di configurazione, ad esempio affinity mask e intervallo di recupero, sono designate come opzioni avanzate. Per impostazione predefinita non è possibile visualizzarle e modificarle. 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 temporaneamente questo stato e tornare a 0 quando viene 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 edizione Standard TTINGS a livello di server. L'autorizzazione ALTER SETTINGS è assegnata implicitamente ai ruoli predefiniti del server sysadmin e serveradmin .

Esempi

R. Visualizzazione dell'elenco delle opzioni di configurazione avanzate

Nell'esempio seguente viene illustrato come impostare ed elencare tutte le opzioni di configurazione. Le opzioni di configurazione avanzate vengono visualizzate se innanzitutto si imposta show advanced options su 1. In seguito alla modifica di questa opzione, se si esegue sp_configure senza parametri, verranno visualizzate tutte le opzioni di configurazione.

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

Viene restituito il messaggio seguente: "L'impostazione 0 dell'opzione di configurazione 'show advanced options' è stata sostituita con 1. Per eseguire l'installazione, utilizzare RECONFIGURE".

Eseguire RECONFIGURE e visualizzare tutte le opzioni di configurazione:

RECONFIGURE;  
EXEC sp_configure;  

B. Modifica di un'opzione di configurazione

Nell'esempio seguente viene impostato il valore di recovery interval del sistema 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. Il config_value è il valore che Azure Synapse Analytics userà al termine della riconfigurazione. config_value è il valore in uso. The config_value e 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 di sp_configure. Per la procedura completa, vedere CREATE EXTERNAL DATA SOURCE (Transact-SQL).

Vedi anche

ALTER SERVER CONFIGURATION (Transact-SQL)
RECONFIGURE (Transact-SQL)
Istruzioni edizione Standard T (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)