Jak nastavit Azure CLI pro službu migrace na flexibilním serveru Azure Database for PostgreSQL

  • Článek

Azure CLI je sada příkazů používaných napříč službami Azure k vytváření a správě prostředků. Poskytuje stejné možnosti jako Azure Portal, ale je optimalizovaný pro uživatele, kteří dávají přednost práci v prostředí příkazového řádku. Pokud chcete začít migrovat pomocí Azure CLI, musíte na místní počítač nainstalovat Azure CLI.

Požadavky

  • Instalace Azure CLI: V závislosti na operačním systému si stáhněte a nainstalujte Azure CLI. Je k dispozici pro Windows, macOS a Linux.
  • Průvodce instalací Azure CLI: Postupujte podle pokynů v oficiální dokumentaci k Azure a nainstalujte Azure CLI – Jak nainstalovat Azure CLI.
  • Zkontrolujte verzi Azure CLI: Ujistěte se, že vaše verze Azure CLI je minimálně 2.56.0 nebo vyšší, protože se vyžaduje pro službu migrace. Pomocí příkazu az --version zkontrolujte aktuální verzi.
  • Přihlaste se k Azure: Po instalaci proveďte az login ověření. Otevře se výchozí prohlížeč pro dokončení procesu přihlášení pomocí přihlašovacích údajů Azure.

Tyto kroky připraví vaše prostředí na efektivní správu služby migrace ve službě Azure Database for PostgreSQL pomocí Azure CLI. Vždy si projděte nejnovější dokumentaci k Azure, kde najdete všechny aktualizace nebo změny procesu instalace.

Nastavení příkazů rozhraní příkazového řádku pro službu migrace

Všechny příkazy rozhraní příkazového řádku začínají na az postgres flexible-server migration. K dispozici jsou také příkazy nápovědy, které vám pomůžou pochopit různé možnosti a určit správnou syntaxi příkazů rozhraní příkazového řádku.

Po instalaci rozhraní příkazového řádku otevřete příkazový řádek a přihlaste se k účtu Azure pomocí následujícího příkazu.

az login

Migrovat příkazy

Služba migrace poskytuje následující příkazy, které vám pomůžou migrovat instance PostgreSQL na flexibilní server Azure Database for PostgreSQL.

Příkaz Nápověda

Příkaz --help v Azure CLI je cenná možnost, která poskytuje podrobnou dokumentaci k příkazům a jejich dílčím příkazům, včetně požadovaných příkazů pro operace. Příkaz –-helpzobrazí potřebné příkazy a jejich přidružené akce pro službu migrace ve službě Azure Database for PostgreSQL.

az postgres flexible-server migration –-help

Výstup vás provede potřebnými kroky a parametry potřebnými ke správě migrací databází efektivně pomocí Azure CLI.

Příkaz Create

Příkaz az postgres flexible-server migration create v Azure CLI slouží k zahájení nového pracovního postupu migrace. Usnadňuje migraci databází ze zdrojové instance PostgreSQL do cílové instance flexibilního serveru Azure Database for PostgreSQL. Tento příkaz nastaví potřebné parametry a konfigurace, které zajistí hladký a efektivní proces migrace.

Další informace najdete v tématu az postgres flexible-server migration create

List – příkaz

Tento az postgres flexible-server migration list příkaz slouží k výpisu všech pokusů o migraci provedených do cíle Azure Database for PostgreSQL. Tento příkaz poskytuje přehled zahájených migrací, což vám umožní sledovat stav a podrobnosti o každém pokusu o migraci.

Další informace najdete v tématu az postgres flexible-server migration list

Zobrazit příkaz

Tento az postgres flexible-server migration show příkaz vám pomůže monitorovat probíhající migrace a poskytuje aktuální stav a podstav migrace. Mezi tyto podrobnosti patří informace o aktuálním stavu a podstavu migrace.

Další informace najdete v tématu az postgres flexible-server migration show

Některé možné stavy migrace:

Stavy migrace

Stát Popis
InProgress Nastavení infrastruktury migrace probíhá nebo probíhá skutečná migrace dat.
Zrušeno Migrace se zruší nebo odstraní.
Neúspěch Migrace se nezdařila.
Ověření se nezdařilo. Ověření se nezdařilo.
Uspěl Migrace byla úspěšná a je dokončená.
WaitingForUserAction Platí jenom pro online migraci. Čeká se na provedení přímé akce uživatele.

Podstavy migrace

Podstate Popis
ProvedeníPreRequisiteSteps Nastavení infrastruktury probíhá pro migraci dat.
Probíhá ověření Probíhá ověřování.
Migrace dat Probíhá migrace dat.
Dokončení migrace Migrace je v posledních fázích dokončení.
Dokončeno Migrace byla dokončena.
Neúspěch Migrace se nezdařila.

Podstate ověření

Podstate Popis
Neúspěch Ověření se nezdařilo.
Uspěl Ověření je úspěšné.
Upozorňující Ověření je v upozornění.

Příkaz Aktualizovat

