Udostępnij za pomocą

Jak skonfigurować Azure CLI do usługi migracji w elastycznym serwerze bazy danych Azure dla PostgreSQL

Interfejs wiersza polecenia platformy Azure to zestaw poleceń używanych w usługach platformy Azure do tworzenia zasobów i zarządzania nimi. Zapewnia ona te same możliwości co witryna Azure Portal, ale jest zoptymalizowana pod kątem użytkowników, którzy wolą pracować w środowisku wiersza polecenia. Aby rozpocząć migrację przy użyciu interfejsu wiersza polecenia platformy Azure, musisz zainstalować interfejs wiersza polecenia platformy Azure na komputerze lokalnym.

Wymagania wstępne

  • Zainstaluj interfejs wiersza polecenia platformy Azure: w zależności od systemu operacyjnego pobierz i zainstaluj interfejs wiersza polecenia platformy Azure. Jest ona dostępna dla systemów Windows, macOS i Linux.

  • Przewodnik instalacji interfejsu wiersza polecenia platformy Azure: postępuj zgodnie z instrukcjami podanymi w oficjalnej dokumentacji platformy Azure, aby zainstalować interfejs wiersza polecenia platformy Azure — jak zainstalować interfejs wiersza polecenia platformy Azure.

  • Sprawdź wersję interfejsu wiersza polecenia platformy Azure: upewnij się, że wersja interfejsu wiersza polecenia platformy Azure jest co najmniej 2.56.0 lub nowsza, ponieważ jest to wymagane dla usługi migracji. Użyj polecenia az --version , aby sprawdzić bieżącą wersję.

  • Zaloguj się do platformy Azure: po zakończeniu instalacji wykonaj polecenie az login w celu uwierzytelnienia. Spowoduje to otwarcie domyślnej przeglądarki w celu ukończenia procesu logowania przy użyciu poświadczeń platformy Azure.

Te kroki przygotowują środowisko do efektywnego zarządzania usługą migracji w usłudze Azure Database for PostgreSQL przy użyciu interfejsu wiersza polecenia platformy Azure. Zawsze zapoznaj się z najnowszą dokumentacją platformy Azure, aby zapoznać się z wszelkimi aktualizacjami lub zmianami w procesie instalacji.

Konfigurowanie poleceń interfejsu wiersza polecenia dla usługi migracji

Wszystkie polecenia interfejsu wiersza polecenia zaczynają się od az postgres flexible-server migration. Dostępne są również instrukcje pomocy ułatwiające zrozumienie różnych opcji i oprawianie poprawnej składni poleceń interfejsu wiersza polecenia.

Kroki konfigurowania poleceń CLI

  1. Instalowanie interfejsu wiersza polecenia platformy Azure: postępuj zgodnie z instrukcjami podanymi w oficjalnej dokumentacji platformy Azure, aby zainstalować interfejs wiersza polecenia platformy Azure — jak zainstalować interfejs wiersza polecenia platformy Azure.

  2. Sprawdź wersję interfejsu wiersza polecenia platformy Azure: upewnij się, że wersja interfejsu wiersza polecenia platformy Azure jest co najmniej 2.56.0 lub nowsza. Użyj polecenia az --version , aby sprawdzić bieżącą wersję.

  3. Zaloguj się do platformy Azure: po zakończeniu instalacji wykonaj polecenie az login w celu uwierzytelnienia. Spowoduje to otwarcie domyślnej przeglądarki w celu ukończenia procesu logowania przy użyciu poświadczeń platformy Azure.

Po zainstalowaniu CLI, otwórz wiersz polecenia i zaloguj się do konta Azure przy użyciu następującego polecenia.

az login

Migrowanie poleceń

Usługa migracji udostępnia następujące polecenia, które ułatwiają migrowanie wystąpień postgreSQL do serwera elastycznego usługi Azure Database for PostgreSQL.

Polecenie Pomoc

Polecenie --help w interfejsie wiersza polecenia platformy Azure to cenna opcja, która zawiera szczegółową dokumentację poleceń i ich poleceń podrzędnych, w tym wymagane czasowniki dla operacji. Polecenie –-helpwyświetla niezbędne polecenia i skojarzone z nimi akcje dla usługi migracji w usłudze Azure Database for PostgreSQL.

az postgres flexible-server migration –-help

Dane wyjściowe umożliwiają wykonanie niezbędnych kroków i parametrów wymaganych do efektywnego zarządzania migracjami bazy danych przy użyciu interfejsu wiersza polecenia platformy Azure.

Utwórz polecenie

