Configuración de parámetros de servidor en Azure Database for PostgreSQL: Servidor flexible

SE APLICA A: Azure Database for PostgreSQL con servidor flexible

Puede enumerar, mostrar y actualizar parámetros de configuración para una instancia de servidor flexible de Azure Database for PostgreSQL.

Personalización de parámetros

Hay varios métodos y niveles disponibles para personalizar los parámetros según sus necesidades específicas.

Nivel global

Para ver los valores configurados actuales para los parámetros del servidor o para modificarlos globalmente en el nivel de instancia o servidor, puede usar los Parámetros del servidor página en Azure Portal. También puede interactuar con parámetros de servidor globalmente mediante la CLI, laAPI de REST, Plantillas de Azure Resource Managero herramientas de IaC de terceros.

Nota:

Dado que Azure Database for PostgreSQL es un servicio de base de datos administrado, los usuarios no tienen acceso de host o sistema operativo para ver o modificar archivos de configuración, como postgresql.conf. El contenido de los archivos se actualiza automáticamente en función de los cambios de parámetro que realice.

En este mismo artículo puede encontrar secciones para interactuar con los parámetros del servidor globalmente para:

• Enumerar todos los parámetros del servidor.
• Enumerar parámetros de servidor con valores predeterminados modificados.
• Enumerar parámetros de servidor estático de lectura y escritura.
• Enumerar parámetros de servidor dinámico de lectura y escritura.
• Enumerar parámetros de servidor de solo lectura.
• Establezca el valor de uno o varios parámetros de servidor.
• Revertir un parámetro de servidor a su valor predeterminado.
• Revierta todos los parámetros de servidor a sus valores predeterminados.

Niveles granulares

Puede ajustar los parámetros en niveles más granulares. Estos ajustes invalidan los valores establecidos globalmente. Su ámbito y duración dependen del nivel en el que los haga:

• Nivel de base de datos: Use el comando ALTER DATABASE para configuraciones específicas de la base de datos.

• Nivel de rol o de usuario: use el comando ALTER USER para la configuración centrada en el usuario.

• Función, nivel de procedimiento: cuando se define una función o procedimiento, puede especificar o modificar los parámetros de configuración que se usan cuando se llama a la función.

• Nivel de tabla: por ejemplo, puede modificar parámetros relacionados con el autovaciado en este nivel.

• Nivel de sesión: para la vida de una sesión de base de datos individual, puede ajustar parámetros específicos. PostgreSQL facilita este ajuste con los siguientes comandos SQL:

  • Use el comando SET para realizar ajustes específicos de la sesión. Estos cambios sirven como la configuración predeterminada durante la sesión actual. El acceso a estos cambios puede requerir privilegios específicosSET, y las limitaciones de los parámetros modificables y de solo lectura descritos anteriormente no se aplican. La función SQL correspondiente es set_config(setting_name, new_value, is_local).
  • Use el comando SHOW para examinar la configuración de parámetros existente. Su función SQL equivalente es current_setting(setting_name text).

Enumerar todos los parámetros del servidor

Portal

Mediante Azure Portal:

1. Seleccione la instancia de servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en la sección Configuración, seleccione Parámetros del servidor. La página muestra una lista de parámetros, sus valores configurados, unidades opcionales, si son de solo lectura, dinámicos o estáticos, y sus descripciones.

   

3. Seleccione o mantenga el puntero sobre el icono de i (información) para ver los valores permitidos en los que se puede establecer cada parámetro. Según el tipo de datos del parámetro, que puede ser cadena, enumeración, entero, booleano, numérico, set, los valores permitidos varían. Y puede ser expresión regular, lista de valores, intervalo de enteros, activado y desactivado, intervalo de decimales, lista de valores, respectivamente.

   

4. La lista de parámetros de servidor admitidos por la instancia consta de varios cientos de elementos, que se representan en páginas de 20 elementos cada uno. En la parte inferior de la página, hay un control en el que se le informa de la posición en la que está. También hay un control de paginación que puede usar para navegar por todo el conjunto de páginas.

   

5. Si es necesario, use el Buscar para filtrar elementos... cuadro de texto para restringir la lista a esos parámetros que contienen el término de búsqueda en su nombre o en su descripción.

   