Příkaz az postgres flexible-server migration update slouží ke správě procesu migrace na flexibilní server Azure Database for PostgreSQL. Konkrétně se dá použít k:

  • Proveďte přímou akci: Tím se proces migrace dokončí přepnutím databázového provozu ze zdrojového serveru na cílový flexibilní server.
    • Po dokončení základní migrace dat se úloha migrace přesune do podstavu WaitingForCutoverTrigger . V tomto stavu můžou uživatelé spustit přímou migraci z portálu tak, že vyberou název migrace v mřížce migrace nebo prostřednictvím rozhraní příkazového řádku.
    • Před zahájením přímé migrace je důležité zajistit, aby:
      • Zápisy do zdroje jsou zastaveny.
      • latency hodnota se zmenší na 0 nebo se blíží 0.
      • latency hodnota označuje, kdy se cíl naposledy synchronizoval se zdrojem. V tomto okamžiku lze zápisy do zdroje zastavit a přímo zahájit. V případě velkého provozu ve zdroji se doporučuje nejprve zastavit zápisy, Latency aby se mohlo blížit 0, a pak se zahájí přímá migrace.
      • Operace přímé migrace použije všechny čekající změny ze zdroje na cíl a dokončí migraci. Pokud aktivujete přímou akci i s nenulovou Latency, replikace se zastaví až do tohoto bodu v čase. Všechna data ve zdroji, dokud se bod přímé migrace nepoužije na cíli. Řekněme, že latence byla v přímé bodě 15 minut, takže všechna změněná data za posledních 15 minut platí pro cíl.
  • Zrušení migrace: V případě potřeby vám tato možnost umožní zastavit proces migrace.
  • Nastavení logické replikace ve zdroji: To je užitečné, když je zdrojový server jednoúčelovým serverem Azure Database for PostgreSQL, protože připraví server na replikaci dat na flexibilní server.

Další informace najdete v tématu az postgres flexible-server migration update

Shrnutí

Následující tabulka shrnuje parametry používané příkazy migrace:

Parametr Relevantní příkazy Popis
subscription create, list, show, update ID předplatného flexibilního serveru PostgreSQL
resource-group create, list, show, update Skupina prostředků flexibilního serveru PostgreSQL
name create, list, show Název flexibilního serveru PostgreSQL
migration-name vytvoření, zobrazení, aktualizace Jedinečný identifikátor migrace se pokusil o flexibilní server. Toto pole přijímá pouze alfanumerické znaky a nepřijímá žádné speciální znaky s výjimkou spojovníku (-). Název nemůže začínat – a žádné dvě migrace na cíl flexibilního serveru nesmí mít stejný název.
filter list Pokud chcete filtrovat migrace, podporují se dvě hodnoty – Aktivní a Vše
help create, list, show, update Poskytuje informace o jednotlivých příkazech.
migration-mode vytvoření Jedná se o volitelný parametr. Povolené hodnoty jsou – offline, online. Výchozí hodnota: Offline.
migration-option vytvoření Umožňuje provádět ověření před aktivací migrace. Výchozí hodnota je ValidateAndMigrate. Povolené hodnoty jsou – Migrate, Validate, ValidateAndMigrate.
properties vytvoření Absolutní cesta k souboru JSON, který obsahuje informace o zdrojovém, cílovém serveru, databázích pro migraci, režimech SSL a definování typů zdrojů

Podrobnosti o souboru JSON

Tento az postgres flexible-server migration create příkaz vyžaduje cestu k souboru JSON jako součást parametru, která obsahuje podrobnosti konfigurace pro migraci, jako je ID prostředku zdrojového databázového --properties serveru, přihlašovací údaje správce, databáze pro migraci a další důležitá nastavení. Níže jsou uvedené různé vlastnosti:

Název vlastnosti Popis
sourceDbServerResourceId Podrobnosti o zdrojovém serveru ve formátu pro místní virtuální počítače, cloudové služby PostgreSQL – <<hostname or IP address>>:<<port>>@<<username>>. Pokud je zdrojovým serverem Azure Database for PostgreSQL – Jednoúčelový server, id prostředku je ve formátu – /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>
adminCredentials Tento parametr uvádí hesla pro uživatele správce pro zdrojový server i cílový flexibilní server PostgreSQL. Tato hesla pomáhají ověřovat se na zdrojových a cílových serverech. Zahrnuje dvě dílčí podmínky a sourceServerPasswordtargetServerPassword
targetServerUserName Výchozí hodnota je uživatel správce vytvořený při vytváření cílového flexibilního serveru PostgreSQL a zadané heslo se používá k ověřování vůči tomuto uživateli.
dbsToMigrate Zadejte seznam databází, které chcete migrovat na flexibilní server. Najednou můžete zahrnout maximálně osm názvů databází. Poskytuje seznam databází ve formátu pole.
overwriteDBsInTarget Pokud je nastavená hodnota true (výchozí), pokud se cílový server stane, že má existující databázi se stejným názvem jako databáze, kterou se pokoušíte migrovat, služba migrace databázi automaticky přepíše.
migrationRuntimeResourceId Vyžaduje se, pokud je potřeba k migraci použít server modulu runtime. Formát je - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL Flexible Server name>>
sourceType Požadovaný parametr . Hodnoty můžou být – místní, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode Režimy SSL pro migraci. Režim SSL pro PostgreSQLSingleServer je VerifyFull a Prefer/Require pro jiné typy zdrojů.

Související obsah