Condividi tramite

Come configurare Azure CLI per il servizio di migrazione nel server flessibile Azure Database per PostgreSQL

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.

Passaggi per configurare i comandi CLI

  1. Installare l'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.

  2. 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. Usare il comando az --version per controllare la versione corrente.

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

Dopo aver installato la CLI, apri il prompt dei comandi e accedi all'account Azure usando il comando seguente.

az login

Eseguire la migrazione dei comandi

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

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. Facilita la migrazione dei database da un'istanza PostgreSQL di origine a un'istanza di destinazione di Azure Database 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

State Descrizione
InProgress È in corso la configurazione dell'infrastruttura di migrazione oppure è in corso la migrazione effettiva dei dati.
Canceled 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 è completa.
Non riuscito Migrazione non riuscita.

Stati secondari della convalida

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

Comando update

Il az postgres flexible-server migration update comando viene usato per gestire il processo di migrazione in un server flessibile di Database di Azure per PostgreSQL. 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. Se l'origine presenta traffico elevato, è consigliabile arrestare prima le scritture in modo che Latency possa avvicinarsi a 0 e successivamente avviare il 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 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 database di Azure per PostgreSQL - Server singolo, perché prepara il server per la replica dei dati nel server flessibile.

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

Summary

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

Parametro Comandi pertinenti Descrizione
subscription creare, elencare, mostrare, aggiornare ID sottoscrizione del server flessibile PostgreSQL
resource-group creare, elencare, mostrare, aggiornare Gruppo di risorse del server flessibile PostgreSQL
name crea, elenca, mostra Nome del server flessibile PostgreSQL
migration-name creare, mostrare, aggiornare Identificatore univoco per le migrazioni tentate verso un server flessibile. Questo campo accetta solo caratteri alfanumerici e non accetta caratteri speciali tranne il trattino (-). Il nome non può iniziare con -, e nessuna delle due migrazioni a un server flessibile di destinazione può avere lo stesso nome.
filter list Per filtrare le migrazioni, sono supportati due valori: Attivo e Tutti
help creare, elencare, mostrare, aggiornare Fornisce informazioni su ogni comando.
migration-mode create Questo parametro è facoltativo. 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 sul 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. Fornitura dell'elenco dei database in formato array.
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>>
sourceDBServerFullyQualifiedDomainName Obbligatorio solo se l'origine è un server singolo e si trova dietro un server DNS personalizzato, spazi dei nomi DNS personalizzati, FQDN personalizzato o deve essere accessibile tramite IP.
targetDBServerFullyQualifiedDomainName Obbligatorio solo se la destinazione si trova dietro un server DNS personalizzato, namespace DNS personalizzati, FQDN personalizzato o deve essere accessibile tramite un indirizzo IP.
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.

Contenuti correlati

  • Last updated on