administración del servidor de Azure

La extensión PostgreSQL para Visual Studio Code le permite administrar los recursos de Azure Database for PostgreSQL admitidos directamente desde Visual Studio Code. Después de conectarse a un servidor flexible de Azure Database for PostgreSQL, puede abrir el panel del servidor para controlar el ciclo de vida del servidor, administrar el acceso a la red, cambiar parámetros, crear o restaurar copias de seguridad, clonar el servidor y descargar registros capturados. Las conexiones de Azure HorizonDB (versión preliminar) tienen una página de configuración de red más compacta para las reglas del firewall.

Note

La mayoría de las tareas de este artículo solo se aplican a Azure Database for PostgreSQL conexiones de servidor flexibles. Azure HorizonDB (versión preliminar) solo admite la administración de reglas de firewall. Las instancias locales de PostgreSQL y los contenedores de Docker no exponen estas páginas de administración de Azure.

Tip

Si todavía necesita crear el servidor o conectarse a él, comience con Creación de un servidor postgreSQL o conexiones e identidad.

Abrir páginas de administración de Azure

  1. En el árbol Conexiones, conéctese al recurso Azure Database for PostgreSQL que desea administrar.
  2. Haga clic con el botón derecho en el nodo del servidor y seleccione Panel.
  3. Para Azure Database for PostgreSQL acciones de ciclo de vida del servidor flexible, seleccione Acciones>Iniciar, Detener o Reiniciar en el panel del servidor.
  4. Para abrir Azure páginas de administración, seleccione Configuración del servidor y, a continuación, elija una página compatible, como Configuración de red, Parámetros del servidor, Copias de seguridad o Registros del servidor.

Iniciar, detener o reiniciar un servidor

Puede ejecutar acciones de ciclo de vida desde el menú Acciones de la barra de herramientas del panel o desde el menú contextual del servidor en el árbol Conexiones .

Inicio de un servidor

  1. En el árbol Conexiones, haga clic con el botón derecho en el servidor y seleccione Iniciar servidor, o abra el panel y seleccione Inicio de acciones>.
  2. Espere mientras la extensión muestra una notificación de progreso y sondea Azure para el resultado de la operación.
  3. Confirme que el servidor vuelve al estado Listo antes de volver a conectar o abrir páginas de administración.

Detener un servidor

  1. En el árbol Conexiones, haga clic con el botón derecho en el servidor y seleccione Detener servidor, o abra el panel y seleccione Detener acciones>.
  2. En el cuadro de diálogo de confirmación, seleccione Detener.
  3. Espere mientras la extensión completa la operación de detención.
  4. Vuelva a conectarse después de iniciar el servidor de nuevo.

Caution

Al detener el servidor, se desconecta la sesión de Conexiones actual. La extensión cierra la conexión automáticamente después de que finalice la operación de parada.

Note

Cuando se detiene el servidor, Azure detiene la facturación del proceso, pero se siguen aplicando cargos de almacenamiento.

Reinicio de un servidor

Si guarda parámetros que requieren un reinicio y selecciona en el símbolo del sistema de reinicio, la extensión inicia automáticamente el reinicio. Siga estos pasos cuando desee reiniciar el servidor usted mismo.

  1. En el árbol Conexiones, haga clic con el botón derecho en el servidor y seleccione Reiniciar servidor, o abra el panel y seleccione Reiniciar acciones>.
  2. Espere mientras la extensión reinicia el servidor y actualiza el estado del servidor.
  3. Continúe trabajando después de que el servidor vuelva al estado Listo .

Administración del acceso a la red

Abra Configuración del servidor>Configuración de red para administrar el acceso a la red.

Platform Opciones de configuración de red admitidas
Azure Database para PostgreSQL - servidor flexible Reglas de firewall, acceso público, acceso a servicios de Azure y reglas generales de lista de permitidos de IPv4
Azure HorizonDB (versión preliminar) Reglas de firewall y acceso a servicios de Azure

Para Azure Database for PostgreSQL servidor flexible, la página Configuración de red deshabilita la edición del firewall hasta que se habilite el acceso público. También mantiene deshabilitado Guardar hasta que realice un cambio válido. Azure HorizonDB (versión preliminar) no muestra controles de acceso público, pero incluye la casilla Permitir acceso público desde cualquier servicio de Azure dentro de Azure a este servidor.

