sp_configure (Transact-SQL)

A következőkre vonatkozik:SQL ServerFelügyelt Azure SQL-példányAnalytics platformrendszer (PDW)

Megjeleníti vagy módosítja az aktuális kiszolgáló globális konfigurációs beállításait.

Megjegyzés:

Az adatbázisszintű konfigurációs beállításokat az ALTER DATABASE SCOPED CONFIGURATION című témakörben talál. A Soft-NUMA konfigurálásához lásd: Soft-NUMA (SQL Server).

Transact-SQL szintaxis konvenciók

Szemantika

Az SQL Server szintaxisa.

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

Az Analytics Platform System (PDW) szintaxisa.

sp_configure
[ ; ]

Arguments

[ @configname = ] 'configname'

A konfigurációs beállítás neve. @confignamea varchar(35), alapértelmezés szerint NULL. Az SQL Server adatbázismotorja felismeri a konfiguráció nevéhez tartozó egyedi sztringeket. Ha nincs megadva, a függvény visszaadja a beállítások teljes listáját.

Az elérhető konfigurációs beállításokról és azok beállításairól a Kiszolgáló konfigurációs beállításai című témakörben olvashat.

[ @configvalue = ] configvalue

Az új konfigurációs beállítás. @configvalueint, alapértelmezés szerint NULL.

A maximális érték az egyéni beállítástól függ. Az egyes beállítások maximális értékének megtekintéséhez tekintse meg a maximumsys.configurations katalógusnézet oszlopát.

Kódértékek visszaadása

0 (sikeres) vagy 1 (hiba).

Eredményhalmaz

Ha paraméterek nélkül hajtja végre, egy öt oszlopot tartalmazó eredményhalmazt ad vissza, sp_configure és a beállításokat betűrendben növekvő sorrendbe rendezi, ahogyan az az alábbi táblázatban látható.

Az értékek config_value automatikusan egyenértékűek, és run_value nem is egyezik meg automatikusan. Miután a konfigurációs beállításokat a használatával sp_configurefrissítette, a futó konfigurációs értéket is frissítenie kell valamelyik RECONFIGURE vagy RECONFIGURE WITH OVERRIDE. További információkért lásd a Megjegyzések szakaszt .

Oszlop neve	Adattípus	Description
name	nvarchar(35)	A konfigurációs beállítás neve.
minimum	Int	A konfigurációs beállítás minimális értéke.
maximum	Int	A konfigurációs beállítás maximális értéke.
config_value	Int	Az érték, amelyre a konfigurációs beállítás be lett állítva sp_configure (érték a következőben sys.configurations.value: ). További információ ezekről a beállításokról: Kiszolgálókonfigurációs beállítások és sys.configurations.
run_value	Int	A konfigurációs beállítás jelenleg futó értéke (érték a következőben sys.configurations.value_in_use: ). További információ: sys.configurations.

Megjegyzések

Kiszolgálószintű beállítások megjelenítésére vagy módosítására szolgál sp_configure . Az adatbázisszintű beállítások módosításához használja a következőt ALTER DATABASE: . Ha csak az aktuális felhasználói munkamenetet érintő beállításokat szeretné módosítani, használja az utasítást SET .

Egyes kiszolgálókonfigurációs beállítások csak az ALTER SERVER CONFIGURATION-on keresztül érhetők el.

A futó konfigurációs érték frissítése

Amikor új @configvalue ad meg egy @configname, az eredményhalmaz megjeleníti ezt az értéket az config_value oszlopban. Ez az érték kezdetben eltér az run_value oszlop értékétől, amely a jelenleg futó konfigurációs értéket jeleníti meg. Az oszlopban run_value futó konfigurációs érték frissítéséhez a rendszergazdának RECONFIGURERECONFIGURE WITH OVERRIDEvagy a .

Mindkettőt RECONFIGURE , és RECONFIGURE WITH OVERRIDE minden konfigurációs lehetőséggel dolgozhat. Az alaputasítás RECONFIGURE azonban elutasít minden olyan beállításértéket, amely egy ésszerű tartományon kívül esik, vagy amely ütközéseket okozhat a lehetőségek között. Például hibát okoz, RECONFIGURE ha a helyreállítási időköz értéke nagyobb, mint 60 perc, vagy ha az affinitásmaszk értéke átfedésben van az affinitás I/O maszkértékével . RECONFIGURE WITH OVERRIDE, ezzel szemben elfogadja a megfelelő adattípussal rendelkező bármely beállításértéket, és kényszeríti az újrakonfigurálást a megadott értékkel.

Caution

A nem megfelelő beállításérték hátrányosan befolyásolhatja a kiszolgálópéldány konfigurációját. Óvatosan használja RECONFIGURE WITH OVERRIDE .

Az RECONFIGURE utasítás néhány beállítást dinamikusan frissít, más beállításokhoz pedig a kiszolgáló leállítása és újraindítása szükséges. A minimális kiszolgálói memória és a kiszolgálói memória maximális memóriabeállításai például dinamikusan frissülnek az adatbázismotorban. Ezért a kiszolgáló újraindítása nélkül módosíthatja őket. Ezzel szemben a kitöltési tényező beállítás futási értékének újrakonfigurálásához újra kell indítani az adatbázismotort.

