Sdílet prostřednictvím


sp_configure (Transact-SQL)

Platí pro: SQL Server Azure SQL Managed Instance není podporován. Azure Synapse Analytics Analytics Platform System (PDW)

Zobrazí nebo změní globální nastavení konfigurace pro aktuální server.

Poznámka:

Možnosti konfigurace na úrovni databáze naleznete v tématu ALTER DATABASE SCOPED CONFIGURATION. Informace o konfiguraci technologie Soft-NUMA najdete v tématu Soft-NUMA (SQL Server).

Transact-SQL konvence syntaxe

Syntaxe

Syntaxe pro SQL Server

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

Syntaxe systému PDW (Analytics Platform System).

sp_configure
[ ; ]

Arguments

[ @configname = ] 'configname'

Název možnosti konfigurace. @configname je varchar(35) s výchozím nastavením NULL. Databázový stroj SQL Serveru rozpozná jakýkoli jedinečný řetězec, který je součástí názvu konfigurace. Pokud není zadaný, vrátí se úplný seznam možností.

Informace o dostupných možnostech konfigurace a jejich nastavení najdete v tématu Možnosti konfigurace serveru.

[ @configvalue = ] configvalue

Nové nastavení konfigurace. @configvalue je int, s výchozím nastavením NULL.

Maximální hodnota závisí na jednotlivých možnostech. Pokud chcete zobrazit maximální hodnotu pro každou možnost, podívejte se na maximum sloupec sys.configurations zobrazení katalogu.

Návratové hodnoty kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Při provádění bez parametrů sp_configure vrátí sadu výsledků s pěti sloupci a pořadím možností abecedně ve vzestupném pořadí, jak je znázorněno v následující tabulce.

Hodnoty pro config_value a run_value nejsou automaticky ekvivalentní. Po aktualizaci nastavení konfigurace pomocí sp_configure, musíte také aktualizovat spuštěnou hodnotu konfigurace pomocí nebo RECONFIGURERECONFIGURE WITH OVERRIDE. Další informace najdete v části Poznámky .

Název sloupce Datový typ Description
name nvarchar(35) Název možnosti konfigurace.
minimum Int Minimální hodnota možnosti konfigurace.
maximum Int Maximální hodnota možnosti konfigurace.
config_value Int Hodnota, na kterou byla možnost konfigurace nastavena ( sp_configure hodnota v sys.configurations.value).

Další informace o těchto možnostech naleznete v tématu Možnosti konfigurace serveru a sys.configurations.
run_value Int Aktuálně spuštěná hodnota možnosti konfigurace (hodnota in sys.configurations.value_in_use).

Další informace naleznete v tématu sys.configurations.

Poznámky

Slouží sp_configure k zobrazení nebo změně nastavení na úrovni serveru. Chcete-li změnit nastavení na úrovni databáze, použijte ALTER DATABASE. Pokud chcete změnit nastavení, která mají vliv pouze na aktuální relaci uživatele, použijte tento SET příkaz.

Některé možnosti konfigurace serveru jsou dostupné pouze prostřednictvím ALTER SERVER CONFIGURATION.

Aktualizace hodnoty spuštěné konfigurace

Když pro @configname zadáte nový @configvalue, sada výsledků zobrazí tuto hodnotu ve sloupciconfig_value. Tato hodnota se zpočátku liší od hodnoty ve run_value sloupci, která zobrazuje aktuálně spuštěnou konfigurační hodnotu. Chcete-li aktualizovat hodnotu spuštěné konfigurace ve run_value sloupci, musí správce systému spustit buď RECONFIGURE nebo RECONFIGURE WITH OVERRIDE.

Obě RECONFIGURE možnosti konfigurace a RECONFIGURE WITH OVERRIDE práce s každou možností konfigurace Základní RECONFIGURE příkaz však odmítne jakoukoli hodnotu možnosti, která je mimo rozumný rozsah nebo která by mohla způsobit konflikty mezi možnostmi. Například vygeneruje chybu, RECONFIGURE pokud je hodnota intervalu obnovení větší než 60 minut nebo pokud se hodnota masky spřažení překrývá s hodnotou Spřažení vstupně-výstupní masky . RECONFIGURE WITH OVERRIDE, naproti tomu přijímá libovolnou hodnotu možnosti se správným datovým typem a vynutí rekonfiguraci se zadanou hodnotou.

Upozornění