Adición o edición de una regla de firewall

  1. Abra Configuración del servidor>Configuración de red.
  2. Para el servidor flexible de Azure Database for PostgreSQL, en Acceso público, habilite el acceso público si actualmente está deshabilitado.
  3. En la tabla de reglas de firewall, use la fila vacía para escribir un nombre de regla de firewall, una dirección IP inicial y una dirección IP final o actualizar una fila existente.
  4. Haga clic en Guardar.

Use estas reglas de validación al editar una regla:

Campo Requirement
Nombre de la regla de firewall Obligatorio, único, de 1 a 80 caracteres, letras, números, guiones (-) y caracteres de subrayado (_) solo
Dirección IP de inicio Dirección IPv4 válida requerida
Dirección IP final Dirección IPv4 válida, obligatoria y no inferior a la dirección IP de inicio

Note

La página muestra los errores de validación en línea y deshabilita Guardar hasta que todas las reglas editadas sean válidas.

Autorizar la dirección IP actual del cliente

  1. Abra Configuración del servidor>Configuración de red.
  2. En la tabla de reglas de firewall, seleccione el vínculo que comienza con Agregar dirección IP del cliente actual.
  3. Revise la regla insertada y seleccione Guardar.

Si el panel no puede detectar la dirección IP pública, el vínculo cambia a No se puede determinar la dirección IP actual automáticamente. Introduzca la dirección manualmente en la fila vacía de la regla del firewall.

Configuración de opciones de acceso más amplias

Use estas opciones del servidor flexible de Azure Database for PostgreSQL en la página Configuración de red cuando las reglas de IP individuales no sean suficientes:

Option Úselo cuando
Acceso público Quiere que el servidor acepte conexiones a través de direcciones IP públicas.
Permitir acceso público a este servidor desde cualquier servicio de Azure dentro de Azure Quiere que los servicios alojados en Azure accedan al servidor sin agregar manualmente cada rango de direcciones IP de los servicios.
Agregar 0.0.0.0 - 255.255.255.255 Quiere crear una regla que permita cualquier dirección IPv4. Úselo solo en entornos estrechamente controlados.

Importante

No escriba 0.0.0.0 para las direcciones IP iniciales y finales. La extensión trata ese intervalo como no válido. Si desea que los servicios hospedados Azure se conecten, use Permitir el acceso público desde cualquier servicio de Azure dentro de Azure a este servidor en su lugar.

Note

Azure Configuración de red de HorizonDB (versión preliminar) no incluye acceso público, parámetros, copias de seguridad, registros de servidor, clonación ni acciones de ciclo de vida.

Tip

Si la página Configuración de red muestra un mensaje que indica que una conexión de Azure HorizonDB (versión preliminar) no está disponible porque falta la información de identidad de Azure, seleccione Obtener metadatos en esa página para obtenerla. Esta es la misma captura de metadatos disponible en el panel Servidor.

Cambiar parámetros

Abra Configuración del servidor>Parámetros del servidor para buscar, filtrar, editar y restablecer los parámetros de PostgreSQL del servidor.

Búsqueda de un parámetro

  1. Abra Configuración del servidor>Parámetros del servidor.
  2. Use los botones de filtro como All, Modified, Static, Dynamic o Read-Only para restringir la lista.
  3. Use el cuadro de texto para buscar por nombre de parámetro o descripción.
  4. Si necesita un conjunto de trabajo mayor, cambie Filas por página a 25, 50o 100.
  5. Si desea agrupar una configuración similar antes de editarlas, ordene una columna.

Guardar cambios en los parámetros

  1. Abra Configuración del servidor>Parámetros del servidor.
  2. Busque el parámetro que desea cambiar.
  3. Edite el valor directamente en la columna Valor .
  4. Si el parámetro muestra un botón de información, mantenga el puntero para revisar los valores permitidos.
  5. Haga clic en Guardar.

Si el parámetro requiere un reinicio, la página agrega una fila Reinicio pendiente debajo del parámetro . Al guardar uno o varios parámetros estáticos, la extensión pregunta si desea reiniciar el servidor inmediatamente.

