Creación y administración de réplicas de lectura en Azure Database for PostgreSQL: servidor flexible desde Azure Portal, la CLI o la API de REST

SE APLICA A: Azure Database for PostgreSQL: servidor flexible

En este artículo, aprenderá a crear y administrar réplicas de lectura en el Servidor flexible de Azure Database for PostgreSQL desde el Azure Portal, CLI y REST API. Para más información acerca de las réplicas de lectura, consulte la introducción.

Requisitos previos

Una Instancia de Servidor flexible de Azure Database for PostgreSQL como servidor principal.

Nota:

Cuando se implementan réplicas de lectura para cargas de trabajo principales continuas con numerosas operaciones de escritura, el retraso en la replicación puede seguir creciendo y no alcanzar nunca al servidor principal. Esto también puede aumentar el uso de almacenamiento en la réplica principal, ya que los archivos WAL solo se eliminan una vez recibidos en la réplica.

Revisión de la configuración principal

Antes de configurar una réplica de lectura para el Servidor flexible de Azure Database for PostgreSQL, asegúrese de que el servidor primario está configurado para cumplir los requisitos previos necesarios. La configuración específica del servidor principal puede afectar a la capacidad de crear réplicas.

Crecimiento automático del almacenamiento: la configuración de crecimiento automático del almacenamiento en el servidor principal y sus réplicas de lectura deben cumplir a guías específicas para garantizar la coherencia y evitar interrupciones de replicación. Consulte el Crecimiento automático del almacenamientopara obtener reglas y configuraciones detalladas.

SSD prémium v2: la versión actual no admite la creación de réplicas de lectura para los servidores principales mediante el almacenamiento SSD prémium v2. Si la carga de trabajo requiere réplicas de lectura, elija una opción de almacenamiento diferente para el servidor principal.

Portal

1. En Azure Portal, elija la instancia de servidor flexible de Azure Database for PostgreSQL que desee para la réplica.

2. En el cuadro de diálogo Información general, anote la versión de PostgreSQL (por ejemplo 15.4). Además, tenga en cuenta la región en la que se implementa la réplica principal (por ejemplo East US).

   

3. En la barra lateral del servidor, en Configuración, seleccione Proceso y almacenamiento.

4. Revise y anote la siguiente configuración:

   • Nivel de proceso, Procesador, Tamaño (por ejemplo Standard_D4ads_v5).

   • Storage

     • Tamaño de almacenamiento (por ejemplo 128GB)
     • Crecimiento automático

   • Alta disponibilidad

     • Habilitada / Deshabilitada
     • Configuración de la zona de disponibilidad

   • Configuración de copia de seguridad

     • Período de retención
     • Opciones de redundancia

5. En Configuración, seleccione Redes.

6. Revisión la configuración de red.

   

CLI

Nota:

Los comandos proporcionados en esta guía son aplicables para la Interfaz de la línea de comandos de Azure versión 2.56.0 o superior. Asegúrese de que tiene instalada la versión requerida o una posterior para ejecutar estos comandos correctamente. Puede comprobar su versión actual de Azure CLI ejecutando az --version en su interfaz de línea de comandos. Para actualizar la Interfaz de la línea de comandos de Azure a la última versión, siga las instrucciones proporcionadas en la Documentación de Azure CLI.

Para ver la configuración y el estado actual de un Servidor Flexible de Azure PostgreSQL, utilice el comando az postgres flexible-server show. Este comando proporciona información detallada sobre el servidor especificado.

az postgres flexible-server show \
  --resource-group <resource-group> \
  --name <server-name>

Sustituya <resource-group> y <server-name> por su grupo de recursos específico y el nombre del servidor que desea ver.

Revise y anote la siguiente configuración:

• Nivel de proceso, Procesador, Tamaño (por ejemplo Standard_D8ads_v5).
• Storage
  • Tipo
  • Tamaño de almacenamiento (por ejemplo 128)
  • crecimiento automático
• Alta disponibilidad
  • Habilitada / Deshabilitada
  • Configuración de la zona de disponibilidad
• Configuración de conjunto de copia de seguridad
  • Período de retención
  • Opciones de redundancia

Respuesta de muestra