La columna Tipo de parámetro puede mostrar cualquiera de los siguientes valores para cada parámetro:

Tipo de parámetro	Descripción
Estática	Requiere un reinicio del servidor para que el cambio sea efectivo.
Dinámica	Se puede modificar sin necesidad de reiniciar la instancia del servidor. Sin embargo, los cambios solo se aplicarán a las nuevas conexiones establecidas después de la modificación.
Solo lectura	No es configurable por el usuario, debido a su rol fundamental en el mantenimiento de la confiabilidad, la seguridad u otros aspectos operativos del servicio.

CLI

Puede enumerar todos los parámetros de servidor de un servidor a través del comando az postgres flexible-server parameter list.

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

Cada parámetro tiene los siguientes atributos:

Attribute name	Descripción	Valores posibles
allowedValues	Describe los valores permitidos para el parámetro.	Dependiendo del valor de dataType, puede ser una expresión regular (cadena), una lista de valores (enumeración), un intervalo de enteros (entero), activado y desactivado (booleano), intervalo de decimales (numérico), lista de valores (conjunto).
dataType	Tipo de datos usados para el parámetro.	Puede ser cualquiera de boolean, enumeration, integer, numeric, set, string.
defaultValue	Valor asignado al parámetro cuando se implementa un nuevo servidor.	Varía, según el tipo de datos y los valores permitidos del parámetro.
descripción	Breve explicación de lo que controla el parámetro.	Descripción textual diferente para cada parámetro.
documentationLink	Dirección URL de la página que apunta a la documentación del parámetro.	Algún tipo de dirección URL.
id	Identificador de recursos que hace referencia de forma única al parámetro de servidor en esta instancia concreta del servidor flexible.	Cadena que sigue al patrón /subscriptions/<subscription_identifier>/resourceGroups/<resource_group_name>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server_name>/configurations/<parameter_name>.
isConfigPendingRestart	Indica si se requiere un reinicio del servidor para el valor establecido actualmente en el valor atributo que surte efecto.	true: para los parámetros cuyo valor se cambió y, porque no son dinámicos (es decir, son estáticos), requieren un reinicio del servidor para que el cambio surta efecto. false: para los parámetros cuyo valor establecido actualmente en el valor de valor atributo está en vigor y no están esperando que un reinicio del servidor surta efecto.
isDynamicConfig	Indica si un cambio en el valor asignado al parámetro no requiere o requiere un reinicio del servidor, para que el cambio entre en vigor.	true: para los parámetros que, cuando cambia su valor, el cambio entre en vigor inmediatamente. false: para los parámetros que, cuando cambia su valor, requieren un reinicio del servidor para que el cambio entre en vigor.
isReadOnly	Indica si el usuario puede invalidar o no puede invalidar el valor predeterminado asignado para el parámetro.	true: para los parámetros designados como de solo lectura y el usuario no puede cambiar. false: para los parámetros designados como de lectura y escritura y el usuario puede establecer en un valor diferente al predeterminado.
name	Nombre del parámetro.	Cualquier nombre válido para un parámetro de servidor.
resourceGroup	Nombre del grupo de recursos en el que se implementa el servidor.	Cualquier nombre válido para un grupo de recursos en Azure.
source	Origen del que se origina el valor establecido actualmente para el parámetro.	system-default o user-override, dependiendo de si valor se establece en el valor predeterminado del sistema o el usuario lo invalida.
unidad	Texto opcional que describe las unidades en las que se expresa el parámetro.	Cuando se establece en algo, puede ser cualquiera de 8KB, bytes, days, KB, megabytes, microseconds, milliseconds, minutes, percentage, seconds.
value	Valor asignado actualmente al parámetro.	Varía, según el tipo de datos y los valores permitidos del parámetro.

Enumerar parámetros de servidor con valores predeterminados modificados

Portal

Mediante Azure Portal:

1. Seleccione la instancia de servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en la sección Configuración, seleccione Parámetros del servidory, a continuación, seleccione la pestaña Modificado. En la página se muestra una lista de parámetros cuyo valor establecido actualmente se desvía del valor predeterminado.

   

CLI

Puede enumerar todos los parámetros de servidor cuyos valores se modifican a partir de los valores predeterminados, a través del 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:

El comando anterior de la CLI no tiene en cuenta los parámetros de servidor modificados que se designan como de solo lectura, temp_tablespaces y vacuum_cost_page_miss, siguiendo los mismos criterios que los Parámetros del servidor página en Azure Portal.

Enumerar parámetros de servidor estático de lectura y escritura

Portal

Mediante Azure Portal:

1. Seleccione la instancia de servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en la sección Configuración, seleccione Parámetros del servidory, a continuación, seleccione la pestaña Estático. En la página se muestra una lista de parámetros de lectura y escritura para los que, si se cambia su valor, se requiere un reinicio del servidor para que el nuevo valor entre en vigor.

   

CLI

Puede enumerar todos los parámetros de servidor que requieren un reinicio después de cambiar sus valores, de modo que los cambios surtan efecto, a través del 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"

Enumerar parámetros de servidor dinámico de lectura y escritura

Portal

Mediante Azure Portal:

1. Seleccione la instancia de servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en la sección Configuración, seleccione Parámetros del servidory, a continuación, seleccione la pestaña Dinámica. En la página se muestra una lista de parámetros de lectura y escritura para los que, si se cambia su valor, se requiere un reinicio del servidor para que el nuevo valor entre en vigor.

   

CLI

Puede enumerar todos los parámetros de servidor que no requieren un reinicio después de cambiar sus valores para que los cambios surtan efecto, a través del comandoaz postgres flexible-server parameter list.

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

Enumerar parámetros de servidor de solo lectura

Portal

Mediante Azure Portal:

1. Seleccione la instancia de servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en la sección Configuración, seleccione Parámetros del servidory, a continuación, seleccione la pestaña Solo lectura. La página muestra una lista de parámetros de solo lectura.

   

CLI

Puede enumerar todos los parámetros de servidor designados como de solo lectura, cuyos valores no pueden cambiar los usuarios mediante el comando az postgres flexible-server parameter list.

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

Establecer el valor de uno o varios parámetros de servidor

Portal

Mediante Azure Portal:

1. Seleccione la instancia de servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en la sección Configuración, seleccione Parámetros del servidor.

3. Busque los parámetros de lectura y escritura cuyos valores actuales desea cambiar, establézcalos en los nuevos valores deseados, observe que un mensaje informativo indica cuántos cambios de parámetros de servidor aún no se guardan y seleccione Guardar.

   

4. Si la columna Tipo de parámetro para cualquiera de los parámetros modificados es igual a Estático, el servidor requiere un reinicio para que los cambios surtan efecto. En ese caso, aparece un cuadro de diálogo para que pueda seleccionar si desea:

   • Guardar y reiniciar: en caso de que desee conservar todos los cambios realizados en todos los parámetros cuyos valores se modificaron y inmediatamente después de reiniciar el servidor para que los cambios en los parámetros estáticos entren en vigor.
   • Guardar solo: si desea conservar todos los cambios realizados en todos los parámetros cuyos valores establecidos han cambiado, pero desea aplazar el reinicio del servidor a un momento posterior. Hasta que no complete la acción de reinicio del servidor, los cambios realizados en los parámetros estáticos del servidor no surten efecto.
   • Cancelar: para no implementar ningún cambio todavía.

   

CLI

Puede establecer el valor de un parámetro de servidor a través del 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 <value>

Y puede usar el siguiente script para reiniciar condicionalmente el servidor, si alguno de los parámetros modificados requiere un reinicio para que el cambio entre en 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

Revertir un parámetro de servidor a su valor predeterminado

Portal

Mediante Azure Portal:

1. Seleccione la instancia de servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en la sección Configuración, seleccione Parámetros del servidor.

3. Busque el parámetro de lectura y escritura cuyo valor actual desea revertir a su valor predeterminado, seleccione los puntos suspensivos en el lado derecho del scree y seleccione Restablecer al valor predeterminado.

   

Importante

En el caso de los parámetros designados como de solo lectura, al seleccionar los puntos suspensivos no aparece la opción de menú Restablecer a predeterminado.