Restablecer un parámetro al valor predeterminado

  1. Abra Configuración del servidor>Parámetros del servidor.
  2. Busque el parámetro que desea restablecer.
  3. Seleccione el icono de restablecimiento situado junto al parámetro .
  4. Haga clic en Guardar.

Administración de copias de seguridad

Abra Configuración del servidor>Copias de seguridad para trabajar con copias de seguridad automáticas y manuales.

Crear una copia de seguridad a petición

  1. Abra Configuración del servidor>Copias de seguridad.
  2. Seleccione Realizar copia de seguridad ahora.
  3. En Crear copia de seguridad, escriba un nombre de copia de seguridad.
  4. Selecciona Crear.

Los nombres de copia de seguridad solo pueden contener letras, números, guiones (-) y caracteres de subrayado (_).

Note

La página puede deshabilitar La copia de seguridad ahora mientras el servidor no está en estado Listo , mientras que otra copia de seguridad ya se está ejecutando o cuando la carga de trabajo actual no admite copias de seguridad manuales.

Restaurar desde una copia de seguridad

  1. Abra Configuración del servidor>Copias de seguridad.
  2. Busque la copia de seguridad que desea usar.
  3. Seleccione Restaurar en esta copia de seguridad.
  4. Complete el flujo de trabajo de restauración para crear una nueva Azure Database for PostgreSQL servidor flexible a partir de esa copia de seguridad.

Eliminación de una copia de seguridad a petición

  1. Abra Configuración del servidor>Copias de seguridad.
  2. Busque la copia de seguridad a petición que desea quitar.
  3. Seleccione Eliminar.
  4. En Eliminar copia de seguridad, seleccione Eliminar de nuevo para confirmar.

Las copias de seguridad automáticas permanecen administradas por Azure y no se pueden eliminar de la extensión.

Cambio de la retención de copia de seguridad

  1. Abra Configuración del servidor>Copias de seguridad.
  2. Mueva el control deslizante de retención al número de días que desee.
  3. Haga clic en Guardar.

También puede filtrar la lista de copia de seguridad con Automático o A petición, restringirla con filtros de tiempo, como Últimas 24 horas o Últimos 7 días, y ordenar la tabla por Nombre, Estado, Hora de finalización, Retención hasta o Tipo.

Copia de seguridad de una base de datos con pg_dump (versión preliminar)

El comando Backup... ejecuta una copia de seguridad del lado pg_dump cliente de una base de datos única y escribe el resultado en la carpeta de salida que elija. A diferencia de las copias de seguridad administradas Azure, este flujo de trabajo funciona para cualquier conexión local de PostgreSQL, Docker o Azure.

Esta característica es una versión preliminar desactivada de forma predeterminada. Para activarlo, establezca pgsql.enablePgDumpRestoreUI en true en la configuración de VS Code.

Note

El comando Backup... requiere la pg_dump herramienta cliente. Si pg_dump no se encuentra, instale las herramientas de cliente de PostgreSQL o agregue el directorio que contiene el archivo binario a pgsql.pgBinaryDirs (una lista de rutas de acceso absolutas de directorio) y reinicie el editor.

Creación de una copia de seguridad

  1. En el árbol Conexiones, haga clic con el botón derecho en un nodo de base de datos y seleccione Copia de seguridad.... Para Azure servidores (servidor flexible o HorizonDB), también puede hacer clic con el botón derecho en el nodo de servidor y seleccionarCopia de seguridad de> servidor....

  2. En el panel Copia de seguridad de la base de datos , elija la base de datos de la que desea realizar una copia de seguridad.

  3. Establezca la carpeta de salida y el nombre de archivo para la salida de copia de seguridad.

  4. Elija un formato:

    Formato Description
    Personalizada (.backup) Formato binario que admite la compresión y la restauración en paralelo. Se recomienda para la mayoría de las copias de seguridad.
    SQL sin formato (.sql) Script SQL legible para personas. Sin compresión.
    Directory Un archivo por tabla. Admite copias de seguridad y restauración paralelas.
    Tar (.tar) Archivo de archivos SQL. Sin compresión.
  5. Para el formato personalizado o de directorio , establezca un nivel de compresión . Se recomienda el nivel 6.

  6. En Contenido, elija Esquema + datos, Solo esquema o Solo datos.

  7. Para revisar el comando generado antes de ejecutarlo, consulte la vista previa del comando. Seleccione Copiar comando para copiarlo.

  8. Seleccione Iniciar copia de seguridad.

