Visualizzare e gestire l'avanzamento della migrazione

Per le migrazioni eterogenee da Oracle ad AlloyDB per PostgreSQL, puoi monitorare e gestire l'avanzamento della migrazione per l'intero job di migrazione o per singole tabelle incluse nel job di migrazione.

Questa pagina descrive le azioni che puoi intraprendere a ogni livello. Per saperne di più, consulta le sezioni Gestisci i job di migrazione e Gestisci singole tabelle.

Gestione dei job di migrazione

Nella console Google Cloud puoi eseguire azioni collettive per i job di migrazione con lo stesso stato. Puoi eseguire azioni su un singolo job di migrazione sia nella console Google Cloud (dalla console di Database Migration Service o direttamente dalla pagina del cluster AlloyDB per PostgreSQL di destinazione) sia utilizzando Google Cloud CLI.

Puoi eseguire una delle seguenti azioni sul job di migrazione:

Azione Descrizione
Avvio Avvia i job di migrazione che non sono in stato In esecuzione o In fase di avvio. Consulta Stati dei job di migrazione.
Interrompi Interrompi un job di migrazione in esecuzione. Lo spostamento dei dati è in pausa. Lo stato del job di migrazione cambia prima in Stopping e poi in Stopped. Puoi riprendere, eliminare o promuovere un job di migrazione interrotto.

Per le migrazioni continue: in alcuni casi, il database di origine deve conservare i dati finché non riprendi il job di migrazione. Il periodo di conservazione del database di origine potrebbe essere limitato. Se il job di migrazione viene messo in pausa per un periodo di tempo superiore a quello di conservazione e poi viene ripreso, il job di migrazione potrebbe non riuscire. In questo caso, elimina o riavvia il job di migrazione.

Riprendi Quando riprendi un job di migrazione, Database Migration Service riprende le operazioni di spostamento dei dati:
  • Per le migrazioni continue interrotte durante la fase CDC, Database Migration Service riprende la replica degli eventi di modifica che si accumulano quando il job di migrazione viene interrotto.
  • Per i job di migrazione interrotti durante la fase di dump completo (una migrazione una tantum o continua), Database Migration Service riprende la copia dei dati che non ha copiato prima dell'interruzione della migrazione.
Riavvia

Puoi riavviare un job di migrazione che ha riscontrato un errore e non può procedere con la replica dei dati.

Il risultato del riavvio di un job di migrazione dipende dal motivo per cui non è riuscito:

  • Se la replica non è riuscita a causa di un errore in una o più tabelle del database di origine o di destinazione, il riavvio del job di migrazione cancella tutti i dati dalle tabelle del database di destinazione incluse nel job di migrazione.
  • Il riavvio del job di migrazione non comporta la replica da parte di Database Migration Service delle nuove tabelle create nel database di origine. Devi prima aggiungere le tabelle al workspace della conversione e convertire il relativo schema.
Modifica Consulta Modifica un job di migrazione.
Elimina Un job di migrazione può essere eliminato. Il risultato dipende dallo stato del job:
  • Se il job di migrazione è nello stato Completed, il record viene eliminato dall'elenco dei job di migrazione.
  • Se il job di migrazione è in un altro stato, puoi scegliere di eliminare il cluster AlloyDB per PostgreSQL di destinazione associato.
Promuovi Durante il processo di migrazione, il database di destinazione viene impostato in uno stato di sola lettura in cui è completamente gestito da Database Migration Service. Quando vuoi passare l'applicazione al database di destinazione di cui è stata eseguita la migrazione, la promozione del job di migrazione aggiorna il database di destinazione in una replica autonoma. Consulta Promuovi una migrazione.

