Configurare i parametri del server in Database di Azure per PostgreSQL - Server flessibile

Articolo
12/11/2024

SI APPLICA A: Database di Azure per PostgreSQL - Server flessibile

È possibile elencare, visualizzare e aggiornare i parametri di configurazione per un'istanza del server flessibile Database di Azure per PostgreSQL.

Personalizzazione dei parametri

Sono disponibili vari metodi e livelli per personalizzare i parametri in base alle esigenze specifiche.

Livello globale

Per visualizzare i valori configurati correnti per i parametri del server o per modificarli a livello globale a livello di istanza o server, è possibile usare la pagina Parametri server nel portale di Azure. È anche possibile interagire con i parametri del server a livello globale usando l'interfaccia della riga di comando, l'API REST, i modelli di Azure Resource Manager o gli strumenti IaC di terze parti.

Nota

Poiché Database di Azure per PostgreSQL è un servizio di database gestito, gli utenti non hanno accesso all’host o al sistema operativo per visualizzare o modificare file di configurazione, ad esempio postgresql.conf. Il contenuto del file viene aggiornato automaticamente in base alle modifiche apportate ai parametri.

In questo stesso articolo è possibile trovare sezioni per interagire con i parametri del server a livello globale per:

Elencare tutti i parametri del server.
Elencare i parametri del server con valori predefiniti modificati.
Elencare i parametri del server statico di lettura/scrittura.
Elencare i parametri del server dinamico di lettura/scrittura.
Elencare i parametri del server di sola lettura.
Impostare il valore di uno o più parametri del server.
Ripristinare il valore predefinito di un parametro del server.
Ripristinare tutte le impostazioni predefinite di tutti i parametri del server.

Livelli granulari

È possibile modificare i parametri a livelli più granulari. Queste modifiche sostituiscono i valori impostati a livello globale. L'ambito e la durata dipendono dal livello in cui vengono eseguite:

Livello database: usare il comando ALTER DATABASE per configurazioni specifiche del database.
Livello Ruolo o utente: usare il comando ALTER USER per le impostazioni incentrate sull'utente.
Funzione, livello di routine: quando si definisce una funzione o una routine, è possibile specificare o modificare i parametri di configurazione usati quando viene chiamata la funzione.
Livello tabella: a questo livello, ad esempio, è possibile modificare i parametri correlati ad autovacuum.
Livello di sessione: per la durata di una singola sessione di database, è possibile modificare parametri specifici. PostgreSQL facilita questa regolazione con i comandi SQL seguenti:
- Usare il comando SET per apportare modifiche specifiche della sessione. Queste modifiche fungono da impostazioni predefinite durante la sessione corrente. L'accesso a queste modifiche potrebbe richiedere privilegi SET specifici e le limitazioni per i parametri modificabili e di sola lettura descritti in precedenza non si applicano. La funzione SQL corrispondente è set_config(setting_name, new_value, is_local).
- Usare il comando SHOW per esaminare le impostazioni dei parametri esistenti. La funzione SQL equivalente è current_setting(setting_name text).

Tramite il portale di Azure:

Selezionare l'istanza del server flessibile di Database di Azure per PostgreSQL.
Nel menu delle risorse, nella sezione Impostazioni selezionare Parametri del server. La pagina mostra un elenco di parametri, i relativi valori configurati, le unità facoltative, se sono di sola lettura/dinamica/statica e le relative descrizioni.
Selezionare o passare il puntatore del mouse sull'icona i (informazioni) per visualizzare i valori consentiti su cui è possibile impostare ogni parametro. A seconda del tipo di dati del parametro, che può essere stringa, enumerazione, integer, booleano, numerico, impostato, i valori consentiti variano. E può essere espressione regolare, elenco di valori, intervallo di interi, on/off, intervallo di decimali, elenco di valori, rispettivamente.
L'elenco dei parametri del server supportati dall'istanza è costituito da diverse centinaia di elementi, di cui viene eseguito il rendering in pagine di 20 elementi ciascuno. Nella parte inferiore della pagina è presente un controllo per informare l'utente della posizione in cui ci si trovi. È anche disponibile un controllo di paging che è possibile usare per spostarsi nell'intero set di pagine.
Se necessario, usare la casella di testo Cerca per filtrare gli elementi... per restringere l'elenco a tali parametri contenenti il termine di ricerca nel nome o nella relativa descrizione.

