Konfigurowanie parametrów serwera w usłudze Azure Database for PostgreSQL — serwer elastyczny

DOTYCZY: Azure Database for PostgreSQL — serwer elastyczny

Możesz wyświetlić, wyświetlić i zaktualizować parametry konfiguracji dla wystąpienia serwera elastycznego usługi Azure Database for PostgreSQL.

Dostosowywanie parametrów

Różne metody i poziomy są dostępne do dostosowywania parametrów zgodnie z konkretnymi potrzebami.

Poziom globalny

Aby wyświetlić bieżące skonfigurowane wartości parametrów serwera lub zmienić je globalnie na poziomie wystąpienia lub serwera, możesz użyć strony Parametry serwera w witrynie Azure Portal. Parametry serwera można również wchodzić w interakcje globalnie przy użyciu interfejsu wiersza polecenia, interfejsu API REST, szablonów usługi Azure Resource Manager lub narzędzi IaC innych firm.

Uwaga

Ponieważ usługa Azure Database for PostgreSQL jest zarządzaną usługą bazy danych, użytkownicy nie mają dostępu do hosta ani systemu operacyjnego, aby wyświetlić lub zmodyfikować pliki konfiguracji, takie jak postgresql.conf. Zawartość plików jest automatycznie aktualizowana w oparciu o wprowadzone zmiany parametrów.

W tym samym artykule można znaleźć sekcje umożliwiające interakcję z parametrami serwera globalnie w celu:

• Wyświetl listę wszystkich parametrów serwera.
• Wyświetlanie listy parametrów serwera z zmodyfikowanymi wartościami domyślnymi.
• Wyświetlanie listy parametrów statycznego serwera do odczytu i zapisu.
• Wyświetl listę parametrów serwera dynamicznego odczytu i zapisu.
• Wyświetlanie listy parametrów serwera tylko do odczytu.
• Ustaw wartość co najmniej jednego parametru serwera.
• Przywróć domyślny parametr jednego serwera.
• Przywróć wartości domyślne wszystkich parametrów serwera.

Poziomy szczegółowe

Parametry można dostosować na bardziej szczegółowych poziomach. Te korekty zastępują globalnie ustawione wartości. Ich zakres i czas trwania zależą od poziomu, na którym je ustawisz:

• Poziom bazy danych: użyj ALTER DATABASE polecenia dla konfiguracji specyficznych dla bazy danych.

• Poziom roli lub użytkownika: użyj ALTER USER polecenia dla ustawień skoncentrowanych na użytkowniku.

• Funkcja, poziom procedury: podczas definiowania funkcji lub procedury można określić lub zmienić parametry konfiguracji używane podczas wywoływanej funkcji.

• Poziom tabeli: na przykład można modyfikować parametry związane z automatycznym czyszczeniem na tym poziomie.

• Poziom sesji: dla okresu życia pojedynczej sesji bazy danych można dostosować określone parametry. Baza danych PostgreSQL ułatwia to dostosowanie za pomocą następujących poleceń SQL:

  • Użyj polecenia , SET aby wprowadzić korekty specyficzne dla sesji. Te zmiany służą jako ustawienia domyślne podczas bieżącej sesji. Dostęp do tych zmian może wymagać określonych SET uprawnień, a ograniczenia dotyczące parametrów modyfikowalnych i tylko do odczytu opisanych wcześniej nie mają zastosowania. Odpowiadająca mu funkcja SQL to set_config(setting_name, new_value, is_local).
  • Użyj polecenia , SHOW aby sprawdzić istniejące ustawienia parametrów. Jej odpowiednik funkcji SQL to current_setting(setting_name text).

Wyświetlanie listy wszystkich parametrów serwera

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. W menu zasobów w sekcji Ustawienia wybierz pozycję Parametry serwera. Na stronie przedstawiono listę parametrów, ich skonfigurowane wartości, opcjonalne jednostki, niezależnie od tego, czy są one tylko do odczytu/dynamiczne/statyczne, oraz ich opisy.

   