Revisione di un job di migrazione

  1. Nella console Google Cloud , vai alla pagina Job di migrazione.

    Vai a Job di migrazione

  2. Seleziona un job di migrazione per visualizzare la relativa pagina dei dettagli, che include:
    • Metadati del job di migrazione, come nome visualizzato, ID, tipo di migrazione, profilo di connessione di origine, motore del database di origine, destinazione, metodo di connettività, data e ora di creazione del job di migrazione e durata dell'esecuzione del job di migrazione.
    • Stato e stato secondario del job di migrazione e informazioni aggiuntive. Sono disponibili diverse azioni a seconda dello stato e dello stato secondario del job di migrazione.

Avvia un job di migrazione

Una volta creato completamente il job di migrazione (ovvero, non è salvato in stato di bozza), puoi avviarlo in qualsiasi momento per iniziare la migrazione dei dati.

Per avviare un job di migrazione, segui questi passaggi:

Console

Puoi avviare un job di migrazione dalla console di Database Migration Service o dalla pagina dell'istanza di destinazione.

Dalla console di Database Migration Service:

  1. Nella console Google Cloud , vai alla pagina Job di migrazione.

    Vai a Job di migrazione

  2. Nella scheda Job, fai clic sul nome visualizzato del job di migrazione che vuoi avviare.

    Viene visualizzata la pagina dei dettagli del job di migrazione.

  3. Fai clic su Avvia.
  4. Nella finestra di dialogo, fai clic su Avvia.

Dall'istanza di destinazione:

  1. Nella console Google Cloud , vai alla pagina Cluster AlloyDB per PostgreSQL.

    Vai ai cluster AlloyDB per PostgreSQL

  2. Fai clic sul nome visualizzato del cluster di destinazione per la migrazione.

    Viene visualizzata la pagina dei dettagli del cluster.

  3. Nella sezione Migrazione, fai clic su Inizia.
  4. Nella finestra di dialogo, fai clic su Avvia.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • MIGRATION_JOB_ID con l'identificatore del job di migrazione.

    Se non conosci l'identificatore, puoi utilizzare il comando gcloud database-migration migration-jobs list per elencare tutti i job di migrazione in una determinata regione e visualizzarne gli identificatori.

  • REGION con l'identificatore della regione in cui è salvato il job di migrazione.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud database-migration migration-jobs \
start MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration migration-jobs `
start MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
start MIGRATION_JOB_ID ^
  --region=REGION

Risultato

L'azione viene eseguita in modo asincrono. Pertanto, questo comando restituisce un' entità Operation che rappresenta un'operazione a lunga esecuzione:

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID

Per verificare se l'operazione è riuscita, puoi eseguire una query sull'oggetto operazione restituito o controllare lo stato del job di migrazione:

Interrompi un job di migrazione

Puoi interrompere un job di migrazione in esecuzione in qualsiasi momento seguendo questi passaggi:

Console

Puoi interrompere un job di migrazione dalla console di Database Migration Service o dalla pagina dell'istanza di destinazione.

Dalla console di Database Migration Service:

  1. Nella console Google Cloud , vai alla pagina Job di migrazione.

    Vai a Job di migrazione

  2. Nella scheda Job, fai clic sul nome visualizzato del job di migrazione che vuoi interrompere.

    Viene visualizzata la pagina dei dettagli del job di migrazione.

  3. Fai clic su Arresta.
  4. Nella finestra di dialogo, fai clic su Interrompi.

Dall'istanza di destinazione:

  1. Nella console Google Cloud , vai alla pagina Cluster AlloyDB per PostgreSQL.

    Vai ai cluster AlloyDB per PostgreSQL

  2. Fai clic sul nome visualizzato del cluster di destinazione per la migrazione.

    Viene visualizzata la pagina dei dettagli del cluster.

  3. Nella sezione Migrazione, fai clic su Interrompi.
  4. Nella finestra di dialogo, fai clic su Interrompi.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • MIGRATION_JOB_ID con l'identificatore del job di migrazione.

    Se non conosci l'identificatore, puoi utilizzare il comando gcloud database-migration migration-jobs list per elencare tutti i job di migrazione in una determinata regione e visualizzarne gli identificatori.

  • REGION con l'identificatore della regione in cui è salvato il profilo di connessione.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud database-migration migration-jobs \
stop MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration migration-jobs `
stop MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
stop MIGRATION_JOB_ID ^
  --region=REGION

