Personalización de los parámetros de configuración del servidor de Azure Database for PostgreSQL: Single Server mediante la CLI de Azure
Se aplica a:
Azure Database for PostgreSQL: servidor único
Importante
El servicio de servidor único de Azure Database for PostgreSQL está en proceso de retirada. Es muy recomendable actualizar al servidor flexible de Azure Database for PostgreSQL. Para más información sobre la migración al servidor flexible de Azure Database for PostgreSQL, consulte ¿Qué sucederá con el servicio de servidor único de Azure Database for PostgreSQL?
Puede enumerar, mostrar y actualizar los parámetros de configuración de un servidor Azure PostgreSQL con la interfaz de la línea de comandos (CLI de Azure). Sin embargo, en el nivel del servidor, solo se expone y se puede modificar un subconjunto de las opciones de configuración del motor.
Requisitos previos
Para seguir esta guía, necesitará:
- Crear una base de datos y un servidor Azure Database for PostgreSQL siguiendo las instrucciones de Creación de una instancia de Azure Database for PostgreSQL
- Instalar la interfaz de la línea de comandos CLI de Azure en la máquina o usar Azure Cloud Shell en Azure Portal mediante el explorador.
Lista de los parámetros de configuración del servidor de Azure Database for PostgreSQL
Para obtener una lista de todos los parámetros modificables en un servidor y sus valores, ejecute el comando az postgres server configuration list.
Puede enumerar los parámetros de configuración del servidor mydemoserver.postgres.database.azure.com en el grupo de recursos myresourcegroup.
az postgres server configuration list --resource-group myresourcegroup --server mydemoserver
Presentación de los detalles de los parámetros de configuración del servidor
Para mostrar los detalles de un parámetro de configuración específico de un servidor, ejecute el comando az postgres server configuration show.
En este ejemplo, se muestran detalles del parámetro de configuración log_min_messages del servidor mydemoserver.postgres.database.azure.com en el grupo de recursos myresourcegroup.
az postgres server configuration show --name log_min_messages --resource-group myresourcegroup --server mydemoserver
Modificación del valor de los parámetros de configuración del servidor
También puede modificar el valor de un determinado parámetro de configuración del servidor; esta acción actualizará el valor de configuración subyacente del motor del servidor PostgreSQL. Para actualizar la configuración, use el comando az postgres server configuration set.
Para actualizar el parámetro de configuración log_min_messages del servidor mydemoserver.postgres.database.azure.com en el grupo de recursos myresourcegroup.
az postgres server configuration set --name log_min_messages --resource-group myresourcegroup --server mydemoserver --value INFO
Si desea restablecer el valor de un parámetro de configuración, basta con no incluir el parámetro opcional --value y el servicio aplicará el valor predeterminado. En el ejemplo anterior, sería:
az postgres server configuration set --name log_min_messages --resource-group myresourcegroup --server mydemoserver
La configuración de log_min_messages se restablecerá al valor predeterminado WARNING. Para obtener más información sobre la configuración del servidor y los valores permitidos, consulte la documentación de PostgreSQL en Server Configuration (Configuración del servidor).
Pasos siguientes
- Aprenda a reiniciar un servidor
- Para configurar y obtener acceso a los registros del servidor, consulte Registros del servidor en Azure Database for PostgreSQL.