Leesreplica's maken en beheren in Azure Database for PostgreSQL - Flexible Server vanuit Azure Portal, CLI of REST API

VAN TOEPASSING OP: Azure Database for PostgreSQL - Flexibele server

In dit artikel leert u hoe u leesreplica's in Azure Database for PostgreSQL flexibele server maakt en beheert vanuit azure Portal, CLI en REST API. Zie het overzicht voor meer informatie over leesreplica's.

Vereisten

Een exemplaar van een flexibele Azure Database for PostgreSQL-server als primaire server.

Notitie

Bij het implementeren van leesreplica's voor permanente zware primaire werkbelastingen met veel schrijfintensieve primaire workloads, kan de replicatievertraging blijven groeien en kan de replicatievertraging nooit worden bijgehouden met de primaire werkbelasting. Dit kan ook het opslaggebruik bij de primaire opslag verhogen, omdat de WAL-bestanden slechts eenmaal worden verwijderd nadat ze zijn ontvangen op de replica.

Primaire instellingen controleren

Voordat u een leesreplica instelt voor een flexibele Azure Database for PostgreSQL-server, moet u ervoor zorgen dat de primaire server is geconfigureerd om te voldoen aan de vereiste vereisten. Specifieke instellingen op de primaire server kunnen van invloed zijn op de mogelijkheid om replica's te maken.

Automatisch vergroten van opslag: instellingen voor automatisch vergroten van opslag op de primaire server en de leesreplica's moeten voldoen aan specifieke richtlijnen om consistentie te garanderen en replicatieonderbrekingen te voorkomen. Raadpleeg de automatische groei van Opslag voor gedetailleerde regels en instellingen.

Premium SSD v2: de huidige release biedt geen ondersteuning voor het maken van leesreplica's voor primaire servers met premium SSD v2-opslag. Als voor uw workload leesreplica's zijn vereist, kiest u een andere opslagoptie voor de primaire server.

Portal

1. Kies in Azure Portal het flexibele serverexemplaren van Azure Database for PostgreSQL dat u wilt gebruiken voor de replica.

2. Noteer in het dialoogvenster Overzicht de PostgreSQL-versie (bijvoorbeeld 15.4). Let ook op de regio waar uw primaire primaire is geïmplementeerd (bijvoorbeeld East US).

   

3. Selecteer Compute en opslag in de zijbalk van de server onder Instellingen.

4. Controleer en noteer de volgende instellingen:

   • Rekenlaag, processor, grootte (bijvoorbeeld Standard_D4ads_v5).

   • Storage

     • Opslaggrootte (bijvoorbeeld 128GB)
     • Automatische groei

   • Hoge beschikbaarheid

     • Ingeschakeld/uitgeschakeld
     • Instellingen voor beschikbaarheidszone

   • Back-upinstellingen

     • Bewaarperiode
     • Opties voor redundantie

5. Selecteer Onder Instellingen de optie Netwerken.

6. Controleer de netwerkinstellingen.

   

CLI

Notitie

De opdrachten in deze handleiding zijn van toepassing op Azure CLI versie 2.56.0 of hoger. Zorg ervoor dat u de vereiste versie of een latere versie hebt geïnstalleerd om deze opdrachten uit te voeren. U kunt uw huidige Versie van Azure CLI controleren door deze uit te voeren az --version in de opdrachtregelinterface. Als u Azure CLI wilt bijwerken naar de nieuwste versie, volgt u de instructies in de Azure CLI-documentatie.

Gebruik de opdracht om de configuratie en de huidige status van een Flexibele Azure PostgreSQL-server weer te az postgres flexible-server show geven. Deze opdracht bevat gedetailleerde informatie over de opgegeven server.

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

Vervang en <server-name> door <resource-group> uw specifieke resourcegroep en de naam van de server die u wilt weergeven.

Controleer en noteer de volgende instellingen:

• Rekenlaag, processor, grootte (bijvoorbeeld Standard_D8ads_v5).
• Opslag
  • Type
  • Opslaggrootte (bijvoorbeeld 128)
  • automatisch groeien