{
  "administratorLogin": "myadmin",
  "administratorLoginPassword": null,
  "authConfig": {
    "activeDirectoryAuth": "Disabled",
    "passwordAuth": "Enabled",
    "tenantId": null
  },
  "availabilityZone": "2",
  "backup": {
    "backupRetentionDays": 7,
    "earliestRestoreDate": "2024-01-06T11:43:44.485537+00:00",
    "geoRedundantBackup": "Disabled"
  },
  "createMode": null,
  "dataEncryption": {
    "geoBackupEncryptionKeyStatus": null,
    "geoBackupKeyUri": null,
    "geoBackupUserAssignedIdentityId": null,
    "primaryEncryptionKeyStatus": null,
    "primaryKeyUri": null,
    "primaryUserAssignedIdentityId": null,
    "type": "SystemManaged"
  },
  "fullyQualifiedDomainName": "{serverName}.postgres.database.azure.com",
  "highAvailability": {
    "mode": "Disabled",
    "standbyAvailabilityZone": null,
    "state": "NotEnabled"
  },
  "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
  "identity": null,
  "location": "East US",
  "maintenanceWindow": {
    "customWindow": "Disabled",
    "dayOfWeek": 0,
    "startHour": 0,
    "startMinute": 0
  },
  "minorVersion": "0",
  "name": "{serverName}",
  "network": {
    "delegatedSubnetResourceId": null,
    "privateDnsZoneArmResourceId": null,
    "publicNetworkAccess": "Enabled"
  },
  "pointInTimeUtc": null,
  "privateEndpointConnections": null,
  "replica": {
    "capacity": 5,
    "promoteMode": null,
    "promoteOption": null,
    "replicationState": null,
    "role": "Primary"
  },
  "replicaCapacity": 5,
  "replicationRole": "Primary",
  "resourceGroup": "{resourceGroupName}",
  "sku": {
    "name": "Standard_D8ads_v5",
    "tier": "GeneralPurpose"
  },
  "sourceServerResourceId": null,
  "state": "Ready",
  "storage": {
    "autoGrow": "Disabled",
    "iops": 500,
    "storageSizeGb": 128,
    "throughput": null,
    "tier": "P10",
    "type": ""
  },
  "systemData": {
    "createdAt": "2023-11-08T11:27:48.972812+00:00",
    "createdBy": null,
    "createdByType": null,
    "lastModifiedAt": null,
    "lastModifiedBy": null,
    "lastModifiedByType": null
  },
  "tags": {},
  "type": "Microsoft.DBforPostgreSQL/flexibleServers",
  "version": "16"
}

REST API

Para obtener información sobre la configuración de un servidor en el servidor flexible de Azure Database for PostgreSQL, especialmente para ver la configuración de características introducidas recientemente, como crecimiento automático de almacenamiento o vínculo privado, debe usar la versión de API más reciente 2023-06-01-preview. La solicitud GET tendría el formato siguiente:

https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}?api-version=2023-06-01-preview

Reemplace {subscriptionId}, {resourceGroupName} y {serverName} por el identificador de suscripción de Azure, el nombre del grupo de recursos y el nombre del servidor principal que desea revisar, respectivamente. Esta solicitud proporciona acceso a los detalles de configuración del servidor principal, lo que garantiza que está configurado correctamente para crear una réplica de lectura.

Revise y anote la siguiente configuración:

• Nivel de proceso, Procesador, Tamaño (por ejemplo Standard_D8ads_v5).
• Storage
  • Tipo
  • Tamaño de almacenamiento (por ejemplo 128)
  • crecimiento automático
• Red
• Alta disponibilidad
  • Habilitada / Deshabilitada
  • Configuración de la zona de disponibilidad
• Configuración de conjunto de copia de seguridad
  • Período de retención
  • Opciones de redundancia

Respuesta de muestra

