Esercitazione: Eseguire la migrazione da una macchina virtuale locale o da una macchina virtuale di Azure ospitata da PostgreSQL a Database di Azure per PostgreSQL usando il servizio di migrazione

SI APPLICA A: Database di Azure per PostgreSQL - Server flessibile

Questa esercitazione illustra come eseguire la migrazione di un'istanza di PostgreSQL dalle macchine virtuali locali o di Azure a Database di Azure per PostgreSQL server flessibile usando le portale di Azure e l'interfaccia della riga di comando di Azure.

Il servizio di migrazione in Database di Azure per PostgreSQL è un servizio completamente gestito integrato nella portale di Azure e nell'interfaccia della riga di comando di Azure. È progettato per semplificare il percorso di migrazione verso Database di Azure per PostgreSQL server flessibile.

• Configurare il server flessibile Database di Azure per PostgreSQL
• Configurare l'attività di migrazione
• Monitorare la migrazione
• Annullare la migrazione
• Dopo la migrazione

Prerequisiti (offline)

Prima di avviare la migrazione con il servizio di migrazione in Database di Azure per PostgreSQL, soddisfare i prerequisiti seguenti, che si applicano agli scenari di migrazione offline è essenziale.

Verificare la versione di origine

La versione di PostgreSQL di origine deve essere >= 9.5. Se la versione postgreSQL di origine è minore di 9.5, aggiornare la versione postgreSQL di origine a 9.5 o versione successiva prima della migrazione.

Configurazione di destinazione

• Database di Azure per PostgreSQL deve essere configurato in Azure prima della migrazione.

• Lo SKU scelto per il Database di Azure per PostgreSQL deve corrispondere alle specifiche del database di origine per garantire la compatibilità e le prestazioni adeguate.

• Per istruzioni dettagliate sulla creazione di un nuovo Database di Azure per PostgreSQL, vedere il collegamento seguente: Avvio rapido: Creare un server.

Configurazione della rete

Una corretta configurazione di rete è essenziale per garantire una corretta connettività tra l'origine e la destinazione durante la migrazione. Ecco una guida che consente di stabilire la connessione di rete per diversi scenari:

Requisiti di rete per la migrazione:

• Tunneling VPN/VPN IPsec ExpressRoute/IPsec: quando si connette l'origine locale/AWS ad Azure, potrebbe essere necessario configurare un tunneling VPN ExpressRoute, IPsec o VPN per facilitare il trasferimento sicuro dei dati.

• Peering reti virtuali: stabilire il peering di rete virtuale tra le due reti virtuali distinte per abilitare la connettività di rete diretta, un prerequisito per la migrazione tra la macchina virtuale di Azure e il Database di Azure per PostgreSQL.

scenari di Connessione ivity:

La tabella seguente consente di configurare la rete tra l'origine e la destinazione.

Source	Target	Connessione ivity Suggerimenti
Pubblico	Pubblico	Non è necessaria alcuna altra azione se l'origine è inclusa nell'elenco elementi consentiti nelle regole del firewall della destinazione.
Privata	Pubblico	Questa configurazione non è supportata; usare pg_dump/pg_restore per il trasferimento dei dati.
Pubblico	Privato	Non è necessaria alcuna altra azione se l'origine è inclusa nell'elenco elementi consentiti nelle regole del firewall della destinazione.
Privata	Privata	Stabilire un peering di rete virtuale, VPN ExpressRoute, IPsec, tunneling VPN o rete virtuale tra l'origine e la destinazione.
Privata	Endpoint privato	Questa configurazione non è supportata; contattare il supporto tecnico Microsoft.

Considerazioni aggiuntive sulla rete:

• pg_hba.conf Configurazione: per facilitare la connettività tra le istanze di PostgreSQL di origine e di destinazione, è essenziale verificare e potenzialmente modificare il file pg_hba.conf. Questo file include l'autenticazione client e deve essere configurato per consentire a PostgreSQL di destinazione di connettersi all'origine. Per rendere effettive le modifiche apportate al file pg_hba.conf, è in genere necessario riavviare l'istanza di PostgreSQL di origine.

