Tworzenie replik do odczytu i zarządzanie nimi w usłudze Azure Database for PostgreSQL — serwer elastyczny za pomocą witryny Azure Portal, interfejsu wiersza polecenia lub interfejsu API REST

DOTYCZY: Azure Database for PostgreSQL — serwer elastyczny

Z tego artykułu dowiesz się, jak tworzyć repliki do odczytu i zarządzać nimi na serwerze elastycznym usługi Azure Database for PostgreSQL za pomocą witryny Azure Portal, interfejsu wiersza polecenia i interfejsu API REST. Aby dowiedzieć się więcej na temat replik do odczytu, zobacz omówienie.

Wymagania wstępne

Wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL jako serwera podstawowego.

Uwaga

Podczas wdrażania replik do odczytu dla trwałych obciążeń podstawowych intensywnie korzystających z zapisu opóźnienie replikacji może nadal rosnąć i nigdy nie nadrobić zaległości w podstawowej wersji. Może to również zwiększyć użycie magazynu w warstwie podstawowej, ponieważ pliki WAL są usuwane tylko raz odebrane w repliki.

Przeglądanie ustawień podstawowych

Przed skonfigurowaniem repliki do odczytu dla serwera elastycznego usługi Azure Database for PostgreSQL upewnij się, że serwer podstawowy jest skonfigurowany do spełnienia niezbędnych wymagań wstępnych. Określone ustawienia na serwerze podstawowym mogą mieć wpływ na możliwość tworzenia replik.

Automatyczne zwiększanie magazynu: ustawienia automatycznego zwiększania rozmiaru magazynu na serwerze podstawowym i jego repliki odczytu muszą być zgodne z określonymi wytycznymi, aby zapewnić spójność i zapobiec zakłóceniom replikacji. Aby uzyskać szczegółowe reguły i ustawienia, zobacz Autogrow magazynu.

SSD w warstwie Premium w wersji 2: bieżąca wersja nie obsługuje tworzenia replik do odczytu dla serwerów podstawowych przy użyciu magazynu SSD w warstwie Premium w wersji 2. Jeśli obciążenie wymaga replik do odczytu, wybierz inną opcję magazynu dla serwera podstawowego.

Portal

1. W witrynie Azure Portal wybierz wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL dla repliki.

2. W oknie dialogowym Przegląd zanotuj wersję bazy danych PostgreSQL (np15.4. ). Należy również pamiętać, że region, w którym jest wdrożony podstawowy element podstawowy (np. East US).

   

3. Na pasku bocznym serwera w obszarze Ustawienia wybierz pozycję Obliczenia i magazyn.

4. Przejrzyj i zanotuj następujące ustawienia:

   • Warstwa obliczeniowa, procesor, rozmiar (np Standard_D4ads_v5. ).

   • Storage

     • Rozmiar magazynu (np 128GB. )
     • Autogrowth

   • Wysoka dostępność

     • Włączone/wyłączone
     • Ustawienia strefy dostępności

   • Ustawienia kopii zapasowej

     • Okres przechowywania
     • Opcje nadmiarowości

5. W obszarze Ustawienia wybierz pozycję Sieć.

6. Przejrzyj ustawienia sieciowe.

   

Interfejs wiersza polecenia

Uwaga

Polecenia podane w tym przewodniku dotyczą interfejsu wiersza polecenia platformy Azure w wersji 2.56.0 lub nowszej. Upewnij się, że masz zainstalowaną wymaganą wersję lub nowszą, aby pomyślnie wykonać te polecenia. Bieżącą wersję interfejsu wiersza polecenia platformy Azure możesz sprawdzić, uruchamiając polecenie az --version w interfejsie wiersza polecenia. Aby zaktualizować interfejs wiersza polecenia platformy Azure do najnowszej wersji, postępuj zgodnie z instrukcjami podanymi w dokumentacji interfejsu wiersza polecenia platformy Azure.

Aby wyświetlić konfigurację i bieżący stan serwera elastycznego usługi Azure PostgreSQL, użyj az postgres flexible-server show polecenia . To polecenie zawiera szczegółowe informacje o określonym serwerze.

az postgres flexible-server show \
  --resource-group <resource-group> \
  --name <server-name>

Zastąp <resource-group> element i <server-name> konkretną grupą zasobów oraz nazwą serwera, który chcesz wyświetlić.

Przejrzyj i zanotuj następujące ustawienia:

• Warstwa obliczeniowa, procesor, rozmiar (np Standard_D8ads_v5. ).
• Magazyn
  • Typ
  • Rozmiar magazynu (np 128. )
  • autogrow
• Wysoka dostępność
  • Włączone/wyłączone
  • Ustawienia strefy dostępności
• Ustawienia kopii zapasowej
  • Okres przechowywania
  • Opcje nadmiarowości

Przykładowa odpowiedź