{
    "sku": {
        "name": "Standard_D8ads_v5",
        "tier": "GeneralPurpose"
    },
    "systemData": {
        "createdAt": "2023-11-22T16:11:42.2461489Z"
    },
    "properties": {
        "replica": {
            "role": "Primary",
            "capacity": 5
        },
        "storage": {
            "type": "",
            "iops": 500,
            "tier": "P10",
            "storageSizeGB": 128,
            "autoGrow": "Disabled"
        },
        "network": {
            "publicNetworkAccess": "Enabled"
        },
        "dataEncryption": {
            "type": "SystemManaged"
        },
        "authConfig": {
            "activeDirectoryAuth": "Disabled",
            "passwordAuth": "Enabled"
        },
        "fullyQualifiedDomainName": "{serverName}.postgres.database.azure.com",
        "version": "15",
        "minorVersion": "4",
        "administratorLogin": "myadmin",
        "state": "Ready",
        "availabilityZone": "1",
        "backup": {
            "backupRetentionDays": 7,
            "geoRedundantBackup": "Disabled",
            "earliestRestoreDate": "2023-11-23T12:55:33.3443218+00:00"
        },
        "highAvailability": {
            "mode": "Disabled",
            "state": "NotEnabled"
        },
        "maintenanceWindow": {
            "customWindow": "Disabled",
            "dayOfWeek": 0,
            "startHour": 0,
            "startMinute": 0
        },
        "replicationRole": "Primary",
        "replicaCapacity": 5
    },
    "location": "East US",
    "tags": {},
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
    "name": "{serverName}",
    "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}

Creación de una réplica de lectura

Para crear una réplica de lectura, siga estos pasos:

Portal

1. Seleccione una instancia de Servidor flexible Azure Database for PostgreSQL existente para utilizarla como servidor principal.

2. En la barra lateral del servidor, en CONFIGURACIÓN, seleccione Replicación.

3. Seleccione Crear réplica.

   

4. Complete el formulario Aspectos básicos con la siguiente información.

   

5. Seleccione Revisar y crear para confirmar la creación de la réplica o Siguiente: Redes si desea agregar, eliminar o modificar las reglas de firewall.

   

6. Deje los valores predeterminados restantes y, a continuación, seleccione el botón Revisar y crear en la parte inferior de la página o continúe con los formularios siguientes para agregar etiquetas o cambiar el método de cifrado de datos.

7. Revise la información en la ventana de confirmación final. Cuando esté listo, seleccione Crear. Se crea una nueva implementación.

   

8. Durante la implementación, verá el elemento principal en estado Updating.

   Después de crear la réplica de lectura, puede verla en la ventana Replicación.

   

CLI

Puede crear una réplica de lectura para su Servidor Flexible de Azure PostgreSQL utilizando el comando az postgres flexible-server replica create.

az postgres flexible-server replica create \
  --replica-name <replica-name> \
  --resource-group <resource-group> \
  --source-server <source-server-name> \
  --location <location>

Reemplace <replica-name>, <resource-group>, <source-server-name>, y <location> por sus valores específicos.

Una vez creada la réplica de lectura, se pueden obtener las propiedades de todos los servidores, que son réplicas de una réplica principal mediante el comando az postgres flexible-server replica create.

az postgres flexible-server replica list \
  --name <source-server-name> \
  --resource-group <resource-group>

Reemplace <source-server-name>, y <resource-group> por sus valores específicos.

REST API

Inicie una solicitud HTTP PUT mediante la API de creación de servidores:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

Aquí, debe reemplazar {subscriptionId}, {resourceGroupName}y {replicaserverName} por su identificador de suscripción de Azure específico, el nombre del grupo de recursos y el nombre deseado para la réplica de lectura, respectivamente.

{
  "location": "eastus",
  "properties": {
    "createMode": "Replica",
    "SourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}"
  }
}

Una vez creada la réplica de lectura, se pueden obtener las propiedades de todos los servidores, que son réplicas de una réplica principal iniciando una HTTP GET solicitud de mediante lista de réplicas por API de servidor:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/replicas?api-version=2022-12-01

Aquí, debe sustituir {subscriptionId}, {resourceGroupName}, y {sourceserverName} por su Id. de suscripción de Azure específico, el nombre de su grupo de recursos y el nombre que asignó a su réplica principal, respectivamente.

[
  {
    "administratorLogin": null,
    "administratorLoginPassword": null,
    "authConfig": null,
    "availabilityZone": null,
    "backup": {
      "backupRetentionDays": null,
      "earliestRestoreDate": "2023-11-23T12:55:33.3443218+00:00",
      "geoRedundantBackup": "Disabled"
    },
    "createMode": null,
    "dataEncryption": {
      "geoBackupEncryptionKeyStatus": null,
      "geoBackupKeyUri": null,
      "geoBackupUserAssignedIdentityId": null,
      "primaryEncryptionKeyStatus": null,
      "primaryKeyUri": null,
      "primaryUserAssignedIdentityId": null,
      "type": "SystemManaged"
    },
    "fullyQualifiedDomainName": null,
    "highAvailability": null,
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{replicaserverName}",
    "identity": null,
    "location": "eastus",
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    },
    "minorVersion": null,
    "name": "{replicaserverName}",
    "network": {
      "delegatedSubnetResourceId": null,
      "privateDnsZoneArmResourceId": null,
      "publicNetworkAccess": "Disabled"
    },
    "pointInTimeUtc": null,
    "privateEndpointConnections": null,
    "replica": {
      "capacity": null,
      "promoteMode": null,
      "promoteOption": null,
      "replicationState": "Active",
      "role": "AsyncReplica"
    },
    "replicaCapacity": null,
    "replicationRole": "AsyncReplica",
    "resourceGroup": "{resourceGroupName}",
    "sku": {
      "name": "",
      "tier": null
    },
    "sourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
    "state": "Ready",
    "storage": {
      "autoGrow": "Disabled",
      "iops": null,
      "storageSizeGb": 0,
      "throughput": null,
      "tier": null,
      "type": null
    },
    "systemData": {
      "createdAt": "2023-11-22T17:11:42.2461489Z",
      "createdBy": null,
      "createdByType": null,
      "lastModifiedAt": null,
      "lastModifiedBy": null,
      "lastModifiedByType": null
    },
    "tags": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers",
    "version": null
  }
]