La colonna Tipo di parametro può visualizzare uno dei valori seguenti per ogni parametro:

Tipo parametro	Descrizione
Statico	Richiede un riavvio del server per rendere effettiva la modifica.
Dinamico	Può essere modificato senza la necessità di riavviare l'istanza del server. Tuttavia, le modifiche saranno applicate solo alle nuove connessioni stabilite dopo la modifica.
Sola lettura	Non è configurabile dall'utente, a causa del ruolo fondamentale per mantenere l'affidabilità, la sicurezza o altri aspetti operativi del servizio.

È possibile elencare tutti i parametri del server in un server tramite il comando az postgres flexible-server parameter list .

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

Ogni parametro ha gli attributi seguenti:

Attribute name	Descrizione	Possibili valori
allowedValues	Descrive i valori consentiti per il parametro .	A seconda del valore di dataType, può essere un'espressione regolare (stringa), un elenco di valori (enumerazione), un intervallo di interi (integer), on/off (booleano), un intervallo di decimali (numerico), un elenco di valori (set).
dataType	Tipo di dati utilizzati per il parametro .	Può essere uno qualsiasi di `boolean`, `enumeration`, `numericinteger`, `setstring`.
defaultValue	Valore assegnato al parametro quando viene distribuito un nuovo server.	Varia a seconda del tipo di dati e dei valori consentiti del parametro.
description	Breve spiegazione dei controlli dei parametri.	Descrizione testuale diversa per ogni parametro.
documentationLink	Indirizzo URL della pagina che punta alla documentazione del parametro .	Qualche forma di URL.
id	Identificatore di risorsa che fa riferimento in modo univoco al parametro del server in questa particolare istanza del server flessibile.	Stringa che segue il modello `/subscriptions/<subscription_identifier>/resourceGroups/<resource_group_name>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server_name>/configurations/<parameter_name>`.
isConfigPendingRestart	Indica se è necessario un riavvio del server per rendere effettivo il valore attualmente impostato nell'attributo value .	`true`: per i parametri il cui valore è stato modificato e, poiché non sono dinamici (ovvero sono statici), richiedere un riavvio del server per rendere effettiva la modifica. `false`: per i parametri il cui valore attualmente impostato nell'attributo value è attivo e non sono in attesa dell'applicazione di un riavvio del server.
isDynamicConfig	Indica se una modifica del valore assegnato al parametro non richiede o richiede un riavvio del server per rendere effettiva la modifica.	`true`: per i parametri che, quando il valore cambia, la modifica diventa effettiva immediatamente. `false`: per i parametri che, quando il valore cambia, richiedono un riavvio del server per rendere effettiva la modifica.
isReadOnly	Indica se il valore predefinito assegnato per il parametro può o non può essere sottoposto a override dall'utente.	`true`: per i parametri designati come di sola lettura e l'utente non può modificare. `false`: per i parametri designati come lettura/scrittura e l'utente può impostare su un valore diverso rispetto al valore predefinito.
name	Nome del parametro.	Qualsiasi nome valido per un parametro del server.
resourceGroup	Nome del gruppo di risorse in cui viene distribuito il server.	Qualsiasi nome valido per un gruppo di risorse in Azure.
source	Origine da cui ha origine il valore attualmente impostato per il parametro.	`system-default` o `user-override`, a seconda che il valore sia impostato sul valore predefinito del sistema o che l'utente ne esempe l'override.
unitàà	Testo facoltativo che descrive le unità in cui è espresso il parametro.	Quando è impostato su un elemento, può essere uno qualsiasi di `8KB`, `bytes`, `KBdays`, , `millisecondsmegabytesmicrosecondsminutespercentage`. `seconds`
value	Valore attualmente assegnato al parametro .	Varia a seconda del tipo di dati e dei valori consentiti del parametro.

