Jak tworzyć repliki do odczytu i zarządzać nimi w usłudze Azure Database for MariaDB przy użyciu interfejsu wiersza polecenia platformy Azure i interfejsu API REST

  • Artykuł

Ważne

Usługa Azure Database for MariaDB znajduje się na ścieżce wycofania. Zdecydowanie zalecamy przeprowadzenie migracji do usługi Azure Database for MySQL. Aby uzyskać więcej informacji na temat migracji do usługi Azure Database for MySQL, zobacz Co się dzieje z usługą Azure Database for MariaDB?.

W tym artykule dowiesz się, jak tworzyć repliki do odczytu i zarządzać nimi w usłudze Azure Database for MariaDB przy użyciu interfejsu wiersza polecenia platformy Azure i interfejsu API REST.

Interfejs wiersza polecenia platformy Azure

Repliki do odczytu można tworzyć i zarządzać nimi przy użyciu interfejsu wiersza polecenia platformy Azure.

Wymagania wstępne

Ważne

Funkcja repliki do odczytu jest dostępna tylko dla serwerów usługi Azure Database for MariaDB w warstwach cenowych Ogólnego przeznaczenia lub Zoptymalizowane pod kątem pamięci. Upewnij się, że serwer źródłowy znajduje się w jednej z tych warstw cenowych.

Tworzenie repliki do odczytu

Ważne

Podczas tworzenia repliki dla źródła, które nie ma istniejących replik, źródło najpierw uruchomi się ponownie, aby przygotować się do replikacji. Weź to pod uwagę i wykonaj te operacje w okresie poza szczytem.

Serwer repliki do odczytu można utworzyć przy użyciu następującego polecenia:

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

Polecenie az mariadb server replica create wymaga następujących parametrów:

Ustawienie Przykładowa wartość Opis
resource-group  myresourcegroup  Grupa zasobów, w której zostanie utworzony serwer repliki. 
name mydemoreplicaserver Nazwa nowego serwera repliki, który jest tworzony.
source-server mydemoserver Nazwa lub identyfikator istniejącego serwera źródłowego do replikacji.

Aby utworzyć replikę do odczytu między regionami, użyj parametru --location .

Poniższy przykład interfejsu wiersza polecenia tworzy replikę w regionie Zachodnie stany USA.

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

Uwaga

Aby dowiedzieć się więcej na temat regionów, w których można utworzyć replikę, zapoznaj się z artykułem pojęcia dotyczące repliki do odczytu.

Uwaga

Repliki do odczytu są tworzone przy użyciu tej samej konfiguracji serwera co główny. Konfigurację serwera repliki można zmienić po jej utworzeniu. Zaleca się, aby konfiguracja serwera repliki była przechowywana w równych lub większych wartościach niż źródło, aby upewnić się, że replika jest w stanie nadążyć za wzorcem.

Wyświetlanie listy replik dla serwera źródłowego

Aby wyświetlić wszystkie repliki dla danego serwera źródłowego, uruchom następujące polecenie:

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

Polecenie az mariadb server replica list wymaga następujących parametrów:

Ustawienie Przykładowa wartość Opis
resource-group  myresourcegroup  Grupa zasobów, w której zostanie utworzony serwer repliki. 
nazwa-serwera mydemoserver Nazwa lub identyfikator serwera źródłowego.

Zatrzymywanie replikacji na serwerze repliki

Ważne

Zatrzymywanie replikacji na serwerze jest nieodwracalne. Po zatrzymaniu replikacji między źródłem i repliką nie można jej cofnąć. Następnie serwer repliki staje się serwerem autonomicznym, a teraz obsługuje zarówno odczyt, jak i zapis. Tego serwera nie można ponownie replikować.

Replikacja do serwera repliki do odczytu można zatrzymać przy użyciu następującego polecenia:

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

Polecenie az mariadb server replica stop wymaga następujących parametrów:

Ustawienie Przykładowa wartość Opis
resource-group  myresourcegroup  Grupa zasobów, w której istnieje serwer repliki. 
name mydemoreplicaserver Nazwa serwera repliki do zatrzymania replikacji.

Usuwanie serwera repliki

Usunięcie serwera repliki do odczytu można wykonać, uruchamiając polecenie az mariadb server delete .

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

Usuwanie serwera źródłowego

Ważne

Usunięcie serwera źródłowego powoduje zatrzymanie replikacji do wszystkich serwerów repliki i usunięcie samego serwera źródłowego. Serwery repliki stają się serwerami autonomicznymi, które teraz obsługują zarówno odczyt, jak i zapis.

Aby usunąć serwer źródłowy, możesz uruchomić polecenie az mariadb server delete .

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

Interfejs API REST

Repliki do odczytu można tworzyć i zarządzać nimi przy użyciu interfejsu API REST platformy Azure.

Tworzenie repliki do odczytu

Replikę do odczytu można utworzyć przy użyciu interfejsu API tworzenia:

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

Uwaga

Aby dowiedzieć się więcej na temat regionów, w których można utworzyć replikę, zapoznaj się z artykułem pojęcia dotyczące repliki do odczytu.

Jeśli nie ustawiono parametru azure.replication_supportREPLICA na serwerze źródłowym Ogólnego przeznaczenia lub Zoptymalizowane pod kątem pamięci i ponownym uruchomieniu serwera, zostanie wyświetlony błąd. Przed utworzeniem repliki wykonaj te dwa kroki.

Replika jest tworzona przy użyciu tych samych ustawień obliczeniowych i magazynu co wzorzec. Po utworzeniu repliki można zmienić kilka ustawień niezależnie od serwera źródłowego: generowanie zasobów obliczeniowych, rdzenie wirtualne, magazyn i okres przechowywania kopii zapasowych. Warstwę cenową można również zmienić niezależnie, z wyjątkiem warstwy Podstawowa lub z warstwy Podstawowa.

Ważne

Zanim ustawienie serwera źródłowego zostanie zaktualizowane do nowej wartości, zaktualizuj ustawienie repliki na wartość równą lub większą. Ta akcja pomaga repliki nadążyć za wszelkimi zmianami wprowadzonych do wzorca.

Lista replik

Listę replik serwera źródłowego można wyświetlić przy użyciu interfejsu API listy replik:

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

Zatrzymywanie replikacji na serwerze repliki

Replikację między serwerem źródłowym i repliką do odczytu można zatrzymać przy użyciu interfejsu API aktualizacji.

Po zatrzymaniu replikacji na serwerze źródłowym i repliki do odczytu nie można jej cofnąć. Replika do odczytu staje się autonomicznym serwerem obsługującym odczyty i zapisy. Nie można ponownie utworzyć autonomicznego serwera w repliki.

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

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

Usuwanie serwera źródłowego lub repliki

Aby usunąć serwer źródłowy lub serwer repliki, należy użyć interfejsu API usuwania:

Po usunięciu serwera źródłowego replikacja do wszystkich replik do odczytu zostanie zatrzymana. Repliki do odczytu stają się serwerami autonomicznymi, które obsługują teraz zarówno operacje odczytu, jak i zapisu.

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

Następne kroki