Esercitazione: Eseguire la migrazione online da Amazon Aurora PostgreSQL a Database di Azure per PostgreSQL con il servizio di migrazione

Il portale di Azure offre un'esperienza semplice e intuitiva basata su procedura guidata per guidare l'utente attraverso la migrazione. Completando i passaggi descritti in questa esercitazione, è possibile trasferire facilmente il database in Database di Azure per PostgreSQL - Server flessibile e sfruttare le potenti funzionalità e la scalabilità.

Per eseguire la migrazione usando il portale di Azure, configurare prima di tutto l'attività di migrazione. Connettersi quindi all'origine e alla destinazione e avviare la migrazione.

Configurare l'attività di migrazione

Per configurare l'attività di migrazione nel portale di Azure:

1. Aprire il Web browser e quindi passare al portale di Azure. Immettere le credenziali di accesso.

2. Passare all'istanza di Database di Azure per PostgreSQL - Server flessibile.

3. Nel menu del servizio selezionare Migrazione.

   

4. Selezionare Crea per eseguire la migrazione da Amazon Aurora a un server flessibile.

   La prima volta che si usa il servizio di migrazione, viene visualizzata una griglia vuota con una richiesta per avviare la prima migrazione. Se le migrazioni alla destinazione del server flessibile sono già state create, la griglia contiene informazioni sui tentativi di migrazione.

5. Selezionare Crea per eseguire una serie di schede per configurare una migrazione.

   

Attrezzaggio

Immettere o selezionare le informazioni seguenti:

• Nome migrazione: immettere un identificatore univoco per ogni migrazione a questa destinazione server flessibile. È possibile usare solo caratteri alfanumerici e trattini (-) nel nome della migrazione. Il nome non può iniziare con un trattino e deve essere univoco per un server di destinazione. Due migrazioni alla stessa destinazione server flessibile possono avere lo stesso nome.

• Tipo di server di origine: selezionare il tipo di origine corrispondente all'origine PostgreSQL, ad esempio un servizio PostgreSQL basato sul cloud, un'installazione locale o una macchina virtuale.

• Opzione di migrazione: scegliere una delle opzioni seguenti per una convalida della premigration:

  • Convalida. Controlla l'idoneità del server e del database per la migrazione all'origine di destinazione.
  • Eseguire la migrazione. Ignora le convalide e avvia la migrazione.
  • Convalidare ed eseguire la migrazione. Esegue la convalida prima di attivare una migrazione. Se non sono presenti errori di convalida, viene attivata la migrazione.

  È consigliabile selezionare l'opzione Convalida o Convalida ed Esegui migrazione per le convalide di premi.

  Per altre informazioni, vedere Convalida della premigration.

• Modalità di migrazione: selezionare la modalità per la migrazione. L'opzione predefinita è Offline.

Selezionare Avanti: Connetti all'origine.

Selezionare il server di runtime

Il server di runtime di migrazione è una funzionalità specializzata del servizio di migrazione. Il server di runtime funge da server intermedio durante la migrazione. Si tratta di un'istanza separata di Database di Azure per PostgreSQL - Server flessibile che non è il server di destinazione. Il server di runtime facilita la migrazione dei database da un ambiente di origine accessibile solo tramite una rete privata.

Per altre informazioni, vedere Server di runtime di migrazione.

Connettersi all'origine

Nella scheda Connetti all'origine immettere o selezionare le informazioni seguenti per l'origine del database:

• Nome server: immettere il nome host o l'indirizzo IP dell'istanza di PostgreSQL di origine.
• Porta: immettere il numero di porta del server di origine.
• Nome di accesso dell'amministratore del server: immettere il nome utente del server PostgreSQL di origine.
• Password: immettere la password del server PostgreSQL di origine.
• Modalità SSL: i valori supportati sono Prefer e Require. Quando Secure Sockets Layer (SSL) nel server PostgreSQL di origine è disattivato, selezionare Prefer (Prefer). Se SSL nel server di origine è attivo, selezionare Richiedi. I valori SSL vengono impostati nel file postgresql.conf .
• Test connessione: avvia un test di connettività tra la destinazione e l'origine. Al termine della connessione, passare al passaggio successivo per identificare i problemi di rete tra la destinazione e l'origine e verificare il nome utente e la password per l'origine. Per stabilire una connessione di test sono necessari alcuni minuti.

Dopo aver completato la connessione di test, selezionare Avanti: Selezionare la destinazione di migrazione.

Selezionare la destinazione della migrazione

Nella scheda Seleziona destinazione della migrazione immettere o selezionare le informazioni seguenti per la destinazione del server flessibile, oltre alla sottoscrizione, al gruppo di risorse e al nome del server:

• Nome utente amministratore: nome utente amministratore del server PostgreSQL di destinazione.
• Password: password del server PostgreSQL di destinazione.
• FQDN/IP personalizzato (facoltativo): il campo FQDN/IP personalizzato è facoltativo e può essere usato quando la destinazione si trova dietro un server DNS personalizzato o dispone di spazi dei nomi DNS personalizzati, rendendolo accessibile solo tramite FQDN o indirizzi IP specifici. Ad esempio, può includere voci come flexibleserver.example.com, 198.1.0.2o un FQDN PostgreSQL, flexibleserver.postgres.database.azure.comad esempio , se il server DNS personalizzato contiene la zona postgres.database.azure.com DNS o inoltra le query per questa zona a 168.63.129.16, dove il nome di dominio completo viene risolto nella zona DNS pubblica o privata di Azure.
• Test connessione: avvia un test di connettività tra la destinazione e l'origine. Al termine della connessione, passare al passaggio successivo per identificare i problemi di rete tra la destinazione e l'origine e verificare il nome utente e la password per il server di destinazione. Per stabilire una connessione di test sono necessari alcuni minuti.

Dopo aver completato la connessione di test, selezionare Avanti: selezionare i database per la migrazione.

Selezionare i database per la migrazione

Nella scheda Seleziona database per la migrazione selezionare da un elenco di database utente di cui eseguire la migrazione dal server PostgreSQL di origine.

Dopo aver selezionato i database, selezionare Avanti: Riepilogo.

Riepilogo

La scheda Riepilogo riepiloga tutti i dettagli di origine e destinazione per la creazione della convalida o della migrazione. Esaminare i dettagli e quindi selezionare Avvia convalida e migrazione.

Monitorare la migrazione

Dopo pochi secondi dopo aver selezionato Avvia convalida e migrazione, viene visualizzata una notifica che indica che la convalida o la creazione della migrazione ha esito positivo. Si viene reindirizzati al riquadro Migrazione dell'istanza del server flessibile. La voce di stato è InProgress e lo stato secondario è PerformingPreRequisiteSteps. Il flusso di lavoro richiede da 2 a 3 minuti per configurare l'infrastruttura di migrazione e controllare le connessioni di rete.

La griglia che visualizza le migrazioni include queste colonne:

• Nome
• Stato
• Modalità di migrazione
• Tipo di migrazione
• Server di origine
• Tipo del server di origine
• Database
• Durata
• Ora di inizio

Le voci vengono visualizzate in ordine decrescente di ora di inizio, con la voce più recente nella parte superiore. È possibile selezionare Aggiorna nella barra dei menu per aggiornare lo stato dell'esecuzione della convalida o della migrazione.

Dettagli della migrazione

Nell'elenco delle migrazioni selezionare il nome di una migrazione per visualizzare i dettagli associati.

Nella scheda Setup (Installazione) selezionare l'opzione di migrazione Validate and Migrate (Convalida e migrazione). In questo scenario, le convalide vengono completate prima dell'avvio della migrazione. Al termine dell'istruzione PerformingPreRequisiteSteps , il flusso di lavoro passa allo stato secondario Convalida in corso .

• Se la convalida presenta errori, la migrazione passa a uno stato Failed.

• Se la convalida è stata completata senza errori, viene avviata la migrazione e il flusso di lavoro passa allo stato secondario Migrazione dei dati.

È possibile controllare i dettagli di convalida a livello di istanza e a livello di database:

• Convalida a livello di istanza:

  • Controllare la convalida relativa al controllo della connettività per la versione di origine (controllo del PostgreSQL version >= 9.5 parametro del server) se le estensioni sono abilitate nei parametri del server dell'istanza di Database di Azure per PostgreSQL - Server flessibile.

• Convalida a livello di database:

  • Controllare la convalida dei singoli database correlati al supporto delle estensioni e delle regole di confronto in Database di Azure per PostgreSQL - Server flessibile.

È possibile visualizzare lo stato corrente per la migrazione e la convalida nel riquadro dei dettagli della migrazione.

Le tabelle seguenti descrivono alcuni possibili stati di migrazione e sottostate.

Stati della migrazione

Stati secondari della migrazione

Stati secondari della convalida

Avviare un cutover

Se viene visualizzata la migrazione e la convalida e la migrazione , il completamento della migrazione online richiede il passaggio aggiuntivo di avvio di un cutover. Al termine della copia e del clone dei dati di base, la migrazione passa allo stato WaitingForUserAction e alla sottostate WaitingForCutoverTrigger . In questo stato, l'utente può attivare il cutover dal portale selezionando la migrazione.

Prima di avviare un cutover, è importante assicurarsi che:

• Le scritture nell'origine vengono arrestate.
• Il latency valore diminuisce a 0 o vicino a 0.