• Hoge beschikbaarheid
  • Ingeschakeld/uitgeschakeld
  • Instellingen voor beschikbaarheidszone
• Back-upinstellingen
  • Bewaarperiode
  • Opties voor redundantie

Voorbeeldrespons

{
  "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

Als u informatie wilt over de configuratie van een server in Azure Database for PostgreSQL Flexibele server, met name om instellingen voor onlangs geïntroduceerde functies zoals automatische groei van opslag of private link weer te geven, moet u de nieuwste API-versie 2023-06-01-previewgebruiken. De GET aanvraag wordt als volgt opgemaakt:

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

Vervang , {resourceGroupName}en {serverName} door {subscriptionId}uw Azure-abonnements-id, de naam van de resourcegroep en de naam van de primaire server die u wilt controleren. Met deze aanvraag krijgt u toegang tot de configuratiedetails van uw primaire server, zodat deze correct is ingesteld voor het maken van een leesreplica.

Controleer en noteer de volgende instellingen:

• Rekenlaag, processor, grootte (bijvoorbeeld Standard_D8ads_v5).
• Opslag
  • Type
  • Opslaggrootte (bijvoorbeeld 128)
  • automatisch groeien
• Netwerk
• Hoge beschikbaarheid
  • Ingeschakeld/uitgeschakeld
  • Instellingen voor beschikbaarheidszone
• Back-upinstellingen
  • Bewaarperiode
  • Opties voor redundantie

Voorbeeldrespons

{
    "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"
}

Een leesreplica maken

Voer de volgende stappen uit om een leesreplica te maken:

Portal

1. Selecteer een bestaand exemplaar van een flexibele Azure Database for PostgreSQL-server dat u als primaire server wilt gebruiken.

2. Selecteer Replicatie in de zijbalk van de server onder Instellingen.

3. Selecteer Replica maken.

   

4. Voer het basisformulier in met de volgende informatie.

   

5. Selecteer Controleren en maken om het maken van de replica of Volgende te bevestigen: Netwerken als u firewallregels wilt toevoegen, verwijderen of wijzigen.

   

6. Laat de overige standaardwaarden staan en selecteer vervolgens de knop Beoordelen en maken onder aan de pagina of ga verder met de volgende formulieren om tags toe te voegen of de gegevensversleutelingsmethode te wijzigen.

7. Bekijk de informatie in het laatste bevestigingsvenster. Wanneer u klaar bent, selecteert u Maken. Er wordt een nieuwe implementatie gemaakt.

   

8. Tijdens de implementatie ziet u de primaire Updating status.

   Nadat de leesreplica is gemaakt, kan deze worden weergegeven vanuit het venster Replicatie .

   

CLI

U kunt met behulp van de az postgres flexible-server replica create opdracht een leesreplica voor uw Flexibele Azure PostgreSQL-server maken.

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

Vervang <replica-name>, <resource-group>, <source-server-name>en <location> door uw specifieke waarden.

Nadat de leesreplica is gemaakt, kunnen de eigenschappen van alle servers, die replica's van een primaire replica zijn, worden verkregen met behulp van de az postgres flexible-server replica create opdracht.

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

Vervang <source-server-name>en <resource-group> door uw specifieke waarden.

REST API

Start een HTTP PUT aanvraag met behulp van de api voor het maken van servers:

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

Hier moet u uw specifieke Azure-abonnements-id, de naam van uw resourcegroep en de gewenste naam voor uw leesreplica vervangen{subscriptionId}{resourceGroupName}{replicaserverName}.

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

Nadat de leesreplica is gemaakt, kunnen de eigenschappen van alle servers, die replica's van een primaire replica zijn, worden verkregen door een HTTP GET aanvraag te starten met behulp van de lijst met replica's per server-API:

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

Hier moet u respectievelijk uw specifieke Azure-abonnements-id, de naam van uw resourcegroep en de naam die u hebt toegewezen aan uw primaire replica vervangen{subscriptionId}{resourceGroupName}{sourceserverName}.

[
  {
    "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
  }
]

• Stel de naam van de replicaserver in.

  Tip

  Het is een CAF-best practice (Cloud Adoption Framework) om een naamconventie voor resources te gebruiken waarmee u eenvoudig kunt bepalen met welk exemplaar u verbinding maakt of beheert en waar deze zich bevindt.

• Selecteer een andere locatie dan uw primaire locatie, maar houd er rekening mee dat u dezelfde regio kunt selecteren.

  Tip

  Raadpleeg het artikel leesreplicaconcepten voor meer informatie over de regio's waarin u een replica kunt maken.

• Stel de berekening en opslag in op wat u hebt vastgelegd op basis van uw primaire opslag. Als de weergegeven berekening niet overeenkomt, selecteert u Server configureren en selecteert u de juiste.

  Notitie

  Als u een rekenkracht selecteert die kleiner is dan de primaire, mislukt de implementatie. Houd er ook rekening mee dat de rekenkracht mogelijk niet beschikbaar is in een andere regio.

  

Belangrijk

Bekijk de overwegingensectie van het overzicht leesreplica.

Om problemen tijdens de promotie van replica's voortdurend te voorkomen, veranderen eerst de volgende serverparameters op de replica's, voordat ze worden toegepast op de primaire: max_connections, max_prepared_transactions, max_locks_per_transaction, max_wal_senders, , . max_worker_processes

Virtuele eindpunten maken

Notitie

Alle bewerkingen met betrekking tot virtuele eindpunten, zoals toevoegen, bewerken of verwijderen, worden uitgevoerd in de context van de primaire server.

Portal

1. Selecteer in Azure Portal de primaire server.

2. Selecteer Replicatie in de zijbalk van de server onder Instellingen.

3. Selecteer Eindpunt maken.

4. Typ in het dialoogvenster een beschrijvende naam voor uw eindpunt. Let op het DNS-eindpunt dat wordt gegenereerd.

   

5. Selecteer Maken.

   Notitie

   Als u geen virtueel eindpunt maakt, krijgt u een foutmelding over de poging om de replica te promoveren.

   

CLI

U kunt een virtueel eindpunt maken met behulp van de az postgres flexible-server virtual-endpoint create opdracht.

    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>

Vervang <resource-group>, <primary-name>, <virtual-endpoint-name>en <replica-name> door uw specifieke waarden.

REST API

Als u een virtueel eindpunt wilt maken met behulp van de REST API van Azure, gebruikt u een HTTP PUT aanvraag. De aanvraag ziet er als volgt uit:

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

De bijbehorende JSON-hoofdtekst voor deze aanvraag is als volgt:

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

{replicaserverName} Hier moet u worden vervangen door de naam van de replicaserver die u als eindpuntdoel voor lezer in dit virtuele eindpunt opvoegt.

Virtuele eindpunten weergeven

Gebruik de volgende stappen om virtuele eindpunten weer te geven:

Portal

1. Selecteer in Azure Portal de primaire server.

2. Selecteer Replicatie in de zijbalk van de server onder Instellingen.

3. Boven aan de pagina ziet u zowel de eindpunten van de lezer als de schrijver, samen met de namen van de servers waarnaar ze verwijzen.

   

CLI

U kunt de details van het virtuele eindpunt weergeven met behulp van de opdracht of show de list opdracht. Aangezien slechts één virtueel eindpunt per primair replicapaar is toegestaan, leveren beide opdrachten hetzelfde resultaat op.

Hier volgt een voorbeeld van het gebruik van de list opdracht:

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

Vervang <server-name> door de naam van uw primaire server en <resource-group> door de naam van uw resourcegroep.

U kunt de show opdracht als volgt gebruiken:

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

Vervang in deze opdracht en<server-name> vervang <virtual-endpoint-name>deze <resource-group> door de respectieve namen. <server-name> is de naam van uw primaire server.

REST API

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

{sourceserverName} Hier moet de naam zijn van de primaire server van waaruit u de virtuele eindpunten beheert.

Toepassing wijzigen zodat deze verwijst naar het virtuele eindpunt

Wijzig alle toepassingen die gebruikmaken van uw flexibele Azure Database for PostgreSQL-serverexemplaren om de nieuwe virtuele eindpunten te gebruiken (bijvoorbeeld: corp-pg-001.writer.postgres.database.azure.com en corp-pg-001.reader.postgres.database.azure.com).

Replica's promoveren

Nu alle benodigde onderdelen aanwezig zijn, bent u klaar om een niveau van replica naar primaire bewerking uit te voeren.

Portal

Voer de volgende stappen uit om de replica te promoveren vanuit Azure Portal:

1. Selecteer in Azure Portal uw primaire exemplaar van azure Database for PostgreSQL Flexibele server.

2. Selecteer Replicatie in het servermenu onder Instellingen.

3. Selecteer onder Servers het pictogram Niveau verhogen voor de replica.

   

4. Controleer in het dialoogvenster of de actie Niveau verhogen naar de primaire server is.

5. Voor gegevenssynchronisatie moet u ervoor zorgen dat geplande synchronisatiegegevens zijn voordat promotie wordt geselecteerd.

   

6. Selecteer Niveau verhogen om het proces te starten. Zodra deze is voltooid, worden de rollen omgekeerd: de replica wordt de primaire en de primaire rol van de replica.

CLI

Gebruik de opdracht bij het az postgres flexible-server replica promote promoveren van een replica naar een primaire server in Azure PostgreSQL Flexible Server. Dit proces is essentieel voor het verhogen van een replicaserver om te functioneren als de primaire server en degradatie van de huidige primaire naar replica-rol. Geef --promote-mode switchover de opdracht op en --promote-option planned geef deze op.

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

Vervang <resource-group> en vervang deze <replica-server-name> door de naam van uw specifieke resourcegroep en replicaserver. Met deze opdracht zorgt u voor een soepele overgang van de replica naar een primaire rol op een geplande manier.

REST API

Gebruik bij het promoveren van een replica naar een primaire server een HTTP PATCH aanvraag met een specifieke JSON hoofdtekst om de promotieopties in te stellen. Dit proces is van cruciaal belang wanneer u een replicaserver moet uitbreiden om te fungeren als de primaire server.

De HTTP aanvraag is als volgt gestructureerd:

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"
    }
  }
}

