Sdílet prostřednictvím

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

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.

Postup nastavení příkazů rozhraní příkazového řádku

  1. Instalace Azure CLI: Postupujte podle pokynů uvedených v oficiální dokumentaci k Azure a nainstalujte Azure CLI – Jak nainstalovat Azure CLI.

  2. Zkontrolujte verzi Azure CLI: Ujistěte se, že je verze Azure CLI minimálně 2.56.0 nebo vyšší. Pomocí příkazu az --version zkontrolujte aktuální verzi.

  3. 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.

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 proběhla úspěšně a byla dokončena.
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 je dokončená.
Neúspěch Migrace se nezdařila.

Podstate ověření

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

Příkaz Aktualizovat

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

  • Proveďte přepnutí: 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 byste měli nejprve zastavit zápisy, aby se Latency mohl přiblížit k 0, a pak se zahájí přepnutí.
      • 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ým serverem jednoúčelový server 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 vytvořit, vypsat, zobrazit, aktualizovat ID předplatného flexibilního serveru PostgreSQL
resource-group vytvořit, seznam, zobrazit, aktualizovat Skupina prostředků flexibilního serveru PostgreSQL
name vytvořit, seznam, zobrazit Název flexibilního serveru PostgreSQL
migration-name vytvoření, zobrazení, aktualizace Jedinečný identifikátor pro migrace pokusající se 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 nesmí začínat na -, a tak žádné dvě migrace do cíle flexibilního serveru nesmí mít stejný název.
filter list Pokud chcete filtrovat migrace, podporují se dvě hodnoty – Aktivní a Vše
help vytvořit, seznam, zobrazit, aktualizovat Poskytuje informace o jednotlivých příkazech.
migration-mode vytvořit Jedná se o volitelný parametr. Povolené hodnoty jsou – offline, online. Výchozí hodnota: Offline.
migration-option vytvořit Umožňuje provádět ověření před aktivací migrace. Výchozí hodnota je ValidateAndMigrate. Povolené hodnoty jsou – Migrate, Validate, ValidateAndMigrate.
properties vytvořit 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í. Toto jsou 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>>
sourceDBServerFullyQualifiedDomainName Vyžaduje se pouze v případě, že je zdrojem jeden server a nachází se za vlastním serverem DNS, vlastními obory názvů DNS, vlastním plně kvalifikovaným názvem domény, nebo musí být přístupný přes IP adresu.
targetDBServerFullyQualifiedDomainName Vyžaduje se pouze v případě, že cíl stojí za vlastním serverem DNS, vlastními obory názvů DNS, vlastním plně kvalifikovaným názvem domény nebo musí být přístupný přes IP adresu.
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

  • Last updated on