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, mostrar e atualizar 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 de instância ou servidor, você pode usar a página 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.

Nota

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 de parâmetros feitas.

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

• Liste todos os parâmetros do servidor.
• Listar parâmetros do servidor com padrões modificados.
• Listar parâmetros de servidor estático de leitura-gravação.
• Liste parâmetros dinâmicos de servidor de leitura-gravação.
• Liste parâmetros de servidor somente leitura.
• Defina o valor de um ou mais parâmetros do servidor.
• Reverta um parâmetro de servidor para seu padrão.
• Reverta todos os parâmetros do servidor para seus padrões.

Níveis granulares

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

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

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

• Função, nível de procedimento: 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 da tabela: Como exemplo, você pode modificar parâmetros relacionados ao autovácuo nesse nível.

• Nível de sessão: Durante a vida de 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 para fazer ajustes específicos da SET sessão. Essas alterações servem como as configurações padrão durante a sessão atual. O acesso a essas alterações pode exigir privilégios específicos SET , e as limitações para parâmetros modificáveis e somente leitura descritas anteriormente não se aplicam. A função SQL correspondente é set_config(setting_name, new_value, is_local).
  • Use o comando para examinar as configurações de SHOW parâmetros existentes. Seu equivalente de função SQL é current_setting(setting_name text).

Listar todos os parâmetros do servidor

Portal

Usando o portal do Azure:

1. Selecione sua instância de 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, seus valores configurados, unidades opcionais, se são somente leitura/dinâmicas/estáticas e suas descrições.

   

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

   

4. A lista de parâmetros de servidor suportados pela 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 informá-lo da 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 aos parâmetros que contêm o termo de pesquisa em seu nome ou em sua descrição.

   

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

Tipo de parâmetro	Description
Estático	Requer uma reinicialização do servidor para tornar a alteração efetiva.
Dinâmico	Pode ser alterado sem a necessidade de reiniciar a instância do servidor. No entanto, as alterações aplicar-se-ão apenas a novas ligações estabelecidas após a modificação.
Só de leitura	Não é configurável pelo usuário, devido ao seu papel crítico na manutenção da confiabilidade, segurança ou outros aspetos operacionais do serviço.

CLI

Você pode listar todos os parâmetros do servidor em um servidor através 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:

Attribute name	Description	Valores possíveis
allowedValues	Descreve os valores permitidos para o parâmetro.	Dependendo do valor de dataType, pode ser uma expressão regular (string), lista de valores (enumeração), intervalo de inteiros (inteiro), on/off (booleano), intervalo de decimais (numérico), lista de valores (set).
Tipo de dados	Tipo de dados utilizados para o parâmetro.	Pode ser qualquer um dos boolean, enumeration, , integer, setnumeric, 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	Breve explicação do que o parâmetro controla.	Descrição textual que é diferente para cada parâmetro.
documentaçãoLink	Endereço URL da página apontando para a documentação do parâmetro.	Alguma forma de URL.
id	Identificador de recurso que se refere exclusivamente ao parâmetro server nesta instância específica de 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, por não serem dinâmicos (ou seja, estáticos), exija 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 a reinicialização do servidor para entrar 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 seu valor muda, a alteração entra em vigor imediatamente. false: para parâmetros que, quando seu valor muda, exigem uma reinicialização do servidor para que a alteração entre em vigor.
isReadOnly	Indica se o valor padrão atribuído ao parâmetro pode ou não ser substituído pelo usuário.	true: para parâmetros que são designados como somente leitura e o usuário não pode alterar. false: para parâmetros que são designados como leitura-gravação e o usuário pode definir para um valor diferente do padrão.
Designação	Nome do parâmetro.	Qualquer nome válido para um parâmetro de servidor.
resourceGroup [en]	Nome do grupo de recursos no qual o servidor está implantado.	Qualquer nome válido para um grupo de recursos no Azure.
fonte	Origem da qual se origina o valor atualmente definido para o parâmetro.	system-default ou user-override, dependendo se o valor está definido como padrão do sistema ou se o usuário o substitui.
unidade	Texto opcional que descreve as unidades em que o parâmetro é expresso.	Quando definido como algo, pode ser qualquer um dos 8KB, bytes, days, , megabytesKB, microseconds, , milliseconds, percentageminutes, seconds.
valor	Valor atualmente atribuído ao parâmetro.	Varia, dependendo do tipo de dados e dos valores permitidos do parâmetro.

Listar parâmetros do servidor com padrões modificados

Portal

Usando o portal do Azure:

1. Selecione sua instância de 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 Modificado . A página mostra uma lista de parâmetros cujo valor definido atualmente se desvia do padrão.

   

CLI

Você pode listar todos os parâmetros do servidor cujos valores são modificados a partir dos padrões, através 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"