3. Wybierz lub umieść kursor na ikonie i (informacje), aby wyświetlić dozwolone wartości, na które można ustawić każdy parametr. W zależności od typu danych parametru, który może być ciągiem, wyliczeniem, liczbą całkowitą, wartością logiczną, liczbową, zestawem dozwolonych wartości. Może to być wyrażenie regularne, lista wartości, zakres liczb całkowitych, włączone/wyłączone, zakres dziesiętnych, lista wartości, odpowiednio.

   

4. Lista parametrów serwera obsługiwanych przez wystąpienie składa się z kilkuset elementów renderowanych na stronach 20 elementów. W dolnej części strony znajduje się kontrolka informująca o pozycji, w której się znajdujesz. Istnieje również kontrolka stronicowania, której można użyć do nawigowania po całym zestawie stron.

   

5. W razie potrzeby użyj pola tekstowego Wyszukaj, aby filtrować elementy... w celu zawężenia listy do tych parametrów zawierających termin wyszukiwania w nazwie lub w opisie.

   

Kolumna Typ parametru może zawierać dowolną z następujących wartości dla każdego parametru:

Typ parametru	opis
Static	Wymaga ponownego uruchomienia serwera, aby wprowadzić zmianę obowiązującą.
Dynamic	Można zmienić bez konieczności ponownego uruchamiania wystąpienia serwera. Jednak zmiany będą stosowane tylko do nowych połączeń ustanowionych po modyfikacji.
Tylko odczyt	Nie można konfigurować użytkownika ze względu na ich krytyczną rolę w utrzymaniu niezawodności, zabezpieczeń lub innych aspektów operacyjnych usługi.

Interfejs wiersza polecenia

Wszystkie parametry serwera można wyświetlić na serwerze za pomocą polecenia az postgres flexible-server parameter list .

az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server>

Każdy parametr ma następujące atrybuty:

Attribute name	opis	Możliwe wartości
allowedValues	Opisuje wartości, które są dozwolone dla parametru.	W zależności od wartości dataType może być wyrażeniem regularnym (ciągiem), listą wartości (wyliczenie), zakresem liczb całkowitych (liczba całkowita), włączonym/wyłączonym (logicznym), zakresem dziesiętnych (liczbowych), listą wartości (zestaw).
Datatype	Typ danych używanych dla parametru.	Może to być dowolny z boolean, enumeration, integer, numeric, set, string.
defaultValue	Wartość przypisana do parametru podczas wdrażania nowego serwera.	Różni się w zależności od typu danych i dozwolonych wartości parametru.
opis	Krótkie wyjaśnienie tego, co kontrolki parametrów.	Opis tekstowy, który jest inny dla każdego parametru.
documentationLink	Adres URL strony wskazującej dokumentację parametru.	Pewna forma adresu URL.
id	Identyfikator zasobu, który jednoznacznie odwołuje się do parametru serwera w tym konkretnym wystąpieniu serwera elastycznego.	Ciąg zgodny ze wzorcem /subscriptions/<subscription_identifier>/resourceGroups/<resource_group_name>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server_name>/configurations/<parameter_name>.
isConfigPendingRestart	Wskazuje, czy ponowne uruchomienie serwera jest wymagane, aby wartość aktualnie ustawiona w atrybucie value zaczęły obowiązywać.	true: dla parametrów, których wartość została zmieniona i, ponieważ nie są one dynamiczne (czyli statyczne), wymagają ponownego uruchomienia serwera, aby zmiany zaczęły obowiązywać. false: dla parametrów, których wartość obecnie ustawiona w atrybucie value jest w mocy i nie oczekuje na ponowne uruchomienie serwera, aby zaczęły obowiązywać.
isDynamicConfig	Wskazuje, czy zmiana wartości przypisanej do parametru nie wymaga lub wymaga ponownego uruchomienia serwera, aby zmiana została w życie.	true: w przypadku parametrów, które gdy ich wartość ulegnie zmianie, zmiana zostanie w życie natychmiast. false: w przypadku parametrów, które po zmianie ich wartości wymagają ponownego uruchomienia serwera, aby zmiany zaczęły obowiązywać.
isReadOnly	Wskazuje, czy wartość domyślna przypisana dla parametru może lub nie może zostać zastąpiona przez użytkownika.	true: dla parametrów wyznaczonych jako tylko do odczytu i użytkownik nie może zmienić. false: w przypadku parametrów wyznaczonych jako odczyt-zapis i użytkownik może ustawić inną wartość niż domyślna.
name	Nazwa parametru.	Dowolna prawidłowa nazwa parametru serwera.
resourceGroup	Nazwa grupy zasobów, w której wdrożono serwer.	Dowolna prawidłowa nazwa grupy zasobów na platformie Azure.
source	Źródło, z którego pochodzi obecnie ustawiona wartość parametru.	system-default lub user-override, w zależności od tego, czy wartość jest ustawiona na wartość domyślną systemu, czy też użytkownik go zastąpi.
jednostka	Opcjonalny tekst opisujący jednostki, w których wyrażono parametr.	W przypadku ustawienia elementu może to być dowolny element 8KB, , bytesmicrosecondsKBdaysmillisecondsminutesmegabytes, , . secondspercentage
wartość	Wartość obecnie przypisana do parametru.	Różni się w zależności od typu danych i dozwolonych wartości parametru.

