Udostępnij za pomocą

sp_configure (Transact-SQL)

Dotyczy: Program SQL Server Azure SQL Managed Instance nie jest obsługiwany. Azure Synapse Analytics Platform System (PDW)

Wyświetla lub zmienia globalne ustawienia konfiguracji bieżącego serwera.

Uwaga / Notatka

Aby uzyskać informacje o opcjach konfiguracji na poziomie bazy danych, zobacz ALTER DATABASE SCOPED CONFIGURATION (ALTER DATABASE SCOPED CONFIGURATION). Aby skonfigurować funkcję Soft-NUMA, zobacz Soft-NUMA (SQL Server).

Transact-SQL konwencje składni

Składnia

Składnia programu SQL Server.

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

Składnia systemu platformy analizy (PDW).

sp_configure
[ ; ]

Arguments

[ @configname = ] 'configname'

Nazwa opcji konfiguracji. @configname jest varchar(35), z wartością domyślną NULL. Aparat bazy danych programu SQL Server rozpoznaje każdy unikatowy ciąg, który jest częścią nazwy konfiguracji. Jeśli nie zostanie określona, zostanie zwrócona pełna lista opcji.

Aby uzyskać informacje o dostępnych opcjach konfiguracji i ich ustawieniach, zobacz Opcje konfiguracji serwera.

[ @configvalue = ] configvalue

Nowe ustawienie konfiguracji. @configvalue jest int z wartością domyślną NULL.

Maksymalna wartość zależy od pojedynczej opcji. Aby wyświetlić maksymalną wartość dla każdej opcji, zobacz kolumnę maximumsys.configurations widoku wykazu.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Zestaw wyników

Po wykonaniu bez parametrów sp_configure zwraca zestaw wyników z pięcioma kolumnami i porządkuje opcje alfabetycznie w kolejności rosnącej, jak pokazano w poniższej tabeli.

Wartości i config_valuerun_value nie są automatycznie równoważne. Po zaktualizowaniu ustawienia konfiguracji przy użyciu polecenia sp_configurenależy również zaktualizować uruchomioną wartość konfiguracji przy użyciu polecenia RECONFIGURE lub RECONFIGURE WITH OVERRIDE. Aby uzyskać więcej informacji, zobacz sekcję Uwagi .

Nazwa kolumny Typ danych Description
name nvarchar(35) Nazwa opcji konfiguracji.
minimum Int Minimalna wartość opcji konfiguracji.
maximum Int Maksymalna wartość opcji konfiguracji.
config_value Int Wartość, za pomocą sp_configure której została ustawiona opcja konfiguracji (wartość w pliku sys.configurations.value).

Aby uzyskać więcej informacji na temat tych opcji, zobacz Opcje konfiguracji serwera i sys.configurations.
run_value Int Obecnie uruchomiona wartość opcji konfiguracji (wartość w sys.configurations.value_in_usepliku ).

Aby uzyskać więcej informacji, zobacz sys.configurations.

Uwagi

Służy sp_configure do wyświetlania lub zmieniania ustawień na poziomie serwera. Aby zmienić ustawienia na poziomie bazy danych, użyj polecenia ALTER DATABASE. Aby zmienić ustawienia, które mają wpływ tylko na bieżącą sesję SET użytkownika, użyj instrukcji .

Niektóre opcje konfiguracji serwera są dostępne tylko za pośrednictwem ALTER SERVER CONFIGURATION.

Aktualizowanie uruchomionej wartości konfiguracji

Po określeniu nowej @configvalue dla @configname zestaw wyników pokazuje tę wartość w kolumnie config_value . Ta wartość początkowo różni się od wartości w run_value kolumnie, która pokazuje aktualnie uruchomioną wartość konfiguracji. Aby zaktualizować uruchomioną wartość konfiguracji w kolumnie run_value , administrator systemu musi uruchomić RECONFIGURE polecenie lub RECONFIGURE WITH OVERRIDE.

Obie RECONFIGURE opcje i RECONFIGURE WITH OVERRIDE działają z każdą opcją konfiguracji. Jednak podstawowa RECONFIGURE instrukcja odrzuca dowolną wartość opcji, która znajduje się poza rozsądnym zakresem lub które mogą powodować konflikty między opcjami. Na przykład generuje błąd, RECONFIGURE jeśli wartość interwału odzyskiwania jest większa niż 60 minut lub jeśli wartość maski koligacji nakłada się na wartość maski we/wy koligacji . RECONFIGURE WITH OVERRIDEnatomiast akceptuje dowolną wartość opcji z poprawnym typem danych i wymusza ponowną konfigurację z określoną wartością.

Ostrzeżenie

Niewłaściwa wartość opcji może niekorzystnie wpłynąć na konfigurację wystąpienia serwera. Ostrożnie używaj RECONFIGURE WITH OVERRIDE .