Nota

O comando anterior da CLI não considera parâmetros de servidor modificados aqueles que são designados como somente temp_tablespaces leitura 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 de 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 seu valor for alterado, será necessário reiniciar o servidor para que o novo valor entre em vigor.

   

CLI

Você pode listar todos os parâmetros do servidor que 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==\`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 de 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 seu valor for alterado, será necessário reiniciar o servidor para que o novo valor entre em vigor.

   

CLI

Você pode listar todos os parâmetros do 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 de 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 do servidor que são 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 do servidor

Portal

Usando o portal do Azure:

1. Selecione sua instância de 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âmetros do servidor ainda não foram salvas e selecione Salvar.

   

4. Se a coluna Tipo de parâmetro 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 aparece para que você possa selecionar se deseja:

   • Salvar e Reiniciar: Caso você queira 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.
   • Somente salvar: caso você queira persistir todas as alterações feitas em todos os parâmetros cujos valores definidos foram alterados, mas queira adiar a reinicialização do servidor para um momento posterior. Até que você não conclua a ação de reinicialização do servidor, as alterações feitas em quaisquer parâmetros estáticos do servidor não terão efeito.
   • Cancelar: Para não implementar nenhuma alteração ainda.

   

CLI

Você pode definir o valor de um parâmetro de servidor através 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 seu padrão

Portal

Usando o portal do Azure:

1. Selecione sua instância de 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 seu padrão, selecione as reticências no lado direito da placa e selecione Redefinir para 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 padrão .

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

   • Salvar e Reiniciar: Caso você queira 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.
   • Somente salvar: caso você queira persistir todas as alterações feitas em todos os parâmetros cujos valores definidos foram alterados, mas queira adiar a reinicialização do servidor para um momento posterior. Até que você não conclua a ação de reinicialização do servidor, as alterações feitas em quaisquer parâmetros estáticos do servidor não terão efeito.
   • Cancelar: Para não implementar nenhuma alteração ainda.

   

CLI

Você pode reverter o valor de um parâmetro de servidor para seu padrão 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 $(az postgres flexible-server parameter show --resource-group <resource_group> --server-name <server> --name <parameter> --output tsv) 

E você pode usar o seguinte script 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 seus padrões

Portal

Usando o portal do Azure:

1. Selecione sua instância de 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 corresponde ao padrão, a coluna Tipo de parâmetro 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 aparece para que você possa selecionar se deseja:

   • Salvar e Reiniciar: Caso você queira 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.
   • Somente salvar: caso você queira persistir todas as alterações feitas em todos os parâmetros cujos valores definidos foram alterados, mas queira adiar a reinicialização do servidor para um momento posterior. Até que você não conclua a ação de reinicialização do servidor, as alterações feitas em quaisquer parâmetros estáticos do servidor não terão efeito.
   • Cancelar: Para não implementar nenhuma alteração ainda.

   

CLI

Você pode reverter o valor de todos os parâmetros do 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 sua 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

Trabalhando 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. Eles são convertidos para a hora local na zona especificada pelo parâmetro do servidor TimeZone antes de serem exibidos para o cliente. Este parâmetro pode ser editado na página Parâmetros do servidor. O PostgreSQL permite especificar fusos horários em três formas diferentes:

• Um nome de fuso horário completo, por exemplo, America/New_York. Os nomes de fuso horário reconhecidos são listados na visualização pg_timezone_names .
  Exemplo para consultar esta vista em psql e obter uma lista de nomes de fuso horário:

  select name FROM pg_timezone_names LIMIT 20;

  Você deve ver o conjunto de resultados como:

            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 abreviatura de fuso horário, por exemplo PST. Tal especificação apenas define um deslocamento específico do UTC, em contraste com nomes de fuso horário completo, o que também pode implicar um conjunto de regras de data de transição do horário de verão. As abreviaturas reconhecidas estão listadas no Exemplo de visualização pg_timezone_abbrevs para consultar esta vista em psql e obter uma lista de abreviaturas de fuso horário:

   select abbrev from pg_timezone_abbrevs limit 20;

  Você deve ver o conjunto de resultados como:

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

• Além dos nomes e abreviaturas de fuso horário, o PostgreSQL aceita especificações de fuso horário no estilo POSIX do formato STDoffset ou STDoffsetDST, onde STD é uma abreviação de zona, offset é um deslocamento numérico em horas a oeste do UTC e DST é uma abreviação opcional de zona de horário de verão, presumida para ficar uma hora à frente do deslocamento dado.

Partilhe as suas sugestões e bugs com a equipa de produto da Base de Dados do Azure para PostgreSQL.

Conteúdos relacionados

• Visão geral dos parâmetros do servidor