In dit JSONgeval wordt de promotie ingesteld in switchover de modus met een planned promotieoptie. Hoewel er twee opties zijn voor promotie- planned of forced - kiest u planned voor deze oefening.

Notitie

Aan de replica die u promoveert, moet het virtuele eindpunt van de lezer zijn toegewezen, anders krijgt u een foutmelding over promotie.

Toepassingen testen

Als u bepaalde bewerkingen wilt uitvoeren, start u uw toepassingen opnieuw op en probeert u deze bewerkingen uit te voeren. Uw toepassingen moeten naadloos functioneren zonder het virtuele eindpunt te wijzigen verbindingsreeks of DNS-vermeldingen. Laat uw toepassingen deze keer actief.

Failback naar de oorspronkelijke server en regio

Herhaal dezelfde bewerkingen om de oorspronkelijke server naar de primaire server te promoveren.

Portal

1. Selecteer de replica in Azure Portal.

2. Selecteer Replicatie in de zijbalk van de server onder Instellingen

3. Selecteer onder Servers het pictogram Niveau verhogen voor de replica.

4. Controleer in het dialoogvenster of de actie Niveau verhogen naar de primaire server is.

5. Voor gegevenssynchronisatie moet u ervoor zorgen dat geplande synchronisatiegegevens zijn voordat promotie wordt geselecteerd.