Nota

Il file pg_hba.conf si trova nella directory dei dati dell'installazione di PostgreSQL. Questo file deve essere controllato e configurato se il database di origine è un server PostgreSQL locale o un server PostgreSQL ospitato in una macchina virtuale di Azure. Per le istanze di PostgreSQL in AWS RDS o servizi gestiti simili, il file pg_hba.conf non è direttamente accessibile o applicabile. L'accesso viene invece controllato tramite le configurazioni di sicurezza e accesso alla rete fornite dal servizio.

Per altre informazioni sulla configurazione di rete, vedere Guida alla rete per il servizio di migrazione in Database di Azure per PostgreSQL - Server flessibile.

Estensioni

Le estensioni sono funzionalità aggiuntive che possono essere aggiunte a PostgreSQL per migliorarne le funzionalità. Le estensioni sono supportate in Database di Azure per PostgreSQL, ma devono essere abilitate manualmente. Per abilitare le estensioni, seguire questa procedura:

• Usare il comando select nell'origine per elencare tutte le estensioni in uso: select extname,extversion from pg_extension;

• Cercare il parametro del server azure.extensions nella pagina Parametro server del Database di Azure per PostgreSQL. Abilitare le estensioni disponibili nell'origine all'interno di PostgreSQL.

• Salvare le modifiche del parametro e riavviare il Database di Azure per PostgreSQL per applicare la nuova configurazione, se necessario.

  

• Controllare se l'elenco contiene una delle estensioni seguenti:

  • PG_CRON
  • PG_HINT_PLAN
  • PG_PARTMAN_BGW
  • PG_PREWARM
  • PG_STAT_STATEMENTS
  • PG_AUDIT
  • PGLOGICAL
  • WAL2JSON

In caso affermativo, cercare il parametro shared_preload_libraries nella pagina dei parametri del server. Questo parametro indica il set di librerie di estensioni precaricati al riavvio del server.

Utenti e ruoli

Quando si esegue la migrazione a Database di Azure per PostgreSQL, è essenziale affrontare separatamente la migrazione di utenti e ruoli, perché richiedono un intervento manuale:

• Migrazione manuale di utenti e ruoli: gli utenti e i ruoli associati devono essere migrati manualmente al Database di Azure per PostgreSQL. Per facilitare questo processo, è possibile usare l'utilità pg_dumpall con il --globals-only flag per esportare oggetti globali, ad esempio ruoli e account utente. Eseguire il comando seguente, sostituendo <<username>> con il nome utente effettivo e <<filename>> con il nome file di output desiderato:

  pg_dumpall --globals-only -U <<username>> -f <<filename>>.sql
  

• Restrizione per i ruoli con privilegi avanzati: Database di Azure per PostgreSQL non supporta i ruoli con privilegi avanzati. Pertanto, gli utenti con privilegi con privilegi avanzati devono avere tali privilegi rimossi prima della migrazione. Assicurarsi di modificare le autorizzazioni e i ruoli di conseguenza.

Seguendo questa procedura, è possibile assicurarsi che gli account utente e i ruoli vengano migrati correttamente al Database di Azure per PostgreSQL senza riscontrare problemi correlati alle restrizioni dell'utente con privilegi avanzati.

Parametri del server

Questi parametri non vengono migrati automaticamente nell'ambiente di destinazione e devono essere configurati manualmente.

• Trovare la corrispondenza dei valori dei parametri del server dal database PostgreSQL di origine al Database di Azure per PostgreSQL accedendo alla sezione "Parametri server" nella portale di Azure e aggiornando manualmente i valori di conseguenza.

• Salvare le modifiche del parametro e riavviare il Database di Azure per PostgreSQL per applicare la nuova configurazione, se necessario.

