Delen via

Leesreplica's maken en beheren in Azure Database for MariaDB met behulp van de Azure CLI en REST API

  • Artikel

Belangrijk

Azure Database for MariaDB bevindt zich op het buitengebruikstellingspad. We raden u ten zeerste aan om te migreren naar Azure Database for MySQL. Zie Wat gebeurt er met Azure Database for MariaDB voor meer informatie over migreren naar Azure Database for MySQL.

In dit artikel leert u hoe u leesreplica's maakt en beheert in de Azure Database for MariaDB-service met behulp van de Azure CLI en REST API.

Azure-CLI

U kunt leesreplica's maken en beheren met behulp van de Azure CLI.

Vereisten

Belangrijk

De functie leesreplica is alleen beschikbaar voor Azure Database for MariaDB-servers in de prijscategorieën Algemeen gebruik of Geoptimaliseerd voor geheugen. Zorg ervoor dat de bronserver zich in een van deze prijscategorieën bevindt.

Een leesreplica maken

Belangrijk

Wanneer u een replica maakt voor een bron die geen bestaande replica's heeft, wordt de bron eerst opnieuw opgestart om zich voor te bereiden op replicatie. Neem hier rekening mee en voer deze bewerkingen uit tijdens een dalperiode.

U kunt een leesreplicaserver maken met behulp van de volgende opdracht:

az mariadb server replica create --name mydemoreplicaserver --source-server mydemoserver --resource-group myresourcegroup

Voor de az mariadb server replica create opdracht zijn de volgende parameters vereist:

Instelling Voorbeeldwaarde Beschrijving
resource-group  myresourcegroup  De resourcegroep waarin de replicaserver wordt gemaakt. 
name mydemoreplicaserver De naam van de nieuwe replicaserver die wordt gemaakt.
source-server mydemoserver De naam of id van de bestaande bronserver waaruit moet worden gerepliceerd.

Als u een leesreplica voor meerdere regio's wilt maken, gebruikt u de --location parameter.

In het onderstaande CLI-voorbeeld wordt de replica gemaakt in VS - west.

az mariadb server replica create --name mydemoreplicaserver --source-server mydemoserver --resource-group myresourcegroup --location westus

Notitie

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

Notitie

Leesreplica's worden gemaakt met dezelfde serverconfiguratie als de hoofdserver. De configuratie van de replicaserver kan worden gewijzigd nadat deze is gemaakt. Het wordt aanbevolen om de configuratie van de replicaserver op gelijke of hogere waarden te houden dan de bron om ervoor te zorgen dat de replica de master kan bijhouden.

Replica's voor een bronserver weergeven

Als u alle replica's voor een bepaalde bronserver wilt weergeven, voert u de volgende opdracht uit:

az mariadb server replica list --server-name mydemoserver --resource-group myresourcegroup

Voor de az mariadb server replica list opdracht zijn de volgende parameters vereist:

Instelling Voorbeeldwaarde Beschrijving
resource-group  myresourcegroup  De resourcegroep waarin de replicaserver wordt gemaakt. 
servernaam mydemoserver De naam of id van de bronserver.

Replicatie naar een replicaserver stoppen

Belangrijk

Replicatie naar een server stoppen kan niet ongedaan worden. Zodra de replicatie tussen een bron en replica is gestopt, kan deze niet ongedaan worden gemaakt. De replicaserver wordt vervolgens een zelfstandige server en ondersteunt nu zowel lees- als schrijfbewerkingen. Van deze server kan niet opnieuw een replica worden gemaakt.

Replicatie naar een leesreplicaserver kan worden gestopt met behulp van de volgende opdracht:

az mariadb server replica stop --name mydemoreplicaserver --resource-group myresourcegroup

Voor de az mariadb server replica stop opdracht zijn de volgende parameters vereist:

Instelling Voorbeeldwaarde Beschrijving
resource-group  myresourcegroup  De resourcegroep waar de replicaserver bestaat. 
name mydemoreplicaserver De naam van de replicaserver waarop de replicatie moet worden gestopt.

Een replicaserver verwijderen

U kunt een leesreplicaserver verwijderen door de opdracht az mariadb server delete uit te voeren.

az mariadb server delete --resource-group myresourcegroup --name mydemoreplicaserver

Een bronserver verwijderen

Belangrijk

Als u een bronserver verwijdert, wordt de replicatie naar alle replicaservers gestopt en wordt de bronserver zelf verwijderd. Replicaservers worden zelfstandige servers die nu zowel lees-als schrijfbewerkingen ondersteunen.

Als u een bronserver wilt verwijderen, kunt u de opdracht az mariadb server delete uitvoeren.

az mariadb server delete --resource-group myresourcegroup --name mydemoserver

REST-API

U kunt leesreplica's maken en beheren met behulp van de Azure REST API.

Een leesreplica maken

U kunt een leesreplica maken met behulp van de create-API:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{replicaName}?api-version=2017-12-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "Replica",
    "sourceServerId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}"
  }
}

Notitie

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

Als u de azure.replication_support parameter niet hebt ingesteld op REPLICA op een bronserver voor algemeen gebruik of geoptimaliseerd voor geheugen en de server opnieuw hebt opgestart, krijgt u een foutmelding. Voer deze twee stappen uit voordat u een replica maakt.

Er wordt een replica gemaakt met dezelfde reken- en opslaginstellingen als de hoofdserver. Nadat een replica is gemaakt, kunnen verschillende instellingen onafhankelijk van de bronserver worden gewijzigd: berekeningsgeneratie, vCores, opslag en back-upretentieperiode. De prijscategorie kan ook onafhankelijk worden gewijzigd, behalve van of van de Basic-laag.

Belangrijk

Voordat een bronserverinstelling wordt bijgewerkt naar een nieuwe waarde, werkt u de replica-instelling bij naar een gelijke of hogere waarde. Met deze actie kan de replica alle wijzigingen in de master bijhouden.

Replica's weergeven

U kunt de lijst met replica's van een bronserver weergeven met behulp van de API voor replicalijsten:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}/Replicas?api-version=2017-12-01

Replicatie naar een replicaserver stoppen

U kunt de replicatie tussen een bronserver en een leesreplica stoppen met behulp van de update-API.

Nadat u de replicatie naar een bronserver en een leesreplica hebt gestopt, kan deze niet ongedaan worden gemaakt. De leesreplica wordt een zelfstandige server die zowel lees- als schrijfbewerkingen ondersteunt. De zelfstandige server kan niet opnieuw in een replica worden gemaakt.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}?api-version=2017-12-01

{
  "properties": {
    "replicationRole":"None"  
   }
}

Een bron- of replicaserver verwijderen

Als u een bron- of replicaserver wilt verwijderen, gebruikt u de verwijder-API:

Wanneer u een bronserver verwijdert, wordt de replicatie naar alle leesreplica's gestopt. De leesreplica's worden zelfstandige servers die nu zowel lees- als schrijfbewerkingen ondersteunen.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}?api-version=2017-12-01

Volgende stappen