6. Selecteer Niveau verhogen, het proces begint. Zodra deze is voltooid, worden de rollen omgekeerd: de replica wordt de primaire en de primaire rol van de replica.

CLI

Wijzig deze keer de <replica-server-name> in de az postgres flexible-server replica promote opdracht om te verwijzen naar uw oude primaire server, die momenteel als een replica fungeert en voer de aanvraag opnieuw uit.

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

Vervang en <replica-server-name> door <resource-group> de naam van uw specifieke resourcegroep en huidige replicaserver.

REST API

Wijzig deze keer de {replicaserverName} API-aanvraag om te verwijzen naar uw oude primaire server, die momenteel als replica fungeert en voer de aanvraag opnieuw uit.

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"
    }
  }
}

In dit JSONgeval wordt de promotie ingesteld in switchover de modus met een planned promotieoptie. Hoewel er twee opties zijn voor promotie- planned of forced - kiest u planned voor deze oefening.

Toepassingen testen

Schakel opnieuw over naar een van de verbruikende toepassingen. Wacht totdat de primaire en replicastatus is gewijzigd Updating en probeer vervolgens enkele bewerkingen uit te voeren. Tijdens het promoveren van de replica kan uw toepassing tijdelijke verbindingsproblemen met het eindpunt ondervinden:

Secundaire leesreplica toevoegen

Maak een secundaire leesreplica in een afzonderlijke regio om het virtuele eindpunt van de lezer te wijzigen en om een onafhankelijke server te maken op basis van de eerste replica.

Portal

1. Kies in Azure Portal het primaire exemplaar van de flexibele Azure Database for PostgreSQL-server.

2. Selecteer Replicatie in de zijbalk van de server onder Instellingen.

3. Selecteer Replica maken.

4. Voer het basisformulier in met informatie in een derde regio (bijvoorbeeld westus )corp-pg-westus-001

5. Selecteer Controleren en maken om het maken van de replica of Volgende te bevestigen: Netwerken als u firewallregels wilt toevoegen, verwijderen of wijzigen.

6. Controleer de firewallinstellingen. U ziet hoe de primaire instellingen automatisch worden gekopieerd.

7. Laat de overige standaardwaarden staan en selecteer vervolgens de knop Beoordelen en maken onder aan de pagina of ga verder met de volgende formulieren om beveiliging te configureren of tags toe te voegen.

8. Bekijk de informatie in het laatste bevestigingsvenster. Wanneer u klaar bent, selecteert u Maken. Er wordt een nieuwe implementatie gemaakt.

9. Tijdens de implementatie ziet u de primaire Updating status.

   

CLI

U kunt een secundaire leesreplica maken met behulp van de az postgres flexible-server replica create opdracht.

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

Kies een afzonderlijke naam om <replica-name> deze te onderscheiden van de primaire server en andere replica's. Vervang <resource-group>, <source-server-name>en <location> door uw specifieke waarden.

REST API

U kunt een secundaire leesreplica maken met behulp van de api voor het maken van servers:

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

Kies een afzonderlijke naam om {replicaserverName} deze te onderscheiden van de primaire server en andere replica's.

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

De locatie is ingesteld op westus3, maar u kunt de instelling aanpassen op basis van uw geografische en operationele behoeften.

Virtueel eindpunt wijzigen

Portal

1. Kies in Azure Portal het primaire exemplaar van de flexibele Azure Database for PostgreSQL-server.

2. Selecteer Replicatie in de zijbalk van de server onder Instellingen.

3. Selecteer het beletselteken en selecteer vervolgens Bewerken.

   

4. Selecteer in het dialoogvenster de nieuwe secundaire replica.

   

5. Selecteer Opslaan. Het eindpunt van de lezer is nu gericht op de secundaire replica en de promotiebewerking is nu gekoppeld aan deze replica.

CLI

U kunt nu het eindpunt van de lezer wijzigen zodat deze verwijst naar de zojuist gemaakte secundaire replica met behulp van een az postgres flexible-server virtual-endpoint update opdracht. Vergeet niet om deze te vervangen door <replica-name> de naam van de zojuist gemaakte leesreplica.

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>

Vervang <resource-group>, <server-name>, <virtual-endpoint-name>en <replica-name> door uw specifieke waarden.

REST API