Disabilitare la disponibilità elevata (affidabilità) e le repliche in lettura nella destinazione

• La disabilitazione della disponibilità elevata (affidabilità) e della lettura delle repliche nell'ambiente di destinazione è essenziale. Queste funzionalità devono essere abilitate solo dopo il completamento della migrazione.

• Seguendo queste linee guida, è possibile garantire un processo di migrazione senza le variabili aggiunte introdotte dalla disponibilità elevata e dalle repliche in lettura. Una volta completata la migrazione e il database è stabile, è possibile abilitare queste funzionalità per migliorare la disponibilità e la scalabilità dell'ambiente di database in Azure.

Portale

È possibile eseguire la migrazione usando il portale di Azure.

Configurare l'attività di migrazione

Il servizio di migrazione include un'esperienza semplice basata su procedura guidata sul portale di Azure.

1. Aprire il Web browser e passare al portale. Immettere le credenziali per accedere. La visualizzazione predefinita è il dashboard del servizio.

2. Passare al server flessibile di Database di Azure per PostgreSQL.

3. Nella scheda Panoramica del server flessibile, nel menu a sinistra scorrere verso il basso fino a Migrazione e selezionarlo.

   

4. Selezionare il pulsante Crea per eseguire la migrazione a un server flessibile da macchine virtuali locali o di Azure.

   Nota

   La prima volta che si usa il servizio di migrazione, viene visualizzata una griglia vuota con un prompt per avviare la prima migrazione.

   Se sono già state create migrazioni alla destinazione del server flessibile, la griglia contiene ora informazioni sui tentativi di migrazione.

5. Selezionare il pulsante Crea per passare a una serie di schede basate su procedura guidata per eseguire una migrazione.

   

Attrezzaggio

La prima scheda è la scheda di installazione.

L'utente deve fornire più dettagli relativi alla migrazione, ad esempio il nome della migrazione, il tipo di server di origine, l'opzione e la modalità.

• Il nome della migrazione è l'identificatore univoco per ogni migrazione a questa destinazione del server flessibile. Questo campo accetta solo caratteri alfanumerici e non accetta caratteri speciali tranne un trattino (-). Il nome non può iniziare con un trattino e deve essere univoco per un server di destinazione. Due migrazioni alla stessa destinazione del server flessibile possono avere lo stesso nome.

• Tipo di server di origine: a seconda dell'origine PostgreSQL, è possibile selezionare Database di Azure per PostgreSQL server singolo, locale, macchina virtuale di Azure.

• Opzione di migrazione: consente di eseguire convalide prima di attivare una migrazione. È possibile scegliere una delle opzioni seguenti

  • Convalida: controlla l'idoneità del server e del database per la migrazione alla destinazione.
  • Migrazione : ignora le convalide e avvia le migrazioni.
  • Convalida e migrazione : esegue la convalida prima di attivare una migrazione. La migrazione viene attivata in caso di errori di convalida.
    • La scelta dell'opzione Convalida o Convalida ed Esegui migrazione è sempre una procedura consigliata per eseguire le convalide di premi prima di eseguire la migrazione.

Per altre informazioni sulla convalida della premigration, vedere premigration (Premigration).

• La modalità di migrazione consente di scegliere la modalità per la migrazione. Offline è l'opzione predefinita.

Selezionare il pulsante Avanti: Connessione all'origine.

Connessione all'origine

La scheda Connessione origine richiede di specificare i dettagli relativi all'origine selezionata nella scheda Imposta, che è l'origine dei database.

• Nome server: specificare il nome host o l'indirizzo IP dell'istanza postgreSQL di origine

• Porta - Numero di porta del server di origine

• Nome di accesso dell'amministratore del server - Nome utente del server PostgreSQL di origine

• Password - Password del server PostgreSQL di origine

• Modalità SSL: i valori supportati sono preferiti e obbligatori. Quando SSL nel server PostgreSQL di origine è OFF, usare SSLMODE=prefer. Se ssl nel server di origine è ON, usare SSLMODE=require. I valori SSL possono essere determinati nel file postgresql.conf.

