Konfigurace parametrů serveru na flexibilním serveru Azure Database for PostgreSQL

PLATÍ PRO: Flexibilní server Azure Database for PostgreSQL

Můžete zobrazit, zobrazit a aktualizovat parametry konfigurace pro instanci flexibilního serveru Azure Database for PostgreSQL.

Přizpůsobení parametru

Různé metody a úrovně jsou k dispozici pro přizpůsobení parametrů podle vašich konkrétních potřeb.

Globální úroveň

Pokud chcete zobrazit aktuální nakonfigurované hodnoty parametrů serveru nebo je globálně změnit na úrovni instance nebo serveru, můžete použít stránku Parametry serveru na webu Azure Portal. S parametry serveru můžete interagovat globálně také pomocí rozhraní příkazového řádku, rozhraní REST API, šablon Azure Resource Manageru nebo nástrojů IaC třetích stran.

Poznámka:

Vzhledem k tomu, že Azure Database for PostgreSQL je spravovaná databázová služba, nemají uživatelé přístup k hostiteli nebo operačnímu systému, aby mohli zobrazovat nebo upravovat konfigurační soubory, jako je postgresql.conf. Obsah souborů se automaticky aktualizuje na základě provedených změn parametrů.

V tomto stejném článku najdete oddíly pro globální interakci s parametry serveru pro:

• Zobrazí seznam všech parametrů serveru.
• Zobrazí seznam parametrů serveru s upravenými výchozími hodnotami.
• Výpis parametrů statického serveru pro čtení i zápis
• Zobrazení seznamu dynamických parametrů serveru pro čtení i zápis
• Zobrazení seznamu parametrů serveru jen pro čtení
• Nastavte hodnotu jednoho nebo více parametrů serveru.
• Vraťte jeden parametr serveru na výchozí hodnotu.
• Vraťte všechny parametry serveru na výchozí hodnoty.

Podrobné úrovně

Parametry můžete upravit na podrobnějších úrovních. Tyto úpravy přepisují globálně nastavené hodnoty. Jejich rozsah a doba trvání závisí na úrovni, na které je uděláte:

• Úroveň databáze: Použijte ALTER DATABASE příkaz pro konfigurace specifické pro databáze.

• Role nebo úroveň uživatele: Použijte ALTER USER příkaz pro nastavení zaměřená na uživatele.

• Úroveň procedury: Při definování funkce nebo procedury můžete zadat nebo změnit parametry konfigurace, které se použijí při volání funkce.

• Úroveň tabulky: Jako příklad můžete upravit parametry související s automatickým úklidem na této úrovni.

• Úroveň relace: Pro životnost jednotlivých databázových relací můžete upravit konkrétní parametry. PostgreSQL tuto úpravu usnadňuje pomocí následujících příkazů SQL:

  • SET Pomocí příkazu proveďte úpravy specifické pro relaci. Tyto změny slouží jako výchozí nastavení během aktuální relace. Přístup k těmto změnám může vyžadovat určitá SET oprávnění a omezení pro upravitelné a dříve popsané parametry jen pro čtení se nevztahují. Odpovídající funkce SQL je set_config(setting_name, new_value, is_local).
  • SHOW Pomocí příkazu můžete prozkoumat existující nastavení parametrů. Její ekvivalent funkce SQL je current_setting(setting_name text).

Výpis všech parametrů serveru

Azure Portal

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Nastavení vyberte Parametry serveru. Na stránce se zobrazí seznam parametrů, jejich nakonfigurované hodnoty, volitelné jednotky, jestli jsou jen pro čtení, dynamické nebo statické a jejich popisy.

   

3. Výběrem ikony i (informace) nebo najetím myší zobrazíte povolené hodnoty, na které lze nastavit jednotlivé parametry. V závislosti na datovém typu parametru, který může být řetězec, výčet, celé číslo, logická hodnota, číselná sada, povolené hodnoty se liší. A může to být regulární výraz, seznam hodnot, rozsah celých čísel, zapnuto/vypnuto, rozsah desetinných míst, seznam hodnot v uvedeném pořadí.

   

4. Seznam parametrů serveru podporovaných instancí se skládá z několika stovek položek, které se vykreslují na stránkách 20 položek. V dolní části stránky je ovládací prvek, který vás informuje o pozici, ve které jste. K dispozici je také ovládací prvek stránkování, pomocí kterého můžete procházet celou sadu stránek.

   