Elencare i parametri del server con impostazioni predefinite modificate

Portale
CLI

Tramite il portale di Azure:

Selezionare l'istanza del server flessibile di Database di Azure per PostgreSQL.
Nel menu delle risorse, nella sezione Impostazioni selezionare Parametri del server e quindi selezionare la scheda Modifica . La pagina mostra un elenco di parametri il cui valore attualmente impostato devia dall'impostazione predefinita.

È possibile elencare tutti i parametri del server i cui valori vengono modificati dai valori predefiniti, tramite il comando 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"

Nota

Il comando dell'interfaccia della riga di comando precedente non considera i parametri del server modificati designati come di sola temp_tablespaces lettura e vacuum_cost_page_miss, seguendo esattamente gli stessi criteri della pagina Parametri server nella portale di Azure.

Elencare i parametri del server statico di lettura/scrittura

Portale
CLI

Tramite il portale di Azure:

Selezionare l'istanza del server flessibile di Database di Azure per PostgreSQL.
Nel menu delle risorse, nella sezione Impostazioni selezionare Parametri del server e quindi selezionare la scheda Statico . Nella pagina viene visualizzato un elenco di parametri di lettura/scrittura per i quali, se il relativo valore è stato modificato, richiedere il riavvio del server per rendere effettivo il nuovo valore.

È possibile elencare tutti i parametri del server che richiedono un riavvio dopo la modifica dei valori, in modo che le modifiche vengano applicate tramite il comando 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"

Elencare i parametri del server dinamico di lettura/scrittura

Portale
CLI

Tramite il portale di Azure:

Selezionare l'istanza del server flessibile di Database di Azure per PostgreSQL.
Nel menu delle risorse, nella sezione Impostazioni selezionare Parametri del server e quindi selezionare la scheda Dinamica . Nella pagina viene visualizzato un elenco di parametri di lettura/scrittura per i quali, se il relativo valore è stato modificato, richiedere il riavvio del server per rendere effettivo il nuovo valore.

È possibile elencare tutti i parametri del server che non richiedono un riavvio dopo la modifica dei valori per rendere effettive le modifiche, tramite il comando 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"

Elencare i parametri del server di sola lettura

Portale
CLI

Tramite il portale di Azure:

Selezionare l'istanza del server flessibile di Database di Azure per PostgreSQL.
Nel menu delle risorse, nella sezione Impostazioni selezionare Parametri server e quindi selezionare la scheda Sola lettura. La pagina mostra un elenco di parametri di sola lettura.

È possibile elencare tutti i parametri del server designati come di sola lettura, i cui valori non possono essere modificati dagli utenti tramite il comando az postgres flexible-server parameter list .

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

Impostare il valore di uno o più parametri del server

Portale
CLI

Tramite il portale di Azure:

Selezionare l'istanza del server flessibile di Database di Azure per PostgreSQL.
Nel menu delle risorse, nella sezione Impostazioni selezionare Parametri del server.
Individuare i parametri di lettura/scrittura i cui valori correnti si desidera modificare, impostarli sui nuovi valori desiderati, notare che un messaggio informativo indica il numero di modifiche ai parametri del server non ancora salvate e selezionare Salva.
Se il tipo di parametro della colonna per uno dei parametri è uguale a Statico, il server richiede un riavvio per rendere effettive le modifiche. In tal caso, viene visualizzata una finestra di dialogo in modo che sia possibile selezionare se si vuole:
- Salva e riavvia: nel caso in cui si desideri rendere persistenti tutte le modifiche apportate a tutti i parametri i cui valori sono stati modificati e immediatamente dopo il riavvio del server per rendere effettive le modifiche apportate ai parametri statici.
- Salva solo: se si desidera rendere persistenti tutte le modifiche apportate a tutti i parametri i cui valori impostati sono stati modificati, ma si desidera rinviare il riavvio del server a un secondo momento. Fino a quando non si completa l'azione di riavvio del server, le modifiche apportate ai parametri del server statico non hanno effetto.
- Annulla: per non implementare ancora alcuna modifica.

