Serverparameters configureren in Azure Database for PostgreSQL - Flexible Server

VAN TOEPASSING OP: Azure Database for PostgreSQL - Flexibele server

U kunt configuratieparameters voor een flexibele Azure Database for PostgreSQL-serverinstantie weergeven, weergeven en bijwerken.

Parameteraanpassing

Er zijn verschillende methoden en niveaus beschikbaar om uw parameters aan te passen op basis van uw specifieke behoeften.

Globaal niveau

Voor het weergeven van de huidige geconfigureerde waarden voor serverparameters of voor het globaal wijzigen ervan op exemplaar- of serverniveau, kunt u de pagina Serverparameters in Azure Portal gebruiken. U kunt ook wereldwijd communiceren met serverparameters met behulp van de CLI, de REST API, Azure Resource Manager-sjablonen of IaC-hulpprogramma's van derden.

Notitie

Omdat Azure Database for PostgreSQL een beheerde databaseservice is, hebben gebruikers geen host- of besturingssysteemtoegang om configuratiebestanden zoals postgresql.conf weer te geven of te wijzigen. De inhoud van de bestanden wordt automatisch bijgewerkt op basis van parameterwijzigingen die u aanbrengt.

In hetzelfde artikel vindt u secties voor interactie met serverparameters wereldwijd voor:

• Geef alle serverparameters weer.
• Geef serverparameters weer met gewijzigde standaardwaarden.
• Lijst met statische serverparameters voor lezen/schrijven weergeven.
• Lijst met dynamische serverparameters voor lezen/schrijven weergeven.
• Geef alleen-lezen serverparameters weer.
• Stel de waarde van een of meer serverparameters in.
• Eén serverparameter herstellen naar de standaardwaarde.
• Alle serverparameter herstellen naar de standaardinstellingen.

Gedetailleerde niveaus

U kunt parameters op gedetailleerdere niveaus aanpassen. Deze aanpassingen overschrijven globaal ingestelde waarden. Hun bereik en duur zijn afhankelijk van het niveau waarop u ze maakt:

• Databaseniveau: gebruik de ALTER DATABASE opdracht voor databasespecifieke configuraties.

• Rol- of gebruikersniveau: gebruik de ALTER USER opdracht voor gebruikersgerichte instellingen.

• Functie, procedureniveau: Wanneer u een functie of procedure definieert, kunt u de configuratieparameters opgeven of wijzigen die worden gebruikt wanneer de functie wordt aangeroepen.

• Tabelniveau: Als voorbeeld kunt u parameters met betrekking tot autovacuum op dit niveau wijzigen.

• Sessieniveau: Voor de levensduur van een afzonderlijke databasesessie kunt u specifieke parameters aanpassen. PostgreSQL faciliteert deze aanpassing met de volgende SQL-opdrachten:

  • Gebruik de SET opdracht om sessiespecifieke aanpassingen te maken. Deze wijzigingen fungeren als de standaardinstellingen tijdens de huidige sessie. Voor toegang tot deze wijzigingen zijn mogelijk specifieke SET bevoegdheden vereist. De beperkingen voor wijzigbare en alleen-lezenparameters die eerder zijn beschreven, zijn niet van toepassing. De bijbehorende SQL-functie is set_config(setting_name, new_value, is_local).
  • Gebruik de SHOW opdracht om bestaande parameterinstellingen te onderzoeken. Het equivalent van de SQL-functie is current_setting(setting_name text).

Alle serverparameters weergeven

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-serverexemplaren.

2. Selecteer serverparameters in het resourcemenu onder de sectie Instellingen. Op de pagina ziet u een lijst met parameters, de geconfigureerde waarden, optionele eenheden, of ze alleen-lezen/dynamisch/statisch zijn en hun beschrijvingen.

   