Risultato

L'azione viene eseguita in modo asincrono. Pertanto, questo comando restituisce un' entità Operation che rappresenta un'operazione a lunga esecuzione:

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: stop
name: OPERATION_ID
Per verificare se l'operazione è andata a buon fine, puoi eseguire una query sull'oggetto dell'operazione restituito o controllare lo stato del job di migrazione:

Riprendi un job di migrazione

Puoi riprendere un job di migrazione interrotto seguendo questi passaggi:

Console

Puoi riprendere un job di migrazione dalla console di Database Migration Service o dalla pagina dell'istanza di destinazione.

Dalla console di Database Migration Service:

  1. Nella console Google Cloud , vai alla pagina Job di migrazione.

    Vai a Job di migrazione

  2. Nella scheda Job, fai clic sul nome visualizzato del job di migrazione che vuoi riprendere.

    Viene visualizzata la pagina dei dettagli del job di migrazione.

  3. Fai clic su Riprendi.
  4. Nella finestra di dialogo, fai clic su Riprendi.

Dall'istanza di destinazione:

  1. Nella console Google Cloud , vai alla pagina Cluster AlloyDB per PostgreSQL.

    Vai ai cluster AlloyDB per PostgreSQL

  2. Fai clic sul nome visualizzato del cluster di destinazione per la migrazione.

    Viene visualizzata la pagina dei dettagli del cluster.

  3. Nella sezione Migrazione, fai clic su Riprendi.
  4. Nella finestra di dialogo, fai clic su Riprendi.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • MIGRATION_JOB_ID con l'identificatore del job di migrazione.

    Se non conosci l'identificatore, puoi utilizzare il comando gcloud database-migration migration-jobs list per elencare tutti i job di migrazione in una determinata regione e visualizzarne gli identificatori.

  • REGION con l'identificatore della regione in cui è salvato il profilo di connessione.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud database-migration migration-jobs \
resume MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration migration-jobs `
resume MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
resume MIGRATION_JOB_ID ^
  --region=REGION

Risultato

L'azione viene eseguita in modo asincrono. Pertanto, questo comando restituisce un' entità Operation che rappresenta un'operazione a lunga esecuzione:

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: resume
name: OPERATION_ID
Per verificare se l'operazione è andata a buon fine, puoi eseguire una query sull'oggetto dell'operazione restituito o controllare lo stato del job di migrazione:

Riavvia un job di migrazione

Quando riavvii un job di migrazione, Database Migration Service cancella tutti i dati dalle tabelle di destinazione. I dati di origine non sono interessati. Il processo di migrazione viene quindi avviato di nuovo, a partire dalla fase di dump completo.

Per riavviare un job di migrazione, segui questi passaggi:

Console

Puoi riavviare un job di migrazione dalla console di Database Migration Service o dalla pagina dell'istanza di destinazione.

Dalla console di Database Migration Service:

  1. Nella console Google Cloud , vai alla pagina Job di migrazione.

    Vai a Job di migrazione

  2. Nella scheda Job, fai clic sul nome visualizzato del job di migrazione che vuoi riavviare.

    Viene visualizzata la pagina dei dettagli del job di migrazione.

  3. Fai clic su Restart (Riavvia).
  4. Nella finestra di dialogo, fai clic su Riavvia.

Dall'istanza di destinazione:

  1. Nella console Google Cloud , vai alla pagina Cluster AlloyDB per PostgreSQL.

    Vai ai cluster AlloyDB per PostgreSQL

  2. Fai clic sul nome visualizzato del cluster di destinazione per la migrazione.

    Viene visualizzata la pagina dei dettagli del cluster.

  3. Nella sezione Migrazione, fai clic su Riavvia.
  4. Nella finestra di dialogo, fai clic su Riavvia.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • MIGRATION_JOB_ID con l'identificatore del job di migrazione.

    Se non conosci l'identificatore, puoi utilizzare il comando gcloud database-migration migration-jobs list per elencare tutti i job di migrazione in una determinata regione e visualizzarne gli identificatori.

  • REGION con l'identificatore della regione in cui è salvato il job di migrazione.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud database-migration migration-jobs \
restart MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration migration-jobs `
restart MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
restart MIGRATION_JOB_ID ^
  --region=REGION