5. V případě potřeby pomocí textového pole Hledat vyfiltrujte položky... tím seznam zúžíte na parametry obsahující hledaný termín v jejich názvu nebo v popisu.

   

Sloupec Typ parametru může pro každý parametr zobrazit některou z následujících hodnot:

Typ parametru	Popis
staticky.	Vyžaduje restartování serveru, aby se změna projevila.
dynamicky,	Lze změnit bez nutnosti restartovat instanci serveru. Změny však budou platit pouze pro nová připojení vytvořená po úpravě.
Jen pro čtení	Není možné konfigurovat uživatele, protože má zásadní roli při zachování spolehlivosti, zabezpečení nebo jiných provozních aspektů služby.

Rozhraní příkazového řádku

Všechny parametry serveru na serveru můžete vypsat pomocí příkazu az postgres flexible-server parameter list list .

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

Každý parametr má následující atributy:

Attribute name	Popis	Možné hodnoty
allowedValues	Popisuje hodnoty, které jsou pro parametr povoleny.	V závislosti na hodnotě dataType může být regulární výraz (řetězec), seznam hodnot (výčet), rozsah celých čísel (celé číslo), zapnuto/vypnuto (boolean), rozsah desetinných míst (číselný), seznam hodnot (set).
Datatype	Typ dat použitých pro parametr	Může být libovolná z boolean, , enumeration, integernumeric, set, , , string.
defaultValue	Hodnota přiřazená parametru při nasazení nového serveru	Liší se v závislosti na datovém typu a povolených hodnotách parametru.
popis	Stručné vysvětlení toho, co ovládací prvky parametrů	Textový popis, který se pro každý parametr liší.
documentationLink	Adresa URL stránky odkazující na dokumentaci parametru	Nějaká forma adresy URL.
id	Identifikátor prostředku, který jednoznačně odkazuje na parametr serveru v této konkrétní instanci flexibilního serveru.	Řetězec, který následuje za vzorem /subscriptions/<subscription_identifier>/resourceGroups/<resource_group_name>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server_name>/configurations/<parameter_name>.
isConfigPendingRestart	Určuje, zda je pro hodnotu aktuálně nastavenou v atributu value vyžadováno restartování serveru.	true: pro parametry, jejichž hodnota byla změněna, a protože nejsou dynamické (tj. statické), vyžadují restartování serveru, aby se změna projevila. false: pro parametry, jejichž hodnota je aktuálně nastavena v atributu value , a nečeká na restartování serveru.
isDynamicConfig	Určuje, jestli změna hodnoty přiřazené parametru nevyžaduje nebo vyžaduje restartování serveru, aby se změna projevila.	true: u parametrů, které se při změně jejich hodnoty projeví okamžitě. false: Pro parametry, které, když se jejich hodnota změní, vyžadují restartování serveru, aby se změna projevila.
isReadOnly	Určuje, jestli uživatel může nebo nemůže přepsat výchozí hodnotu přiřazenou parametru.	true: pro parametry, které jsou určeny jen pro čtení a uživatel nemůže změnit. false: pro parametry, které jsou určeny jako čtení a zápis, a uživatel může nastavit jinou hodnotu než výchozí.
Jméno	Název parametru.	Libovolný platný název parametru serveru.
resourceGroup	Název skupiny prostředků, ve které je server nasazen.	Libovolný platný název skupiny prostředků v Azure
source	Zdroj, ze kterého pochází hodnota aktuálně nastavená pro parametr.	system-default nebo user-override, v závislosti na tom, zda je hodnota nastavena na výchozí systém nebo uživatel přepsat.
jednotka	Volitelný text popisující jednotky, ve kterých je parametr vyjádřen.	Když něco nastavíte, může to být libovolná z 8KB, , daysbytes, KB, megabytes, microseconds, milliseconds, , minutes, , percentage, . seconds
value	Hodnota, která je aktuálně přiřazena k parametru	Liší se v závislosti na datovém typu a povolených hodnotách parametru.

Výpis parametrů serveru s upravenými výchozími hodnotami

Azure Portal

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Nastavení vyberte Parametry serveru a pak vyberte kartu Změněno . Na stránce se zobrazí seznam parametrů, jejichž aktuálně nastavená hodnota se liší od výchozího nastavení.

   

