Set the parameters of an RDS for PostgreSQL instance - ApsaraDB RDS

Este tema describe cómo modificar los parámetros de una instancia de ApsaraDB RDS for PostgreSQL para optimizar el rendimiento o cumplir con sus requisitos empresariales. También puede consultar el historial de modificaciones de parámetros.

Notas de uso

La modificación de algunos parámetros desencadena un reinicio de la instancia. La instancia se reinicia inmediatamente después de que usted modifica los parámetros y hace clic en Apply Parameters. Para comprobar si la modificación de un parámetro provoca un reinicio, consulte la columna Force Restart en la pestaña Modifiable Parameters. Si la instancia se reinicia, su aplicación se desconecta. Asegúrese de que su negocio pueda tolerar el reinicio antes de continuar.
Cuando modifique un parámetro en la consola, consulte la columna Valid Values en la pestaña Modifiable Parameters para conocer los valores permitidos.
Cuando modifica los siguientes parámetros en la instancia principal, los cambios se sincronizan con todas las instancias de solo lectura asociadas.

wal_level, max_replication_slots, max_wal_senders, max_locks_per_transaction, max_worker_processes, max_prepared_transactions
Al modificar un parámetro, el sistema intenta aplicar el cambio. Si el nuevo valor no es válido o provoca un error en la instancia, la modificación se revierte y el resultado se marca como Failed. Puede ver el resultado en la columna Status de la pestaña Edit History.
El parámetro log_statement no se puede modificar directamente. Para cambiar este parámetro, enable or disable SQL Explorer and Audit.

Modificación de valores de parámetros

Inicie sesión en la consola de ApsaraDB RDS y vaya a la página de Instances. En la barra de navegación superior, seleccione la región donde reside la instancia de RDS. A continuación, localice la instancia de RDS y haga clic en el ID de la instancia.
En el panel de navegación izquierdo, haga clic en Parameters.
En la pestaña Modifiable Parameters, busque el parámetro que desea modificar. Puede modificar los parámetros individualmente o por lotes:
- Modificar un solo parámetro
  1. Haga clic en el icono junto al parámetro que desea modificar.
  2. Introduzca el nuevo valor y haga clic en OK.
  3. Haga clic en Apply Parameters.
  4. En el cuadro de diálogo, seleccione cuándo entrará en vigor el nuevo valor: Take Effect Immediately, Take Effect Within the Maintenance Window (02:00-06:00) o Take Effect at Specified Time. Luego, haga clic en OK.
- Modificar parámetros por lotes
  1. Haga clic en Export Parameters para descargar el archivo de parámetros a su computadora.
  2. Abra el archivo de parámetros y modifique los valores.
  3. Haga clic en Import Parameters.
  4. En el cuadro de diálogo Import Parameters, pegue los parámetros y sus nuevos valores, y luego haga clic en OK.
  5. Confirme las modificaciones en la lista de parámetros y haga clic en Apply Parameters.
  6. En el cuadro de diálogo, seleccione cuándo entrarán en vigor los nuevos valores: Take Effect Immediately, Take Effect Within the Maintenance Window (02:00-06:00) o Take Effect at Specified Time, y luego haga clic en OK.
Nota
En la pestaña Scheduled Tasks, puede ver las tareas de modificación de parámetros programadas para Take Effect Within the Maintenance Window (02:00-06:00) o Take Effect at Specified Time.

Consulta del historial de modificaciones de parámetros

Inicie sesión en la consola de ApsaraDB RDS y vaya a la página de Instances. En la barra de navegación superior, seleccione la región donde reside la instancia de RDS. A continuación, localice la instancia de RDS y haga clic en el ID de la instancia.
En el panel de navegación izquierdo, haga clic en Parameters.
Haga clic en la pestaña Edit History.
Seleccione un intervalo de tiempo y haga clic en OK.

Expresiones de parámetros

Puede usar expresiones para configurar parámetros. Cuando establece un parámetro relacionado con el tipo de instancia mediante una expresión, el valor del parámetro se ajusta automáticamente al cambiar el tipo de instancia. Esto garantiza que el valor del parámetro siga siendo óptimo para el nuevo tipo de instancia.

La siguiente tabla describe la sintaxis de expresiones compatible.