Risultato

L'azione viene eseguita in modo asincrono. Pertanto, questo comando restituisce un' entità Operation che rappresenta un'operazione a lunga esecuzione:

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: restart
name: OPERATION_ID
Per verificare se l'operazione è andata a buon fine, puoi eseguire una query sull'oggetto dell'operazione restituito o controllare lo stato del job di migrazione:

Aggiorna una bozza di job di migrazione

Per completare la creazione di un job di migrazione, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Job di migrazione.

    Vai a Job di migrazione

  2. Nella scheda Bozze, fai clic sul nome visualizzato del job di migrazione di cui vuoi completare la creazione.

    Viene visualizzata la procedura guidata per la creazione del job di migrazione.

  3. Completa la creazione del job di migrazione. Consulta Crea un job di migrazione.

Modifica un job di migrazione

Puoi modificare le informazioni di configurazione per l'origine, ad esempio le tabelle e gli schemi del database nell'origine di cui Database Migration Service eseguirà la migrazione alla destinazione. Database Migration Service utilizza queste informazioni di configurazione per eseguire la migrazione dei dati corretti dall'origine alla destinazione.

Aggiungi o rimuovi oggetti dalla migrazione

Per aggiungere o rimuovere tabelle o schemi dalla migrazione:

  1. Vai alla pagina Job di migrazione nella console Google Cloud .

    Vai a Job di migrazione

  2. Fai clic sul nome visualizzato del job di migrazione che vuoi modificare. Viene visualizzata una pagina di riepilogo del job di migrazione.

  3. Nella sezione Seleziona gli oggetti di cui eseguire la migrazione, seleziona o deseleziona le caselle di controllo per modificare le tabelle e gli schemi nell'origine di cui Database Migration Service eseguirà la migrazione nella destinazione.

  4. Fai clic su Salva o Salva e riavvia.

    • Se fai clic su Salva, Database Migration Service sposterà solo i dati storici per gli schemi e le tabelle selezionati.

    • Se fai clic su Salva e riavvia, Database Migration Service avvierà la migrazione dall'inizio, dopo aver pulito tutte le tabelle selezionate nella destinazione.

Regola il numero massimo di connessioni simultanee al database di origine

Puoi personalizzare il numero massimo di connessioni simultanee che Database Migration Service può stabilire con l'istanza di origine per la fase di dump completo o la fase CDC.

  1. Vai alla pagina Job di migrazione nella console Google Cloud .

    Vai a Job di migrazione

  2. Fai clic sul nome visualizzato del job di migrazione che vuoi modificare. Viene visualizzata una pagina di riepilogo per il job di migrazione.

  3. Espandi la sezione Personalizza la configurazione di origine > Impostazioni di lettura dell'origine.

  4. Nelle sezioni Numero massimo di connessioni di dump complete contemporanee o Numero massimo di connessioni CDC contemporanee, utilizza il campo Personalizzato per inserire il limite massimo di connessioni per le fasi di dump completo o CDC.

  5. Fai clic su Salva o Salva e riavvia.

Modifica le impostazioni di configurazione della destinazione