3. Selecteer of beweeg de muisaanwijzer over het pictogram i (informatie) om de toegestane waarden weer te geven waarop elke parameter kan worden ingesteld. Afhankelijk van het gegevenstype van de parameter, dat tekenreeks, opsomming, geheel getal, booleaanse waarde, numeriek, ingesteld kan zijn, variëren de toegestane waarden. En dit kan een reguliere expressie zijn, een lijst met waarden, een bereik van gehele getallen, aan/uit, een bereik van decimalen, respectievelijk een lijst met waarden.

   

4. De lijst met serverparameters die door het exemplaar worden ondersteund, bestaat uit enkele honderden items, die elk worden weergegeven op pagina's van 20 items. Onderaan de pagina bevindt zich een besturingselement om u te informeren over de positie waarop u zich bevindt. Er is ook een paging-besturingselement dat u kunt gebruiken om door de hele set pagina's te navigeren.

   

5. Gebruik indien nodig het tekstvak Zoeken om items te filteren... om de lijst te beperken tot de parameters die de zoekterm in hun naam of in hun beschrijving bevatten.

   

De kolom Parametertype kan een van de volgende waarden voor elke parameter weergeven:

Parametertype	Beschrijving
Static	Vereist dat de server opnieuw wordt opgestart om de wijziging effectief te maken.
Dynamisch	Kan worden gewijzigd zonder dat u het serverexemplaren opnieuw hoeft op te starten. Wijzigingen zijn echter alleen van toepassing op nieuwe verbindingen die na de wijziging tot stand zijn gebracht.
Alleen-lezen	Kan de gebruiker niet configureren vanwege hun kritieke rol bij het onderhouden van betrouwbaarheid, beveiliging of andere operationele aspecten van de service.

CLI

U kunt alle serverparameters op een server weergeven via de opdracht az postgres flexible-server parameter list .

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

Elke parameter heeft de volgende kenmerken:

Naam van kenmerk	Beschrijving	Mogelijke waarden
allowedValues	Beschrijft de waarden die zijn toegestaan voor de parameter.	Afhankelijk van de waarde van dataType kan een reguliere expressie (tekenreeks), lijst met waarden (opsomming), bereik van gehele getallen (geheel getal), aan/uit (booleaanse waarde), bereik van decimalen (numeriek), lijst met waarden (set) zijn.
Datatype	Type gegevens dat wordt gebruikt voor de parameter.	Kan elk van boolean, enumeration, integer, , numeric, , set. string.
standaardwaarde	Waarde die is toegewezen aan de parameter wanneer een nieuwe server wordt geïmplementeerd.	Varieert, afhankelijk van het gegevenstype en de toegestane waarden van de parameter.
beschrijving	Korte uitleg van wat de parameterbesturingselementen zijn.	Tekstbeschrijving die voor elke parameter anders is.
documentationLink	URL-adres van de pagina die verwijst naar de documentatie van de parameter.	Een vorm van URL.
id	Resource-id die uniek verwijst naar de serverparameter in dit specifieke exemplaar van flexibele server.	Een tekenreeks die het patroon /subscriptions/<subscription_identifier>/resourceGroups/<resource_group_name>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server_name>/configurations/<parameter_name>volgt.
isConfigPendingRestart	Geeft aan of opnieuw opstarten van de server vereist is voor de waarde die momenteel is ingesteld in het waardekenmerk om van kracht te worden.	true: voor parameters waarvan de waarde is gewijzigd en, omdat deze niet dynamisch zijn (dat wil gezegd, ze statisch zijn), moet de server opnieuw worden opgestart om de wijziging van kracht te laten worden. false: voor parameters waarvan de waarde die momenteel is ingesteld in het waardekenmerk van kracht is en wacht niet totdat de server opnieuw wordt opgestart.
isDynamicConfig	Hiermee wordt aangegeven of een wijziging in de waarde die is toegewezen aan de parameter, geen server opnieuw hoeft te worden opgestart of vereist, zodat de wijziging van kracht wordt.	true: voor parameters die, wanneer hun waarde verandert, de wijziging onmiddellijk van kracht wordt. false: voor parameters die, wanneer hun waarde wordt gewijzigd, een server opnieuw moeten worden opgestart om de wijziging van kracht te laten worden.
isReadOnly	Geeft aan of de standaardwaarde die voor de parameter is toegewezen, wel of niet kan worden overschreven door de gebruiker.	true: voor parameters die zijn aangewezen als alleen-lezen en de gebruiker niet kan wijzigen. false: voor parameters die zijn aangewezen als lezen/schrijven en de gebruiker kan instellen op een andere waarde dan de standaardwaarde.
name	Naam van de parameter.	Elke geldige naam voor een serverparameter.
resourceGroup	Naam van de resourcegroep waarin de server is geïmplementeerd.	Elke geldige naam voor een resourcegroep in Azure.
bron	Bron waaruit de waarde die momenteel voor de parameter is ingesteld, afkomstig is.	system-default of user-override, afhankelijk van of de waarde is ingesteld op de systeemstandaard of de gebruiker deze overschrijft.
eenheid	Optionele tekst waarin de eenheden worden beschreven waarin de parameter wordt uitgedrukt.	Als de waarde is ingesteld op iets, kan dit elk van, , , , KB, , minutesmillisecondsmicrosecondsmegabytes, percentage, . secondsdaysbytes8KB
value	De waarde die momenteel is toegewezen aan de parameter.	Varieert, afhankelijk van het gegevenstype en de toegestane waarden van de parameter.