Polecenie az postgres flexible-server migration create w interfejsie wiersza polecenia platformy Azure służy do inicjowania nowego przepływu pracy migracji. Ułatwia migrację baz danych ze źródłowego wystąpienia bazy danych PostgreSQL do docelowego wystąpienia serwera elastycznego usługi Azure Database for PostgreSQL. To polecenie konfiguruje niezbędne parametry i konfiguracje, aby zapewnić sprawny i wydajny proces migracji.

Aby uzyskać więcej informacji, zobacz az postgres flexible-server migration create

Polecenie Listy

To az postgres flexible-server migration list polecenie służy do wyświetlania listy wszystkich prób migracji do docelowego obiektu docelowego usługi Azure Database for PostgreSQL. To polecenie zawiera omówienie migracji, które zostały zainicjowane, co umożliwia śledzenie stanu i szczegółów każdej próby migracji.

Aby uzyskać więcej informacji, zobacz az postgres flexible-server migration list

Pokaż polecenie

Polecenie az postgres flexible-server migration show ułatwia monitorowanie bieżących migracji i zapewnia bieżący stan i podstan migracji. Te szczegóły obejmują informacje dotyczące bieżącego stanu i podstanu migracji.

Aby uzyskać więcej informacji, zobacz az postgres flexible-server migration show

Niektóre możliwe stany migracji:

Stany migracji

Stan opis
Ruch przychodzący Trwa konfigurowanie infrastruktury migracji lub trwa rzeczywista migracja danych.
Anulowane Migracja zostanie anulowana lub usunięta.
Nie działa Migracja nie powiodła się.
Walidacja nie powiodła się Walidacja nie powiodła się.
Powodzenie Migracja zakończyła się pomyślnie i została ukończona.
OczekiwanieForUserAction Dotyczy tylko migracji online. Oczekiwanie na wykonanie akcji jednorazowej przez użytkownika.

Podstany migracji

Podstan opis
PerformingPreRequisiteSteps Trwa konfigurowanie infrastruktury na potrzeby migracji danych.
Walidacja w toku Walidacja jest w toku.
Migrowanie danych Migracja danych jest w toku.
UkończenieMigration Migracja jest na ostatnim etapie ukończenia.
Zakończono Migracja została ukończona.
Nie działa Migracja nie powiodła się.

Podstany walidacji

Podstan opis
Nie działa Sprawdzanie poprawności nie powiodło się.
Powodzenie Walidacja zakończyła się pomyślnie.
Ostrzeżenie Walidacja jest ostrzegawcza.

Aktualizuj polecenie

Polecenie az postgres flexible-server migration update służy do zarządzania procesem migracji do serwera elastycznego usługi Azure Database for PostgreSQL. W szczególności można go użyć do:

  • Przeprowadź migrację jednorazową: spowoduje to sfinalizowanie procesu migracji przez przełączenie ruchu bazy danych z serwera źródłowego na docelowy serwer elastyczny.

    • Po zakończeniu migracji danych podstawowych zadanie migracji zostanie przeniesione do podstanu WaitingForCutoverTrigger . W tym stanie użytkownicy mogą wyzwolić migrację jednorazową z portalu, wybierając nazwę migracji w siatce migracji lub za pośrednictwem interfejsu wiersza polecenia.
    • Przed zainicjowaniem migracji jednorazowej należy upewnić się, że:
      • Operacje zapisu w źródle są zatrzymywane
      • latency wartość zmniejsza się do 0 lub zbliżonej do 0
      • latency wartość wskazuje, kiedy element docelowy został ostatnio zsynchronizowany ze źródłem. W tym momencie operacje zapisu w źródle można zatrzymać i zainicjować migrację jednorazową. W przypadku dużego ruchu w źródle należy najpierw zatrzymać zapisy, aby Latency mogło się zbliżyć do 0, a następnie rozpocząć przełączenie.
      • Operacja cutover stosuje wszystkie oczekujące zmiany ze źródła do elementu docelowego i kończy migrację. Jeśli wyzwalasz "Cutover", nawet w przypadku braku zera Latency, replikacja zostanie zatrzymana do tego momentu w czasie. Wszystkie dane w źródle do momentu zastosowania punktu jednorazowego w obiekcie docelowym. Załóżmy, że opóźnienie było 15 minut w punkcie migracji jednorazowej, więc wszystkie zmienione dane w ciągu ostatnich 15 minut mają zastosowanie do celu.

  • Anuluj migrację: w razie potrzeby ta opcja umożliwia zatrzymanie procesu migracji.

  • Konfigurowanie replikacji logicznej w źródle: jest to przydatne, gdy serwer źródłowy jest usługą Azure Database for PostgreSQL — pojedynczy serwer, ponieważ przygotowuje serwer do replikacji danych na serwer elastyczny.

Aby uzyskać więcej informacji, zobacz az postgres flexible-server migration update

Podsumowanie