Rozhraní příkazového řádku

Pomocí příkazu az postgres flexible-server parameter list list můžete zobrazit seznam všech parametrů serveru, jejichž hodnoty se mění z výchozích hodnot.

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"

Poznámka:

Předchozí příkaz rozhraní příkazového řádku nebere v úvahu upravené parametry serveru, které jsou určené jen pro čtení, temp_tablespaces a vacuum_cost_page_missza stejnými kritérii jako na stránce Parametry serveru na webu Azure Portal.

Výpis parametrů statického serveru pro čtení i zápis

Azure Portal

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Nastavení vyberte Parametry serveru a pak vyberte kartu Statická . Na stránce se zobrazí seznam parametrů pro čtení i zápis, pro které v případě změny jejich hodnoty bude nutné restartovat server, aby se nová hodnota projevila.

   

Rozhraní příkazového řádku

Pomocí příkazu az postgres flexible-server parameter list můžete zobrazit seznam všech parametrů serveru, které po změně jejich hodnot vyžadují restartování, aby se změny projevily.

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

Výpis parametrů dynamického serveru pro čtení i zápis

Azure Portal

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Nastavení vyberte Parametry serveru a pak vyberte dynamickou kartu. Na stránce se zobrazí seznam parametrů pro čtení i zápis, pro které v případě změny jejich hodnoty bude nutné restartovat server, aby se nová hodnota projevila.

   

Rozhraní příkazového řádku

Pomocí příkazu az postgres flexible-server parameter list můžete zobrazit seznam všech parametrů serveru, které nevyžadují restartování po změně jejich hodnot, aby se změny projevily.

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

Výpis parametrů serveru jen pro čtení

Azure Portal

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Nastavení vyberte Parametry serveru a pak vyberte kartu Jen pro čtení. Na stránce se zobrazí seznam parametrů jen pro čtení.

   

Rozhraní příkazového řádku

Pomocí příkazu az postgres flexible-server list list můžete zobrazit seznam všech parametrů serveru, které jsou určené jen pro čtení, jejichž hodnoty nelze změnit uživateli.

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

Nastavení hodnoty jednoho nebo více parametrů serveru

Azure Portal

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Nastavení vyberte Parametry serveru.

3. Vyhledejte parametry pro čtení i zápis, jejichž aktuální hodnoty chcete změnit, nastavte je na nové požadované hodnoty, všimněte si, že informační zpráva indikuje, kolik změn parametrů serveru se ještě neuloží, a vyberte Uložit.

   

4. Pokud je typ parametru sloupce pro některý ze změněných parametrů roven statickému, server vyžaduje restartování, aby se změny projevily. V takovém případě se zobrazí dialogové okno, abyste mohli vybrat, jestli chcete:

   • Uložit a Restartovat: V případě, že chcete zachovat všechny změny provedené u všech parametrů, jejichž hodnoty byly změněny, a okamžitě po restartování serveru, aby se projevily všechny změny statických parametrů.
   • Uložit pouze: V případě, že chcete zachovat všechny změny provedené u všech parametrů, jejichž nastavené hodnoty se změnily, ale chcete odložit restartování serveru na později. Dokud nedokončíte akci restartování serveru, neprojeví se změny parametrů statického serveru.
   • Zrušit: Chcete-li ještě neimplementovat žádné změny.

   

Rozhraní příkazového řádku

Hodnotu parametru serveru můžete nastavit pomocí příkazu 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>

K podmíněnému restartování serveru můžete použít následující skript, pokud některý ze změněných parametrů vyžaduje restartování, aby se změna projevila:

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

Vrácení jednoho parametru serveru na výchozí hodnotu

Azure Portal

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Nastavení vyberte Parametry serveru.

3. Vyhledejte parametr pro čtení i zápis, jehož aktuální hodnotu chcete vrátit k výchozímu nastavení, vyberte tři tečky na pravé straně výkreu a vyberte Obnovit výchozí hodnotu.

   

Důležité

U parametrů určených jako jen pro čtení se při výběru tří teček nezobrazí možnost Obnovit do výchozí nabídky.