{
  "administratorLogin": "myadmin",
  "administratorLoginPassword": null,
  "authConfig": {
    "activeDirectoryAuth": "Disabled",
    "passwordAuth": "Enabled",
    "tenantId": null
  },
  "availabilityZone": "2",
  "backup": {
    "backupRetentionDays": 7,
    "earliestRestoreDate": "2024-01-06T11:43:44.485537+00:00",
    "geoRedundantBackup": "Disabled"
  },
  "createMode": null,
  "dataEncryption": {
    "geoBackupEncryptionKeyStatus": null,
    "geoBackupKeyUri": null,
    "geoBackupUserAssignedIdentityId": null,
    "primaryEncryptionKeyStatus": null,
    "primaryKeyUri": null,
    "primaryUserAssignedIdentityId": null,
    "type": "SystemManaged"
  },
  "fullyQualifiedDomainName": "{serverName}.postgres.database.azure.com",
  "highAvailability": {
    "mode": "Disabled",
    "standbyAvailabilityZone": null,
    "state": "NotEnabled"
  },
  "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
  "identity": null,
  "location": "East US",
  "maintenanceWindow": {
    "customWindow": "Disabled",
    "dayOfWeek": 0,
    "startHour": 0,
    "startMinute": 0
  },
  "minorVersion": "0",
  "name": "{serverName}",
  "network": {
    "delegatedSubnetResourceId": null,
    "privateDnsZoneArmResourceId": null,
    "publicNetworkAccess": "Enabled"
  },
  "pointInTimeUtc": null,
  "privateEndpointConnections": null,
  "replica": {
    "capacity": 5,
    "promoteMode": null,
    "promoteOption": null,
    "replicationState": null,
    "role": "Primary"
  },
  "replicaCapacity": 5,
  "replicationRole": "Primary",
  "resourceGroup": "{resourceGroupName}",
  "sku": {
    "name": "Standard_D8ads_v5",
    "tier": "GeneralPurpose"
  },
  "sourceServerResourceId": null,
  "state": "Ready",
  "storage": {
    "autoGrow": "Disabled",
    "iops": 500,
    "storageSizeGb": 128,
    "throughput": null,
    "tier": "P10",
    "type": ""
  },
  "systemData": {
    "createdAt": "2023-11-08T11:27:48.972812+00:00",
    "createdBy": null,
    "createdByType": null,
    "lastModifiedAt": null,
    "lastModifiedBy": null,
    "lastModifiedByType": null
  },
  "tags": {},
  "type": "Microsoft.DBforPostgreSQL/flexibleServers",
  "version": "16"
}

Interfejs API REST

Aby uzyskać informacje o konfiguracji serwera na serwerze elastycznym usługi Azure Database for PostgreSQL, zwłaszcza w celu wyświetlenia ustawień ostatnio wprowadzonych funkcji, takich jak automatyczne dodawanie magazynu lub łącze prywatne, należy użyć najnowszej wersji 2023-06-01-previewinterfejsu API. Żądanie GET zostanie sformatowane w następujący sposób:

https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}?api-version=2023-06-01-preview

Zastąp {subscriptionId}wartości , {resourceGroupName}i {serverName} identyfikatorem subskrypcji platformy Azure, nazwą grupy zasobów i nazwą serwera podstawowego, który chcesz przejrzeć, odpowiednio. To żądanie zapewnia dostęp do szczegółów konfiguracji serwera podstawowego, zapewniając, że jest prawidłowo skonfigurowany do tworzenia repliki do odczytu.

Przejrzyj i zanotuj następujące ustawienia:

• Warstwa obliczeniowa, procesor, rozmiar (np Standard_D8ads_v5. ).
• Magazyn
  • Typ
  • Rozmiar magazynu (np 128. )
  • autogrow
• Sieć
• Wysoka dostępność
  • Włączone/wyłączone
  • Ustawienia strefy dostępności
• Ustawienia kopii zapasowej
  • Okres przechowywania
  • Opcje nadmiarowości

Przykładowa odpowiedź

