Configurar parâmetros de servidor no Banco de Dados do Azure para PostgreSQL – Servidor Flexível

APLICA-SE A: Banco de dados do Azure para PostgreSQL – Servidor Flexível

Você pode listar, exibir e atualizar os parâmetros de configuração para uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL.

Personalização de parâmetros

Vários métodos e níveis estão disponíveis para personalizar seus parâmetros de acordo com suas necessidades específicas.

Nível global

Para exibir os valores configurados atuais para parâmetros de servidor ou para alterá-los globalmente no nível da instância ou do servidor, você pode usar a página de Parâmetros do servidor no portal do Azure. Você também pode interagir com parâmetros de servidor globalmente usando a CLI, a API REST, modelos do Azure Resource Manager ou ferramentas IaC de terceiros.

Observação

Como o Banco de Dados do Azure para PostgreSQL é um serviço de banco de dados gerenciado, os usuários não têm acesso ao host ou ao sistema operacional para exibir ou modificar arquivos de configuração, como postgresql.conf. O conteúdo dos arquivos é atualizado automaticamente com base nas alterações que você faz no parâmetro.

Neste mesmo artigo, você pode encontrar seções para interagir com parâmetros de servidor globalmente para:

• Listar todos os parâmetros do servidor.
• Listar parâmetros de servidor com padrões modificados.
• Listar parâmetros de servidor estático de leitura/gravação.
• Listar parâmetros de servidor dinâmico de leitura/gravação.
• Listar parâmetros de servidor somente leitura.
• Definir o valor de um ou mais parâmetros de servidor.
• Reverter um parâmetro de servidor para o valor padrão dele.
• Reverta todos os parâmetros do servidor para os valores padrão dele.

Níveis granulares

Você pode ajustar parâmetros em níveis mais granulares. Esses ajustes substituem valores definidos globalmente. O escopo e a duração dependem do nível em que você os faz:

• Nível de banco de dados: utilize o comando ALTER DATABASE para configurações específicas do banco de dados.

• Nível de usuário ou função: use o comando ALTER USER para configurações centradas no usuário.

• Nível de procedimento, função: ao definir uma função ou procedimento, você pode especificar ou alterar os parâmetros de configuração que são usados quando a função é chamada.

• Nível de tabela: por exemplo, você pode modificar parâmetros relacionados ao vácuo automático nesse nível.

• Nível de sessão: durante uma sessão de banco de dados individual, você pode ajustar parâmetros específicos. O PostgreSQL facilita esse ajuste com os seguintes comandos SQL:

  • Use o comando SET permite para fazer ajustes específicos à sessão. Essas alterações servem como configurações padrão durante a sessão atual. O acesso a essas alterações pode exigir privilégios SET específicos, e as limitações de parâmetros modificáveis e somente leitura descritos antes não se aplicam. A função SQL correspondente é set_config(setting_name, new_value, is_local).
  • Use o comando SHOW para examinar as configurações de parâmetro existentes. A função SQL equivalente é current_setting(setting_name text).

Listar todos os parâmetros do servidor

Portal

Usando o portal do Azure:

1. Selecione sua instância do servidor flexível do Banco de Dados do Azure para PostgreSQL.

2. No menu de recursos, na seção Configurações, selecione Parâmetros do servidor. A página mostra uma lista de parâmetros, os seus valores configurados, unidades opcionais, se eles são somente leitura/dinâmicos/estáticos e as descrições deles.

   

3. Selecione ou passe o mouse sobre o ícone i (informações) para ver os valores permitidos aos quais cada parâmetro pode ser definido. Dependendo do tipo de dados do parâmetro, que pode ser cadeia de caracteres, enumeração, inteiro, booliano, numérico, conjunto, os valores permitidos variam. E pode ser uma expressão regular, lista de valores, intervalo de inteiros, ligado/desligado, intervalo de decimais, lista de valores, respectivamente.

   

4. A lista de parâmetros de servidor compatível com a instância consiste em várias centenas de itens, que são renderizados em páginas de 20 itens cada. Na parte inferior da página, há um controle para informar você sobre a posição em que você está. Há também um controle de paginação que você pode usar para navegar por todo o conjunto de páginas.

   

5. Se necessário, use a caixa de texto Pesquisar para filtrar itens... para restringir a lista a esses parâmetros que contêm o termo de pesquisa no nome deles ou na descrição deles.

   

A coluna Tipo de parâmetro pode mostrar qualquer um dos seguintes valores para cada parâmetro:

Tipo de parâmetro	Descrição
Estático	Requer uma reinicialização do servidor para tornar a alteração eficaz.
Dinâmico	Pode ser alterado sem a necessidade de reiniciar a instância do servidor. No entanto, as alterações serão aplicadas somente a novas conexões estabelecidas após a modificação.
Somente leitura	Não é configurável pelo usuário devido à sua função crítica na manutenção da confiabilidade, da segurança ou de outros aspectos operacionais do serviço.

CLI

Você pode listar todos os parâmetros de servidor em um servidor por meio do comando az postgres flexible-server parameter list.

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

Cada parâmetro tem os seguintes atributos:

Nome do atributo	Descrição	Valores possíveis
allowedValues	Descreve os valores permitidos para o parâmetro.	Dependendo do valor de dataType, pode ser uma expressão regular (cadeia de caracteres), lista de valores (enumeração), intervalo de inteiros (inteiro), ligado/desligado (booliano), intervalo de decimais (numéricos), lista de valores (conjunto).
dataType	Tipo de dados usado para o parâmetro.	Pode ser qualquer um de boolean, enumeration, integer, numeric, set e string.
defaultValue	Valor atribuído ao parâmetro quando um novo servidor é implantado.	Varia, dependendo do tipo de dados e dos valores permitidos do parâmetro.
descrição	Uma explicação breve sobre o que o parâmetro controla.	Descrição textual, que é diferente para cada parâmetro.
documentationLink	Endereço de URL da página que aponta para a documentação do parâmetro.	Alguma forma de URL.
id	Identificador de recurso que se refere exclusivamente ao parâmetro de servidor nesta instância específica do servidor flexível.	Uma cadeia de caracteres que segue o padrão /subscriptions/<subscription_identifier>/resourceGroups/<resource_group_name>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server_name>/configurations/<parameter_name>.
isConfigPendingRestart	Indica se uma reinicialização do servidor é necessária para que o valor atualmente definido no atributo value entre em vigor.	true: para parâmetros cujo valor foi alterado e, como eles não são dinâmicos (ou seja, são estáticos), exigem uma reinicialização do servidor para que a alteração entre em vigor. false: para parâmetros cujo valor atualmente definido no atributo value está em vigor e não estão aguardando que uma reinicialização do servidor entre em vigor.
isDynamicConfig	Indica se uma alteração no valor atribuído ao parâmetro não requer ou requer uma reinicialização do servidor para que a alteração entre em vigor.	true: para parâmetros que, quando o valor deles é alterado, a alteração entra em vigor imediatamente. false: para parâmetros que, quando o valor deles é alterado, exigem uma reinicialização do servidor para que a alteração entre em vigor.
isReadOnly	Indica se o valor padrão atribuído para o parâmetro pode ou não ser substituído pelo usuário.	true: para parâmetros designados como somente leitura e que o usuário não pode alterar. false: para parâmetros designados como leitura/gravação e que o usuário pode definir como um valor diferente do padrão.
name	Nome do parâmetro.	Qualquer nome válido para um parâmetro de servidor.
resourceGroup	O nome do grupo de recursos no qual o servidor está implantado.	Qualquer nome válido para um grupo de recursos no Azure.
source	Origem da qual o valor definido atualmente para o parâmetro é originado.	system-default ou user-override, dependendo se value é definido como o padrão do sistema ou se o usuário o substitui.
unidade	Texto opcional que descreve as unidades nas quais o parâmetro é expresso.	Quando definido como algo, pode ser qualquer um de 8KB, bytes, days, KB, megabytes, microseconds, milliseconds, minutes, percentage e seconds.
value	Valor atribuído atualmente ao parâmetro.	Varia, dependendo do tipo de dados e dos valores permitidos do parâmetro.

Listar parâmetros de servidor com padrões modificados

Portal

Usando o portal do Azure:

1. Selecione sua instância do servidor flexível do Banco de Dados do Azure para PostgreSQL.

2. No menu de recursos, na seção Configurações, selecione Parâmetros de servidor e, em seguida, selecione a guia Última modificação. A página mostra uma lista de parâmetros cujo valor atualmente definido se desvia do padrão.

   

CLI

Você pode listar todos os parâmetros de servidor cujos valores são modificados de padrões, por meio do 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"

Observação

O comando anterior da CLI não considera os parâmetros de servidor modificados que são designados como somente leitura, temp_tablespaces e vacuum_cost_page_miss, seguindo exatamente os mesmos critérios da página Parâmetros do servidor no portal do Azure.

