Share via

Come creare e gestire repliche in lettura in Database di Azure per MariaDB usando l'interfaccia della riga di comando di Azure e l'API REST

  • Articolo

Importante

Database di Azure per MariaDB è sul percorso di ritiro. È consigliabile eseguire la migrazione a Database di Azure per MySQL. Per altre informazioni sulla migrazione a Database di Azure per MySQL, vedere What's happening to Database di Azure per MariaDB?.

Questo articolo illustra come creare e gestire repliche in lettura nel servizio Database di Azure per MariaDB usando l'interfaccia della riga di comando di Azure e l'API REST.

Interfaccia della riga di comando di Azure

È possibile creare e gestire repliche in lettura usando l'interfaccia della riga di comando di Azure.

Prerequisiti

Importante

La funzionalità di replica in lettura è disponibile solo per i server Database di Azure per MariaDB nei piani tariffari Per utilizzo generico o Ottimizzato per la memoria. Verificare che il server di origine si trova in uno di questi piani tariffari.

Creare una replica in lettura

Importante

Quando si crea una replica per un'origine che non dispone di repliche esistenti, l'origine verrà prima riavviata per prepararsi per la replica. Tenere in considerazione questo aspetto ed eseguire queste operazioni durante un periodo di scarso traffico.

È possibile creare un server di replica in lettura usando il comando seguente:

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

Il comando az mariadb server replica create richiede i parametri seguenti:

Impostazione Valore di esempio Descrizione
resource-group  myresourcegroup  Gruppo di risorse in cui verrà creato il server di replica. 
name mydemoreplicaserver Nome del nuovo server di replica creato.
source-server mydemoserver Nome o ID del server di origine esistente da cui eseguire la replica.

Per creare una replica in lettura tra aree, usare il --location parametro .

L'esempio dell'interfaccia della riga di comando seguente crea la replica negli Stati Uniti occidentali.

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

Nota

Per altre informazioni sulle aree in cui è possibile creare una replica, vedere l'articolo Concetti relativi alle repliche in lettura.

Nota

Le repliche in lettura vengono create con la stessa configurazione server del master. La configurazione del server di replica può essere modificata dopo la creazione. È consigliabile mantenere la configurazione del server di replica con valori uguali o maggiori rispetto all'origine per garantire che la replica sia in grado di mantenere il passo con il master.

Elencare le repliche per un server di origine

Per visualizzare tutte le repliche per un determinato server di origine, eseguire il comando seguente:

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

Il comando az mariadb server replica list richiede i parametri seguenti:

Impostazione Valore di esempio Descrizione
resource-group  myresourcegroup  Gruppo di risorse in cui verrà creato il server di replica. 
server-name mydemoserver Nome o ID del server di origine.

Arrestare la replica in un server di replica

Importante

L'arresto della replica in un server è irreversibile. Una volta arrestata la replica tra un'origine e una replica, non può essere annullata. Il server di replica diventa quindi un server autonomo che supporta sia la lettura che la scrittura. Questo server non può essere di nuovo impostato come replica.

È possibile interrompere la replica su un server di replica in lettura usando il comando seguente:

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

Il comando az mariadb server replica stop richiede i parametri seguenti:

Impostazione Valore di esempio Descrizione
resource-group  myresourcegroup  Gruppo di risorse in cui si trova il server di replica. 
name mydemoreplicaserver Nome del server di replica su cui si vuole arrestare la replica.

Eliminare un server di replica

L'eliminazione di un server di replica in lettura può essere eseguita eseguendo il comando az mariadb server delete .

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

Eliminare un server di origine

Importante

Eliminando un server di origine si arresta la replica in tutti i server di replica, oltre a eliminare il server di origine stesso. I server di replica diventano server autonomi che supportano sia la lettura che la scrittura.

Per eliminare un server di origine, è possibile eseguire il comando az mariadb server delete .

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

REST API

È possibile creare e gestire repliche in lettura usando l'API REST di Azure.

Creare una replica in lettura

È possibile creare una replica di lettura usando l'API di creazione:

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

Nota

Per altre informazioni sulle aree in cui è possibile creare una replica, vedere l'articolo Concetti relativi alle repliche in lettura.

Se il parametro non è stato impostato su azure.replication_support REPLICA in un server di origine per utilizzo generico o ottimizzato per la memoria e riavviato il server, viene visualizzato un errore. Completare questi due passaggi prima di creare una replica.

Una replica viene creata usando le stesse impostazioni di calcolo e archiviazione del master. Dopo aver creato una replica, è possibile modificare diverse impostazioni in modo indipendente dal server di origine: generazione di calcolo, vCore, archiviazione e periodo di conservazione del backup. È anche possibile modificare in modo indipendente il piano tariffario, tranne da o verso il livello Basic.

Importante

Prima che un'impostazione del server di origine venga aggiornata a un nuovo valore, aggiornare l'impostazione della replica su un valore uguale o maggiore. Questa azione consente alla replica di mantenere le modifiche apportate al master.

Elencare le repliche

È possibile visualizzare l'elenco delle repliche di un server di origine usando l'API dell'elenco di repliche:

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

Arrestare la replica in un server di replica

È possibile arrestare la replica tra un server di origine e una replica di lettura usando l'API di aggiornamento.

Dopo aver arrestato la replica in un server di origine e in una replica di lettura, non può essere annullata. La replica in lettura diventa un server autonomo che supporta sia la lettura che la scrittura. Il server autonomo non può essere di nuovo impostato come replica.

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

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

Eliminare un server di origine o di replica

Per eliminare un server di origine o di replica, usare l'API delete:

Quando si elimina un server di origine, la replica in tutte le repliche in lettura viene arrestata. Le repliche in lettura diventano server autonomi che supportano sia la lettura che la scrittura.

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

Passaggi successivi