{
    "sku": {
        "name": "Standard_D8ads_v5",
        "tier": "GeneralPurpose"
    },
    "systemData": {
        "createdAt": "2023-11-22T16:11:42.2461489Z"
    },
    "properties": {
        "replica": {
            "role": "Primary",
            "capacity": 5
        },
        "storage": {
            "type": "",
            "iops": 500,
            "tier": "P10",
            "storageSizeGB": 128,
            "autoGrow": "Disabled"
        },
        "network": {
            "publicNetworkAccess": "Enabled"
        },
        "dataEncryption": {
            "type": "SystemManaged"
        },
        "authConfig": {
            "activeDirectoryAuth": "Disabled",
            "passwordAuth": "Enabled"
        },
        "fullyQualifiedDomainName": "{serverName}.postgres.database.azure.com",
        "version": "15",
        "minorVersion": "4",
        "administratorLogin": "myadmin",
        "state": "Ready",
        "availabilityZone": "1",
        "backup": {
            "backupRetentionDays": 7,
            "geoRedundantBackup": "Disabled",
            "earliestRestoreDate": "2023-11-23T12:55:33.3443218+00:00"
        },
        "highAvailability": {
            "mode": "Disabled",
            "state": "NotEnabled"
        },
        "maintenanceWindow": {
            "customWindow": "Disabled",
            "dayOfWeek": 0,
            "startHour": 0,
            "startMinute": 0
        },
        "replicationRole": "Primary",
        "replicaCapacity": 5
    },
    "location": "East US",
    "tags": {},
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
    "name": "{serverName}",
    "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}

Tworzenie repliki do odczytu

Aby utworzyć replikę do odczytu, wykonaj następujące kroki:

Portal

1. Wybierz istniejące wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL do użycia jako serwer podstawowy.

2. Na pasku bocznym serwera w obszarze Ustawienia wybierz pozycję Replikacja.

3. Wybierz pozycję Utwórz replikę.

   

4. Wprowadź formularz Podstawy, korzystając z poniższych informacji.

   

5. Wybierz pozycję Przejrzyj i utwórz , aby potwierdzić utworzenie repliki lub Dalej: Sieć , jeśli chcesz dodać, usunąć lub zmodyfikować reguły zapory.

   

6. Pozostaw pozostałe wartości domyślne, a następnie wybierz przycisk Przejrzyj i utwórz w dolnej części strony lub przejdź do następnych formularzy, aby dodać tagi lub zmienić metodę szyfrowania danych.

7. Przejrzyj informacje w ostatnim oknie potwierdzenia. Gdy wszystko będzie gotowe, wybierz pozycję Utwórz. Zostanie utworzone nowe wdrożenie.

   

8. Podczas wdrażania jest wyświetlany stan podstawowy Updating .

   Po utworzeniu repliki do odczytu można ją wyświetlić w oknie Replikacja .

   

Interfejs wiersza polecenia

Replikę do odczytu dla serwera elastycznego Usługi Azure PostgreSQL można utworzyć za pomocą az postgres flexible-server replica create polecenia .

az postgres flexible-server replica create \
  --replica-name <replica-name> \
  --resource-group <resource-group> \
  --source-server <source-server-name> \
  --location <location>

Zastąp <replica-name>wartości , <resource-group>, <source-server-name>i <location> określonymi wartościami.

Po utworzeniu repliki do odczytu właściwości wszystkich serwerów, które są replikami repliki repliki podstawowej, można uzyskać za pomocą az postgres flexible-server replica create polecenia .

az postgres flexible-server replica list \
  --name <source-server-name> \
  --resource-group <resource-group>

Zastąp <source-server-name>wartości , i <resource-group> określonymi wartościami.

Interfejs API REST

Zainicjuj HTTP PUT żądanie przy użyciu interfejsu API tworzenia serwerów:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

W tym miejscu należy zastąpić {subscriptionId}wartości , {resourceGroupName}i {replicaserverName} określonym identyfikatorem subskrypcji platformy Azure, nazwą grupy zasobów i odpowiednią nazwą repliki do odczytu.

{
  "location": "eastus",
  "properties": {
    "createMode": "Replica",
    "SourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}"
  }
}

Po utworzeniu repliki do odczytu właściwości wszystkich serwerów, które są replikami repliki podstawowej repliki, można uzyskać, inicjując HTTP GET żądanie przy użyciu listy replik według interfejsu API serwera:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/replicas?api-version=2022-12-01

W tym miejscu należy zastąpić {subscriptionId}wartości , {resourceGroupName}i {sourceserverName} określonym identyfikatorem subskrypcji platformy Azure, nazwą grupy zasobów i nazwą przypisaną odpowiednio do repliki podstawowej.

[
  {
    "administratorLogin": null,
    "administratorLoginPassword": null,
    "authConfig": null,
    "availabilityZone": null,
    "backup": {
      "backupRetentionDays": null,
      "earliestRestoreDate": "2023-11-23T12:55:33.3443218+00:00",
      "geoRedundantBackup": "Disabled"
    },
    "createMode": null,
    "dataEncryption": {
      "geoBackupEncryptionKeyStatus": null,
      "geoBackupKeyUri": null,
      "geoBackupUserAssignedIdentityId": null,
      "primaryEncryptionKeyStatus": null,
      "primaryKeyUri": null,
      "primaryUserAssignedIdentityId": null,
      "type": "SystemManaged"
    },
    "fullyQualifiedDomainName": null,
    "highAvailability": null,
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{replicaserverName}",
    "identity": null,
    "location": "eastus",
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    },
    "minorVersion": null,
    "name": "{replicaserverName}",
    "network": {
      "delegatedSubnetResourceId": null,
      "privateDnsZoneArmResourceId": null,
      "publicNetworkAccess": "Disabled"
    },
    "pointInTimeUtc": null,
    "privateEndpointConnections": null,
    "replica": {
      "capacity": null,
      "promoteMode": null,
      "promoteOption": null,
      "replicationState": "Active",
      "role": "AsyncReplica"
    },
    "replicaCapacity": null,
    "replicationRole": "AsyncReplica",
    "resourceGroup": "{resourceGroupName}",
    "sku": {
      "name": "",
      "tier": null
    },
    "sourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
    "state": "Ready",
    "storage": {
      "autoGrow": "Disabled",
      "iops": null,
      "storageSizeGb": 0,
      "throughput": null,
      "tier": null,
      "type": null
    },
    "systemData": {
      "createdAt": "2023-11-22T17:11:42.2461489Z",
      "createdBy": null,
      "createdByType": null,
      "lastModifiedAt": null,
      "lastModifiedBy": null,
      "lastModifiedByType": null
    },
    "tags": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers",
    "version": null
  }
]