Serverparameters weergeven met gewijzigde standaardwaarden

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-serverexemplaren.

2. Selecteer serverparameters in het resourcemenu onder de sectie Instellingen en selecteer vervolgens het tabblad Gewijzigd. Op de pagina ziet u een lijst met parameters waarvan de huidige ingestelde waarde afwijkt van de standaardwaarde.

   

CLI

U kunt alle serverparameters weergeven waarvan de waarden worden gewijzigd op basis van standaardwaarden, via de opdracht 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"

Notitie

Met de vorige CLI-opdracht kunt u geen gewijzigde serverparameters overwegen die zijn aangewezen als alleen-lezen en temp_tablespaces , volgens vacuum_cost_page_missexact dezelfde criteria als de pagina Serverparameters in Azure Portal.

Statische serverparameters voor lezen/schrijven weergeven

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-serverexemplaren.

2. Selecteer serverparameters in het resourcemenu onder de sectie Instellingen en selecteer vervolgens het tabblad Statisch. Op de pagina wordt een lijst met lees-/schrijfparameters weergegeven waarvoor, als de waarde ervan wordt gewijzigd, de server opnieuw moet worden opgestart voordat de nieuwe waarde van kracht wordt.

   

CLI

U kunt alle serverparameters weergeven waarvoor opnieuw opstarten is vereist nadat de waarden zijn gewijzigd, zodat de wijzigingen van kracht worden via de opdracht 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"

Dynamische serverparameters voor lezen/schrijven weergeven

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-serverexemplaren.

2. Selecteer serverparameters in het resourcemenu onder de sectie Instellingen en selecteer vervolgens het tabblad Dynamisch. Op de pagina wordt een lijst met lees-/schrijfparameters weergegeven waarvoor, als de waarde ervan wordt gewijzigd, de server opnieuw moet worden opgestart voordat de nieuwe waarde van kracht wordt.

   

CLI

U kunt alle serverparameters weergeven waarvoor opnieuw opstarten niet nodig is nadat de waarden zijn gewijzigd, zodat de wijzigingen van kracht worden, via de opdracht 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"

Alleen-lezenserverparameters weergeven

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-serverexemplaren.

2. Selecteer serverparameters in het resourcemenu onder de sectie Instellingen en selecteer vervolgens het tabblad Alleen-lezen. Op de pagina wordt een lijst met alleen-lezenparameters weergegeven.

   

