Konfigurera serverparametrar i Azure Database for PostgreSQL – flexibel server

GÄLLER FÖR: Azure Database for PostgreSQL – flexibel server

Du kan lista, visa och uppdatera konfigurationsparametrar för en flexibel Azure Database for PostgreSQL-serverinstans.

Parameteranpassning

Olika metoder och nivåer är tillgängliga för att anpassa parametrarna efter dina specifika behov.

Global nivå

Om du vill visa aktuella konfigurerade värden för serverparametrar eller ändra dem globalt på instans- eller servernivå kan du använda sidan Serverparametrar i Azure Portal. Du kan också interagera med serverparametrar globalt med hjälp av CLI, REST API, Azure Resource Manager-mallar eller IaC-verktyg från tredje part.

Kommentar

Eftersom Azure Database for PostgreSQL är en hanterad databastjänst har användarna inte åtkomst till värd- eller operativsystem för att visa eller ändra konfigurationsfiler som postgresql.conf. Innehållet i filerna uppdateras automatiskt baserat på de parameterändringar som du gör.

I samma artikel hittar du avsnitt som du kan interagera med serverparametrar globalt för att:

• Visa en lista över alla serverparametrar.
• Lista serverparametrar med ändrade standardvärden.
• Visa en lista över statiska serverparametrar för läs- och skrivåtgärder.
• Visa en lista över dynamiska serverparametrar för läs- och skrivåtgärder.
• Lista skrivskyddade serverparametrar.
• Ange värdet för en eller flera serverparametrar.
• Återställ en serverparameter till standardvärdet.
• Återställ alla serverparameter till standardvärdena.

Detaljerade nivåer

Du kan justera parametrar på mer detaljerade nivåer. Dessa justeringar åsidosätter globalt angivna värden. Deras omfång och varaktighet beror på vilken nivå du gör dem på:

• Databasnivå: Använd ALTER DATABASE kommandot för databasspecifika konfigurationer.

• Roll- eller användarnivå: Använd ALTER USER kommandot för användarcentrerade inställningar.

• Funktion, procedurnivå: När du definierar en funktion eller procedur kan du ange eller ändra de konfigurationsparametrar som används när funktionen anropas.

• Tabellnivå: Du kan till exempel ändra parametrar relaterade till autovacuum på den här nivån.

• Sessionsnivå: Under en enskild databassessions livslängd kan du justera specifika parametrar. PostgreSQL underlättar den här justeringen med följande SQL-kommandon:

  • SET Använd kommandot för att göra sessionsspecifika justeringar. Dessa ändringar fungerar som standardinställningar under den aktuella sessionen. Åtkomst till dessa ändringar kan kräva specifika SET privilegier och begränsningarna för ändringsbara och skrivskyddade parametrar som beskrivs tidigare gäller inte. Motsvarande SQL-funktion är set_config(setting_name, new_value, is_local).
  • SHOW Använd kommandot för att undersöka befintliga parameterinställningar. Dess SQL-funktionsekvivalent är current_setting(setting_name text).

Visa en lista över alla serverparametrar

Portal

Använd Azure Portal:

1. Välj din azure database for PostgreSQL– flexibel serverinstans.

2. I resursmenyn går du till avsnittet Inställningar och väljer Serverparametrar. Sidan visar en lista över parametrar, deras konfigurerade värden, valfria enheter, om de är skrivskyddade/dynamiska/statiska och deras beskrivningar.

   

3. Välj eller hovra över ikonen i (information) för att se de tillåtna värden som varje parameter kan anges till. Beroende på parameterns datatyp, som kan vara sträng, uppräkning, heltal, boolesk, numerisk, uppsättning, varierar de tillåtna värdena. Och det kan vara reguljärt uttryck, lista över värden, heltalsintervall, på/av, decimalintervall, lista med värden.

   

4. Listan över serverparametrar som stöds av instansen består av flera hundra objekt, som återges på sidor med 20 objekt vardera. Längst ned på sidan finns en kontroll som informerar dig om den position du befinner dig på. Det finns också en växlingskontroll som du kan använda för att navigera genom hela uppsättningen sidor.

   

5. Om det behövs använder du textrutan Sök för att filtrera objekt... för att begränsa listan till de parametrar som innehåller söktermen i deras namn eller i beskrivningen.

   