• Establezca el nombre del servidor de réplica.

  Sugerencia

  Se trata de un procedimiento recomendado de Cloud Adoption Framework (CAF) para usar una convención de nomenclatura de recursos que le permitirá determinar fácilmente a qué instancia se conecta o administra y dónde reside.

• Seleccione una ubicación diferente de la principal, pero tenga en cuenta que puede seleccionar la misma región.

  Sugerencia

  Para más información sobre las regiones en las que puede crear una réplica, consulte el artículo sobre los conceptos de la réplica de lectura.

• Establezca el proceso y el almacenamiento como lo registró en la base de datos principal. Si el proceso mostrado no coincide, seleccione Configurar servidor y seleccione el adecuado.

  Nota:

  Si selecciona un tamaño de proceso menor que el principal, se producirá un error en la implementación. Tenga en cuenta también que es posible que el tamaño de proceso no esté disponible en otra región.

  

Importante

Revise la sección sobre las consideraciones de la información general de Réplicas de lectura.

Para evitar problemas durante la promoción de réplicas, cambie constantemente los siguientes parámetros de servidor en las réplicas en primer lugar, antes de aplicarlos en la principal: max_connections, max_prepared_transactions, max_locks_per_transaction, max_wal_senders, max_worker_processes.

Creación de puntos de conexión virtuales

Nota:

Todas las operaciones que implican puntos de conexión virtuales, como agregar, editar o quitar, se ejecutan en el contexto del servidor principal.

Portal

1. En Azure Portal, seleccione el servidor principal.

2. En la barra lateral del servidor, en CONFIGURACIÓN, seleccione Replicación.

3. Seleccione Crear punto de conexión.

4. En el cuadro de diálogo, escriba un nombre descriptivo para el punto de conexión. Observe el punto de conexión DNS que se está generando.

   

5. Seleccione Crear.

   Nota:

   Si no crea un punto de conexión virtual, recibirá un error en el intento de promoción de réplica.

   

CLI

Puede crear un punto de conexión virtual utilizando el comando az postgres flexible-server virtual-endpoint create.

    az postgres flexible-server virtual-endpoint create \
      --resource-group <resource-group> \
      --server-name <primary-name> \
      --name <virtual-endpoint-name> \
      --endpoint-type ReadWrite \
      --members <replica-name>

Reemplace <resource-group>, <primary-name>, <virtual-endpoint-name>, y <replica-name> por sus valores específicos.

REST API

Para crear un punto de conexión virtual mediante la API de REST de Azure, usaría una solicitud HTTP PUT. La solicitud tendría este aspecto:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/virtualendpoints/{virtualendpointName}?api-version=2023-06-01-preview

El cuerpo JSON adjunto para esta solicitud es el siguiente:

{ 
  "Properties": { 
    "EndpointType": "ReadWrite", 
    "Members": ["{replicaserverName}"] 
  }
} 

Aquí, {replicaserverName} debe reemplazarse por el nombre del servidor de réplica que está incluyendo como destino de punto de conexión de lector en este punto de conexión virtual.