4. Si la columna Tipo de parámetro para el parámetro que intenta restablecer de forma predeterminada es igual a Estático, el servidor requiere un reinicio para que el cambio entre en vigor. En ese caso, aparece un cuadro de diálogo para que pueda seleccionar si desea:

   • Guardar y reiniciar: en caso de que desee conservar todos los cambios realizados en todos los parámetros cuyos valores se modificaron y inmediatamente después de reiniciar el servidor para que los cambios en los parámetros estáticos entren en vigor.
   • Guardar solo: si desea conservar todos los cambios realizados en todos los parámetros cuyos valores establecidos han cambiado, pero desea aplazar el reinicio del servidor a un momento posterior. Hasta que no complete la acción de reinicio del servidor, los cambios realizados en los parámetros estáticos del servidor no surten efecto.
   • Cancelar: para no implementar ningún cambio todavía.

   

CLI

Puede revertir el valor de un parámetro de servidor a su valor predeterminado a través del 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) 

Y puede usar el siguiente script para reiniciar condicionalmente el servidor, si el parámetro cambiado requiere un reinicio para que el cambio surta efecto:

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

Revertir todos los parámetros del servidor a sus valores predeterminados

Portal

Mediante Azure Portal:

1. Seleccione la instancia de servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en la sección Configuración, seleccione Parámetros del servidor.

3. Seleccione Restablecer todo al valor predeterminado.

   

4. Si, para cualquiera de los parámetros cuyo valor actual no coincide con su valor predeterminado, el Tipo de parámetro es igual a Estático, el servidor requiere un reinicio para que el cambio surta efecto. En ese caso, aparece un cuadro de diálogo para que pueda seleccionar si desea:

   • Guardar y reiniciar: en caso de que desee conservar todos los cambios realizados en todos los parámetros cuyos valores se modificaron y inmediatamente después de reiniciar el servidor para que los cambios en los parámetros estáticos entren en vigor.
   • Guardar solo: si desea conservar todos los cambios realizados en todos los parámetros cuyos valores establecidos han cambiado, pero desea aplazar el reinicio del servidor a un momento posterior. Hasta que no complete la acción de reinicio del servidor, los cambios realizados en los parámetros estáticos del servidor no surten efecto.
   • Cancelar: para no implementar ningún cambio todavía.

   

CLI

Puede revertir el valor de todos los parámetros de servidor de lectura y escritura a sus valores predeterminados a través del 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

Y puede usar el siguiente script para reiniciar condicionalmente el servidor, si alguno de los parámetros modificados requiere un reinicio para que su cambio surta efecto:

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

Trabajo con el parámetro de zona horaria

Si planea trabajar con datos de fecha y hora en PostgreSQL, asegúrese de establecer la zona horaria correcta para su ubicación. Todas las fechas y horas que reconocen la zona horaria se almacenan internamente en PostgreSQL en formato UTC. Se convierten en hora local en la zona especificada por el parámetro de servidor TimeZone antes de mostrarse al cliente. Este parámetro se puede editar en la página Parámetros del servidor. PostgreSQL permite especificar zonas horarias de tres formas diferentes:

• Un nombre de zona horaria completo, por ejemplo, América/Nueva_York. Los nombres de zona horaria reconocidos se muestran en la vista pg_timezone_names.
  Ejemplo para consultar esta vista en psql y obtener una lista de nombres de zona horaria:

  select name FROM pg_timezone_names LIMIT 20;

  Verá un conjunto de resultados parecido al siguiente:

            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)
    

• Abreviatura de zona horaria, por ejemplo, PST. Esta especificación simplemente define una diferencia horaria particular con UTC, al contrario que los nombres de zona horaria completos, que también pueden implicar un conjunto de reglas de fecha de transición del horario de verano. Las abreviaturas reconocidas se muestran en el ejemplo de la vista pg_timezone_abbrevs para consultar esta vista en psql y obtener la lista de abreviaturas de zona horaria:

   select abbrev from pg_timezone_abbrevs limit 20;

  Verá un conjunto de resultados parecido al siguiente:

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

• Además de los nombres y abreviaturas de zona horaria, PostgreSQL acepta especificaciones de zona horaria de estilo POSIX del formato STDoffset o STDoffsetDST, donde STD es una abreviatura de zona, offset es un desplazamiento numérico en horas oeste de UTC y DST es una abreviatura opcional de zona de verano, que se supone que se mantiene durante una hora antes del desplazamiento especificado.

Comparta sugerencias y errores con el equipo de producto de Azure Database for PostgreSQL.

Contenidos relacionados

• información general sobre los parámetros del servidor