Kolumnen Parametertyp kan visa något av följande värden för varje parameter:

Parametertyp	beskrivning
Statiskt	Kräver en omstart av servern för att ändringen ska gälla.
Dynamiskt	Kan ändras utan att du behöver starta om serverinstansen. Ändringar gäller dock endast för nya anslutningar som upprättas efter ändringen.
Skrivskyddad	Är inte användarkonfigurerbar på grund av deras viktiga roll när det gäller att upprätthålla tillförlitlighet, säkerhet eller andra operativa aspekter av tjänsten.

CLI

Du kan lista alla serverparametrar i en server via kommandot az postgres flexible-server parameter list .

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

Varje parameter har följande attribut:

Attribute name	beskrivning	Möjliga värden
allowedValues	Beskriver de värden som tillåts för parametern.	Beroende på värdet för dataType kan det vara ett reguljärt uttryck (sträng), en lista med värden (uppräkning), ett heltalsintervall (heltal), på/av (booleskt), decimalintervall (numeriskt), en lista med värden (uppsättning).
Datatyp	Typ av data som används för parametern.	Kan vara någon av boolean, enumeration, integer, numeric, set, . string
defaultValue	Värde som tilldelas parametern när en ny server distribueras.	Varierar beroende på datatyp och tillåtna värden för parametern.
beskrivning	Kort förklaring av vad parametern styr.	Textbeskrivning som skiljer sig åt för varje parameter.
documentationLink	URL-adressen till sidan som pekar på dokumentationen för parametern.	Någon form av URL.
id	Resursidentifierare som unikt refererar till serverparametern i den här specifika instansen av flexibel server.	En sträng som följer mönstret /subscriptions/<subscription_identifier>/resourceGroups/<resource_group_name>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server_name>/configurations/<parameter_name>.
isConfigPendingRestart	Anger om en omstart av servern krävs för att värdet som för närvarande anges i värdeattributet ska börja gälla.	true: För parametrar vars värde har ändrats och, eftersom de inte är dynamiska (dvs. de är statiska), kräver en omstart av servern för att ändringen ska börja gälla. false: för parametrar vars värde som för närvarande anges i värdeattributet gäller och inte väntar på att en omstart av servern ska börja gälla.
isDynamicConfig	Anger om en ändring i värdet som tilldelats parametern inte kräver eller kräver en omstart av servern för att ändringen ska börja gälla.	true: för parametrar som när deras värde ändras börjar ändringen gälla omedelbart. false: för parametrar som när deras värde ändras kräver en omstart av servern för att ändringen ska börja gälla.
isReadOnly	Anger om standardvärdet som tilldelats för parametern kan eller inte kan åsidosättas av användaren.	true: för parametrar som är avsedda som skrivskyddade och användaren inte kan ändra. false: för parametrar som har angetts som skrivskyddade och användaren kan ange ett annat värde än standardvärdet.
Namn	Namn på parameter.	Valfritt giltigt namn för en serverparameter.
resourceGroup	Namnet på resursgruppen där servern distribueras.	Valfritt giltigt namn för en resursgrupp i Azure.
källa	Källa som värdet som för närvarande anges för parametern kommer från.	system-default eller user-override, beroende på om värdet är inställt på systemets standardvärde eller om användaren åsidosätter det.
enhet	Valfri text som beskriver de enheter där parametern uttrycks.	När det är inställt på något kan det vara något av 8KB, bytes, days, KB, megabytes, microseconds, , milliseconds, minutes, percentage, seconds.
värde	Värde som för närvarande har tilldelats parametern.	Varierar beroende på datatyp och tillåtna värden för parametern.

Lista serverparametrar med ändrade standardvärden

Portal

Använd Azure Portal:

1. Välj din azure database for PostgreSQL– flexibel serverinstans.

2. I resursmenyn går du till avsnittet Inställningar och väljer Serverparametrar och sedan fliken Ändrad . Sidan visar en lista över parametrar vars för närvarande inställda värde avviker från standardvärdet.

   

CLI

Du kan lista alla serverparametrar vars värden ändras från standardvärden, via kommandot 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"

Kommentar