Enumeración de puntos de conexión virtuales

Para enumerar los puntos de conexión virtuales, siga estos pasos:

Portal

1. En Azure Portal, seleccione el servidor principal.

2. En la barra lateral del servidor, en CONFIGURACIÓN, seleccione Replicación.

3. En la parte superior de la página, verá que se muestran los puntos de conexión lector y escritor, junto con los nombres de los servidores a los que apunta.

   

CLI

Puede ver los detalles del punto de conexión virtual utilizando el comando list o show. Dado que solo se permite un punto de conexión virtual por par de réplica principal, ambos comandos producen el mismo resultado.

Este es un ejemplo de cómo usar el comandolist:

az postgres flexible-server virtual-endpoint list \
      --resource-group <resource-group> \
      --server-name <server-name>

Reemplace <server-name> por el nombre de su servidor primario y <resource-group> por el nombre de su grupo de recursos.

A continuación le explicamos cómo utilizar el comando show:

az postgres flexible-server virtual-endpoint show \
      --name <virtual-endpoint-name>
      --resource-group <resource-group> \
      --server-name <server-name>

En este comando, reemplace <virtual-endpoint-name>,<server-name>y <resource-group> por los nombres respectivos. <server-name> es el nombre de su servidor principal.

REST API

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/virtualendpoints?api-version=2023-06-01-preview

Aquí debe {sourceserverName} ser el nombre del servidor principal desde el que se administran los puntos de conexión virtuales.

Modificación de la aplicación para que apunte al punto de conexión virtual

Modifique cualquier aplicación que esté utilizando su instancia del Servidor flexible de Azure Database for PostgreSQL para utilizar los nuevos puntos de conexión virtuales (ej: corp-pg-001.writer.postgres.database.azure.com y corp-pg-001.reader.postgres.database.azure.com).

Promoción de la réplica

Con todos los componentes necesarios en su lugar, ya puede realizar una operación de promover de réplica a principal.

Portal

Para promover la réplica desde Azure Portal, siga estos pasos:

1. En Azure Portal, seleccione su instancia de Servidor flexible principal de Azure Database for PostgreSQL.

2. En el menú del servidor, en Configuración, seleccione Replicación.

3. En Servidores, seleccione el icono Promover de la réplica.

   

4. En el cuadro de diálogo, asegúrese de que la acción sea Promover al servidor principal.

5. En Sincronización de datos, asegúrese de que Planear: sincronizar datos antes de promover está seleccionado.

   

6. Seleccione Promover para comenzar el proceso. Una vez completado, los roles inversos: la réplica se convierte en la principal y la principal asume el rol de la réplica.

CLI

Al promover una réplica a un servidor principal en el Servidor Flexible de Azure PostgreSQL, utilice el comando az postgres flexible-server replica promote. Este proceso es esencial para elevar un servidor de réplica para que funcione como servidor principal y para degradar el actual primario al rol de réplica. Especifique --promote-mode switchover y --promote-option planned en el comando.

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name> \
  --promote-mode switchover \
  --promote-option planned

Reemplace <resource-group> y <replica-server-name> por el grupo de recursos específico y el nombre del servidor de réplica. Este mando garantiza una transición fluida de la réplica a una función primaria de forma planificada.

REST API

Al promover una réplica a un servidor principal, use una solicitud HTTP PATCHcon un cuerpo específico JSON para establecer las opciones de promoción. Este proceso es fundamental cuando necesita elevar un servidor de réplica para que actúe como servidor principal.

La solicitud HTTP se estructura de la siguiente manera:

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "switchover",
      "PromoteOption": "planned"
    }
  }
}

En este JSON, la promoción se establece para que se produzca en el modo switchover con una opción de promociónplanned. Aunque hay dos opciones para la promoción ( planned o forced ) ha elegido planned para este ejercicio.

Nota:

La réplica que está promoviendo debe tener asignado el punto de conexión virtual del lector o recibirá un error en la promoción.

Prueba de aplicaciones

Para realizar algunas operaciones, reinicie las aplicaciones y, a continuación, intente esas operaciones. Las aplicaciones deben funcionar sin problemas sin modificar la cadena de conexión del punto de conexión virtual ni las entradas DNS. Deje las aplicaciones en ejecución esta vez.

Conmutación por recuperación al servidor y la región originales

Repita las mismas operaciones para promover el servidor original al servidor principal.