• Test Connessione ion: esegue il test di connettività tra la destinazione e l'origine. Una volta completata la connessione, gli utenti possono procedere con il passaggio successivo; devono identificare i problemi di rete tra la destinazione e l'origine e verificare il nome utente/password per l'origine. La connessione di test richiede alcuni minuti per stabilire una connessione tra la destinazione e l'origine.

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

Connessione alla destinazione

Nella scheda Seleziona destinazione della migrazione vengono visualizzati i metadati per la destinazione del server flessibile, ad esempio nome sottoscrizione, gruppo di risorse, nome del server, percorso e versione di PostgreSQL.

• nome utente Amministrazione : Amministrazione nome utente del server PostgreSQL di destinazione

• Password - Password del server PostgreSQL di destinazione

• Test Connessione ion: esegue il test di connettività tra la destinazione e l'origine. Una volta completata la connessione, gli utenti possono procedere con il passaggio successivo. In caso contrario, è necessario identificare i problemi di rete tra la destinazione e l'origine e verificare il nome utente/password per la destinazione. La connessione di test richiede alcuni minuti per stabilire una connessione tra la destinazione e l'origine

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

Selezionare i database per la migrazione

Nella scheda Selezione database per la migrazione è possibile scegliere 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 selezionare il pulsante Avvia convalida e migrazione .

Monitorare la migrazione

Dopo aver selezionato il pulsante Avvia convalida e migrazione , viene visualizzata una notifica in pochi secondi per indicare che la convalida o la creazione della migrazione ha esito positivo. Si viene reindirizzati automaticamente alla pagina migrazione del server flessibile. La voce si trova nello stato InProgress e nella sottostate PerformingPreRequisiteSteps . Il flusso di lavoro richiede 2-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à migrazione, Tipo di migrazione, Server di origine, Tipo di server di origine, Database, Durata e Ora di inizio. Le voci vengono visualizzate nell'ordine decrescente dell'ora di inizio, con la voce più recente nella parte superiore. È possibile usare il pulsante aggiorna per aggiornare lo stato dell'esecuzione della convalida o della migrazione.

Dettagli della migrazione

Selezionare il nome della migrazione nella griglia per visualizzare i dettagli associati.

Nella scheda Installazione è stata selezionata l'opzione di migrazione convalida e migrazione. In questo scenario, le convalide vengono eseguite prima dell'avvio della migrazione. Al termine del supporto PerformingPreRequisiteSteps, il flusso di lavoro passa al supporto di Convalida in corso.

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

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

I dettagli di convalida sono disponibili a livello di istanza e database.

• Convalida a livello di istanza
  • Contiene la convalida correlata al controllo della connettività, alla versione di origine, ovvero alla versione >di PostgreSQL = 9.5, al controllo dei parametri del server, ovvero se le estensioni sono abilitate nei parametri server del server Database di Azure per PostgreSQL - server flessibile.
• Convalida a livello di database
  • Contiene la convalida dei singoli database correlati al supporto delle estensioni e delle regole di confronto in Database di Azure per PostgreSQL, un server flessibile.

È possibile visualizzare la convalida e lo stato della migrazione nella pagina dei dettagli della migrazione.

I possibili stati di migrazione includono:

• InProgress: la configurazione dell'infrastruttura di migrazione è in corso o la migrazione effettiva dei dati è in corso.
• Annullata: la migrazione viene annullata o eliminata.
• Operazione non riuscita: la migrazione non è riuscita.
• Convalida non riuscita : la convalida non è riuscita.
• Operazione completata: la migrazione è stata completata e completata.
• WaitingForUserAction: applicabile solo per la migrazione online. In attesa dell'azione dell'utente per eseguire il cutover.

Le possibili sottostate di migrazione includono:

• Esecuzione diPreRequisiteSteps: è in corso la configurazione dell'infrastruttura per la migrazione dei dati.
• Convalida in corso: la convalida è in corso.
• Migrazione diData: la migrazione dei dati è in corso.
• CompletionMigration: la migrazione è nelle fasi finali del completamento.
• Completato: la migrazione è stata completata.
• Operazione non riuscita: la migrazione non è riuscita.

Le possibili sottostate di convalida includono:

• Operazione non riuscita: la convalida non è riuscita.
• Operazione riuscita: la convalida ha esito positivo.
• Avviso: la convalida è in avviso. Gli avvisi sono messaggi informativi che è necessario ricordare durante la pianificazione della migrazione.

Annullare la migrazione tramite il portale

È possibile annullare eventuali convalide o migrazioni in corso. Il flusso di lavoro deve trovarsi nello stato InProgress da annullare. Non è possibile annullare una convalida o una migrazione nello stato Operazione riuscita o Non riuscita.

• L'annullamento di una convalida arresta un'ulteriore attività di convalida e la convalida passa a uno stato Annullato .
• L'annullamento di una migrazione arresta altre attività di migrazione nel server di destinazione e passa a uno stato Annullato . L'azione di annullamento eseguirà il rollback di tutte le modifiche apportate dal servizio di migrazione nel server di destinazione.

CLI

È possibile eseguire la migrazione usando l'interfaccia della riga di comando di Azure.

Per iniziare la migrazione usando l'interfaccia della riga di comando di Azure, è necessario installare l'interfaccia della riga di comando di Azure nel computer locale.

Configurare l'interfaccia della riga di comando di Azure per il servizio di migrazione in Database di Azure per PostgreSQL - Server flessibile

• Installare l'interfaccia della riga di comando di Azure a seconda del sistema operativo per eseguire i comandi dell'interfaccia della riga di comando.
• L'interfaccia della riga di comando di Azure può essere installata da : come installare l'interfaccia della riga di comando di Azure.
• Se l'interfaccia della riga di comando di Azure è già installata, controllare la versione eseguendo il comando az version. La versione deve essere almeno 2.56.0 o successiva per usare il servizio di migrazione.
• Dopo l'installazione, eseguire il comando az sign in. Verrà aperto il browser predefinito e viene caricata una pagina di accesso di Azure per l'autenticazione. Passare le credenziali di Azure per eseguire correttamente l'autenticazione. Per altri modi per accedere con l'interfaccia della riga di comando di Azure, visitare questo collegamento.

Configurare i comandi dell'interfaccia della riga di comando per il servizio di migrazione

Tutti i comandi dell'interfaccia della riga di comando iniziano con az postgres flexible-server migration. Sono disponibili anche istruzioni della Guida per comprendere le varie opzioni e definire la sintassi corretta per i comandi dell'interfaccia della riga di comando.

Dopo aver installato l'interfaccia della riga di comando, aprire il prompt dei comandi e accedere all'account Azure usando il comando seguente.

Esempio con il prompt dei comandi di Windows: az login.

Comandi da usare con il servizio di migrazione

Il servizio di migrazione fornisce i comandi seguenti che consentono di eseguire la migrazione dei database PostgreSQL a Database di Azure per PostgreSQL - Server flessibile.

Comando della Guida

Il comando az postgres flexible-server migration –-help fornisce il nome e i verbi corrispondenti.

Comando create

Il comando create consente di eseguire la migrazione da un server di origine a un server di destinazione.

Il comando della Guida consente agli utenti di comprendere i diversi argomenti usati per la creazione e l'avvio della migrazione az postgres flexible-server migration create --help.

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --migration-option ValidateAndMigrate --properties "C:\Users\Administrator\Documents\migrationBody.JSON" --migration-mode offline

Flusso di sottostate diverso quando viene attivato il comando create.

• La migrazione passa allo stato InProgress e alla sottostate PerformingPreRequisiteSteps.