Poniższa tabela zawiera podsumowanie parametrów używanych przez polecenia migracji:

Parametr Odpowiednie polecenia opis
subscription tworzenie, wyświetlanie, wyświetlanie, aktualizowanie Identyfikator subskrypcji serwera elastycznego PostgreSQL
resource-group tworzenie, wyświetlanie, wyświetlanie, aktualizowanie Grupa zasobów serwera elastycznego PostgreSQL
name tworzenie, wyświetlanie, wyświetlanie Nazwa serwera elastycznego PostgreSQL
migration-name tworzenie, pokazywanie, aktualizowanie Unikatowy identyfikator dla migracji do serwera elastycznego. To pole akceptuje tylko znaki alfanumeryczne i nie akceptuje żadnych znaków specjalnych z wyjątkiem łącznika (-). Nazwa nie może zaczynać się od -, a żadne dwie migracje do serwera elastycznego nie mogą mieć takiej samej nazwy.
filter lista Aby filtrować migracje, obsługiwane są dwie wartości — Aktywne i Wszystkie
help tworzenie, wyświetlanie, wyświetlanie, aktualizowanie Zawiera informacje o każdym poleceniu.
migration-mode utworzyć Jest to opcjonalny parametr. Dozwolone wartości to : offline, online. Wartość domyślna: Offline.
migration-option utworzyć Umożliwia przeprowadzenie walidacji przed wyzwoleniem migracji. Wartość domyślna to ValidateAndMigrate. Dozwolone wartości to: Migrate, Validate, ValidateAndMigrate.
properties utworzyć Ścieżka bezwzględna do pliku JSON zawierającego informacje o źródle, serwerze docelowym, bazach danych do migracji, trybach SSL, definiowaniu typów źródłowych

Szczegóły pliku JSON

Polecenie az postgres flexible-server migration create wymaga ścieżki pliku JSON w ramach parametru --properties , który zawiera szczegóły konfiguracji migracji, takie jak identyfikator zasobu serwera źródłowej bazy danych, poświadczenia administratora, bazy danych do migracji i inne ważne ustawienia. Poniżej przedstawiono różne właściwości:

Nazwa właściwości opis
sourceDbServerResourceId Szczegóły serwera źródłowego w formacie dla lokalnych maszyn wirtualnych , usługi PostgreSQL opartej na chmurze — <<hostname or IP address>>:<<port>>@<<username>>. Jeśli serwer źródłowy to Azure Database for PostgreSQL — pojedynczy serwer, identyfikator zasobu ma format — /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>
adminCredentials Ten parametr zawiera listę haseł dla użytkowników administracyjnych zarówno dla serwera źródłowego, jak i docelowego serwera elastycznego PostgreSQL. Te hasła pomagają uwierzytelniać się na serwerach źródłowych i docelowych. Obejmuje ona dwie podwłaściwości i sourceServerPasswordtargetServerPassword
targetServerUserName Wartość domyślna to użytkownik administracyjny utworzony podczas tworzenia docelowego serwera elastycznego PostgreSQL, a podane hasło jest używane do uwierzytelniania względem tego użytkownika.
dbsToMigrate Określ listę baz danych, które mają być migrowane na serwer elastyczny. Jednocześnie można uwzględnić maksymalnie osiem nazw baz danych. Podawanie listy baz danych w formacie tablicy.
overwriteDBsInTarget Jeśli ustawienie ma wartość true (wartość domyślna), jeśli serwer docelowy ma istniejącą bazę danych o takiej samej nazwie jak ta, którą próbujesz przeprowadzić migrację, usługa migracji automatycznie zastępuje bazę danych
migrationRuntimeResourceId Wymagane, jeśli serwer środowiska uruchomieniowego musi być używany do migracji. Format to : /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL flexible server name>>
sourceDBServerFullyQualifiedDomainName Wymagane tylko wtedy, gdy źródło jest pojedynczym serwerem i znajduje się za niestandardowym serwerem DNS, niestandardowymi przestrzeniami nazw DNS, niestandardową nazwą FQDN lub musi być dostępna za pośrednictwem adresu IP.
targetDBServerFullyQualifiedDomainName Wymagane tylko wtedy, gdy obiekt docelowy znajduje się za niestandardowym serwerem DNS, niestandardowymi przestrzeniami nazw DNS, niestandardową nazwą FQDN lub musi być dostępny za pośrednictwem adresu IP.
sourceType Wymagany parametr interfejsu . Wartości mogą być następujące: lokalne, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode Tryby ssl na potrzeby migracji. Tryb SSL dla serwera PostgreSQLSingleServer to VerifyFull i Prefer/Require dla innych typów źródłowych.

Powiązana zawartość

  • Last updated on