Instrukcja RECONFIGURE aktualizuje niektóre opcje dynamicznie; inne opcje wymagają zatrzymania i ponownego uruchomienia serwera. Na przykład minimalna pamięć serwera i maksymalne opcje pamięci serwera serwera są aktualizowane dynamicznie w a aparatu bazy danych. W związku z tym można je zmienić bez ponownego uruchamiania serwera. Z kolei ponowne skonfigurowanie wartości uruchomionej opcji współczynnika wypełnienia wymaga ponownego uruchomienia aparatu bazy danych.

Po uruchomieniu RECONFIGURE opcji konfiguracji można sprawdzić, czy opcja została zaktualizowana dynamicznie, wykonując polecenie sp_configure '<configname>'. Wartości w kolumnach run_value i config_value powinny być zgodne z opcją dynamicznej aktualizacji. Możesz również sprawdzić, które opcje są dynamiczne, przeglądając kolumnę is_dynamicsys.configurations widoku wykazu.

Zmiana jest również zapisywana w dzienniku błędów programu SQL Server.

Jeśli określona @configvalue jest zbyt wysoka dla opcji, run_value kolumna odzwierciedla fakt, że aparat bazy danych domyślnie używa pamięci dynamicznej, zamiast używać ustawienia, które nie jest prawidłowe.

Aby uzyskać więcej informacji, zobacz RECONFIGURE.

Opcje zaawansowane

Niektóre opcje konfiguracji, takie jak maska koligacji i interwał odzyskiwania, są wyznaczone jako opcje zaawansowane. Domyślnie te opcje nie są dostępne do wyświetlania i zmieniania. Aby udostępnić je, ustaw opcję pokaż opcje zaawansowane na 1wartość .

Ostrzeżenie

Gdy opcja pokaż opcje zaawansowane jest ustawiona na 1, to ustawienie dotyczy wszystkich użytkowników. Zaleca się używanie tego stanu tylko tymczasowo i przełączenie się z powrotem do 0 zadania, do którego wymagane jest wyświetlenie opcji zaawansowanych.

Aby uzyskać więcej informacji na temat opcji konfiguracji i ich ustawień, zobacz Opcje konfiguracji serwera.

Permissions

Wykonywanie uprawnień bez sp_configure parametrów lub tylko pierwszy parametr jest domyślnie udzielany wszystkim użytkownikom. Aby wykonać sp_configure przy użyciu obu parametrów, aby zmienić opcję konfiguracji lub uruchomić instrukcję RECONFIGURE , musisz przyznać ALTER SETTINGS uprawnienie na poziomie serwera. Uprawnienie ALTER SETTINGS jest niejawnie przechowywane przez administrator systemu i administrator serwera stałe role serwera.

Przykłady

A. Wyświetlanie listy zaawansowanych opcji konfiguracji

W poniższym przykładzie pokazano, jak ustawić i wyświetlić listę wszystkich opcji konfiguracji. Zaawansowane opcje konfiguracji można wyświetlić, ustawiając najpierw wartość show advanced options1. Po zmianie tej opcji można wyświetlić wszystkie opcje konfiguracji, wykonując bez sp_configure parametrów.

USE master;
GO

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

Oto zestaw wyników.

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

Uruchom RECONFIGURE polecenie i pokaż wszystkie opcje konfiguracji:

RECONFIGURE;

EXECUTE sp_configure;

B. Zmienianie opcji konfiguracji

W poniższym przykładzie ustawiono opcję konfiguracji systemu recovery interval na 3 minuty.

USE master;
GO

EXECUTE sp_configure 'recovery interval', '3';

RECONFIGURE WITH OVERRIDE;

Przykłady: Analytics Platform System (PDW)

C. Wyświetlanie listy wszystkich dostępnych ustawień konfiguracji

W poniższym przykładzie pokazano, jak wyświetlić listę wszystkich opcji konfiguracji.

EXECUTE sp_configure;

Wynik zwraca nazwę opcji, po której następuje minimalna i maksymalna wartość opcji. Jest config_value to wartość używana przez usługę Azure Synapse Analytics podczas ponownej konfiguracji. Jest run_value to wartość, która jest obecnie używana. Wartości config_value i run_value są zwykle takie same, chyba że wartość jest w trakcie zmiany.

D. Wyświetlanie listy ustawień konfiguracji dla jednej nazwy konfiguracji

EXECUTE sp_configure @configname = 'hadoop connectivity';

E. Ustawianie łączności z usługą Hadoop

Ustawienie łączności z usługą Hadoop wymaga jeszcze kilku kroków oprócz uruchamiania programu sp_configure. Aby uzyskać pełną procedurę, zobacz CREATE EXTERNAL DATA SOURCE (TWORZENIE ZEWNĘTRZNEGO ŹRÓDŁA DANYCH).

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

Treści powiązane

  • Last updated on