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
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
- Zainstaluj interfejs wiersza polecenia platformy Azure 2.0
- Serwer usługi Azure Database for MariaDB, który będzie używany jako serwer źródłowy.
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_support
REPLICA 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
- Dowiedz się więcej o replikach do odczytu