Listar parâmetros de servidor estático de leitura/gravação

Portal

Usando o portal do Azure:

1. Selecione sua instância do servidor flexível do Banco de Dados do Azure para PostgreSQL.

2. No menu de recursos, na seção Configurações, selecione Parâmetros do servidor e, em seguida, selecione a guia Estático. A página mostra uma lista de parâmetros de leitura/gravação para os quais, se o valor for alterado, exigirá uma reinicialização do servidor para que o novo valor entre em vigor.

   

CLI

Você pode listar todos os parâmetros de servidor que exigem uma reinicialização depois que os valores deles são alterados, para que as alterações entrem em vigor, por meio do 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"

Listar parâmetros de servidor dinâmico de leitura/gravação

Portal

Usando o portal do Azure:

1. Selecione sua instância do servidor flexível do Banco de Dados do Azure para PostgreSQL.

2. No menu de recursos, na seção Configurações, selecione Parâmetros do servidor e, em seguida, selecione a guia Dinâmico. A página mostra uma lista de parâmetros de leitura/gravação para os quais, se o valor for alterado, exigirá uma reinicialização do servidor para que o novo valor entre em vigor.

   

CLI

Você pode listar todos os parâmetros de servidor que não exigem uma reinicialização depois que seus valores são alterados para que as alterações entrem em vigor, por meio do 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"

Listar parâmetros de servidor somente leitura

Portal

Usando o portal do Azure:

1. Selecione sua instância do servidor flexível do Banco de Dados do Azure para PostgreSQL.

2. No menu de recursos, na seção Configurações, selecione Parâmetros do servidor e, em seguida, selecione a guia Somente leitura. A página mostra uma lista de parâmetros somente leitura.

   

CLI

Você pode listar todos os parâmetros de servidor designados como somente leitura, cujos valores não podem ser alterados pelos usuários, por meio do comando az postgres flexible-server parameter list.

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

Definir o valor de um ou mais parâmetros de servidor

Portal

Usando o portal do Azure:

1. Selecione sua instância do servidor flexível do Banco de Dados do Azure para PostgreSQL.

2. No menu de recursos, na seção Configurações, selecione Parâmetros do servidor.

3. Localize os parâmetros de leitura/gravação cujos valores atuais você deseja alterar, defina-os para os novos valores desejados, observe que uma mensagem informativa indica quantas alterações de parâmetro de servidor ainda não foram salvas e selecione Salvar.

   

4. Se o Tipo de parâmetro de coluna para qualquer um dos parâmetros alterados for igual a Estático, o servidor exigirá uma reinicialização para que as alterações entrem em vigor. Nesse caso, uma caixa de diálogo é exibida para que você possa selecionar se quiser:

   • Salvar e reiniciar: caso deseje persistir todas as alterações feitas em todos os parâmetros cujos valores foram modificados e imediatamente após reiniciar o servidor para que quaisquer alterações nos parâmetros estáticos entrem em vigor.
   • Salvar somente: caso você deseje persistir todas as alterações feitas em todos os parâmetros cujos valores definidos foram alterados, mas deseje adiar a reinicialização do servidor para uma hora posterior. Até que você conclua a ação de reinicialização do servidor, as alterações feitas em qualquer parâmetro de servidor estático não entrarão em vigor.
   • Cancelar: para ainda não implementar nenhuma alteração.

   

CLI

Você pode definir o valor de um parâmetro de servidor por meio do 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>

E você pode usar o seguinte script para reiniciar condicionalmente o servidor, se qualquer um dos parâmetros alterados exigir uma reinicialização para que a alteração entre em vigor:

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

Reverter um parâmetro de servidor para o padrão dele

Portal

Usando o portal do Azure:

1. Selecione sua instância do servidor flexível do Banco de Dados do Azure para PostgreSQL.

2. No menu de recursos, na seção Configurações, selecione Parâmetros do servidor.

3. Localize o parâmetro de leitura/gravação cujo valor atual você deseja reverter para o padrão dele, selecione as reticências no lado direito da tela e selecione Redefinir como padrão.

   

Importante

Para parâmetros designados como somente leitura, a seleção das reticências não exibe a opção de menu Redefinir para o padrão.