Puoi personalizzare il timeout delle transazioni e il numero massimo di connessioni simultanee per il database di destinazione:

  1. Vai alla pagina Job di migrazione nella console Google Cloud .

    Vai a Job di migrazione

  2. Fai clic sul nome visualizzato del job di migrazione che vuoi modificare.

    Viene visualizzata una pagina di riepilogo del job di migrazione.

  3. Espandi la sezione Personalizza configurazione della destinazione e modifica le seguenti impostazioni:
    Numero massimo di connessioni contemporanee di destinazione

    Valore predefinito: 128

    Valori consentiti: minimo 2, massimo 256

    Puoi personalizzare il numero massimo di connessioni simultanee che Database Migration Service può stabilire con l'istanza di destinazione.

    Database Migration Service regola il numero di connessioni per garantire le migliori prestazioni entro il limite di connessioni fornito. L'aumento del limite massimo di connessioni può migliorare la velocità di migrazione, ma introduce un carico aggiuntivo sui database di destinazione.

    Timeout della transazione

    Valore predefinito: 30

    Valori consentiti: minimo 30, massimo 300

    Durante il processo di migrazione, Database Migration Service può riscontrare alcuni problemi che causano il timeout della transazione. Puoi modificare il numero di secondi che Database Migration Service attende per il completamento della transazione prima che venga annullata.

    Le transazioni annullate non causano l'errore del job di migrazione. Il job di migrazione continua a copiare i dati, ma passa allo stato In esecuzione con errori. Puoi visualizzare i dettagli del job di migrazione per verificare quali problemi devono essere risolti.

  4. Fai clic su Salva o Salva e riavvia.

Testa un job di migrazione

Prima di eseguire il job di migrazione, puoi eseguire un'operazione di test per verificare se Database Migration Service può raggiungere tutte le entità di origine e di destinazione necessarie. Nella console Google Cloud , puoi testare solo le bozze dei job di migrazione che crei nella procedura guidata di creazione dei job di migrazione (consulta Crea un job di migrazione).

Con gcloud CLI, puoi testare i job di migrazione creati, ma non ancora avviati.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • MIGRATION_JOB_ID con l'identificatore del job di migrazione.

    Se non conosci l'identificatore, puoi utilizzare il comando gcloud database-migration migration-jobs list per elencare tutti i job di migrazione in una determinata regione e visualizzarne gli identificatori.

  • REGION con l'identificatore della regione in cui è salvato il profilo di connessione.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud database-migration migration-jobs \
verify MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration migration-jobs `
verify MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
verify MIGRATION_JOB_ID ^
  --region=REGION

Risultato

L'azione viene eseguita in modo asincrono. Pertanto, questo comando restituisce un' entità Operation che rappresenta un'operazione a lunga esecuzione:

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: verify
name: OPERATION_ID
Per verificare se l'operazione è andata a buon fine, puoi eseguire una query sull'oggetto dell'operazione restituito o controllare lo stato del job di migrazione:

Gestisci singole tabelle

Per le migrazioni eterogenee da Oracle ad AlloyDB per PostgreSQL, puoi visualizzare i dettagli dello stato di tabelle specifiche incluse nel job di migrazione.

Visualizza tutte le tabelle di un job

Per visualizzare i dettagli di tutte le tabelle in un job di migrazione:

Console

  1. Nella console Google Cloud , vai alla pagina Job di migrazione.

    Vai a Job di migrazione

  2. Nella scheda Job, fai clic sul nome visualizzato del job di migrazione.

    Viene visualizzata la pagina dei dettagli del job di migrazione.

  3. Seleziona la scheda Tabelle e visualizza tutte le tabelle incluse nel job. Puoi anche utilizzare i filtri interattivi per restringere l'elenco.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • MIGRATION_JOB_ID con l'identificatore del job di migrazione.

    Se non conosci l'identificatore, puoi utilizzare il comando gcloud database-migration migration-jobs list per elencare tutti i job di migrazione in una determinata regione e visualizzarne gli identificatori.

  • REGION con l'identificatore della regione in cui è salvato il job di migrazione.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud database-migration objects list \
  --migration-job=MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration objects list `
  --migration-job=MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration objects list ^
  --migration-job=MIGRATION_JOB_ID ^
  --region=REGION

Risultato

Questo comando restituisce i dettagli di stato, fase ed errore per tutte le tabelle incluse nel job di migrazione, separati da righe vuote.