È possibile impostare il valore di un parametro del server tramite il comando 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>

È anche possibile usare lo script seguente per riavviare il server in modo condizionale, se uno dei parametri modificati richiede un riavvio per rendere effettiva la modifica:

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

Ripristinare il valore predefinito di un parametro del server

Portale
CLI

Tramite il portale di Azure:

Selezionare l'istanza del server flessibile di Database di Azure per PostgreSQL.
Nel menu delle risorse, nella sezione Impostazioni selezionare Parametri del server.
Individuare il parametro di lettura/scrittura il cui valore corrente si vuole ripristinare l'impostazione predefinita, selezionare i puntini di sospensione sul lato destro dello scree e selezionare Ripristina impostazione predefinita.

Importante

Per i parametri designati come di sola lettura, se si selezionano i puntini di sospensione non viene visualizzata l'opzione di menu Ripristina impostazioni predefinite .

Se il tipo di parametro della colonna per il parametro che si sta tentando di reimpostare per impostazione predefinita è uguale a Statico, il server richiede un riavvio per rendere effettiva la modifica. In tal caso, viene visualizzata una finestra di dialogo in modo che sia possibile selezionare se si vuole:
- Salva e riavvia: nel caso in cui si desideri rendere persistenti tutte le modifiche apportate a tutti i parametri i cui valori sono stati modificati e immediatamente dopo il riavvio del server per rendere effettive le modifiche apportate ai parametri statici.
- Salva solo: se si desidera rendere persistenti tutte le modifiche apportate a tutti i parametri i cui valori impostati sono stati modificati, ma si desidera rinviare il riavvio del server a un secondo momento. Fino a quando non si completa l'azione di riavvio del server, le modifiche apportate ai parametri del server statico non hanno effetto.
- Annulla: per non implementare ancora alcuna modifica.

È possibile ripristinare il valore di un parametro del server come predefinito tramite il comando 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)

È inoltre possibile usare lo script seguente per riavviare il server in modo condizionale, se il parametro modificato richiede un riavvio per rendere effettiva la modifica:

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

Ripristinare tutte le impostazioni predefinite di tutti i parametri del server

Portale
CLI

Tramite il portale di Azure:

Selezionare l'istanza del server flessibile di Database di Azure per PostgreSQL.
Nel menu delle risorse, nella sezione Impostazioni selezionare Parametri del server.
Selezionare Reimposta tutto sul valore predefinito.
Se, per uno dei parametri il cui valore corrente non corrisponde al valore predefinito, il tipo di parametro della colonna è uguale a Statico, il server richiede un riavvio per rendere effettiva la modifica. In tal caso, viene visualizzata una finestra di dialogo in modo che sia possibile selezionare se si vuole:
- Salva e riavvia: nel caso in cui si desideri rendere persistenti tutte le modifiche apportate a tutti i parametri i cui valori sono stati modificati e immediatamente dopo il riavvio del server per rendere effettive le modifiche apportate ai parametri statici.
- Salva solo: se si desidera rendere persistenti tutte le modifiche apportate a tutti i parametri i cui valori impostati sono stati modificati, ma si desidera rinviare il riavvio del server a un secondo momento. Fino a quando non si completa l'azione di riavvio del server, le modifiche apportate ai parametri del server statico non hanno effetto.
- Annulla: per non implementare ancora alcuna modifica.

È possibile ripristinare i valori predefiniti di tutti i parametri del server di lettura/scrittura tramite il comando 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

È anche possibile usare lo script seguente per riavviare il server in modo condizionale, se uno dei parametri modificati richiede un riavvio per rendere effettiva la modifica:

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