4. Pokud je typ parametru sloupce pro parametr, který se pokoušíte obnovit do výchozího nastavení, roven statickému, vyžaduje server restartování, aby se změna projevila. V takovém případě se zobrazí dialogové okno, abyste mohli vybrat, jestli chcete:

   • Uložit a Restartovat: V případě, že chcete zachovat všechny změny provedené u všech parametrů, jejichž hodnoty byly změněny, a okamžitě po restartování serveru, aby se projevily všechny změny statických parametrů.
   • Uložit pouze: V případě, že chcete zachovat všechny změny provedené u všech parametrů, jejichž nastavené hodnoty se změnily, ale chcete odložit restartování serveru na později. Dokud nedokončíte akci restartování serveru, neprojeví se změny parametrů statického serveru.
   • Zrušit: Chcete-li ještě neimplementovat žádné změny.

   

Rozhraní příkazového řádku

Hodnotu parametru serveru můžete vrátit na výchozí hodnotu pomocí příkazu 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) 

K podmíněnému restartování serveru můžete použít následující skript, pokud změna parametru vyžaduje restartování, aby se změna projevila:

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

Vrácení všech parametrů serveru na výchozí hodnoty

Azure Portal

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Nastavení vyberte Parametry serveru.

3. Vyberte Obnovit vše do výchozího nastavení.

   

4. Pokud u některého z parametrů, jejichž aktuální hodnota neodpovídá jejich výchozí hodnotě, je typ parametru sloupce roven statickému, server vyžaduje restartování, aby se změna projevila. V takovém případě se zobrazí dialogové okno, abyste mohli vybrat, jestli chcete:

   • Uložit a Restartovat: V případě, že chcete zachovat všechny změny provedené u všech parametrů, jejichž hodnoty byly změněny, a okamžitě po restartování serveru, aby se projevily všechny změny statických parametrů.
   • Uložit pouze: V případě, že chcete zachovat všechny změny provedené u všech parametrů, jejichž nastavené hodnoty se změnily, ale chcete odložit restartování serveru na později. Dokud nedokončíte akci restartování serveru, neprojeví se změny parametrů statického serveru.
   • Zrušit: Chcete-li ještě neimplementovat žádné změny.

   

Rozhraní příkazového řádku

Hodnotu všech parametrů serveru pro čtení a zápis můžete vrátit zpět na výchozí hodnoty pomocí příkazu 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

Pokud některý ze změně parametrů vyžaduje, aby se změny projevily, můžete použít následující skript k podmíněnému restartování serveru:

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

Práce s parametry časového pásma

Pokud plánujete pracovat s daty data a času v PostgreSQL, ujistěte se, že jste pro své umístění nastavili správné časové pásmo. Všechna data a časy pracující s časovým pásmem se ukládají interně v PostgreSQL ve standardu UTC. Před zobrazením klienta se převedou na místní čas v zóně určené parametrem serveru TimeZone . Tento parametr lze upravit na stránce Parametry serveru. PostgreSQL umožňuje zadat časová pásma ve třech různých formách:

• Název úplného časového pásma, například Amerika/New_York. Rozpoznané názvy časových pásem jsou uvedeny v zobrazení pg_timezone_names.
  Příklad dotazu na toto zobrazení v psql a získání seznamu názvů časových pásem:

  select name FROM pg_timezone_names LIMIT 20;

  Měla by se zobrazit sada výsledků jako:

            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)
    

• Zkratka časového pásma, například PST. Tato specifikace pouze definuje určitý posun od času UTC, na rozdíl od názvů celých časových pásem, což může znamenat i sadu pravidel přechodu na letní čas. Rozpoznané zkratky jsou uvedeny v pg_timezone_abbrevs příkladu pro dotazování tohoto zobrazení v psql a získání seznamu zkratek časových pásem:

   select abbrev from pg_timezone_abbrevs limit 20;

  Měla by se zobrazit sada výsledků jako:

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

• Kromě názvů a zkratek časového pásma přijímá PostgreSQL specifikace časového pásma ve stylu POSIX formuláře STDoffset nebo STDoffsetDST, kde STD je zkratka zóny, posun je číselný posun v hodinách západ od UTC a DST je volitelná zkratka zóny letního času, která se předpokládá, že stojí před daným posunem po dobu jedné hodiny před daným posunem.

Sdílejte své návrhy a chyby s produktovým týmem Azure Database for PostgreSQL.

Související obsah

• přehled parametrů serveru