Wyświetlanie listy parametrów serwera z zmodyfikowanymi wartościami domyślnymi

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. W menu zasobów w sekcji Ustawienia wybierz pozycję Parametry serwera, a następnie wybierz kartę Zmodyfikowane . Na stronie zostanie wyświetlona lista parametrów, których obecnie ustawiona wartość odbiega od wartości domyślnej.

   

Interfejs wiersza polecenia

Możesz wyświetlić listę wszystkich parametrów serwera, których wartości są modyfikowane z wartości domyślnych, za pomocą polecenia az postgres flexible-server parameter list .

az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?value!=defaultValue && isReadOnly==\`false\` && name!='temp_tablespaces' && name!='vacuum_cost_page_miss'] | [].name"

Uwaga

Poprzednie polecenie interfejsu wiersza polecenia nie uwzględnia zmodyfikowanych parametrów serwera, które są wyznaczone jako tylko do odczytu, temp_tablespaces i vacuum_cost_page_miss, zgodnie z dokładnie tymi samymi kryteriami co strona Parametry serwera w witrynie Azure Portal.

Wyświetlanie listy parametrów statycznego serwera do odczytu i zapisu

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. W menu zasobów w sekcji Ustawienia wybierz pozycję Parametry serwera, a następnie wybierz kartę Statyczne . Na stronie zostanie wyświetlona lista parametrów odczytu i zapisu, dla których, jeśli ich wartość zostanie zmieniona, wymagane jest ponowne uruchomienie serwera, aby nowa wartość została w życie.

   

Interfejs wiersza polecenia

Możesz wyświetlić listę wszystkich parametrów serwera, które wymagają ponownego uruchomienia po zmianie ich wartości, aby zmiany zaczęły obowiązywać za pomocą polecenia az postgres flexible-server parameter list .

az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?isDynamicConfig==\`false\` && isReadOnly==\`false\`] | [].name"

Wyświetlanie listy parametrów serwera dynamicznego odczytu i zapisu

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. W menu zasobów w sekcji Ustawienia wybierz pozycję Parametry serwera, a następnie wybierz kartę Dynamiczne . Na stronie zostanie wyświetlona lista parametrów odczytu i zapisu, dla których, jeśli ich wartość zostanie zmieniona, wymagane jest ponowne uruchomienie serwera, aby nowa wartość została w życie.

   

Interfejs wiersza polecenia

Możesz wyświetlić listę wszystkich parametrów serwera, które nie wymagają ponownego uruchomienia po zmianie ich wartości, aby zmiany zaczęły obowiązywać, za pomocą polecenia az postgres flexible-server parameter list .

az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?isDynamicConfig==\`true\` && isReadOnly==\`false\`] | [].name"

Wyświetlanie listy parametrów serwera tylko do odczytu

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. W menu zasobów w sekcji Ustawienia wybierz pozycję Parametry serwera, a następnie wybierz kartę Tylko do odczytu. Na stronie zostanie wyświetlona lista parametrów tylko do odczytu.

   

Interfejs wiersza polecenia

Można wyświetlić listę wszystkich parametrów serwera wyznaczonych jako tylko do odczytu, których wartości nie można zmienić przez użytkowników, za pomocą polecenia az postgres flexible-server parameter list .

az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?isReadOnly==\`true\`] | [].name"

Ustawianie wartości co najmniej jednego parametru serwera

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. W menu zasobów w sekcji Ustawienia wybierz pozycję Parametry serwera.

3. Znajdź parametry odczytu i zapisu, których bieżące wartości chcesz zmienić, ustaw je na nowe żądane wartości, zwróć uwagę, że komunikat informacyjny wskazuje, ile zmian parametrów serwera nie zostało jeszcze zapisanych, a następnie wybierz pozycję Zapisz.

   

4. Jeśli typ parametru kolumny dla któregokolwiek ze zmienionych parametrów jest równy Statyczny, serwer wymaga ponownego uruchomienia, aby zmiany zaczęły obowiązywać. W takim przypadku zostanie wyświetlone okno dialogowe, aby wybrać, czy chcesz:

   • Zapisz i uruchom ponownie: jeśli chcesz utrwalić wszystkie zmiany wprowadzone we wszystkich parametrach, których wartości zostały zmodyfikowane, i natychmiast po ponownym uruchomieniu serwera, aby wszelkie zmiany parametrów statycznych zaczęły obowiązywać.
   • Zapisz tylko: w przypadku, gdy chcesz zachować wszystkie zmiany wprowadzone we wszystkich parametrach, których ustawione wartości uległy zmianie, ale chcesz odroczyć ponowne uruchomienie serwera do późniejszego czasu. Dopóki nie ukończysz akcji ponownego uruchomienia serwera, zmiany wprowadzone w żadnych parametrach serwera statycznego nie zostaną zastosowane.
   • Anuluj: Aby jeszcze nie implementować żadnych zmian.

   

Interfejs wiersza polecenia

Wartość parametru serwera można ustawić za pomocą polecenia az postgres flexible-server parameter set .

az postgres flexible-server parameter set --resource-group <resource_group> --server-name <server> --source user-override --name <parameter> --value <value>

Można również użyć następującego skryptu, aby warunkowo ponownie uruchomić serwer, jeśli którykolwiek ze zmienionych parametrów wymaga ponownego uruchomienia zmiany, aby zmiany zaczęły obowiązywać:

parameters_requiring_restart=$(az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?isConfigPendingRestart==\`true\`] | length(@)")

if [ "$parameters_requiring_restart" -gt 0 ]; then
  az postgres flexible-server restart --resource-group <resource_group> --name <server>
fi

Przywróć domyślny parametr jednego serwera

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. W menu zasobów w sekcji Ustawienia wybierz pozycję Parametry serwera.

3. Znajdź parametr read-write, którego bieżąca wartość ma zostać przywrócona do wartości domyślnej, wybierz wielokropek po prawej stronie scree, a następnie wybierz pozycję Resetuj do wartości domyślnej.

   

Ważne

W przypadku parametrów wyznaczonych jako tylko do odczytu wybranie wielokropka nie powoduje wyskakującego opcji menu Resetuj do domyślnego menu.

4. Jeśli kolumna Typ parametru dla parametru, który próbujesz zresetować do wartości domyślnej, jest równa statycznej, serwer wymaga ponownego uruchomienia, aby zmiana weszła w życie. W takim przypadku zostanie wyświetlone okno dialogowe, aby wybrać, czy chcesz:

   • Zapisz i uruchom ponownie: jeśli chcesz utrwalić wszystkie zmiany wprowadzone we wszystkich parametrach, których wartości zostały zmodyfikowane, i natychmiast po ponownym uruchomieniu serwera, aby wszelkie zmiany parametrów statycznych zaczęły obowiązywać.
   • Zapisz tylko: w przypadku, gdy chcesz zachować wszystkie zmiany wprowadzone we wszystkich parametrach, których ustawione wartości uległy zmianie, ale chcesz odroczyć ponowne uruchomienie serwera do późniejszego czasu. Dopóki nie ukończysz akcji ponownego uruchomienia serwera, zmiany wprowadzone w żadnych parametrach serwera statycznego nie zostaną zastosowane.
   • Anuluj: Aby jeszcze nie implementować żadnych zmian.

   

Interfejs wiersza polecenia

Wartość parametru serwera można przywrócić domyślnie za pomocą polecenia az postgres flexible-server parameter set .

az postgres flexible-server parameter set --resource-group <resource_group> --server-name <server> --source user-override --name <parameter> --value $(az postgres flexible-server parameter show --resource-group <resource_group> --server-name <server> --name <parameter> --output tsv) 

Możesz również użyć następującego skryptu, aby warunkowo ponownie uruchomić serwer, jeśli zmieniono parametr wymaga ponownego uruchomienia zmiany, aby zmiany zaczęły obowiązywać:

parameters_requiring_restart=$(az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?isConfigPendingRestart==\`true\`] | length(@)")

if [ "$parameters_requiring_restart" -gt 0 ]; then
  az postgres flexible-server restart --resource-group <resource_group> --name <server>
fi

Przywróć wartości domyślne wszystkich parametrów serwera

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. W menu zasobów w sekcji Ustawienia wybierz pozycję Parametry serwera.

3. Wybierz pozycję Resetuj wszystko domyślnie.

   

4. Jeśli w przypadku któregokolwiek z parametrów, których bieżąca wartość nie jest zgodna z ich wartością domyślną, typ parametru jest równy Statyczny, serwer wymaga ponownego uruchomienia zmiany, aby zmiany zaczęły obowiązywać. W takim przypadku zostanie wyświetlone okno dialogowe, aby wybrać, czy chcesz:

   • Zapisz i uruchom ponownie: jeśli chcesz utrwalić wszystkie zmiany wprowadzone we wszystkich parametrach, których wartości zostały zmodyfikowane, i natychmiast po ponownym uruchomieniu serwera, aby wszelkie zmiany parametrów statycznych zaczęły obowiązywać.
   • Zapisz tylko: w przypadku, gdy chcesz zachować wszystkie zmiany wprowadzone we wszystkich parametrach, których ustawione wartości uległy zmianie, ale chcesz odroczyć ponowne uruchomienie serwera do późniejszego czasu. Dopóki nie ukończysz akcji ponownego uruchomienia serwera, zmiany wprowadzone w żadnych parametrach serwera statycznego nie zostaną zastosowane.
   • Anuluj: Aby jeszcze nie implementować żadnych zmian.

   

Interfejs wiersza polecenia

Wartość wszystkich parametrów serwera odczytu i zapisu można przywrócić do ich wartości domyślnych za pomocą polecenia az postgres flexible-server parameter set .

parameters_to_reset=$(az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?value!=defaultValue && isReadOnly==\`false\`].name" -o tsv)
for parameter_to_reset in $parameters_to_reset; do
  az postgres flexible-server parameter set --resource-group <resource_group> --server-name <server> --name $parameter_to_reset --value $(az postgres flexible-server parameter show --resource-group <resource_group> --server-name <server> --name $parameter_to_reset --output tsv)
done

Możesz również użyć następującego skryptu, aby warunkowo ponownie uruchomić serwer, jeśli którykolwiek ze zmienionych parametrów wymaga ponownego uruchomienia zmiany, aby zmiany zaczęły obowiązywać:

parameters_requiring_restart=$(az postgres flexible-server parameter list --resource-group <resource_group> --server-name <server> --query "[?isConfigPendingRestart==\`true\`] | length(@)")

if [ "$parameters_requiring_restart" -gt 0 ]; then
  az postgres flexible-server restart --resource-group <resource_group> --name <server>
fi

Praca z parametrami strefy czasowej

Jeśli planujesz pracować z danymi daty i godziny w usłudze PostgreSQL, upewnij się, że ustawiono prawidłową strefę czasową dla swojej lokalizacji. Wszystkie daty i godziny obsługujące strefę czasową są przechowywane wewnętrznie w usłudze PostgreSQL w formacie UTC. Są one konwertowane na czas lokalny w strefie określonej przez parametr serwera TimeZone przed wyświetleniem do klienta. Ten parametr można edytować na stronie Parametry serwera. Usługa PostgreSQL umożliwia określenie stref czasowych w trzech różnych formach:

• Pełna nazwa strefy czasowej, na przykład Ameryka/New_York. Nazwy rozpoznanych stref czasowych są wyświetlane w widoku pg_timezone_names.
  Przykład wykonywania zapytań dotyczących tego widoku w narzędziu psql i uzyskiwania listy nazw stref czasowych:

  select name FROM pg_timezone_names LIMIT 20;

  Powinien zostać wyświetlony zestaw wyników, taki jak:

            name
        -----------------------
        GMT0
        Iceland
        Factory
        NZ-CHAT
        America/Panama
        America/Fort_Nelson
        America/Pangnirtung
        America/Belem
        America/Coral_Harbour
        America/Guayaquil
        America/Marigot
        America/Barbados
        America/Porto_Velho
        America/Bogota
        America/Menominee
        America/Martinique
        America/Asuncion
        America/Toronto
        America/Tortola
        America/Managua
        (20 rows)
    

• Skrót strefy czasowej, na przykład PST. Taka specyfikacja definiuje jedynie określone przesunięcie od UTC, w przeciwieństwie do nazw stref pełnoetatowych, co może oznaczać również zestaw reguł daty przejścia na czas letni. Rozpoznane skróty są wymienione w widoku pg_timezone_abbrevs Przykład, aby wykonywać zapytania dotyczące tego widoku w narzędziu psql i uzyskać listę skrótów strefy czasowej:

   select abbrev from pg_timezone_abbrevs limit 20;

  Powinien zostać wyświetlony zestaw wyników, taki jak:

        abbrev|
        ------+
        ACDT  |
        ACSST |
        ACST  |
        ACT   |
        ACWST |
        ADT   |
        AEDT  |
        AESST |
        AEST  |
        AFT   |
        AKDT  |
        AKST  |
        ALMST |
        ALMT  |
        AMST  |
        AMT   |
        ANAST |
        ANAT  |
        ARST  |
        ART   |
    

• Oprócz nazw i skrótów strefy czasowej, PostgreSQL akceptuje specyfikacje strefy czasowej w stylu POSIX formularza STDoffset lub STDoffsetDST, gdzie STD jest skrótem strefy, przesunięcie jest przesunięciem liczbowym w godzinach zachodnich od UTC, a DST jest opcjonalnym skrótem strefy oszczędności światła dziennego, zakłada się, że stać przez jedną godzinę przed danym przesunięciem.

Podziel się swoimi sugestiami i usterkami z zespołem produktu usługi Azure Database for PostgreSQL.

Powiązana zawartość

• omówienie parametrów serwera