• Ustaw nazwę serwera repliki.

  Napiwek

  Jest to najlepsze rozwiązanie w przewodniku Cloud Adoption Framework (CAF), które umożliwia łatwe określenie, z jakim wystąpieniem nawiązujesz połączenie lub zarządzasz, i gdzie się znajduje.

• Wybierz lokalizację inną niż podstawowa, ale pamiętaj, że możesz wybrać ten sam region.

  Napiwek

  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.

• Ustaw zasoby obliczeniowe i magazyn na to, co zostało zarejestrowane z poziomu podstawowego. Jeśli wyświetlane zasoby obliczeniowe nie są zgodne, wybierz pozycję Konfiguruj serwer i wybierz odpowiedni.

  Uwaga

  Jeśli wybierzesz rozmiar obliczeniowy mniejszy niż podstawowy, wdrożenie zakończy się niepowodzeniem. Należy również pamiętać, że rozmiar obliczeniowy może nie być dostępny w innym regionie.

  

Ważne

Zapoznaj się z sekcją dotyczącą zagadnień w przeglądzie repliki do odczytu.

Aby uniknąć problemów podczas podwyższania poziomu replik stale zmieniać następujące parametry serwera w replikach, przed zastosowaniem ich na serwerze podstawowym: max_connections, , max_prepared_transactionsmax_locks_per_transaction, max_wal_senders, max_worker_processes.

Tworzenie wirtualnych punktów końcowych

Uwaga

Wszystkie operacje obejmujące wirtualne punkty końcowe — takie jak dodawanie, edytowanie lub usuwanie — są wykonywane w kontekście serwera podstawowego.

Portal

1. W witrynie Azure Portal wybierz serwer podstawowy.

2. Na pasku bocznym serwera w obszarze Ustawienia wybierz pozycję Replikacja.

3. Wybierz pozycję Utwórz punkt końcowy.

4. W oknie dialogowym wpisz zrozumiałą nazwę punktu końcowego. Zwróć uwagę na generowany punkt końcowy DNS.

   

5. Wybierz pozycję Utwórz.

   Uwaga

   Jeśli nie utworzysz wirtualnego punktu końcowego, zostanie wyświetlony błąd podczas próby podwyższenia poziomu repliki.

   

Interfejs wiersza polecenia

Wirtualny punkt końcowy można utworzyć przy użyciu az postgres flexible-server virtual-endpoint create polecenia .

    az postgres flexible-server virtual-endpoint create \
      --resource-group <resource-group> \
      --server-name <primary-name> \
      --name <virtual-endpoint-name> \
      --endpoint-type ReadWrite \
      --members <replica-name>

Zastąp <resource-group>wartości , <primary-name>, <virtual-endpoint-name>i <replica-name> określonymi wartościami.

Interfejs API REST

Aby utworzyć wirtualny punkt końcowy przy użyciu interfejsu API REST platformy Azure, użyj HTTP PUT żądania. Żądanie wygląda następująco:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/virtualendpoints/{virtualendpointName}?api-version=2023-06-01-preview

Dołączona treść JSON dla tego żądania jest następująca:

{ 
  "Properties": { 
    "EndpointType": "ReadWrite", 
    "Members": ["{replicaserverName}"] 
  }
} 

W tym miejscu należy zastąpić nazwę serwera repliki, {replicaserverName} który jest dołączany jako element docelowy punktu końcowego czytelnika w tym wirtualnym punkcie końcowym.

Wyświetlanie listy wirtualnych punktów końcowych

Aby wyświetlić listę wirtualnych punktów końcowych, wykonaj następujące kroki:

Portal

1. W witrynie Azure Portal wybierz serwer podstawowy .

2. Na pasku bocznym serwera w obszarze Ustawienia wybierz pozycję Replikacja.

3. W górnej części strony zostaną wyświetlone punkty końcowe czytnika i modułu zapisywania wraz z nazwami serwerów, do których wskazują.

   

Interfejs wiersza polecenia

Szczegóły wirtualnego punktu końcowego można wyświetlić przy użyciu list polecenia lub show . Biorąc pod uwagę, że tylko jeden wirtualny punkt końcowy jest dozwolony dla pary repliki podstawowej, oba polecenia dają ten sam wynik.

Oto przykład użycia list polecenia :

az postgres flexible-server virtual-endpoint list \
      --resource-group <resource-group> \
      --server-name <server-name>

Zastąp <server-name> ciąg nazwą serwera podstawowego i <resource-group> nazwą grupy zasobów.