Portal

1. Seleccione la réplica en Azure Portal.

2. En la barra lateral del servidor, en Configuración, seleccione Replicación

3. En Servidores, seleccione el icono Promover de la réplica.

4. En el cuadro de diálogo, asegúrese de que la acción sea Promover al servidor principal.

5. En Sincronización de datos, asegúrese de que Planear: sincronizar datos antes de promover está seleccionado.

6. Seleccione Promover, comienza el proceso. Una vez completado, los roles inversos: la réplica se convierte en la principal y la principal asume el rol de la réplica.

CLI

Esta vez, cambie el <replica-server-name> en el comando az postgres flexible-server replica promote para hacer referencia a su antiguo servidor principal, que actualmente está actuando como una réplica, y ejecute la solicitud de nuevo.

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name> \
  --promote-mode switchover \
  --promote-option planned

Reemplace <resource-group> y <replica-server-name> por el grupo de recursos específico y el nombre del servidor de réplica actual.

REST API

Esta vez, cambie en {replicaserverName} la solicitud de API para hacer referencia al servidor principal anterior, que actualmente actúa como una réplica y vuelve a ejecutar la solicitud.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "switchover",
      "PromoteOption": "planned"
    }
  }
}

En este JSON, la promoción se establece para que se produzca en el modo switchover con una opción de promociónplanned. Aunque hay dos opciones para la promoción ( planned o forced ) ha elegido planned para este ejercicio.

Prueba de aplicaciones

De nuevo, cambie a una de las aplicaciones que consumen. Espere a que el estado principal y de réplica cambie a Updating y, a continuación, intente realizar algunas operaciones. Durante la promoción de réplica, la aplicación podría encontrar problemas de conectividad temporales con el punto de conexión:

Agregar réplica de lectura secundaria

Cree una réplica de lectura secundaria en una región independiente para modificar el punto de conexión virtual del lector y para permitir la creación de un servidor independiente desde la primera réplica.

Portal

1. En Azure Portal, elija el Servidor flexible principal de Azure Database for PostgreSQL.

2. En la barra lateral del servidor, en CONFIGURACIÓN, seleccione Replicación.

3. Seleccione Crear réplica.

4. Introduzca el formulario Aspectos básicos con información en una tercera región (por ejemplo westus y corp-pg-westus-001)

5. Seleccione Revisar y crear para confirmar la creación de la réplica o Siguiente: Redes si desea agregar, eliminar o modificar las reglas de firewall.

6. Verificar la configuración del firewall. Observe cómo se copian automáticamente la configuración principal.

7. Deje los valores predeterminados restantes y, a continuación, seleccione el botón Revisar y crear en la parte inferior de la página o continúe con los siguientes formularios para configurar la seguridad o agregar etiquetas.

8. Revise la información en la ventana de confirmación final. Cuando esté listo, seleccione Crear. Se crea una nueva implementación.

9. Durante la implementación, verá el elemento principal en estado Updating.

   

CLI

Puede crear una réplica de lectura secundaria utilizando el comando az postgres flexible-server replica create.

az postgres flexible-server replica create \
  --replica-name <replica-name> \
  --resource-group <resource-group> \
  --source-server <source-server-name> \
  --location <location>

Elija un nombre distinto para que <replica-name> lo diferencie del servidor principal y de cualquier otra réplica. Reemplace <resource-group>, <source-server-name>y <location> por sus valores específicos.

REST API

Puede crear una réplica de lectura secundaria utilizando la API de creación de servidores:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

Elija un nombre distinto para que {replicaserverName} lo diferencie del servidor principal y de cualquier otra réplica.

{
  "location": "westus3",
  "properties": {
    "createMode": "Replica",
    "SourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}"
  }
}

La ubicación se establece en westus3, pero puede ajustar la configuración en función de sus necesidades geográficas y operativas.

Modificación del punto de conexión virtual

Portal

1. En Azure Portal, elija el Servidor flexible principal de Azure Database for PostgreSQL.

2. En la barra lateral del servidor, en CONFIGURACIÓN, seleccione Replicación.

3. Seleccione los puntos suspensivos y, a continuación, seleccione Editar.

   

4. En el cuadro de diálogo, seleccione la nueva réplica secundaria.

   

5. Seleccione Guardar. El punto de conexión del lector ahora apunta a la réplica secundaria y la operación de promoción ahora está vinculada a esta réplica.