4. Se o Tipo de parâmetro de coluna para o parâmetro que você está tentando redefinir como padrão for igual a Estático, o servidor exigirá uma reinicialização para que a alteração entre em vigor. Nesse caso, uma caixa de diálogo é exibida para que você possa selecionar se quiser:

   • Salvar e reiniciar: caso deseje persistir todas as alterações feitas em todos os parâmetros cujos valores foram modificados e imediatamente após reiniciar o servidor para que quaisquer alterações nos parâmetros estáticos entrem em vigor.
   • Salvar somente: caso você deseje persistir todas as alterações feitas em todos os parâmetros cujos valores definidos foram alterados, mas deseje adiar a reinicialização do servidor para uma hora posterior. Até que você conclua a ação de reinicialização do servidor, as alterações feitas em qualquer parâmetro de servidor estático não entrarão em vigor.
   • Cancelar: para ainda não implementar nenhuma alteração.

   

CLI

Você pode reverter o valor de um parâmetro de servidor para o padrão dele por meio do comandoaz 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) 

E você pode usar o script a seguir para reiniciar condicionalmente o servidor, se o parâmetro alterado exigir uma reinicialização para que a alteração entre em vigor:

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

Reverter todos os parâmetros do servidor para os respectivos padrões

Portal

Usando o portal do Azure:

1. Selecione sua instância do servidor flexível do Banco de Dados do Azure para PostgreSQL.

2. No menu de recursos, na seção Configurações, selecione Parâmetros do servidor.

3. Selecione Redefinir tudo para o padrão.

   

4. Se, para qualquer um dos parâmetros cujo valor atual não corresponda ao padrão, o Tipo de parâmetro de coluna for igual a Estático, o servidor exigirá uma reinicialização para que a alteração entre em vigor. Nesse caso, uma caixa de diálogo é exibida para que você possa selecionar se quiser:

   • Salvar e reiniciar: caso deseje persistir todas as alterações feitas em todos os parâmetros cujos valores foram modificados e imediatamente após reiniciar o servidor para que quaisquer alterações nos parâmetros estáticos entrem em vigor.
   • Salvar somente: caso você deseje persistir todas as alterações feitas em todos os parâmetros cujos valores definidos foram alterados, mas deseje adiar a reinicialização do servidor para uma hora posterior. Até que você conclua a ação de reinicialização do servidor, as alterações feitas em qualquer parâmetro de servidor estático não entrarão em vigor.
   • Cancelar: para ainda não implementar nenhuma alteração.

   

CLI

Você pode reverter o valor de todos os parâmetros de servidor de leitura/gravação para seus padrões por meio do 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

E você pode usar o seguinte script para reiniciar condicionalmente o servidor, se qualquer um dos parâmetros alterados exigir uma reinicialização para que a alteração deles entre em vigor:

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

Trabalhar com parâmetros de fuso horário

Se você planeja trabalhar com dados de data e hora no PostgreSQL, certifique-se de definir o fuso horário correto para sua localização. Todas as datas e horas com reconhecimento de fuso horário são armazenadas internamente no PostgreSQL em UTC. Elas são convertidas para a hora local na zona especificada pelo parâmetro do servidor TimeZone antes de serem exibidas para o cliente. Esse parâmetro pode ser editado na página Parâmetros do servidor. O PostgreSQL permite especificar fusos horários de três modos diferentes:

• Um nome completo de fuso horário, como América/New_York. Os nomes de fuso horário reconhecidos estão listados na exibição pg_timezone_names.
  Veja abaixo um exemplo para consultar a exibição no psql e obter uma lista de nomes de fuso horário:

  select name FROM pg_timezone_names LIMIT 20;

  Será possível ver o seguinte conjunto de resultados:

            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)
    

• Uma abreviação do fuso horário, como PST. Essa especificação somente define um deslocamento específico do UTC, em comparação com nomes completos de fuso horário, que também podem sugerir um conjunto de regras de datas de transição para o horário de verão. As abreviações reconhecidas estão listadas na exibição pg_timezone_abbrevs. Veja abaixo um exemplo para consultar a exibição no psql e obter uma lista de abreviações de fuso horário:

   select abbrev from pg_timezone_abbrevs limit 20;

  Será possível ver o seguinte conjunto de resultados:

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

• Além de nomes e abreviações de fuso horário, o PostgreSQL aceita especificações de fuso horário no estilo POSIX de formato STDoffset ou STDoffsetDST. Desse modo, STD representa uma abreviação de zona, offset é um deslocamento numérico em horas a oeste de UTC e DST é uma abreviação de zona de horário de verão, considerada como uma hora antes do deslocamento fornecido.

Compartilhe suas sugestões e bugs com a equipe de produtos do Banco de Dados do Azure para PostgreSQL.

Conteúdo relacionado

• visão geral dos parâmetros do servidor