Oto jak można użyć show polecenia :

az postgres flexible-server virtual-endpoint show \
      --name <virtual-endpoint-name>
      --resource-group <resource-group> \
      --server-name <server-name>

W tym poleceniu zastąp ciąg <virtual-endpoint-name>,<server-name> i <resource-group> odpowiednimi nazwami. <server-name> to nazwa serwera podstawowego.

Interfejs API REST

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/virtualendpoints?api-version=2023-06-01-preview

W tym miejscu powinna być nazwą serwera podstawowego, {sourceserverName} z którego zarządzasz wirtualnymi punktami końcowymi.

Modyfikowanie aplikacji w celu wskazania wirtualnego punktu końcowego

Zmodyfikuj wszystkie aplikacje korzystające z elastycznego wystąpienia serwera usługi Azure Database for PostgreSQL, aby używać nowych wirtualnych punktów końcowych (np. corp-pg-001.writer.postgres.database.azure.com i corp-pg-001.reader.postgres.database.azure.com).

Podwyższanie poziomu replik

W przypadku wszystkich niezbędnych składników możesz przystąpić do wykonywania repliki podwyższania poziomu do operacji podstawowej.

Portal

Aby podwyższyć poziom repliki z witryny Azure Portal, wykonaj następujące kroki:

1. W witrynie Azure Portal wybierz podstawowe wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. W menu serwera w obszarze Ustawienia wybierz pozycję Replikacja.

3. W obszarze Serwery wybierz ikonę Podwyższanie poziomu dla repliki.

   

4. W oknie dialogowym upewnij się, że akcja to Podwyższanie poziomu do serwera podstawowego.

5. W obszarze Synchronizacja danych upewnij się, że opcja Planowana — synchronizuj dane przed wybraniem podwyższania wartości.

   

6. Wybierz pozycję Podwyższ poziom , aby rozpocząć proces. Po zakończeniu role odwracają się: replika staje się podstawowa, a podstawowa przyjmuje rolę repliki.

Interfejs wiersza polecenia

Podczas podwyższania poziomu repliki do serwera podstawowego na serwerze elastycznym Usługi Azure PostgreSQL użyj az postgres flexible-server replica promote polecenia . Ten proces jest niezbędny do uniesienia serwera repliki do działania jako serwera podstawowego i degradacji bieżącej roli podstawowej do repliki. Określ --promote-mode switchover polecenie i --promote-option planned w poleceniu .

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name> \
  --promote-mode switchover \
  --promote-option planned

Zastąp <resource-group> wartości i <replica-server-name> nazwą określonej grupy zasobów i serwera repliki. To polecenie zapewnia płynne przejście repliki do roli podstawowej w zaplanowany sposób.

Interfejs API REST

Podczas podwyższania poziomu repliki do serwera podstawowego użyj HTTP PATCH żądania z określoną JSON treścią, aby ustawić opcje podwyższania poziomu. Ten proces ma kluczowe znaczenie, gdy trzeba podnieść poziom serwera repliki do działania jako serwer podstawowy.

Żądanie jest ustrukturyzowane HTTP w następujący sposób:

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "switchover",
      "PromoteOption": "planned"
    }
  }
}

W tym JSONsystemie podwyższanie poziomu ma być wykonywane w switchover trybie z opcją podwyższenia poziomu planned . Chociaż istnieją dwie opcje podwyższania poziomu — planned lub forced — wybrane planned dla tego ćwiczenia.

Uwaga

Promująca się replika musi mieć przypisany wirtualny punkt końcowy czytnika lub zostanie wyświetlony błąd podczas podwyższania poziomu.

Testowanie aplikacji

Aby wykonać niektóre operacje, uruchom ponownie aplikacje, a następnie spróbuj wykonać te operacje. Aplikacje powinny działać bezproblemowo bez modyfikowania wirtualnego punktu końcowego parametry połączenia lub wpisów DNS. Pozostaw aplikacje uruchomione tym razem.

Powrót po awarii do oryginalnego serwera i regionu

Powtórz te same operacje, aby podwyższyć poziom oryginalnego serwera do serwera podstawowego.

Portal

1. W witrynie Azure Portal wybierz replikę.

2. Na pasku bocznym serwera w obszarze Ustawienia wybierz pozycję Replikacja

3. W obszarze Serwery wybierz ikonę Podwyższanie poziomu dla repliki.

4. W oknie dialogowym upewnij się, że akcja to Podwyższanie poziomu do serwera podstawowego.

5. W obszarze Synchronizacja danych upewnij się, że opcja Planowana — synchronizuj dane przed wybraniem podwyższania wartości.

6. Wybierz pozycję Podwyższ poziom, rozpocznie się proces. Po zakończeniu role odwracają się: replika staje się podstawowa, a podstawowa przyjmuje rolę repliki.

Interfejs wiersza polecenia