• Al termine dell'istruzione PerformingPreRequisiteSteps, la migrazione passa allo stato secondario di Migrazione dei dati, in cui viene eseguita la clonazione/copia dei database.

• Ogni database migrato ha la relativa sezione con tutti i dettagli della migrazione, ad esempio conteggio tabelle, inserimenti incrementali, eliminazioni e byte in sospeso.

• Il tempo necessario per completare l'istruzione di migrazione dei dati dipende dalle dimensioni dei database di cui viene eseguita la migrazione.

• La migrazione passa allo stato Succeeded al termine dell'operazione di migrazione dei dati. Se si verifica un problema nella sottostato Migrazione dei dati, la migrazione passa a uno stato Non riuscito.

È possibile comprendere i dettagli di ogni parametro usato nel comando create.

Nome parametro	Descrizione
subscription	ID sottoscrizione del server flessibile PostgreSQL
resource-group	Gruppo di risorse del server flessibile PostgreSQL
name	Nome del server flessibile PostgreSQL
migration-name	Identificatore univoco per le migrazioni tentate di eseguire il server flessibile. Questo campo accetta solo caratteri alfanumerici e non accetta caratteri speciali tranne un trattino (-). Il nome non può iniziare con - e nessuna due migrazioni a una destinazione server flessibile può avere lo stesso nome.
migration-mode	Questo è un parametro opzionale. Valore predefinito: offline. La migrazione offline comporta la copia dei database di origine in un momento specifico nel server di destinazione.
migration-option	Consente di eseguire convalide prima di attivare una migrazione. Il valore predefinito è ValidateAndMigrate. I valori consentiti sono: eseguire la migrazione, convalidare, convalidareeMigrate.
properties	Percorso assoluto di un file JSON con le informazioni sul server di origine

È necessario fornire un file JSON con il percorso assoluto come parametro durante l'avvio della migrazione.

Il file JSON contiene le informazioni seguenti:

Nome proprietà	Descrizione
sourceDbServerResourceId	Dettagli del server di origine nel formato per macchine virtuali (VM) locali, AWS - <<hostname or IP address>>:<<port>>@<<username>>
AdminCredentials	Questo parametro elenca le password per gli utenti amministratori sia per il server di origine che per il server flessibile PostgreSQL di destinazione. Queste password consentono di eseguire l'autenticazione nei server di origine e di destinazione
targetServerUserName	Il valore predefinito è l'utente amministratore creato durante la creazione del server flessibile e la password specificata viene usata per l'autenticazione per l'utente. Se non si usa l'utente predefinito, questo parametro è l'utente o il ruolo nel server di destinazione per la migrazione. L'utente deve essere membro dei ruoli di azure_pg_admin, pg_read_all_settings, pg_read_all_stats e pg_stat_scan_tables e deve avere il ruolo Create DB
dbsToMigrate	Specificare l'elenco di database di cui si vuole eseguire la migrazione al server flessibile. È possibile includere un massimo di otto nomi di database alla volta. Specificare l'elenco di database in formato matrice.
OverwriteDBsInTarget	Se è impostata su true (impostazione predefinita), se il server di destinazione ha un database esistente con lo stesso nome di quello di cui si sta tentando di eseguire la migrazione, lo strumento di migrazione sovrascrive automaticamente il database
MigrationMode	Modalità della migrazione. Il valore supportato è "Offline"
sourceType	Parametro obbligatorio. I valori possono essere : OnPremises, AWS, AzureVM, PostgreSQLSingleServer
sslMode	Modalità SSL per la migrazione. La modalità SSL per PostgreSQLSingleServer è VerifyFull e Prefer/Require per altri tipi di origine

Comando list

Il comando list elenca tutti i tentativi di migrazione eseguiti a una destinazione Database di Azure per PostgreSQL.

az postgres flexible-server migration list [--subscription] [--resource-group][--name] [--filter]

