Creare uno spazio di lavoro di conversione e convertire lo schema

Questa pagina mostra come creare un workspace della conversione e utilizzarlo per eseguire immediatamente la conversione deterministica di codice e schema da Oracle a PostgreSQL.

Puoi creare workspace della conversione interattivi in due modi:

  • Tramite una connessione diretta al database: Database Migration Service si connette direttamente al database di origine in esecuzione tramite un profilo di connessione e recupera lo schema tramite una connessione di rete.

  • Con i file di schema in Cloud Storage: puoi estrarre i metadati dello schema localmente utilizzando gli script di estrazione forniti da Google, caricare i file risultanti in un bucket Cloud Storage e preparare l'area di lavoro senza connetterti al database di origine.

Connettiti direttamente al database di origine

Puoi creare un workspace della conversione interattivo ed eseguire la conversione dello schema connettendoti direttamente al database di origine con Database Migration Service. Prima di creare l'area di lavoro in questo modo, assicurati di creare un profilo di connessione per il database di origine.

Ruoli obbligatori per il metodo di connessione diretta

Per ottenere le autorizzazioni necessarie per creare un workspace della conversione, chiedi all'amministratore di concederti il ruolo IAM Database Migration Admin (roles/datamigration.admin) nel progetto.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso nella documentazione di Identity and Access Management.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un workspace della conversione in Database Migration Service. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare un workspace della conversione in Database Migration Service sono necessarie le seguenti autorizzazioni:

  • cloudaicompanion.entitlements.get

    Questa autorizzazione è inclusa nel ruolo roles/datamigration.admin. È obbligatorio per le funzionalità di conversione migliorate con Gemini.

  • datamigration.conversionworkspaces.apply
  • datamigration.conversionworkspaces.commit
  • datamigration.conversionworkspaces.convert
  • datamigration.conversionworkspaces.create
  • datamigration.conversionworkspaces.delete
  • datamigration.conversionworkspaces.get
  • datamigration.conversionworkspaces.getIamPolicy
  • datamigration.conversionworkspaces.list
  • datamigration.conversionworkspaces.rollback
  • datamigration.conversionworkspaces.seed
  • datamigration.conversionworkspaces.setIamPolicy
  • datamigration.conversionworkspaces.update

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Crea un workspace della conversione con un profilo di connessione

Per creare un workspace della conversione in cui Database Migration Service si connette al tuo database di origine e prepara lo snapshot iniziale degli oggetti del database di origine, segui questi passaggi:

  1. Nella console Google Cloud , vai a Workspace della conversione.

    Vai a Workspace della conversione

  2. Fai clic su Configura l'area di lavoro.
  3. Nella pagina Crea un workspace della conversione, segui questi passaggi:
    1. Inserisci il nome, l'identificatore e la regione del workspace della conversione.
    2. Dal menu a discesa Motore del database di origine, seleziona Oracle.
    3. In Motore del database di destinazione, seleziona Cloud SQL per PostgreSQL.

    4. Nella sezione Abilita le impostazioni di Gemini per il tuo workspace, utilizza le caselle di controllo per attivare le funzionalità di conversione basate su Gemini. Puoi anche attivare queste funzionalità in un secondo momento, quando vuoi convertire codice e schema con l'assistenza di Gemini.

      Le funzionalità di conversione basate su Gemini richiedono l'API Gemini for Google Cloud . Per saperne di più, consulta Funzionalità di conversione basate su Gemini.

    5. Fai clic su Crea spazio di lavoro e continua.
  4. Nella pagina Definisci l'origine ed esegui il pull dello snapshot dello schema, segui questi passaggi:
    1. Nella sezione Metodo di connessione di origine, seleziona Profilo di connessione.
    2. Dal menu a discesa Profilo di connessione di origine, seleziona il profilo di connessione per il tuo database di origine.
    3. Fai clic su Esegui il pull dello snapshot dello schema e continua.

    Database Migration Service si sta connettendo al database di origine e sta recuperando lo schema. Questa procedura può richiedere alcuni minuti.

  5. Nella pagina Seleziona e converti gli oggetti, utilizza le caselle di controllo per selezionare gli oggetti che vuoi convertire nella sintassi PostgreSQL.

    Non è necessario convertire tutti gli oggetti in una sola volta. Puoi selezionare solo alcuni oggetti ora e aggiungerne altri alla conversione in un secondo momento.

  6. Fai clic su Converti e continua.

    Si apre il workspace della conversione.

  7. Quando apri una nuova area di lavoro per la prima volta, puoi eseguirne l'upgrade per accedere alla funzionalità di conversione automatica basata su Gemini. Procedi nel seguente modo:
    • Nella finestra di dialogo Ti presentiamo la conversione automatica di Gemini, seleziona la casella di controllo Esegui l'upgrade del workspace per esplorare la nuova esperienza e fai clic su Continua.
    • Nella finestra di dialogo Convertire gli oggetti di origine con Gemini?, fai clic su Converti.

      Database Migration Service esegue nuovamente il processo di conversione per applicare i miglioramenti della conversione basata su Gemini ai risultati della conversione deterministica. Per saperne di più sulla funzionalità di conversione automatica di Gemini, consulta Conversione automatica di Gemini.