U kunt nu het eindpunt van de lezer wijzigen zodat deze verwijst naar de zojuist gemaakte secundaire replica met behulp van een PATCH aanvraag. Vergeet niet om deze te vervangen door {replicaserverName} de naam van de zojuist gemaakte leesreplica.

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}"] 
  }
} 

Replica promoveren naar onafhankelijke server

In plaats van over te schakelen naar een replica, is het ook mogelijk om de replicatie van een replica te verbreken, zodat deze de zelfstandige server wordt.

Portal

1. Kies in Azure Portal de primaire server van Azure Database for PostgreSQL flexibele server.

2. Selecteer Replicatie in de zijbalk van de server in het servermenu onder Instellingen.

3. Selecteer onder Servers het pictogram Niveau verhogen voor de replica die u wilt promoveren naar een onafhankelijke server.

   

4. Controleer in het dialoogvenster of de actie Niveau verhogen naar onafhankelijke server is en verwijder uit replicatie. Dit heeft geen invloed op de primaire server.

5. Voor gegevenssynchronisatie moet u ervoor zorgen dat geplande synchronisatiegegevens zijn voordat promotie wordt geselecteerd.

   

6. Selecteer Niveau verhogen, het proces begint. Zodra dit is voltooid, is de server geen replica meer van de primaire server.

CLI

Wanneer u een replica in Azure PostgreSQL Flexible Server promoveert, is het standaardgedrag om deze te promoveren naar een onafhankelijke server. De promotie wordt bereikt met behulp van de az postgres flexible-server replica promote opdracht zonder de --promote-mode optie op te geven, omdat standalone standaard wordt uitgegaan van de modus.

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

Vervang in deze opdracht <resource-group> de naam van uw specifieke resourcegroep en <replica-server-name> de naam van de eerste replicaserver die u hebt gemaakt, die geen deel meer uitmaakt van het virtuele eindpunt.

REST API

U kunt een replica promoveren naar een zelfstandige server met behulp van een PATCH aanvraag. Verzend een PATCH aanvraag naar de opgegeven AZURE Management REST API-URL met de eerste JSON hoofdtekst, waar PromoteMode deze is ingesteld standalone op en PromoteOption op planned. De indeling van de tweede JSON hoofdtekst, ingesteld ReplicationRole op None, is afgeschaft, maar wordt hier nog steeds vermeld voor compatibiliteit met eerdere versies.

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"
  }
}

Notitie

Zodra een replica is gepromoveerd naar een onafhankelijke server, kan deze niet meer worden toegevoegd aan de replicatieset.

Virtueel eindpunt verwijderen

Portal

1. Selecteer in Azure Portal de primaire server.

2. Selecteer Replicatie in de zijbalk van de server onder Instellingen.

3. Zoek Virtual endpoints de sectie boven aan de pagina. Navigeer naar de drie puntjes (menuopties) naast de naam van het eindpunt, vouw deze uit en kies Delete.

4. Er wordt een bevestigingsvenster voor verwijderen weergegeven. Er wordt een waarschuwing weergegeven: 'Met deze actie wordt het virtuele eindpunt virtualendpointNameverwijderd. Clients die zijn verbonden met deze domeinen, hebben mogelijk geen toegang meer. Bevestig de gevolgen en bevestig dit door op Verwijderen te klikken.

CLI

Als u een virtueel eindpunt van een Flexibele Azure PostgreSQL-server wilt verwijderen, kunt u de az postgres flexible-server virtual-endpoint delete opdracht gebruiken. Met deze actie wordt het opgegeven virtuele eindpunt definitief verwijderd.

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

Vervang in deze opdracht en <server-name>vervang <resource-group>deze <virtual-endpoint-name> door uw specifieke resourcegroep, servernaam en de naam van het virtuele eindpunt dat u wilt verwijderen.

REST API

Als u een virtueel eindpunt wilt verwijderen met behulp van de REST API van Azure, zou u een HTTP DELETE aanvraag indienen. De aanvraag-URL wordt als volgt gestructureerd:

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

Een replica verwijderen

Portal