Nome parametro	Descrizione
subscription	ID sottoscrizione della destinazione del server flessibile PostgreSQL
resource-group	Gruppo di risorse di destinazione del server flessibile PostgreSQL
name	Nome della destinazione del server flessibile PostgreSQL
filter	Per filtrare le migrazioni, sono supportati due valori: Active e All

Comando show

Il comando show consente di monitorare le migrazioni in corso e fornisce lo stato corrente e lo stato secondario della migrazione. Questi dettagli includono informazioni sullo stato corrente e sullo stato secondario della migrazione.

az postgres flexible-server migration show [--subscription][--resource-group][--name][--migration-name]

Nome parametro	Descrizione
subscription	ID sottoscrizione della destinazione del server flessibile PostgreSQL
resource-group	Gruppo di risorse di destinazione del server flessibile PostgreSQL
name	Nome della destinazione del server flessibile PostgreSQL
migration-name	Identificatore univoco per le migrazioni tentate di eseguire il server flessibile. Questo campo accetta solo caratteri alfanumerici e non accetta caratteri speciali tranne un trattino (-). Il nome non può iniziare con - e nessuna due migrazioni a una destinazione server flessibile può avere lo stesso nome.

Stati diversi supportati all'interno del comando show

Stato migrazione	Descrizione
InProgress	L'infrastruttura di migrazione è configurata o la migrazione effettiva dei dati è in corso
Canceled	La migrazione viene annullata o eliminata
Failed	La migrazione non è riuscita
Succeeded	La migrazione è stata completata e completata
WaitingForUserAction	Applicabile solo per la migrazione online. In attesa dell'azione dell'utente per eseguire il cutover
ValidationFailed	La convalida a livello di database o server non è riuscita

Stati secondari diversi supportati all'interno del comando show per la migrazione

SubState della migrazione	Descrizione
PerformingPreRequisiteSteps	L'infrastruttura è configurata e viene preparata per la migrazione dei dati
MigratingData	La migrazione dei dati è in corso
Completed	La migrazione è stata completata
Failed	La migrazione non è riuscita
Validation in Progress	La convalida è in corso
CompletingMigration	La migrazione è nelle fasi finali del completamento

I dettagli di convalida sono a livello di istanza e database

• Convalida a livello di istanza

  • Contiene la convalida correlata al controllo della connettività, alla versione di origine, ovvero alla versione >postgreSQL = 9.5, al controllo dei parametri del server, ovvero se le estensioni sono abilitate nei parametri del server del server Database di Azure per PostgreSQL - server flessibile.

• Convalida a livello di database

  • Contiene la convalida dei singoli database correlati alle estensioni, il supporto delle regole di confronto in Database di Azure per PostgreSQL - server flessibile.

Stati secondari diversi supportati all'interno del comando show per la convalida.

Stato secondario di convalida	Descrizione
Failed	La convalida non è riuscita
Succeeded	La convalida ha esito positivo
Warning	La convalida è in Avviso. Gli avvisi sono messaggi informativi da tenere presenti durante la pianificazione della migrazione

Annullare la migrazione

È possibile annullare qualsiasi tentativo di migrazione in corso usando il cancel comando . Questo comando arresta il tentativo di migrazione specifico, ma non rilascia o esegue il rollback delle modifiche nel server di destinazione. Ecco il comando dell'interfaccia della riga di comando per eliminare una migrazione:

az postgres flexible-server migration update cancel [--subscription][--resource-group][--name][--migration-name]

Ad esempio:

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

Per altre informazioni su questo comando, usare il help parametro :

az postgres flexible-server migration update cancel -- help

Connessione all'origine

Verrà eseguita la migrazione di "ticketdb","inventorydb","salesdb" in Database di Azure per PostgreSQL server flessibile.

Eseguire la migrazione tramite l'interfaccia della riga di comando

• Aprire il prompt dei comandi e accedere ad Azure usando az login il comando

  