SOURCE_OBJECT: {'schema': 'Schema1', 'table': 'MyTable1', 'type': 'TABLE'}
STATE: RUNNING
PHASE: CDC
ERROR: {}

SOURCE_OBJECT: {'schema': 'Production', 'table': 'MyTable2', 'type': 'TABLE'}
STATE: RUNNING
PHASE: FULL_DUMP
ERROR:
  { 'code': 2,
    'details': [
        { '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
          'domain': 'datamigration.googleapis.com',
          'metadata': {
            'errorMessage': '[DATABASE] error trying to write processed rows.
              Line: 2619 Position: 0 Schema: production Table: mytable2',
            'errorScope': 'NON_GLOBAL',
            'objectId': 'Production_MyTable2',
            'projectName': 'PROJECT_ID',
            'resourceName': 'MIGRATION_JOB_ID',
            'severity': 'ERROR'
          },
          'reason': 'DESTINATION_WRITE_ERROR'
        }
      ],
    'message': 'Encountered errors with your migration job table. Check the `details`
                  array for specific information on each issue.'
  }

Visualizza i dettagli di una singola tabella

Per visualizzare i dettagli della migrazione di una singola tabella:

Console

  1. Nella console Google Cloud , vai alla pagina Job di migrazione.

    Vai a Job di migrazione

  2. Nella scheda Job, fai clic sul nome visualizzato del job di migrazione.

    Viene visualizzata la pagina dei dettagli del job di migrazione.

  3. Seleziona la scheda Tabelle e fai clic sulla tabella che vuoi esaminare. Puoi anche utilizzare i filtri interattivi per restringere l'elenco.

    Si apre il riquadro laterale dei dettagli della tabella.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • MIGRATION_JOB_ID con l'identificatore del job di migrazione.

    Se non conosci l'identificatore, puoi utilizzare il comando gcloud database-migration migration-jobs list per elencare tutti i job di migrazione in una determinata regione e visualizzarne gli identificatori.

  • REGION con l'identificatore della regione in cui è salvato il job di migrazione.
  • SCHEMA_NAME con il nome dello schema principale che contiene la tabella.
  • TABLE_NAME con il nome della tabella.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud database-migration objects lookup \
  --migration-job=MIGRATION_JOB_ID \
  --region=REGION \
  --schema=SCHEMA_NAME \
  --table=TABLE_NAME

Windows (PowerShell)

gcloud database-migration objects lookup `
  --migration-job=MIGRATION_JOB_ID `
  --region=REGION `
  --schema=SCHEMA_NAME `
  --table=TABLE_NAME

Windows (cmd.exe)

gcloud database-migration objects lookup ^
  --migration-job=MIGRATION_JOB_ID ^
  --region=REGION ^
  --schema=SCHEMA_NAME ^
  --table=TABLE_NAME

Risultato

Questo comando restituisce lo stato, la fase, l'ora di creazione e i dettagli degli errori della tabella. L'intera risposta è una stringa su più righe formattata in YAML. Ad esempio:

createTime: '2025-06-02T10:20:29.792832Z'
error:
  code: 2
  details:
  - '@type': type.googleapis.com/google.rpc.ErrorInfo
    domain: datamigration.googleapis.com
    metadata:
      errorMessage: '[DATABASE] error trying to write processed rows.
              Line: 2619 Position: 0 Schema: production Table: mytable2'
      errorScope: NON_GLOBAL
      objectId: Production_MyTable2
      projectName: PROJECT_ID
      resourceName: MIGRATION_JOB_ID
      severity: ERROR
    reason: DESTINATION_WRITE_ERROR
  message: Encountered errors with your migration job table. Check the `details` array
    for specific information on each issue.
name: projects/PROJECT_ID/locations/REGION/migrationJobs/MIGRATION_JOB_ID/objects/TABLE_UUID
phase: FULL_DUMP
sourceObject:
  schema: Production
  table: MyTable2
  type: TABLE
state: RUNNING