Utilizza i file di schema archiviati in Cloud Storage

Puoi estrarre i metadati dello schema localmente utilizzando gli script di estrazione forniti da Google, caricare i file risultanti in un bucket Cloud Storage e preparare l'area di lavoro senza connetterti al database di origine.

Ruoli richiesti per l'utilizzo dei file di schema in Cloud Storage

Per ottenere le autorizzazioni necessarie per creare un workspace della conversione utilizzando i file di schema archiviati in Cloud Storage, chiedi all'amministratore di concedere i ruoli IAM richiesti nel progetto per i seguenti account coinvolti nel processo di migrazione:

  • Account utente che crea il workspace della conversione: Database Migration Admin (roles/datamigration.admin)
  • Account di servizio Database Migration Service: Storage Object Viewer (roles/storage.objectViewer) sul bucket Cloud Storage in cui sono archiviati i file di schema.

    L'indirizzo email del account di servizio di Database Migration Service utilizza il seguente formato: service-PROJECT_NUMBER@gcp-sa-datamigration.. Sostituisci PROJECT_NUMBER con il tuo numero di progetto Google Cloud . Per ulteriori informazioni su questo account di servizio, consulta Service account Database Migration Service.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso nella documentazione di Identity and Access Management.

Il ruolo predefinito roles/datamigration.admin contiene le autorizzazioni necessarie per creare un workspace della conversione in Database Migration Service. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare un workspace della conversione in Database Migration Service sono necessarie le seguenti autorizzazioni:

  • cloudaicompanion.entitlements.get

    Questa autorizzazione è inclusa nel ruolo roles/datamigration.admin. È obbligatorio per le funzionalità di conversione migliorate con Gemini.

  • datamigration.conversionworkspaces.apply
  • datamigration.conversionworkspaces.commit
  • datamigration.conversionworkspaces.convert
  • datamigration.conversionworkspaces.create
  • datamigration.conversionworkspaces.delete
  • datamigration.conversionworkspaces.get
  • datamigration.conversionworkspaces.getIamPolicy
  • datamigration.conversionworkspaces.list
  • datamigration.conversionworkspaces.rollback
  • datamigration.conversionworkspaces.seed
  • datamigration.conversionworkspaces.setIamPolicy
  • datamigration.conversionworkspaces.update

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Crea un workspace della conversione con i file di schema

Per creare un workspace della conversione con file di schema, segui questi passaggi.

  1. Recupera gli script Python dalla console Google Cloud . Segui questi passaggi:
    1. Nella console Google Cloud , vai a Workspace della conversione.

      Vai a Workspace della conversione

    2. Fai clic su Configura l'area di lavoro.
    3. Nella pagina Crea un workspace della conversione:
      1. Inserisci il nome, l'identificatore e la regione del workspace.
      2. Dal menu a discesa Motore del database di origine, seleziona Oracle.
      3. Dal menu a discesa Motore del database di destinazione, seleziona Cloud SQL per PostgreSQL.

      4. Nella sezione Attiva le impostazioni di Gemini per l'area di lavoro, utilizza le caselle di controllo per attivare le funzionalità di conversione basate su Gemini e fai clic su Continua.

        Puoi anche abilitare queste funzionalità in un secondo momento, quando vuoi convertire codice e schema con l'aiuto di Gemini. Le funzionalità di conversione basate su Gemini richiedono l'API Gemini for Google Cloud . Per saperne di più, consulta Funzionalità di conversione basate su Gemini.

    4. Nella pagina Definisci l'origine ed esegui il pull dello snapshot dello schema, nella sezione Metodo di connessione di origine, seleziona Cloud Storage.
    5. Nella sezione Prima di selezionare una cartella, accanto all'intestazione Oracle metadata extractor, fai clic su Apri. Segui le istruzioni nel riquadro laterale per scaricare ed eseguire l'utilità di estrazione sul database di origine per generare i file JSON dei metadati dello schema. Questa utilità richiede che tu sia in grado di stabilire una connessione di rete con il database di origine.
  2. Crea un bucket Cloud Storage dedicato in cui caricare i file JSON dei metadati dello schema. Per saperne di più sulla creazione di bucket Cloud Storage, consulta Crea bucket nella documentazione di Cloud Storage.
  3. All'interno del bucket Cloud Storage dedicato, crea una cartella vuota dedicata per i file dello schema del database esportati nei passaggi precedenti. Per saperne di più sulla creazione di cartelle Cloud Storage, consulta Crea e gestisci cartelle nella documentazione di Cloud Storage.
  4. Carica solo i file di schema JSON dei metadati che hai creato con gli script Python recuperati dalla console Google Cloud nei passaggi precedenti nella cartella del database vuota e dedicata nel bucket Cloud Storage.
  5. Continua a creare il tuo workspace nella console Google Cloud o creane uno nuovo con Google Cloud CLI.

    Console

    1. Dopo aver caricato i file dei metadati dello schema estratti in un bucket Cloud Storage, continua nella pagina Definisci l'origine ed estrai lo snapshot dello schema.
    2. Nel campo Cartella, fai clic su Sfoglia e seleziona la cartella che contiene i file di schema.
    3. Fai clic su Esegui il pull dello snapshot dello schema e continua.

      Database Migration Service ora analizza i metadati dello schema dal bucket.

    4. Nella pagina Seleziona e converti oggetti, seleziona gli oggetti che vuoi convertire e fai clic su Converti e continua.

    gcloud

    Dopo aver caricato i file dei metadati dello schema estratti in un bucket Cloud Storage, puoi creare e inizializzare una nuova area di lavoro con Google Cloud CLI. Segui questi passaggi:

    1. Crea un workspace della conversione vuoto.
      Esegui questo comando (fai clic per espandere):

      gcloud database-migration conversion-workspaces create

        gcloud database-migration conversion-workspaces create WORKSPACE_ID \
      --region=REGION \
      --source-database-engine=ORACLE \
      --destination-database-engine=POSTGRESQL

      Sostituisci quanto segue:

      • WORKSPACE_ID: con l'identificatore del workspace della conversione.
      • REGION: la regione in cui vuoi creare l'hub.

    2. Inizializza l'area di lavoro utilizzando i file di schema in Cloud Storage.
      Per analizzare e caricare i file dei metadati dello schema archiviati nel bucket nel workspace della conversione, esegui questo comando (fai clic per espandere):

      gcloud database-migration conversion-workspaces seed

        gcloud database-migration conversion-workspaces seed WORKSPACE_ID \
      --region=REGION \
      --gcs-path=gs://BUCKET_NAME/PREFIX/

      Sostituisci quanto segue:

      • WORKSPACE_ID: con l'identificatore del workspace della conversione.
      • REGION: la regione in cui vuoi creare l'hub.
      • BUCKET_NAME: il nome del bucket Cloud Storage contenente i file di schema.
      • PREFIX: il percorso della cartella contenente i file dei metadati dello schema estratti.