• Modificare i segnaposto << >> seguenti nelle righe JSON e archiviarli nel computer locale come <<filename>>.json in cui viene richiamata l'interfaccia della riga di comando. In questa esercitazione il file è stato salvato in C:\migration-CLI\migration_body.json

  {
  "properties": {
  "SourceDBServerResourceId": "<<source hostname or IP address>>:<<port>>@<<username>>",
          "SecretParameters": {
              "AdminCredentials": {
                  "SourceServerPassword": "<<Source Password>>",
                  "TargetServerPassword": "<<Target Password>>"
              }
          },
       "targetServerUserName":"<<Target username>>",
          "DBsToMigrate": [
             "<<comma separated list of databases like - "ticketdb","timedb","salesdb">>"
          ],
          "OverwriteDBsInTarget": "true",
          "MigrationMode": "Offline",
          "sourceType": "AzureVM",
          "sslMode": "Prefer"
      }
  }
  

• Eseguire il comando seguente per verificare se sono in esecuzione migrazioni. Il nome della migrazione è univoco tra le migrazioni all'interno della destinazione del server flessibile Database di Azure per PostgreSQL.

  az postgres flexible-server migration list --subscription <<subscription ID>> --resource-group <<resource group name>> --name <<Name of the Flexible Server>> --filter All
  

  

• Nei passaggi precedenti non sono state eseguite migrazioni, quindi si inizia con la nuova migrazione eseguendo il comando seguente

  az postgres flexible-server migration create --subscription <<subscription ID>> --resource-group <<resource group name>> --name <<Name of the Flexible Server>> --migration-name <<Unique Migration Name>> --migration-option ValidateAndMigrate --properties "C:\migration-cli\migration_body.json"
  

• Eseguire il comando seguente per avviare lo stato della migrazione nel passaggio precedente. È possibile controllare lo stato della migrazione specificando il nome della migrazione

  az postgres flexible-server migration show --subscription <<subscription ID>> --resource-group <<resource group name>> --name <<Name of the Flexible Server>> --migration-name <<Migration ID>>
  

• Lo stato dello stato di avanzamento della migrazione viene visualizzato nell'interfaccia della riga di comando.

  

• È anche possibile visualizzare lo stato nel portale del server flessibile Database di Azure per PostgreSQL.

  

Annullare la migrazione tramite l'interfaccia della riga di comando

È possibile annullare qualsiasi tentativo di migrazione in corso usando il cancel comando . 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 per eliminare una migrazione:

az postgres flexible-server migration update cancel [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--migration-name]

Ad esempio:

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

Per altre informazioni su questo comando, usare il help parametro :

 az postgres flexible-server migration update cancel -- help

Il comando fornisce l'output seguente:

---

Dopo la migrazione

Dopo aver completato i database, è necessario convalidare manualmente i dati tra origine e destinazione e verificare che tutti gli oggetti nel database di destinazione siano stati creati correttamente.

Dopo la migrazione, è possibile eseguire le attività seguenti:

• Verificare i dati nel server flessibile e assicurarsi che si tratti di una copia esatta dell'istanza di origine.

• Dopo la verifica, abilitare l'opzione a disponibilità elevata nel server flessibile in base alle esigenze.

• Modificare lo SKU del server flessibile in modo che corrisponda alle esigenze dell'applicazione. Questa modifica richiede un riavvio del server di database.

• Se si modificano i parametri del server dai relativi valori predefiniti nell'istanza di origine, copiare i valori dei parametri del server nel server flessibile.

• Copiare altre impostazioni del server, ad esempio tag, avvisi e regole del firewall (se applicabile) dall'istanza di origine al server flessibile.

• Apportare modifiche all'applicazione per puntare le stringa di connessione a un server flessibile.

• Monitorare attentamente le prestazioni del database per verificare se richiede l'ottimizzazione delle prestazioni.

Contenuto correlato

• Servizio di migrazione
• Eseguire la migrazione da AWS RDS
• Procedure consigliate
• Problemi noti e limitazioni
• Configurazione di rete
• Convalide di premi