U kunt een leesreplica verwijderen die vergelijkbaar is met hoe u een zelfstandig exemplaar van een flexibele Azure Database for PostgreSQL-server verwijdert.

1. Open in Azure Portal de pagina Overzicht voor de leesreplica. Selecteer Verwijderen.

   

U kunt de leesreplica ook verwijderen uit het venster Replicatie door de volgende stappen uit te voeren:

2. Selecteer in Azure Portal uw primaire exemplaar van azure Database for PostgreSQL Flexibele server.

3. Selecteer Replicatie in het servermenu onder Instellingen.

4. Selecteer de leesreplica die u wilt verwijderen en selecteer vervolgens het beletselteken. Selecteer Verwijderen.

   

5. Bevestig de bewerking Verwijderen .

CLI

Als u een primaire server of replicaserver wilt verwijderen, gebruikt u de az postgres flexible-server delete opdracht. Als de server leesreplica's heeft, moet u eerst de leesreplica's verwijderen voordat u de primaire server verwijdert.

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

Vervang <resource-group> en <server-name> door de naam van de resourcegroep en de naam van de replicaserver die u wilt verwijderen.

REST API

Als u een primaire of replicaserver wilt verwijderen, gebruikt u de API voor het verwijderen van servers. Als de server leesreplica's heeft, moeten leesreplica's eerst worden verwijderd voordat u de primaire server verwijdert.

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

Een primaire server verwijderen

U kunt de primaire server alleen verwijderen nadat u alle leesreplica's hebt verwijderd. Als u replica's wilt verwijderen, volgt u de instructies in de sectie Een replica verwijderen en gaat u vervolgens verder met de opgegeven stappen.

Portal

Voer de volgende stappen uit om een server te verwijderen uit Azure Portal:

1. Selecteer in Azure Portal uw primaire exemplaar van azure Database for PostgreSQL Flexibele server.

2. Open de pagina Overzicht voor de server en selecteer Verwijderen.

   

3. Voer de naam in van de primaire server die u wilt verwijderen. Selecteer Verwijderen om het verwijderen van de primaire server te bevestigen.

   

CLI

Als u een primaire server of replicaserver wilt verwijderen, gebruikt u de az postgres flexible-server delete opdracht. Als de server leesreplica's heeft, moeten leesreplica's eerst worden verwijderd voordat u de primaire server verwijdert.

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

Vervang en <server-name> door <resource-group> de naam van uw resourcegroep en de naam van de primaire server die u wilt verwijderen.

REST API

Als u een primaire of replicaserver wilt verwijderen, gebruikt u de API voor het verwijderen van servers. Als de server leesreplica's heeft, moeten leesreplica's eerst worden verwijderd voordat u de primaire server verwijdert.

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

Een replica bewaken

Er zijn twee metrische gegevens beschikbaar om leesreplica's te bewaken.

Maximale vertraging van fysieke replicatie

Alleen beschikbaar op de primaire.

De meetwaarde Max Physical Replication Lag toont de bytevertraging tussen de primaire server en de meest achterblijvende replica.

1. Selecteer in Azure Portal de primaire server.

2. Selecteer Metrische gegevens. Selecteer Max Physical Replication Lag in het venster Metrische gegevens.

   

3. Selecteer Max voor uw aggregatie.

Metrische waarde replicavertraging lezen

De metrische gegevens leesreplicavertraging toont de tijd sinds de laatste opnieuw afgespeelde transactie op een replica. Als er geen transacties plaatsvinden op uw primaire computer, weerspiegelt de metrische waarde deze tijdvertraging. Als er bijvoorbeeld geen transacties plaatsvinden op uw primaire server en de laatste transactie vijf seconden geleden opnieuw is afgespeeld, toont de vertraging van leesreplica een vertraging van 5 seconden.

1. Selecteer leesreplica in Azure Portal.

2. Selecteer Metrische gegevens. Selecteer leesreplicavertraging in het venster Metrische gegevens.

   

3. Selecteer Max voor uw aggregatie.

Gerelateerde inhoud

• Leesreplica's in Azure Database for PostgreSQL - flexibele server