Condividi tramite

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

  • Articolo

L'interfaccia della riga di comando di Azure è un set di comandi utilizzati nei servizi di Azure per creare e gestire le risorse. Offre le stesse funzionalità del portale di Azure, ma è ottimizzata per gli utenti che preferiscono lavorare all'interno di un ambiente della riga di comando. Per iniziare la migrazione usando l'interfaccia della riga di comando di Azure, è necessario installare questa interfaccia nel computer locale.

Prerequisiti

  • Installare l'interfaccia della riga di comando di Azure: a seconda del sistema operativo, scaricare e installare l'interfaccia della riga di comando di Azure. È disponibile per Windows, macOS e Linux.
  • Guida all'installazione dell'interfaccia della riga di comando di Azure: seguire le istruzioni fornite nella documentazione ufficiale di Azure per installare l'interfaccia della riga di comando di Azure, Come installare l'interfaccia della riga di comando di Azure.
  • Controllare la versione dell'interfaccia della riga di comando di Azure: assicurarsi che la versione dell'interfaccia della riga di comando di Azure sia almeno 2.56.0 o successiva, perché è quella richiesta dal servizio di migrazione. Usare il comando az --version per controllare la versione corrente.
  • Accedere ad Azure: dopo l'installazione, eseguire az login per effettuare l'autenticazione. Verrà aperto il browser predefinito per completare il processo di accesso mediante le credenziali di Azure.

Questi passaggi preparano l'ambiente per l'utilizzo dell'interfaccia della riga di comando di Azure per una gestione efficace del servizio di migrazione in Database di Azure per PostgreSQL. Per eventuali aggiornamenti o modifiche al processo di installazione, fare sempre riferimento alla documentazione più recente di Azure.

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

az login

Eseguire la migrazione dei comandi

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

Comando help

Il comando --help nell'interfaccia della riga di comando di Azure è un'opzione utile che fornisce una documentazione dettagliata sui comandi e sui relativi sottocomandi, inclusi i verbi necessari per le operazioni. Il comando –-help mostra i comandi necessari e le azioni associate al servizio di migrazione in Database di Azure per PostgreSQL.

az postgres flexible-server migration –-help

L'output illustra i passaggi e i parametri necessari per gestire in modo efficace le migrazioni di database mediante l'interfaccia della riga di comando di Azure.

Creare il comando

Il comando az postgres flexible-server migration create nell'interfaccia della riga di comando di Azure viene usato per avviare un nuovo flusso di lavoro di migrazione. Semplifica la migrazione dei database da un'istanza PostgreSQL di origine a un'istanza di destinazione di Database di Azure per PostgreSQL - Server flessibile. Questo comando configura i parametri e le configurazioni necessari per garantire un processo di migrazione uniforme ed efficiente.

Per altre informazioni, vedere az postgres flexible-server migration create

Comando elenco

Il comando az postgres flexible-server migration list viene usato per elencare tutti i tentativi di migrazione effettuati a una destinazione di Database di Azure per PostgreSQL. Questo comando offre una panoramica delle migrazioni avviate, consentendo di tenere traccia dello stato e dei dettagli di ogni tentativo di migrazione.

Per altre informazioni, vedere az postgres flexible-server migration list

Mostra comando

Il comando az postgres flexible-server migration show consente di monitorare le migrazioni in corso e fornisce lo stato e lo stato secondario attuali della migrazione. Questi dettagli includono informazioni sullo stato e sullo stato secondario attuali della migrazione.

Per altre informazioni, vedere az postgres flexible-server migration show

I possibili stati della migrazione includono:

Stati della migrazione

Stato Descrizione
InProgress È in corso la configurazione dell'infrastruttura di migrazione oppure è in corso la migrazione effettiva dei dati.
Annullata La migrazione viene annullata o eliminata.
Non riuscito La migrazione non è riuscita.
Convalida non riuscita La convalida non è riuscita.
Completato La migrazione è riuscita ed è stata completata.
WaitingForUserAction Applicabile solo per la migrazione online. In attesa dell'azione di cutover da parte dell'utente.

Stati secondari della migrazione

Sottostato Descrizione
PerformingPreRequisiteSteps La configurazione dell'infrastruttura è in corso per la migrazione dei dati.
Convalida in corso La convalida è in esecuzione.
MigratingData La migrazione dei dati è in corso.
CompletingMigration La migrazione è nelle fasi finali del completamento.
Completato La migrazione è stata completata.
Non riuscito La migrazione non è riuscita.

Stati secondari della convalida

Sottostato Descrizione
Non riuscito Convalida non riuscita.
Completato La convalida ha avuto esito positivo.
Avvertenza La convalida è in stato di avviso.

Comando update