Categoría	Notas de uso	Ejemplo
Parámetros	Los siguientes parámetros admiten expresiones: Parámetros que admiten expresiones work_mem: especifica la cantidad de memoria que utilizan las operaciones de ordenamiento interno y las tablas hash antes de escribir los datos en archivos temporales. maintenance_work_mem: establece la cantidad máxima de memoria que se puede utilizar para operaciones de mantenimiento, como VACUUM y CREATE INDEX. autovacuum_work_mem: especifica la cantidad máxima de memoria que puede usar cada proceso de trabajo de autovacuum. max_parallel_workers: establece el número máximo de trabajadores que el sistema puede admitir para operaciones paralelas. max_parallel_workers_per_gather: establece el número máximo de trabajadores que puede iniciar un solo nodo Gather o Gather Merge. effective_cache_size: establece el valor predefinido del optimizador para el tamaño total de la caché de datos. autovacuum_max_workers: especifica el número máximo de procesos de autovacuum que pueden ejecutarse simultáneamente, excluyendo el lanzador de autovacuum. max_wal_size: establece el tamaño de los archivos de write-ahead logging (WAL) que desencadenan un punto de control. min_wal_size: establece el tamaño mínimo de archivos WAL para reciclar. Mientras el uso de disco de WAL se mantenga por debajo de esta configuración, los archivos WAL antiguos siempre se reciclan para uso futuro en un punto de control, en lugar de eliminarse. temp_file_limit: especifica el espacio máximo en disco que un proceso puede usar para archivos temporales, como archivos temporales de ordenamiento y hash, o el archivo de almacenamiento para un cursor mantenido. wal_buffers: establece el tamaño de los búferes de páginas de disco en la memoria compartida para WAL, que es la cantidad de memoria compartida utilizada para datos WAL que aún no se han escrito en el disco. max_parallel_maintenance_workers: establece el número máximo de trabajadores paralelos para una operación CREATE INDEX. max_worker_processes: establece el número máximo de procesos de trabajo concurrentes. Nota El parámetro max_parallel_maintenance_workers solo es compatible con RDS PostgreSQL 11.0 y versiones posteriores.	effective_cache_size
Variables	AllocatedStorage: la capacidad de almacenamiento del tipo de instancia en MB. El valor de esta variable es un número entero. DBInstanceClassMemory: el tamaño de memoria del tipo de instancia en bytes. El valor de esta variable es un número entero. DBInstanceClassCPU: el número de núcleos de CPU del tipo de instancia. El valor de esta variable es un número entero. DBInstanceClassConnections: el número máximo de conexiones del tipo de instancia. El valor de esta variable es un número entero. Nota Para obtener más información sobre los tipos de instancia y la capacidad de almacenamiento, el tamaño de memoria, el número de núcleos de CPU y el número máximo de conexiones que admite cada tipo de instancia, consulte Primary RDS for PostgreSQL instance types.	effective_cache_size={DBInstanceClassMemory/16384}
Operadores	Sintaxis de expresión: Una expresión se encierra entre llaves (`{}`). Operador de división (/): divide un dividendo entre un divisor y devuelve un cociente entero. Si el cociente es decimal, el sistema no lo redondea, sino que trunca la parte decimal. El dividendo y el divisor pueden ser decimales. Operador de multiplicación (*): multiplica dos factores y devuelve un producto entero. Si el producto es decimal, el sistema no lo redondea, sino que trunca la parte decimal. Los dos factores pueden ser decimales.	effective_cache_size={DBInstanceClassMemory/16384}
Funciones	La función GREATEST() devuelve el valor mayor de una lista de enteros o fórmulas de parámetros. La función LEAST() devuelve el valor menor de una lista de enteros o fórmulas de parámetros. La función SUM() suma los valores de enteros o fórmulas de parámetros especificados.	max_parallel_workers={GREATEST(DBInstanceClassCPU*3/4, 8)}

Referencias

Para obtener más información sobre los parámetros de PostgreSQL, consulte Server Configuration en la documentación de PostgreSQL.

Para modificar parámetros mediante llamadas a operaciones de API, consulte las siguientes API:

API	Descripción
ModifyParameter	Modifica los parámetros de una instancia de RDS.
DescribeParameterTemplates	Consulta la plantilla de parámetros de una base de datos.
DescribeParameters	Consulta la configuración actual de parámetros de una instancia.

Preguntas frecuentes

¿Cómo cambio el número máximo de conexiones para una instancia de RDS for PostgreSQL?

El número máximo de conexiones para una instancia de RDS for PostgreSQL está determinado por el tipo de instancia y no se puede cambiar manualmente. Para aumentarlo, actualice a un tipo de instancia mayor. Las conexiones máximas pueden diferir entre las instancias principales y las de solo lectura. Para obtener más información, consulte Primary instance types y Read-only instance types.

¿Por qué ocurre un error al modificar el parámetro max_slot_wal_keep_size?

Este problema suele ocurrir en instancias de RDS for PostgreSQL que utilizan el motor DuckDB. Consulte las siguientes causas y recomendaciones:

El parámetro max_slot_wal_keep_size es una limitación del motor DuckDB y no se puede modificar.
Si desea ajustar este parámetro para controlar el crecimiento de los registros WAL, le recomendamos adquirir una nueva instancia de RDS for PostgreSQL que no utilice el motor DuckDB. Posteriormente, podrá modificar este parámetro en la nueva instancia.