Föregående CLI-kommando överväger inte ändrade serverparametrar som är avsedda som skrivskyddade och temp_tablespaces vacuum_cost_page_miss, enligt exakt samma villkor som sidan Serverparametrar i Azure Portal.

Visa en lista över statiska serverparametrar för läs- och skrivåtgärder

Portal

Använd Azure Portal:

1. Välj din azure database for PostgreSQL– flexibel serverinstans.

2. I resursmenyn går du till avsnittet Inställningar och väljer Serverparametrar och sedan fliken Statisk . Sidan visar en lista över skrivskyddade parametrar för vilka, om deras värde ändras, kräver en omstart av servern för att det nya värdet ska börja gälla.

   

CLI

Du kan lista alla serverparametrar som kräver en omstart när deras värden har ändrats, så att ändringarna börjar gälla via kommandot 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"

Visa en lista över dynamiska serverparametrar för läs- och skrivåtgärder

Portal

Använd Azure Portal:

1. Välj din azure database for PostgreSQL– flexibel serverinstans.

2. I resursmenyn går du till avsnittet Inställningar och väljer Serverparametrar och sedan fliken Dynamisk . Sidan visar en lista över skrivskyddade parametrar för vilka, om deras värde ändras, kräver en omstart av servern för att det nya värdet ska börja gälla.

   

CLI

Du kan lista alla serverparametrar som inte kräver en omstart när deras värden har ändrats för att ändringarna ska börja gälla, via kommandot 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"

Lista skrivskyddade serverparametrar

Portal

Använd Azure Portal:

1. Välj din azure database for PostgreSQL– flexibel serverinstans.

2. I resursmenyn går du till avsnittet Inställningar och väljer Serverparametrar och sedan fliken Skrivskyddad . Sidan visar en lista över skrivskyddade parametrar.

   

CLI

Du kan lista alla serverparametrar som är avsedda som skrivskyddade, vars värden inte kan ändras av användare, via kommandot az postgres flexible-server parameter list .

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

Ange värdet för en eller flera serverparametrar

Portal

Använd Azure Portal:

1. Välj din azure database for PostgreSQL– flexibel serverinstans.

2. I resursmenyn går du till avsnittet Inställningar och väljer Serverparametrar.

3. Leta upp de skrivskyddade parametrar vars aktuella värden du vill ändra, ange dem till de nya önskade värdena, observera att ett informationsmeddelande anger hur många serverparameterändringar som inte har sparats ännu och välj Spara.

   

4. Om kolumnen Parametertyp för någon av de ändrade parametrarna är lika med Static kräver servern en omstart för att ändringarna ska börja gälla. I så fall visas en dialogruta så att du kan välja om du vill:

   • Spara och starta om: Om du vill spara alla ändringar som gjorts i alla parametrar vars värden har ändrats och omedelbart efter omstart av servern för att eventuella ändringar av statiska parametrar ska börja gälla.
   • Spara endast: Om du vill spara alla ändringar som gjorts i alla parametrar vars uppsättningsvärden har ändrats, men vill skjuta upp serverns omstart till en senare tidpunkt. Tills du inte har slutfört åtgärden för omstart av servern börjar inte ändringar som gjorts i statiska serverparametrar att gälla.
   • Avbryt: Om du inte vill implementera några ändringar ännu.

   

CLI

Du kan ange värdet för en serverparameter via kommandot 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>

Och du kan använda följande skript för att villkorligt starta om servern, om någon av de ändrade parametrarna kräver en omstart för att ändringen ska börja gälla:

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

Återställ en serverparameter till standardvärdet

Portal

Använd Azure Portal:

1. Välj din azure database for PostgreSQL– flexibel serverinstans.

2. I resursmenyn går du till avsnittet Inställningar och väljer Serverparametrar.

3. Leta upp den skrivskyddade parametern vars aktuella värde du vill återgå till som standard, välj ellipsen till höger i scree och välj Återställ till standard.

   

Viktigt!

För parametrar som är avsedda som skrivskyddade visas inte menyalternativet Återställ till standard om du väljer ellipsen.