Uso dei parametri del fuso orario

Se si prevede di usare i dati di data e ora in PostgreSQL, assicurarsi di impostare il fuso orario corretto per la posizione. Tutte le date e le ore con riconoscimento del fuso orario vengono archiviate internamente in PostgreSQL in formato UTC. Vengono convertiti in ora locale nel fuso orario specificato dal parametro del server TimeZone prima di essere visualizzati nel client. Questo parametro può essere modificato nella pagina Parametri del server. PostgreSQL consente di specificare fusi orari in tre formati diversi:

Nome del fuso orario completo, ad esempio America/New_York. I nomi del fuso orario riconosciuti sono elencati nella visualizzazione pg_timezone_names.
Esempio per eseguire una query su questa vista in psql e ottenere l'elenco dei nomi del fuso orario:

select name FROM pg_timezone_names LIMIT 20;

Verrà visualizzato un set di risultati simile al seguente:

          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)

Abbreviazione del fuso orario, ad esempio PST. Tale specifica definisce semplicemente un offset specifico rispetto all'ora UTC, a differenza dei nomi di fuso orario completo che possono implicare anche un set di regole di transizione dell'ora legale. Le abbreviazioni riconosciute sono elencate nell'esempio di visualizzazione pg_timezone_abbrevs per eseguire query su questa vista in psql e ottenere l'elenco delle abbreviazioni del fuso orario:
```
 select abbrev from pg_timezone_abbrevs limit 20;
```
Verrà visualizzato un set di risultati simile al seguente:
```
      abbrev|
      ------+
      ACDT  |
      ACSST |
      ACST  |
      ACT   |
      ACWST |
      ADT   |
      AEDT  |
      AESST |
      AEST  |
      AFT   |
      AKDT  |
      AKST  |
      ALMST |
      ALMT  |
      AMST  |
      AMT   |
      ANAST |
      ANAT  |
      ARST  |
      ART   |
  
```
Oltre ai nomi e alle abbreviazioni del fuso orario, PostgreSQL accetta le specifiche del fuso orario in stile POSIX del formato STDoffset o STDoffsetDST, dove STD è un'abbreviazione della zona, l'offset è un offset numerico in ore occidentali dall'ORA UTC e DST è un'abbreviazione facoltativa della zona di risparmio legale, presupponendo che si supporti per un'ora prima dell'offset specificato.

Condividere i suggerimenti e i bug con il team del prodotto Database di Azure per PostgreSQL.

panoramica dei parametri del server

Condividi tramite

Configurare i parametri del server in Database di Azure per PostgreSQL - Server flessibile

Personalizzazione dei parametri

Livello globale

Livelli granulari

Elencare tutti i parametri del server

Elencare i parametri del server con impostazioni predefinite modificate

Elencare i parametri del server statico di lettura/scrittura

Elencare i parametri del server dinamico di lettura/scrittura

Elencare i parametri del server di sola lettura

Impostare il valore di uno o più parametri del server

Ripristinare il valore predefinito di un parametro del server

Ripristinare tutte le impostazioni predefinite di tutti i parametri del server

Uso dei parametri del fuso orario

Commenti e suggerimenti

Risorse aggiuntive

Condividi tramite

Configurare i parametri del server in Database di Azure per PostgreSQL - Server flessibile

Personalizzazione dei parametri

Livello globale

Livelli granulari

Elencare tutti i parametri del server

Elencare i parametri del server con impostazioni predefinite modificate

Elencare i parametri del server statico di lettura/scrittura

Elencare i parametri del server dinamico di lettura/scrittura

Elencare i parametri del server di sola lettura

Impostare il valore di uno o più parametri del server

Ripristinare il valore predefinito di un parametro del server

Ripristinare tutte le impostazioni predefinite di tutti i parametri del server

Uso dei parametri del fuso orario

Contenuto correlato

Commenti e suggerimenti

Risorse aggiuntive