Tym razem zmień wartość <replica-server-name> w az postgres flexible-server replica promote poleceniu, aby odwoływać się do starego serwera podstawowego, który obecnie działa jako replika, i ponownie wykonać żądanie.

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name> \
  --promote-mode switchover \
  --promote-option planned

Zastąp <resource-group> wartości i <replica-server-name> konkretną grupą zasobów i bieżącą nazwą serwera repliki.

Interfejs API REST

Tym razem zmień wartość {replicaserverName} w żądaniu interfejsu API, aby odwoływać się do starego serwera podstawowego, który obecnie działa jako replika, i ponownie wykonać żądanie.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "switchover",
      "PromoteOption": "planned"
    }
  }
}

W tym JSONsystemie podwyższanie poziomu ma być wykonywane w switchover trybie z opcją podwyższenia poziomu planned . Chociaż istnieją dwie opcje podwyższania poziomu — planned lub forced — wybrane planned dla tego ćwiczenia.

Testowanie aplikacji

Ponownie przełącz się na jedną z aplikacji zużywających. Poczekaj, aż stan podstawowej i repliki zmieni się na Updating , a następnie spróbuj wykonać pewne operacje. Podczas podwyższania poziomu repliki aplikacja może napotkać tymczasowe problemy z łącznością z punktem końcowym:

Dodawanie pomocniczej repliki do odczytu

Utwórz pomocniczą replikę do odczytu w osobnym regionie, aby zmodyfikować wirtualny punkt końcowy czytnika i umożliwić utworzenie niezależnego serwera z pierwszej repliki.

Portal

1. W witrynie Azure Portal wybierz podstawowe wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. Na pasku bocznym serwera w obszarze Ustawienia wybierz pozycję Replikacja.

3. Wybierz pozycję Utwórz replikę.

4. Wprowadź formularz Podstawy z informacjami w trzecim regionie (np westus . i corp-pg-westus-001)

5. Wybierz pozycję Przejrzyj i utwórz , aby potwierdzić utworzenie repliki lub Dalej: Sieć , jeśli chcesz dodać, usunąć lub zmodyfikować reguły zapory.

6. Sprawdź ustawienia zapory. Zwróć uwagę, że ustawienia podstawowe są kopiowane automatycznie.

7. Pozostaw pozostałe wartości domyślne, a następnie wybierz przycisk Przejrzyj i utwórz w dolnej części strony lub przejdź do następujących formularzy, aby skonfigurować zabezpieczenia lub dodać tagi.

8. Przejrzyj informacje w ostatnim oknie potwierdzenia. Gdy wszystko będzie gotowe, wybierz pozycję Utwórz. Zostanie utworzone nowe wdrożenie.

9. Podczas wdrażania jest wyświetlany stan podstawowy Updating .

   

Interfejs wiersza polecenia

Możesz utworzyć pomocniczą replikę do odczytu przy użyciu az postgres flexible-server replica create polecenia .

az postgres flexible-server replica create \
  --replica-name <replica-name> \
  --resource-group <resource-group> \
  --source-server <source-server-name> \
  --location <location>

Wybierz odrębną nazwę, <replica-name> aby odróżnić ją od serwera podstawowego i innych replik. Zastęp <resource-group>, <source-server-name>, i <location> swoimi konkretnymi wartościami.

Interfejs API REST

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

Wybierz odrębną nazwę, {replicaserverName} aby odróżnić ją od serwera podstawowego i innych replik.

{
  "location": "westus3",
  "properties": {
    "createMode": "Replica",
    "SourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}"
  }
}

Lokalizacja jest ustawiona na westus3, ale można dostosować to ustawienie na podstawie potrzeb geograficznych i operacyjnych.

Modyfikowanie wirtualnego punktu końcowego

Portal

1. W witrynie Azure Portal wybierz podstawowe wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. Na pasku bocznym serwera w obszarze Ustawienia wybierz pozycję Replikacja.

3. Wybierz wielokropek, a następnie wybierz pozycję Edytuj.

   

4. W oknie dialogowym wybierz nową replikę pomocniczą.

   

5. Wybierz pozycję Zapisz. Punkt końcowy czytnika jest teraz wskazywany na replikę pomocniczą, a operacja podwyższania poziomu jest teraz powiązana z tą repliką.

Interfejs wiersza polecenia

Teraz możesz zmodyfikować punkt końcowy czytnika, aby wskazywał nowo utworzoną replikę pomocniczą az postgres flexible-server virtual-endpoint update przy użyciu polecenia . Pamiętaj, aby zastąpić <replica-name> ciąg nazwą nowo utworzonej repliki do odczytu.

az postgres flexible-server virtual-endpoint update \
  --resource-group <resource-group> \
  --server-name <server-name> \
  --name <virtual-endpoint-name> \
  --endpoint-type ReadWrite \
  --members <replica-name>

Zastąp <resource-group>wartości , <server-name>, <virtual-endpoint-name>i <replica-name> określonymi wartościami.

Interfejs API REST