CLI

U kunt alle serverparameters weergeven die zijn aangewezen als alleen-lezen, waarvan de waarden niet kunnen worden gewijzigd door gebruikers, via de opdracht az postgres flexible-server parameter list .

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

De waarde van een of meer serverparameters instellen

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-serverexemplaren.

2. Selecteer serverparameters in het resourcemenu onder de sectie Instellingen.

3. Zoek de parameters voor lezen/schrijven waarvan u de huidige waarden wilt wijzigen, stel deze in op de nieuwe gewenste waarden, u ziet dat een informatief bericht aangeeft hoeveel wijzigingen in de serverparameter nog niet zijn opgeslagen en selecteer Opslaan.

   

4. Als het kolomparametertype voor een van de gewijzigde parameters gelijk is aan Statisch, moet de server opnieuw worden opgestart om de wijzigingen van kracht te laten worden. In dat geval wordt er een dialoogvenster weergegeven, zodat u kunt selecteren of u het volgende wilt doen:

   • Opslaan en opnieuw opstarten: als u alle wijzigingen wilt behouden die zijn aangebracht in alle parameters waarvan de waarden zijn gewijzigd, en onmiddellijk na het opnieuw opstarten van de server, zodat wijzigingen in statische parameters van kracht worden.
   • Alleen opslaan: als u alle wijzigingen wilt behouden die zijn aangebracht in alle parameters waarvan de ingestelde waarden zijn gewijzigd, maar de server later opnieuw wilt opstarten. Totdat u de actie voor opnieuw opstarten van de server niet voltooit, worden wijzigingen die zijn aangebracht in de parameters van de statische server niet van kracht.
   • Annuleren: Als u nog geen wijzigingen wilt implementeren.

   

CLI

U kunt de waarde van een serverparameter instellen via de opdracht 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>

En u kunt het volgende script gebruiken om de server voorwaardelijk opnieuw op te starten, als een van de gewijzigde parameters opnieuw moet worden opgestart om de wijziging van kracht te laten worden:

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

Eén serverparameter herstellen naar de standaardwaarde

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-serverexemplaren.

2. Selecteer serverparameters in het resourcemenu onder de sectie Instellingen.

3. Zoek de parameter read-write waarvan u de huidige waarde wilt herstellen naar de standaardwaarde, selecteer het beletselteken aan de rechterkant van de cree en selecteer Standaardinstelling herstellen.

   

Belangrijk

Voor parameters die als alleen-lezen zijn aangewezen, wordt de standaardmenuoptie Opnieuw instellen niet weergegeven wanneer u het beletselteken selecteert.

4. Als het kolomparametertype voor de parameter die u opnieuw wilt instellen op de standaardwaarde gelijk is aan Statisch, moet de server opnieuw worden opgestart om de wijziging van kracht te laten worden. In dat geval wordt er een dialoogvenster weergegeven, zodat u kunt selecteren of u het volgende wilt doen:

   • Opslaan en opnieuw opstarten: als u alle wijzigingen wilt behouden die zijn aangebracht in alle parameters waarvan de waarden zijn gewijzigd, en onmiddellijk na het opnieuw opstarten van de server, zodat wijzigingen in statische parameters van kracht worden.
   • Alleen opslaan: als u alle wijzigingen wilt behouden die zijn aangebracht in alle parameters waarvan de ingestelde waarden zijn gewijzigd, maar de server later opnieuw wilt opstarten. Totdat u de actie voor opnieuw opstarten van de server niet voltooit, worden wijzigingen die zijn aangebracht in de parameters van de statische server niet van kracht.
   • Annuleren: Als u nog geen wijzigingen wilt implementeren.

   

CLI

U kunt de waarde van een serverparameter terugzetten naar de standaardwaarde via de opdracht 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) 

En u kunt het volgende script gebruiken om de server voorwaardelijk opnieuw op te starten. Als de parameter is gewijzigd, moet de wijziging opnieuw worden opgestart om de wijziging van kracht te laten worden:

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