È possibile ottenere il latency valore nel riquadro dei dettagli della migrazione:

Il valore latency indica quando è avvenuta l'ultima sincronizzazione della destinazione con l'origine. A questo punto, la scrittura nell'origine può essere arrestata e il cutover può essere avviato. Se il traffico sul server di origine è elevato, è consigliabile arrestare prima le scritture in modo che latency possano raggiungere il valore 0. Quindi, avviare un cutover.

L'operazione di cutover applica tutte le modifiche in sospeso dall'origine alla destinazione e completa la migrazione. Se si attiva un cutover, anche con un valore diverso da zero per latency, la replica si arresta in quel momento. Tutti i dati si trova nell'origine fino a quando il punto di cutover non viene applicato alla destinazione. Ad esempio, se la latenza è di 15 minuti al punto di cutover, tutti i dati modificati negli ultimi 15 minuti vengono applicati alla destinazione. Il tempo necessario per completare il cutover dipende dal backlog delle modifiche che si sono verificate durante questi 15 minuti. È quindi consigliabile che la latenza vada a zero o quasi zero prima di attivare il cutover.

La migrazione passa allo stato Succeeded quando l'istruzione di migrazione dei dati o il cutover (in una migrazione online) termina correttamente. Se si verifica un problema nello stato secondario Migrazione dei dati , la migrazione passa a uno stato Non riuscito .

Questo articolo descrive come usare l'interfaccia della riga di comando di Azure per eseguire la migrazione del database PostgreSQL da Amazon Aurora a Database di Azure per PostgreSQL. L'interfaccia della riga di comando di Azure è un'interfaccia della riga di comando potente e flessibile che è possibile usare per completare varie attività, tra cui la migrazione del database.

Per altre informazioni, vedere Configurare l'interfaccia della riga di comando di Azure per il servizio di migrazione.

Dopo aver installato l'interfaccia della riga di comando di Azure, nella riga di comando accedere all'account Azure usando il comando seguente:

az login

Configurare l'attività di migrazione

1. Per iniziare la migrazione, creare un file JSON per contenere i dettagli della migrazione. Salvare il file JSON nel computer locale come <nome file>.json. Ad esempio, è possibile salvare il file come C:\migration-CLI\migration_body.json.

   Copiare il codice JSON seguente e incollarlo nel file JSON. Sostituire <placeholders> con le informazioni pertinenti dello scenario.

   {
   "properties": {
   "SourceDBServerResourceId": "<source host name or IP address>:<port>@<username>",
           "SecretParameters": {
               "AdminCredentials": {
                   "SourceServerPassword": "<source password>",
                   "TargetServerPassword": "<target password>"
               },
               "targetServerUserName": "<target username>"
           },
           "DBsToMigrate": "<a comma-separated list of databases in an array, similar to the example "ticketdb","timedb","inventorydb">",
           "OverwriteDBsInTarget": "true",
           "sourceType": "AWS_AURORA",
           "sslMode": "Require"
       }
   }
   

2. Per verificare se vi sono migrazioni in esecuzione, eseguire il comando seguente. Il nome della migrazione è univoco per le migrazioni nella destinazione Database di Azure per PostgreSQL - Server flessibile.

   az postgres flexible-server migration list --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --filter All
   

3. Nei passaggi precedenti non vengono eseguite migrazioni. Iniziare con la nuova migrazione eseguendo il comando seguente:

   az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --migration-mode online --migration-option ValidateAndMigrate --properties "C:\migration-cli\migration_body.json"
   

4. Per avviare lo stato della migrazione nel passaggio precedente, eseguire il comando seguente. È possibile controllare lo stato della migrazione specificando il nome della migrazione.

   az postgres flexible-server migration show --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1
   

   Lo stato della migrazione viene visualizzato nell'interfaccia della riga di comando di Azure. È anche possibile visualizzare lo stato dell'istanza di Database di Azure per PostgreSQL - Server flessibile nel portale di Azure.

Annullare o eliminare una migrazione

È possibile annullare qualsiasi tentativo di migrazione in corso usando il comando cancel. Questo comando arresta il tentativo di migrazione specifico ed esegue il rollback di tutte le modifiche nel server di destinazione.

Ecco il comando dell'interfaccia della riga di comando di Azure per eliminare una migrazione:

az postgres flexible-server migration update cancel --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1

Cutover

Al termine della migrazione dei dati di base in una migrazione online, l'attività di migrazione passa allo stato secondario WaitingForCutoverTrigger . In questo stato è possibile attivare il cutover usando il comando seguente nell'interfaccia della riga di comando di Azure:

az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --cutover

È anche possibile attivare un cutover nel portale selezionando il nome della migrazione nella griglia di migrazione.