sp_configure (Transact-SQL)

Articolo
10/14/2021
6 minuti per la lettura

SI APPLICA A: SQL Server Istanza gestita di SQL di Azure Azure Synapse Analytics Parallel Data Warehouse

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

Icona di collegamento a un argomento Convenzioni della 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. Motore di database di SQL Server riconosce qualsiasi stringa univoca che faccia parte del nome della 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 è int e 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

Se 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 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
nome	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 su 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).
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).

Commenti

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 interessano solo la sessione utente corrente, usare SET l'istruzione .

Alcune opzioni di configurazione del server sono disponibili solo tramite ALTER SERVER 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 config_value colonna. 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 della maschera di affinità si sovrappone al valore della maschera di I/O di affinità. 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 memory vengono aggiornate dinamicamente in . Di conseguenza, è possibile modificarle senza Motore di database riavviare il server. Al contrario, la riconfigurazione del valore di esecuzione dell'opzione del fattore di riempimento richiede il riavvio di 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 per un'opzione aggiornata dinamicamente. È anche possibile verificare quali opzioni sono dinamiche esaminando la colonna is_dynamic della vista del catalogo sys.configurations.

La modifica viene scritta anche nel log SQL Server errori.

Nota

Se un valore specificato è troppo alto per un'opzione, la colonna run_value riflette il fatto che per l'oggetto è stata impostata la memoria dinamica anziché usare un'impostazione Motore di database non valida.

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

Opzioni avanzate

Alcune opzioni di configurazione, ad esempio affinity mask e recovery interval, sono designate come opzioni avanzate. Per impostazione predefinita non è possibile visualizzarle e modificarle. Per renderle 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 solo temporaneamente e tornare a 0 al termine dell'attività che richiedeva 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 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 Microsoft Azure Synapse Analytics verrà utilizzato 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).

Vedere anche

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)