Il comando az postgres flexible-server migration update viene usato per gestire il processo di migrazione a Database di Azure per PostgreSQL - Server flessibile. In particolare, può essere usato per:

  • Eseguire un cutover: consente di finalizzare il processo di migrazione passando il traffico del database dal server di origine al server flessibile di destinazione.
    • Al termine della migrazione dei dati di base, l'attività di migrazione passa allo stato secondario WaitingForCutoverTrigger. In questo stato, gli utenti possono attivare il cutover dal portale selezionando il nome della migrazione nella griglia di migrazione o tramite l'interfaccia della riga di comando.
    • Prima di avviare il cutover, è importante assicurarsi che:
      • Le scritture nell'origine vengano arrestate
      • Il valore latency diminuisca fino a 0 o vicino allo 0
      • Il valore latency indichi quando è avvenuta l'ultima sincronizzazione della destinazione con l'origine. A questo punto, le scritture nell'origine possono essere arrestate e il cutover può essere avviato. Nel caso in cui si verifichi un traffico elevato nell'origine, è consigliabile arrestare prima le scritture in modo che Latency possa avvicinarsi a 0 e successivamente il cutover possa essere avviato.
      • 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 il valore Latency diverso da zero, la replica si arresta fino a quel momento. Tutti i dati nell'origine fino al momento del cutover vengono quindi applicati alla destinazione. Si supponga che la latenza fosse di 15 minuti nel punto di cutover, tutti i dati delle modifiche apportate negli ultimi 15 minuti si applicano quindi alla destinazione.
  • Annullare la migrazione: se necessario, questa opzione consente di arrestare il processo di migrazione.
  • Configurare la replica logica nell'origine: è utile quando il server di origine è un server singolo di Database di Azure per PostgreSQL, in quanto prepara il server per la replica dei dati nel server flessibile.

Per altre informazioni, vedere az postgres flexible-server migration update

Riepilogo

La tabella seguente riepiloga i parametri usati dai comandi di migrazione:

Parametro Comandi pertinenti Descrizione
subscription create, list, show, update ID sottoscrizione del server flessibile PostgreSQL
resource-group create, list, show, update Gruppo di risorse del server flessibile PostgreSQL
name create, list, show Nome del server flessibile PostgreSQL
migration-name create, show, update Identificatore univoco per le migrazioni tentate verso il server flessibile. Questo campo accetta solo caratteri alfanumerici e non accetta caratteri speciali tranne il trattino (-). Il nome non può iniziare con - e due migrazioni verso la stessa destinazione del server flessibile non possono avere lo stesso nome.
filter list Per filtrare le migrazioni, sono supportati due valori: Attivo e Tutti
help create, list, show, update Fornisce informazioni su ogni comando.
migration-mode create Questo è un parametro opzionale. I valori consentiti sono offline e online. Valore predefinito: Offline.
migration-option create Consente di eseguire convalide prima di attivare una migrazione. Il valore predefinito è ValidateAndMigrate. I valori consentiti sono: esegui la migrazione, convalida, ValidateAndMigrate.
properties create Percorso assoluto di un file JSON con informazioni sull'origine, sul server di destinazione, sui database di cui eseguire la migrazione, sulle modalità SSL, sulla definizione dei tipi di origine

Dettagli del file JSON

Il comando az postgres flexible-server migration create richiede un percorso di file JSON come parte del parametro --properties, che contiene i dettagli di configurazione per la migrazione, ad esempio l'ID risorsa del server di database di origine, le credenziali di amministratore, i database di cui eseguire la migrazione e altre impostazioni importanti. Di seguito sono riportate le diverse proprietà:

Nome proprietà Descrizione
sourceDbServerResourceId Dettagli del server di origine nel formato per macchine virtuali (VM) locali, servizio PostgreSQL basato su cloud - <<hostname or IP address>>:<<port>>@<<username>>. Se il server di origine è Database di Azure per PostgreSQL - Server singolo, l'ID risorsa è nel formato: /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>
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. Include due sottoproprietà, sourceServerPassword e targetServerPassword
targetServerUserName Il valore predefinito è l'utente amministratore creato durante la creazione del server flessibile di destinazione PostgreSQL e la password specificata viene usata per l'autenticazione per questo utente.
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 impostato 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, il servizio di migrazione sovrascrive automaticamente il database
migrationRuntimeResourceId Obbligatorio se è necessario usare un server di runtime per la migrazione. Il formato è - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL Flexible Server name>>
sourceType Parametro obbligatorio. I valori possono essere: locale, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode Modalità SSL per la migrazione. La modalità SSL per PostgreSQLSingleServer è VerifyFull e Prefer/Require per altri tipi di origine.

Contenuto correlato