CLI

Ahora puede modificar su punto de conexión del lector para que apunte a la réplica secundaria recién creada mediante un comando az postgres flexible-server virtual-endpoint update. Recuerde reemplazar <replica-name> por el nombre de la réplica de lectura recién creada.

az postgres flexible-server virtual-endpoint update \
  --resource-group <resource-group> \
  --server-name <server-name> \
  --name <virtual-endpoint-name> \
  --endpoint-type ReadWrite \
  --members <replica-name>

Reemplace <resource-group>, <server-name>, <virtual-endpoint-name>, y <replica-name> por sus valores específicos.

REST API

Ahora puede modificar el punto de conexión del lector para que apunte a la réplica secundaria recién creada mediante una solicitudPATCH. Recuerde reemplazar {replicaserverName} por el nombre de la réplica de lectura recién creada.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/virtualendpoints/{virtualendpointName}?api-version=2023-06-01-preview

{ 
  "Properties": { 
    "EndpointType": "ReadWrite", 
    "Members": ["{replicaserverName}"] 
  }
} 

Promoción de la réplica al servidor independiente

En lugar de cambiar a una réplica, también es posible interrumpir la replicación de una réplica de modo que se convierta en su servidor independiente.

Portal

1. En Azure Portal, elija el servidor principal del Servidor flexible de Azure Database for PostgreSQL.

2. En la barra lateral del servidor, en el menú del servidor, en Configuración, seleccione Replicación.

3. En Servidores, seleccione el icono Promover de la réplica que desea promover a un servidor independiente.

   

4. En el cuadro de diálogo, asegúrese de que la acción es Promover al servidor independiente y quitar de la replicación. Esto no afectará al servidor principal.

5. En Sincronización de datos, asegúrese de que Planear: sincronizar datos antes de promover está seleccionado.

   

6. Seleccione Promover, comienza el proceso. Una vez completado, el servidor ya no es una réplica de la principal.

CLI

Al promover una réplica en el servidor flexible de Azure PostgreSQL, el comportamiento predeterminado es promoverlo a un servidor independiente. La promoción se logra mediante el comando az postgres flexible-server replica promote sin especificar la opción --promote-mode, ya que se supone standalone modo de forma predeterminada.

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name>

En este comando, reemplace <resource-group> y <replica-server-name> por el nombre del grupo de recursos específico y el nombre del primer servidor de réplica que creó, que ya no forma parte del punto de conexión virtual.

REST API

Puede promover una réplica a un servidor independiente mediante una solicitud PATCH. Envíe una solicitud PATCH a la dirección URL de la API de REST de administración de Azure especificada con el primer cuerpo de JSON, donde PromoteMode está establecido en standalone y PromoteOption en planned. El segundo formato de cuerpo JSON, estableciendo ReplicationRole en None, está en desuso, pero todavía se menciona aquí para la compatibilidad con versiones anteriores.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "standalone",
      "PromoteOption": "planned"
    }
  }
}

{
  "Properties": {
    "ReplicationRole": "None"
  }
}

Nota:

Una vez que se promueve una réplica a un servidor independiente, no se puede volver a agregar al conjunto de replicación.

Eliminación del punto de conexión virtual

Portal

1. En Azure Portal, seleccione el servidor principal.

2. En la barra lateral del servidor, en CONFIGURACIÓN, seleccione Replicación.

3. En la parte superior de la página, busque la sección Virtual endpoints. Vaya a los tres puntos (opciones de menú) junto al nombre del punto de conexión, expándalo y elija Delete.

4. Aparece un cuadro de diálogo de confirmación de eliminación. Le advierte: "Esta acción elimina el punto de conexión virtual virtualendpointName. Los clientes conectados mediante estos dominios pueden perder acceso". Confirme las implicaciones y confirme haciendo clic en Eliminar.

CLI

Para quitar un punto de conexión virtual de un Servidor flexible de Azure PostgreSQL, puede usar el comando az postgres flexible-server virtual-endpoint delete. Esta acción elimina permanentemente el punto de conexión virtual especificado.

az postgres flexible-server virtual-endpoint delete \
  --resource-group <resource-group> \
  --server-name <server-name> \
  --name <virtual-endpoint-name>

En este comando, reemplace <resource-group>, <server-name>y <virtual-endpoint-name> por el grupo de recursos, el nombre del servidor y el nombre del punto de conexión virtual que desea eliminar.