Teraz możesz zmodyfikować punkt końcowy czytelnika, aby wskazywał nowo utworzoną replikę pomocniczą PATCH przy użyciu żądania. Pamiętaj, aby zastąpić {replicaserverName} ciąg nazwą nowo utworzonej repliki do odczytu.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/virtualendpoints/{virtualendpointName}?api-version=2023-06-01-preview

{ 
  "Properties": { 
    "EndpointType": "ReadWrite", 
    "Members": ["{replicaserverName}"] 
  }
} 

Podwyższanie poziomu repliki do niezależnego serwera

Zamiast przełączać się do repliki, można również przerwać replikację repliki, tak aby stała się serwerem autonomicznym.

Portal

1. W witrynie Azure Portal wybierz serwer podstawowy serwera elastycznego usługi Azure Database for PostgreSQL.

2. Na pasku bocznym serwera w menu serwera w obszarze Ustawienia wybierz pozycję Replikacja.

3. W obszarze Serwery wybierz ikonę Podwyższanie poziomu dla repliki, którą chcesz podwyższyć poziom do niezależnego serwera.

   

4. W oknie dialogowym upewnij się, że akcja jest podwyższana do niezależnego serwera i usuń z replikacji. Nie będzie to miało wpływu na serwer podstawowy.

5. W obszarze Synchronizacja danych upewnij się, że opcja Planowana — synchronizuj dane przed wybraniem podwyższania wartości.

   

6. Wybierz pozycję Podwyższ poziom, rozpocznie się proces. Po zakończeniu serwer nie jest już repliką podstawowej.

Interfejs wiersza polecenia

W przypadku podwyższenia poziomu repliki na serwerze elastycznym Usługi Azure PostgreSQL domyślne zachowanie polega na podwyższeniu poziomu repliki do niezależnego serwera. Podwyższenie poziomu jest osiągane przy użyciu az postgres flexible-server replica promote polecenia bez określania --promote-mode opcji, ponieważ standalone tryb jest przyjmowany domyślnie.

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name>

W tym poleceniu zastąp <resource-group> wartości i <replica-server-name> nazwą określonej grupy zasobów oraz nazwą utworzonego pierwszego serwera repliki, który nie jest już częścią wirtualnego punktu końcowego.

Interfejs API REST

Replikę można podwyższyć do autonomicznego serwera przy użyciu PATCH żądania. PATCH Wyślij żądanie do określonego adresu URL interfejsu API REST usługi Azure Management z pierwszą JSON treścią, gdzie PromoteMode jest ustawiona wartość standalone i PromoteOption na planned. Drugi JSON format treści, ustawienie ReplicationRole na None, jest przestarzałe, ale nadal wymienione tutaj w celu zapewnienia zgodności z poprzednimi wersjami.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "standalone",
      "PromoteOption": "planned"
    }
  }
}

{
  "Properties": {
    "ReplicationRole": "None"
  }
}

Uwaga

Po podwyższeniu poziomu repliki do niezależnego serwera nie można go dodać z powrotem do zestawu replikacji.

Usuwanie wirtualnego punktu końcowego

Portal

1. W witrynie Azure Portal wybierz serwer podstawowy .

2. Na pasku bocznym serwera w obszarze Ustawienia wybierz pozycję Replikacja.

3. W górnej części strony znajdź sekcję Virtual endpoints . Przejdź do trzech kropek (opcji menu) obok nazwy punktu końcowego, rozwiń go i wybierz pozycję Delete.

4. Zostanie wyświetlone okno dialogowe potwierdzenia usuwania. Ostrzega: "Ta akcja powoduje usunięcie wirtualnego punktu końcowego virtualendpointName. Wszyscy klienci połączeni przy użyciu tych domen mogą utracić dostęp". Potwierdź implikacje i potwierdź, klikając pozycję Usuń.

Interfejs wiersza polecenia

Aby usunąć wirtualny punkt końcowy z serwera elastycznego usługi Azure PostgreSQL, możesz użyć az postgres flexible-server virtual-endpoint delete polecenia . Ta akcja powoduje trwałe usunięcie określonego wirtualnego punktu końcowego.

az postgres flexible-server virtual-endpoint delete \
  --resource-group <resource-group> \
  --server-name <server-name> \
  --name <virtual-endpoint-name>

W tym poleceniu zastąp wartości <resource-group>, <server-name>i <virtual-endpoint-name> konkretną grupą zasobów, nazwą serwera i nazwą wirtualnego punktu końcowego, który chcesz usunąć.

Interfejs API REST

Aby usunąć wirtualny punkt końcowy przy użyciu interfejsu API REST platformy Azure, należy wysłać HTTP DELETE żądanie. Adres URL żądania będzie ustrukturyzowany w następujący sposób:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{serverName}/virtualendpoints/{virtualendpointName}?api-version=2023-06-01-preview

Usuwanie repliki

Portal

Replikę do odczytu podobną do sposobu usuwania autonomicznego wystąpienia serwera elastycznego usługi Azure Database for PostgreSQL można usunąć.

1. W witrynie Azure Portal otwórz stronę Przegląd repliki do odczytu. Wybierz Usuń.

   

