Vytvoření a správa replik pro čtení ve službě Azure Database for MariaDB pomocí Rozhraní příkazového řádku Azure a rozhraní REST API

Důležité

Azure Database for MariaDB je na cestě vyřazení. Důrazně doporučujeme migrovat do služby Azure Database for MySQL. Další informace o migraci na Azure Database for MySQL najdete v tématu Co se děje se službou Azure Database for MariaDB?.

V tomto článku se dozvíte, jak vytvářet a spravovat repliky pro čtení ve službě Azure Database for MariaDB pomocí Rozhraní příkazového řádku Azure a rozhraní REST API.

Azure CLI

Repliky pro čtení můžete vytvářet a spravovat pomocí Azure CLI.

Požadavky

Důležité

Funkce repliky pro čtení je k dispozici pouze pro servery Azure Database for MariaDB v cenových úrovních Pro obecné účely nebo Optimalizováno pro paměť. Ujistěte se, že zdrojový server je v některé z těchto cenových úrovní.

Vytvoření repliky pro čtení

Důležité

Když vytvoříte repliku pro zdroj, který nemá žádné existující repliky, zdroj se nejprve restartuje, aby se připravil na replikaci. Vezměte v úvahu tyto operace a proveďte tyto operace v období mimo špičku.

Server repliky pro čtení je možné vytvořit pomocí následujícího příkazu:

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

Příkaz az mariadb server replica create vyžaduje následující parametry:

Nastavení Příklad hodnoty Popis
resource-group  myresourcegroup  Skupina prostředků, do které se vytvoří server repliky. 
name mydemoreplicaserver Název nového serveru repliky, který se vytvoří.
source-server mydemoserver Název nebo ID existujícího zdrojového serveru, ze které se má replikovat.

K vytvoření repliky pro čtení mezi oblastmi použijte --location parametr.

Následující příklad rozhraní příkazového řádku vytvoří repliku v oblasti USA – západ.

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

Poznámka:

Další informace o oblastech, ve kterých můžete vytvořit repliku, najdete v článku konceptů replik pro čtení.

Poznámka:

Repliky pro čtení se vytvářejí se stejnou konfigurací serveru jako hlavní server. Konfiguraci serveru repliky je možné po vytvoření změnit. Doporučuje se zachovat konfiguraci serveru repliky na stejné nebo větší hodnoty než zdroj, aby se zajistilo, že replika bude schopná držet krok s hlavním serverem.

Výpis replik pro zdrojový server

Pokud chcete zobrazit všechny repliky pro daný zdrojový server, spusťte následující příkaz:

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

Příkaz az mariadb server replica list vyžaduje následující parametry:

Nastavení Příklad hodnoty Popis
resource-group  myresourcegroup  Skupina prostředků, do které se vytvoří server repliky. 
název-serveru mydemoserver Název nebo ID zdrojového serveru.

Zastavení replikace na server repliky

Důležité

Zastavení replikace na server je nevratné. Jakmile se replikace zastaví mezi zdrojem a replikou, nedá se vrátit zpět. Server repliky se pak stane samostatným serverem a teď podporuje čtení i zápisy. Z tohoto serveru nejde znovu udělat repliku.

Replikaci na server repliky pro čtení je možné zastavit pomocí následujícího příkazu:

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

Příkaz az mariadb server replica stop vyžaduje následující parametry:

Nastavení Příklad hodnoty Popis
resource-group  myresourcegroup  Skupina prostředků, ve které existuje server repliky. 
name mydemoreplicaserver Název serveru repliky pro zastavení replikace.

Odstranění serveru repliky

Odstranění serveru repliky pro čtení je možné provést spuštěním příkazu az mariadb server delete .

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

Odstranění zdrojového serveru

Důležité

Odstraněním zdrojového serveru se zastaví replikace na všechny servery replik a odstraní se samotný zdrojový server. Ze serverů replik se stanou samostatné servery, které teď podporují čtení i zápis.

Pokud chcete odstranit zdrojový server, můžete spustit příkaz az mariadb server delete .

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

REST API

Repliky pro čtení můžete vytvářet a spravovat pomocí rozhraní Azure REST API.

Vytvoření repliky pro čtení

Repliku pro čtení můžete vytvořit pomocí rozhraní API pro vytvoření:

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

Poznámka:

Další informace o oblastech, ve kterých můžete vytvořit repliku, najdete v článku konceptů replik pro čtení.

Pokud jste parametr nenastavili azure.replication_support na repliku na zdrojovém serveru pro obecné účely nebo optimalizováno pro paměť a restartovali server, zobrazí se chyba. Před vytvořením repliky dokončete tyto dva kroky.

Replika se vytvoří pomocí stejného nastavení výpočetních prostředků a úložiště jako hlavní server. Po vytvoření repliky je možné změnit několik nastavení nezávisle na zdrojovém serveru: generování výpočetních prostředků, virtuální jádra, úložiště a doba uchovávání záloh. Cenovou úroveň lze také změnit nezávisle, s výjimkou úrovně Basic nebo z ní.

Důležité

Před aktualizací nastavení zdrojového serveru na novou hodnotu aktualizujte nastavení repliky na stejnou nebo vyšší hodnotu. Tato akce pomáhá replikě udržovat krok se všemi změnami provedenými v hlavním serveru.

Výpis replik

Seznam replik zdrojového serveru můžete zobrazit pomocí rozhraní API seznamu replik:

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

Zastavení replikace na server repliky

Replikaci mezi zdrojovým serverem a replikou pro čtení můžete zastavit pomocí rozhraní API aktualizace.

Jakmile zastavíte replikaci na zdrojový server a repliku pro čtení, nedá se vrátit zpět. Replika pro čtení se stane samostatným serverem, který podporuje čtení i zápisy. Samostatný server nelze znovu vytvořit do repliky.

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

Odstranění zdrojového serveru nebo serveru repliky

Pokud chcete odstranit zdrojový server nebo server repliky, použijte rozhraní API pro odstranění:

Když odstraníte zdrojový server, zastaví se replikace do všech replik pro čtení. Repliky pro čtení se stanou samostatnými servery, které teď podporují čtení i zápisy.

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

Další kroky