REST API

Para eliminar un punto de conexión virtual mediante la API de REST de Azure, emitiría una solicitud HTTP DELETE. La dirección URL de la solicitud se estructuraría de la siguiente manera:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{serverName}/virtualendpoints/{virtualendpointName}?api-version=2023-06-01-preview

Eliminación de una réplica

Portal

Puede eliminar una réplica de lectura de forma similar a como elimina una instancia de servidor flexible independiente de Azure Database for PostgreSQL.

1. En Azure Portal, abra la página Introducción para la réplica de lectura. Seleccione Eliminar.

   

También puede eliminar la réplica de lectura desde la ventana Replicación siguiendo estos pasos:

2. En Azure Portal, seleccione su instancia de Servidor flexible principal de Azure Database for PostgreSQL.

3. En el menú del servidor, en Configuración, seleccione Replicación.

4. Seleccione la réplica de lectura que desea eliminar y, a continuación, seleccione los puntos suspensivos. Seleccione Eliminar.

   

5. Confirme la operación de eliminación.

CLI

Para eliminar un servidor primario o réplica, utilice el comando az postgres flexible-server delete. Si el servidor tiene réplicas de lectura, primero debe eliminar las réplicas de lectura antes de eliminar el servidor principal.

az postgres flexible-server delete \
  --resource-group <resource-group> \
  --name <server-name>

Reemplace <resource-group> y <server-name> por el nombre de su grupo de recursos y el nombre del servidor de réplica que desea eliminar.

REST API

Para eliminar un servidor primario o réplica, utilice la API de eliminación de servidores. Si el servidor tiene réplicas de lectura, las réplicas de lectura se deben eliminar primero antes de eliminar el servidor principal.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

Eliminación de un servidor principal

Solo puede eliminar el servidor principal una vez que elimine todas las réplicas de lectura. Para eliminar réplicas, siga las instrucciones de la sección Eliminar una réplica y, a continuación, continúe con los pasos proporcionados.

Portal

Para eliminar un servidor de Azure Portal, siga estos pasos:

1. En Azure Portal, seleccione su instancia de Servidor flexible principal de Azure Database for PostgreSQL.

2. En la página Información general del servidor, seleccione Eliminar.

   

3. Escriba el nombre del servidor principal que desea eliminar. Seleccione Eliminar para confirmar la eliminación del servidor principal.

   

CLI

Para eliminar un servidor primario o réplica, utilice el comando az postgres flexible-server delete. Si el servidor tiene réplicas de lectura, las réplicas de lectura se deben eliminar primero antes de eliminar el servidor principal.

az postgres flexible-server delete \
  --resource-group <resource-group> \
  --name <server-name>

Reemplace <resource-group> y <server-name> por el nombre de su grupo de recursos y el nombre del servidor principal que desea eliminar.

REST API

Para eliminar un servidor primario o réplica, utilice la API de eliminación de servidores. Si el servidor tiene réplicas de lectura, las réplicas de lectura se deben eliminar primero antes de eliminar el servidor principal.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}?api-version=2022-12-01

Supervisión de una réplica

Están disponibles dos métricas para supervisar las réplicas de lectura.

Retraso máximo de replicación física

Solo está disponible en el servidor principal.

La métrica Retraso máximo de replicación física muestra el retardo en bytes entre el servidor principal y la réplica con mayor retardo.

1. En Azure Portal, seleccione el servidor principal.

2. Seleccione Métricas. En la ventana Métricas, seleccione Retraso máximo de replicación física.

   

3. En Agregación, seleccione Máx.

Métrica Retraso de réplica de lectura

La métrica Retraso de réplica de lectura muestra el tiempo transcurrido desde la última transacción reproducida en una réplica. Si no se produce ninguna transacción en el servidor principal, la métrica refleja este retardo de tiempo. Por ejemplo, si no se producen transacciones en el servidor principal y la última transacción se reprodujo hace 5 segundos, el retraso de réplica de lectura mostrará 5 segundos de retraso.

1. En Azure Portal, seleccione Réplica de lectura.

2. Seleccione Métricas. En la ventana Métricas, seleccione Retraso de réplica de lectura.

   

3. En Agregación, seleccione Máx.

Contenido relacionado

• Réplicas de lectura en Azure Database for PostgreSQL: servidor flexible