Replikę do odczytu można również usunąć z okna Replikacja , wykonując następujące kroki:

2. W witrynie Azure Portal wybierz podstawowe wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

3. W menu serwera w obszarze Ustawienia wybierz pozycję Replikacja.

4. Wybierz replikę do odczytu do usunięcia, a następnie wybierz wielokropek. Wybierz Usuń.

   

5. Potwierdzanie operacji usuwania .

Interfejs wiersza polecenia

Aby usunąć serwer podstawowy lub repliki, użyj az postgres flexible-server delete polecenia . Jeśli serwer ma repliki do odczytu, należy najpierw usunąć repliki do odczytu przed usunięciem serwera podstawowego.

az postgres flexible-server delete \
  --resource-group <resource-group> \
  --name <server-name>

Zastąp <resource-group> wartości i <server-name> nazwą grupy zasobów oraz nazwą serwera repliki, którą chcesz usunąć.

Interfejs API REST

Aby usunąć serwer podstawowy lub replikę, użyj interfejsu API usuwania serwerów. Jeśli serwer ma repliki do odczytu, przed usunięciem serwera podstawowego należy najpierw usunąć repliki do odczytu.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

Usuwanie serwera podstawowego

Serwer podstawowy można usunąć tylko po usunięciu wszystkich replik do odczytu. Aby usunąć repliki, postępuj zgodnie z instrukcjami w sekcji Usuwanie repliki , a następnie wykonaj podane kroki.

Portal

Aby usunąć serwer z witryny Azure Portal, wykonaj następujące kroki:

1. W witrynie Azure Portal wybierz podstawowe wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. Otwórz stronę Przegląd serwera i wybierz pozycję Usuń.

   

3. Wprowadź nazwę serwera podstawowego do usunięcia. Wybierz pozycję Usuń , aby potwierdzić usunięcie serwera podstawowego.

   

Interfejs wiersza polecenia

Aby usunąć serwer podstawowy lub repliki, użyj az postgres flexible-server delete polecenia . Jeśli serwer ma repliki do odczytu, przed usunięciem serwera podstawowego należy najpierw usunąć repliki do odczytu.

az postgres flexible-server delete \
  --resource-group <resource-group> \
  --name <server-name>

Zastąp <resource-group> ciąg i <server-name> nazwą grupy zasobów oraz nazwą serwera podstawowego, który chcesz usunąć.

Interfejs API REST

Aby usunąć serwer podstawowy lub replikę, użyj interfejsu API usuwania serwerów. Jeśli serwer ma repliki do odczytu, przed usunięciem serwera podstawowego należy najpierw usunąć repliki do odczytu.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}?api-version=2022-12-01

Monitorowanie repliki

Dostępne są dwie metryki do monitorowania replik do odczytu.

Maksymalne opóźnienie replikacji fizycznej

Dostępne tylko dla podstawowego.

Metryka Maksymalne opóźnienie replikacji fizycznej pokazuje opóźnienie bajtów między serwerem podstawowym a najbardziej opóźniającą repliką.

1. W witrynie Azure Portal wybierz serwer podstawowy.

2. Wybierz pozycję Metryki. W oknie Metryki wybierz pozycję Maksymalne opóźnienie replikacji fizycznej.

   

3. W obszarze Agregacja wybierz pozycję Maks.

Metryka Opóźnienie repliki do odczytu

Metryka Opóźnienie repliki do odczytu pokazuje czas od czasu ostatniego odtworzenia transakcji w replice. Jeśli nie wystąpią żadne transakcje na serwerze podstawowym, metryka odzwierciedla to opóźnienie czasu. Jeśli na przykład na serwerze podstawowym nie wystąpią żadne transakcje, a ostatnia transakcja została odtworzona 5 sekund temu, opóźnienie repliki do odczytu pokazuje 5-sekundowe opóźnienie.

1. W witrynie Azure Portal wybierz pozycję replika do odczytu.

2. Wybierz pozycję Metryki. W oknie Metryki wybierz pozycję Opóźnienie repliki do odczytu.

   

3. W obszarze Agregacja wybierz pozycję Maks.

Podziel się swoimi sugestiami i usterkami z zespołem produktu usługi Azure Database for PostgreSQL.

Powiązana zawartość

• Repliki do odczytu w usłudze Azure Database for PostgreSQL — serwer elastyczny.
• Replikacja geograficzna w usłudze Azure Database for PostgreSQL — serwer elastyczny.
• Podwyższanie poziomu replik do odczytu w usłudze Azure Database for PostgreSQL — serwer elastyczny.
• Wirtualne punkty końcowe dla replik do odczytu w usłudze Azure Database for PostgreSQL — serwer elastyczny.
• Tworzenie replik do odczytu i zarządzanie nimi w usłudze Azure Database for PostgreSQL — serwer elastyczny.
• Replikacja między regionami platformy Azure i sieciami wirtualnymi przy użyciu sieci prywatnej.
• Dokumentacja dostawcy platformy Azure programu Terraform.