A konfigurációs beállítás futtatása RECONFIGURE után láthatja, hogy a beállítás dinamikusan frissült-e a végrehajtással sp_configure '<configname>'. A dinamikusan frissített beállítás értékeinek run_value és config_value oszlopainak egyezniük kell. A katalógusnézet oszlopának is_dynamic megtekintésével sys.configurations azt is ellenőrizheti, hogy mely beállítások dinamikusak.

A módosítás az SQL Server hibanaplójába is be van írva.

Ha egy megadott @configvalue túl magas egy beállításhoz, az run_value oszlop azt a tényt tükrözi, hogy az adatbázismotor alapértelmezés szerint dinamikus memóriát használ ahelyett, hogy érvénytelen beállítást használ.

További információ: RECONFIGURE.

Speciális beállítások

Bizonyos konfigurációs beállítások, például az affinitási maszk és a helyreállítási időköz speciális beállításokként vannak kijelölve. Alapértelmezés szerint ezek a beállítások nem érhetők el megtekintésre és módosításra. Ha elérhetővé szeretné tenni őket, állítsa a speciális beállítások megjelenítésének beállítását a következőre 1: .

Caution

Ha a beállítás speciális beállításokat1jelenít meg, ez a beállítás minden felhasználóra érvényes. Javasoljuk, hogy csak ideiglenesen használja ezt az állapotot, és váltson vissza 0 , amikor végzett a speciális beállítások megtekintését igénylő feladattal.

A konfigurációs beállításokról és azok beállításairól további információt a Kiszolgáló konfigurációs beállításai című témakörben talál.

Permissions

Az engedélyek végrehajtása sp_configure paraméterek nélkül vagy csak az első paraméterrel alapértelmezés szerint minden felhasználónak meg lesz adva. A konfigurációs beállítás módosításához vagy az sp_configure utasítás futtatásához mindkét paraméterrel történő végrehajtáshoz RECONFIGURE meg kell adni a ALTER SETTINGS kiszolgálószintű engedélyt. Az ALTER SETTINGS engedélyt implicit módon a sysadmin és a serveradmin rögzített kiszolgálói szerepkörök birtokolják.

Példák

A. A speciális konfigurációs beállítások listázása

Az alábbi példa bemutatja, hogyan állíthatja be és listázhatja az összes konfigurációs beállítást. A speciális konfigurációs beállításokat az első beállítással show advanced options jelenítheti meg.1 A beállítás módosítása után az összes konfigurációs beállítást megjelenítheti paraméterek nélküli végrehajtással sp_configure .

USE master;
GO

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

Itt van az eredmények összessége.

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

Futtassa RECONFIGURE és jelenítse meg az összes konfigurációs beállítást:

RECONFIGURE;

EXECUTE sp_configure;

B. Konfigurációs beállítás módosítása

Az alábbi példa percekre recovery interval állítja a rendszerkonfigurációs 3 beállítást.

USE master;
GO

EXECUTE sp_configure 'recovery interval', '3';

RECONFIGURE WITH OVERRIDE;

Példák: Elemzési platformrendszer (PDW)

C. Az összes elérhető konfigurációs beállítás listázása

Az alábbi példa bemutatja, hogyan listázhatja az összes konfigurációs beállítást.

EXECUTE sp_configure;

Az eredmény visszaadja a beállítás nevét, majd a beállítás minimális és maximális értékeit. Ez config_value az az érték, amelyet az Azure Synapse Analytics használ az újrakonfigurálás befejezésekor. Ez run_value a jelenleg használt érték. Az config_value érték általában run_value megegyezik, kivéve, ha az érték módosítása folyamatban van.

D. Egy konfigurációnév konfigurációs beállításainak listázása

EXECUTE sp_configure @configname = 'hadoop connectivity';

E. Hadoop-kapcsolat beállítása

A Hadoop-kapcsolat beállításához a futtatás sp_configuremellett további lépésekre is szükség van. A teljes eljárásért lásd a CREATE EXTERNAL DATA SOURCE (KÜLSŐ ADATFORRÁS LÉTREHOZÁSA) című témakört.

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

Kapcsolódó tartalom

• SZERVER KONFIGURÁCIÓJÁNAK MÓDOSÍTÁSA (Transact-SQL)
• ÚJRAKONFIGURÁLÁS (Transact-SQL)
• SET-utasítások (Transact-SQL)
• kiszolgáló konfigurációs beállításai
• ADATBÁZIS MÓDOSÍTÁSA (Transact-SQL)
• Rendszer által tárolt eljárások (Transact-SQL)
• sys.configurations (Transact-SQL)
• ALTER DATABASE HATÓKÖRŰ KONFIGURÁCIÓ (Transact-SQL)
• Soft-NUMA (SQL Server)