Workspace della conversione legacy

I workspace della conversione legacy sono un tipo di workspace della conversione più vecchio e limitato. Non è consigliabile utilizzare il tipo di workspace della conversione legacy per le migrazioni. Se devi utilizzare un workspace di conversione legacy, espandi la sezione Crea un workspace di conversione legacy e converti lo schema per saperne di più.

Crea un workspace della conversione legacy e converti lo schema

I workspace della conversione legacy utilizzano i file di configurazione Ora2Pg. Prima di creare un workspace della conversione legacy, assicurati di creare la configurazione Ora2Pg al di fuori di Database Migration Service. Per saperne di più, consulta Utilizza i workspace della conversione legacy.

  1. Nella console Google Cloud , vai a Workspace della conversione.

    Vai a Workspace della conversione

  2. Fai clic su Configura l'area di lavoro.
  3. Nella pagina Crea un workspace della conversione, segui questi passaggi:
    1. Inserisci il nome, l'identificatore e la regione del workspace della conversione.
    2. Dal menu a discesa Motore del database di origine, seleziona Oracle.
    3. In Motore del database di destinazione, seleziona Cloud SQL per PostgreSQL.
    4. Espandi la sezione Personalizza le configurazioni del workspace e seleziona la casella di controllo Abilita il workspace della conversione legacy.
    5. Fai clic su Crea spazio di lavoro e continua.
  4. Nella pagina Connettiti all'origine e converti gli oggetti, segui questi passaggi:
    1. Dal menu a discesa Profilo di connessione di origine, seleziona il profilo di connessione per il database di origine.

    2. Nella casella File di configurazione, fai clic su Sfoglia e utilizza il selettore file di sistema per selezionare il file di mappatura delle conversioni.

      Puoi caricare più file di mappatura delle conversioni facendo clic su Aggiungi file.

    3. Nella sezione Converti la configurazione, fai clic su Esegui il pull dello schema e converti.

      Database Migration Service si sta connettendo al database di origine, recuperando lo schema e convertendolo nello schema SQL di destinazione in base alle regole definite nel file di mappatura della conversione. Questa procedura può richiedere alcuni minuti.

  5. Fai clic su Salva e chiudi.

    Viene visualizzata la pagina dei dettagli del workspace della conversione.

Ora puoi applicare lo schema convertito al database di destinazione. Se il database di origine include tabelle senza chiavi primarie, devi anche creare manualmente i vincoli della chiave primaria nelle tabelle convertite nel database di destinazione dopo aver applicato lo schema convertito. Per saperne di più, consulta Utilizza i workspace della conversione legacy.

Passaggi successivi

Ora puoi utilizzare il workspace della conversione per risolvere i problemi di conversione, modificare gli oggetti con l'editor interattivo e applicare lo schema convertito al database di destinazione. Consulta Converti il codice e lo schema Oracle nella sintassi PostgreSQL.