El panel transmite pg_dump la salida a medida que se ejecuta la copia de seguridad. Cuando termine, seleccione Abrir copia de seguridad para abrir la carpeta de salida o Haga que se vuelva a iniciar otra copia de seguridad . Si se produce un error en la copia de seguridad, seleccione Ver registros completos para obtener más información o Depurar con Copilot para la solución de problemas asistida por IA.

Ajuste de la copia de seguridad

Seleccione Opciones avanzadas para abrir un cajón con opciones adicionales:

  • Ámbito: limite la copia de seguridad a esquemas o tablas específicos.
  • Contenido: incluya o excluya las secciones Pre-Data, Data y Post-Data y elija si se van a incluir objetos grandes.
  • Rendimiento y registros: establezca Tareas paralelas (solo para el formato de directorio) y active o desactive Registro detallado.
  • Comportamiento de restauración: elija si se debe incluir la propiedad y los privilegios (GRANT) y si se deshabilitan los desencadenadores mientras se cargan los datos durante una restauración posterior.
  • Opciones de formato SQL: para el formato SQL simple, agregue sentencias clean, create-database o sentencias basadas en INSERT.
  • Seguridad: active o desactive Habilitar seguridad de filas para controlar cómo se gestiona la seguridad a nivel de fila en el volcado.

Note

El comando Backup... crea solo una copia de seguridad; no se restaura. Para restaurar una copia de seguridad, use las herramientas de cliente de PostgreSQL como pg_restore o psql.

Clonación de un servidor

Use Clone Server cuando desee crear un nuevo servidor flexible Azure Database for PostgreSQL basado en el servidor actual.

  1. Abra el panel.
  2. Seleccione Configuración del servidor>Clonar servidor.
  3. Complete el flujo de trabajo de clonación para crear el nuevo servidor.

Captura y descarga de registros del servidor

Abra Configuración del servidor>Registros del servidor para capturar registros de diagnóstico y descargarlos para la resolución de problemas.

Activar o desactivar la captura de registros

  1. Abra Configuración del servidor>Registros del servidor.
  2. Active o desactive la opción Capturar registros para descargarlos.
  3. Si la captura de registros está activada, establezca Período de retención de registros.
  4. Haga clic en Guardar.

Filtrar y descargar archivos de registro

  1. Abra Configuración del servidor>Registros del servidor.
  2. Usa Todos los tipos, Registro del servidor o Registro de actualización para acotar la lista.
  3. Use el filtro de tiempo o el cuadro de búsqueda de nombre de archivo para encontrar los archivos que necesita.
  4. Seleccione uno o varios archivos de registro o use el botón descargar en una sola fila.
  5. Seleccione Descargar.

La tabla de registro admite la ordenación por Nombre, Última modificación, Tamaño (KB) y Tipo. Cuando más de 100 archivos coinciden con los filtros actuales, la página muestra los controles de paginación.

Ver actividad

Abra Configuración del servidor>Registro de actividad para revisar la actividad del plano de control de Azure del servidor, incluidos los cambios operativos, los eventos de estado y las acciones de administración iniciadas por el usuario, como las operaciones de inicio, detención y configuración. Esta página está disponible para las conexiones de Azure Database for PostgreSQL - Servidor flexible y Azure HorizonDB (versión preliminar).

  1. Abra Configuración del servidor>Registro de actividad.
  2. Use los filtros Timespan, Severity y Status para restringir la lista o buscar por operación, iniciador o estado. Seleccione Restablecer filtros para borrarlos.
  3. Seleccione un evento para expandir sus detalles, como el nombre de la operación, el estado, la hora del evento y el iniciador.
  4. Para mantener una copia para el análisis, seleccione Descargar como CSV.

Note

Azure conserva los registros de actividad durante los últimos 90 días. No hay disponibles fechas de inicio de hace más de 90 días.