sp_configure (Transact-SQL)

  • Articolo

Si applica a: SQL Server Istanza gestita di SQL di Azure Non supportato. 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 il sistema della piattaforma di analisi (PDW).

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.

[ @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 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.

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';

Il set di risultati è il seguente.

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_configuredi . 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