Alle serverparameters terugzetten naar de standaardwaarden

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-serverexemplaren.

2. Selecteer serverparameters in het resourcemenu onder de sectie Instellingen.

3. Selecteer Alles opnieuw instellen op de standaardwaarde.

   

4. Als voor een van de parameters waarvan de huidige waarde niet overeenkomt met de standaardwaarde, het kolomparametertype gelijk is aan Statisch, moet de server opnieuw worden opgestart om de wijziging van kracht te laten worden. In dat geval wordt er een dialoogvenster weergegeven, zodat u kunt selecteren of u het volgende wilt doen:

   • Opslaan en opnieuw opstarten: als u alle wijzigingen wilt behouden die zijn aangebracht in alle parameters waarvan de waarden zijn gewijzigd, en onmiddellijk na het opnieuw opstarten van de server, zodat wijzigingen in statische parameters van kracht worden.
   • Alleen opslaan: als u alle wijzigingen wilt behouden die zijn aangebracht in alle parameters waarvan de ingestelde waarden zijn gewijzigd, maar de server later opnieuw wilt opstarten. Totdat u de actie voor opnieuw opstarten van de server niet voltooit, worden wijzigingen die zijn aangebracht in de parameters van de statische server niet van kracht.
   • Annuleren: Als u nog geen wijzigingen wilt implementeren.

   

CLI

U kunt de waarde van alle parameters van de read-write-server terugzetten naar de standaardwaarden via de opdracht 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

En u kunt het volgende script gebruiken om de server voorwaardelijk opnieuw op te starten, als een van de gewijzigde parameters opnieuw moet worden opgestart om de wijziging van kracht te laten worden:

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

Werken met tijdzoneparameters

Als u van plan bent om te werken met datum- en tijdgegevens in PostgreSQL, moet u ervoor zorgen dat u de juiste tijdzone voor uw locatie instelt. Alle tijdzonebewuste datums en tijden worden intern opgeslagen in PostgreSQL in UTC. Ze worden geconverteerd naar lokale tijd in de zone die is opgegeven door de parameter TimeZone-server voordat ze worden weergegeven naar de client. Deze parameter kan worden bewerkt op de pagina Serverparameters . Met PostgreSQL kunt u tijdzones opgeven in drie verschillende formulieren:

• Een volledige tijdzonenaam, bijvoorbeeld Amerika/New_York. De herkende tijdzonenamen worden weergegeven in de pg_timezone_names weergave.
  Voorbeeld om een query uit te voeren op deze weergave in psql en een lijst met tijdzonenamen op te halen:

  select name FROM pg_timezone_names LIMIT 20;

  Als het goed is, ziet u de resultatenset als volgt:

            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)
    

• Een afkorting van een tijdzone, bijvoorbeeld PST. Een dergelijke specificatie definieert slechts een bepaalde verschuiving van UTC, in tegenstelling tot volledige tijdzonenamen die ook een set zomertijdovergangsdatumregels kunnen impliceren. De herkende afkortingen worden vermeld in het pg_timezone_abbrevs weergavevoorbeeld om deze weergave in psql op te vragen en een lijst met tijdzone afkortingen op te halen:

   select abbrev from pg_timezone_abbrevs limit 20;

  Als het goed is, ziet u de resultatenset als volgt:

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

• Naast de tijdzonenamen en afkortingen accepteert PostgreSQL posix-stijl tijdzonespecificaties van de vorm STDoffset of STDoffsetDST, waarbij STD een zoneafkorting is, offset een numerieke verschuiving is in uren west van UTC en DST een optionele zomer-spaarzone afkorting, verondersteld om één uur voor de opgegeven offset te staan.

Deel uw suggesties en bugs met het productteam van Azure Database for PostgreSQL.

Gerelateerde inhoud

• overzicht van serverparameters