4. Om kolumnen Parametertyp för parametern som du försöker återställa till standardvärdet är lika med Statisk, kräver servern en omstart för att ändringen ska börja gälla. I så fall visas en dialogruta så att du kan välja om du vill:

   • Spara och starta om: Om du vill spara alla ändringar som gjorts i alla parametrar vars värden har ändrats och omedelbart efter omstart av servern för att eventuella ändringar av statiska parametrar ska börja gälla.
   • Spara endast: Om du vill spara alla ändringar som gjorts i alla parametrar vars uppsättningsvärden har ändrats, men vill skjuta upp serverns omstart till en senare tidpunkt. Tills du inte har slutfört åtgärden för omstart av servern börjar inte ändringar som gjorts i statiska serverparametrar att gälla.
   • Avbryt: Om du inte vill implementera några ändringar ännu.

   

CLI

Du kan återställa värdet för en serverparameter till standardvärdet via kommandot 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) 

Och du kan använda följande skript för att villkorligt starta om servern, om parametern som har ändrats kräver en omstart för att ändringen ska börja gälla:

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

Återställ alla serverparametrar till standardinställningarna

Portal

Använd Azure Portal:

1. Välj din azure database for PostgreSQL– flexibel serverinstans.

2. I resursmenyn går du till avsnittet Inställningar och väljer Serverparametrar.

3. Välj Återställ alla till standard.

   

4. Om kolumnen Parametertyp är lika med Statisk för någon av de parametrar vars aktuella värde inte matchar deras standardvärde, kräver servern en omstart för att ändringen ska börja gälla. I så fall visas en dialogruta så att du kan välja om du vill:

   • Spara och starta om: Om du vill spara alla ändringar som gjorts i alla parametrar vars värden har ändrats och omedelbart efter omstart av servern för att eventuella ändringar av statiska parametrar ska börja gälla.
   • Spara endast: Om du vill spara alla ändringar som gjorts i alla parametrar vars uppsättningsvärden har ändrats, men vill skjuta upp serverns omstart till en senare tidpunkt. Tills du inte har slutfört åtgärden för omstart av servern börjar inte ändringar som gjorts i statiska serverparametrar att gälla.
   • Avbryt: Om du inte vill implementera några ändringar ännu.

   

CLI

Du kan återställa värdet för alla skrivskyddade serverparametrar till deras standardvärden via kommandot 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

Och du kan använda följande skript för att villkorligt starta om servern, om någon av de ändrade parametrarna kräver en omstart för att ändringen ska börja gälla:

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

Arbeta med tidszonsparametrar

Om du planerar att arbeta med datum- och tidsdata i PostgreSQL kontrollerar du att du anger rätt tidszon för din plats. Alla tidszonsmedvetna datum och tider lagras internt i PostgreSQL i UTC. De konverteras till lokal tid i zonen som anges av timezone-serverparametern innan de visas för klienten. Den här parametern kan redigeras på sidan Serverparametrar . Med PostgreSQL kan du ange tidszoner i tre olika former:

• Ett namn på en hel tidszon, till exempel Amerika/New_York. De identifierade tidszonsnamnen visas i vyn pg_timezone_names .
  Exempel för att fråga den här vyn i psql och hämta en lista över tidszonsnamn:

  select name FROM pg_timezone_names LIMIT 20;

  Du bör se resultatuppsättningen så här:

            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)
    

• En tidszonsförkortning, till exempel PST. En sådan specifikation definierar bara en viss förskjutning från UTC, till skillnad från namn på fullständiga tidszoner, vilket även kan innebära en uppsättning övergångsdatumregler för sommartid. De identifierade förkortningarna visas i pg_timezone_abbrevs-vyn Exempel för att köra frågor mot den här vyn i psql och hämta en lista över förkortningar för tidszon:

   select abbrev from pg_timezone_abbrevs limit 20;

  Du bör se resultatuppsättningen så här:

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

• Utöver tidszonsnamnen och förkortningarna accepterar PostgreSQL tidszonsspecifikationer i POSIX-format för formatet STDoffset eller STDoffsetDST, där STD är en zonförkortning, offset är en numerisk förskjutning i timmar västerut från UTC, och DST är en valfri förkortning av sommartidszonen som antas stå i en timme före den angivna förskjutningen.

Dela dina förslag och buggar med produktteamet för Azure Database for PostgreSQL.

Relaterat innehåll

• översikt över serverparametrar