Nevhodná hodnota možnosti může nepříznivě ovlivnit konfiguraci instance serveru. Používejte RECONFIGURE WITH OVERRIDE opatrně.

Příkaz RECONFIGURE aktualizuje některé možnosti dynamicky. Jiné možnosti vyžadují zastavení a restartování serveru. Například minimální paměť serveru a maximální počet možností paměti serveru se dynamicky aktualizují v databázovém stroji. Proto je můžete změnit bez restartování serveru. Naproti tomu změna konfigurace spuštěné hodnoty možnosti vyplnit faktor vyžaduje restartování databázového stroje.

Po spuštění RECONFIGURE možnosti konfigurace můžete zjistit, zda byla možnost dynamicky aktualizována spuštěním sp_configure '<configname>'. Hodnoty ve sloupcích run_value a config_value sloupcích by se měly shodovat s dynamicky aktualizovanou možností. Můžete také zkontrolovat, které možnosti jsou dynamické, is_dynamic zobrazením sloupce sys.configurations zobrazení katalogu.

Tato změna se také zapíše do protokolu chyb SQL Serveru.

Pokud je zadaná @configvalue pro možnost příliš vysoká, sloupec odráží skutečnost, run_value že databázový stroj ve výchozím nastavení používá dynamickou paměť místo použití nastavení, které není platné.

Další informace naleznete v tématu RECONFIGURE.

Rozšířené možnosti

Některé možnosti konfigurace, jako je maska spřažení a interval obnovení, jsou určené jako pokročilé možnosti. Ve výchozím nastavení nejsou tyto možnosti k dispozici pro zobrazení a změnu. Pokud je chcete zpřístupnit, nastavte možnost konfigurace rozšířených možností na 1hodnotu .

Upozornění

Pokud je možnost zobrazit upřesňující možnosti nastavená na 1, toto nastavení platí pro všechny uživatele. Tento stav se doporučuje používat dočasně a přepnout 0 zpět až po dokončení s úlohou, která vyžaduje zobrazení rozšířených možností.

Další informace o možnostech konfigurace a jejich nastavení najdete v tématu Možnosti konfigurace serveru.

Povolení

Ve výchozím nastavení se všem uživatelům udělí oprávnění sp_configure bez parametrů nebo pouze s prvním parametrem. Pokud chcete s oběma parametry změnit sp_configure možnost konfigurace nebo spustit RECONFIGURE příkaz, musíte mít udělená ALTER SETTINGS oprávnění na úrovni serveru. Oprávnění ALTER SETTINGS se implicitně uchovává rolemi serveru sysadmin a serveradmin .

Examples

A. Zobrazení seznamu rozšířených možností konfigurace

Následující příklad ukazuje, jak nastavit a zobrazit seznam všech možností konfigurace. Rozšířené možnosti konfigurace můžete zobrazit tak, že nejprve nastavíte show advanced options možnost 1. Po provedení této možnosti můžete zobrazit všechny možnosti konfigurace spuštěním sp_configure bez parametrů.

USE master;
GO

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

Tady je soubor výsledků.

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

Spusťte a zobrazte RECONFIGURE všechny možnosti konfigurace:

RECONFIGURE;

EXECUTE sp_configure;

B. Změna možnosti konfigurace

Následující příklad nastaví možnost konfigurace systému recovery interval na 3 minuty.

USE master;
GO

EXECUTE sp_configure 'recovery interval', '3';

RECONFIGURE WITH OVERRIDE;

Příklady: Systém analytických platforem (PDW)

C. Zobrazit seznam všech dostupných nastavení konfigurace

Následující příklad ukazuje, jak zobrazit seznam všech možností konfigurace.

EXECUTE sp_configure;

Výsledek vrátí název možnosti následovaný minimálními a maximálními hodnotami pro možnost. Jedná se config_value o hodnotu, kterou Azure Synapse Analytics používá při dokončení rekonfigurace. Jedná se run_value o hodnotu, která se právě používá. run_value A config_value jsou obvykle stejné, pokud hodnota není v procesu změny.

D. Výpis nastavení konfigurace pro jeden název konfigurace

EXECUTE sp_configure @configname = 'hadoop connectivity';

E. Nastavení připojení Hadoopu

Nastavení připojení Hadoop vyžaduje kromě spuštění sp_configureněkolik dalších kroků. Úplný postup najdete v tématu VYTVOŘENÍ EXTERNÍHO ZDROJE DAT.

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