Importa metadati da Oracle

Knowledge Catalog (in precedenza Dataplex Universal Catalog) consente di estrarre e importare i metadati dai database Oracle utilizzando un connettore gestito. Puoi quindi cercare e scoprire i tuoi asset Oracle insieme agli altri dati catalogati e recuperare il contesto per i workload dei modelli linguistici di grandi dimensioni (LLM).

Questo connettore supporta le istanze Oracle ospitate on-premise, su Google Cloudo in altri ambienti cloud. Per saperne di più sul funzionamento dei connettori, consulta Informazioni sui connettori dei metadati.

Prima di iniziare

Prima di poter importare i metadati da Oracle, completa le seguenti attività:

  1. Concedi i ruoli e le autorizzazioni richiesti.
  2. Abilita l'API Dataplex e l'API BigQuery Data Transfer Service.
  3. Soddisfare i prerequisiti di Oracle.
  4. Soddisfare i prerequisiti di rete.

Ruoli e autorizzazioni IAM

Per creare e gestire un job del connettore di Knowledge Catalog, devi disporre dei ruoli Identity and Access Management (IAM) che concedono le autorizzazioni per Knowledge Catalog e BigQuery Data Transfer Service.

Per ottenere le autorizzazioni necessarie per configurare un connettore Oracle, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Inoltre, devi concedere all'agente di servizio BigQuery Data Transfer Service (service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com) l'autorizzazione dataplex.entryGroups.import o il ruolo Dataplex Entry Group Importer (roles/dataplex.entryGroupImporter). Puoi concedere questo ruolo a livello di progetto o di gruppo di voci.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso.

Abilita API

Abilita l'API Dataplex e l'API BigQuery Data Transfer Service.

Abilita le API

Prerequisiti di Oracle

Assicurati di soddisfare i prerequisiti per i trasferimenti Oracle. Per maggiori dettagli, consulta i prerequisiti di Oracle nella documentazione di BigQuery Data Transfer Service.

Oltre ai prerequisiti di BigQuery Data Transfer Service, l'istanza Oracle deve soddisfare i seguenti requisiti:

  • Versione minima: per supportare gli attributi dei metadati del database, come type e parentContainer, è richiesta la versione 12 o successive di Oracle.

  • Privilegi minimi: devi concedere i seguenti privilegi all'utente del database:

    Autorizzazioni di base (obbligatorie per tutte le configurazioni):

    GRANT SELECT_CATALOG_ROLE TO USER_NAME;
GRANT CREATE SESSION TO USER_NAME;
GRANT SELECT ON SYS.COL$ TO USER_NAME;

    Autorizzazioni per accedere a uno schema specifico (Oracle versione 23 e successive):

    GRANT SELECT ANY TABLE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
GRANT EXECUTE ANY PROCEDURE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
GRANT EXECUTE ANY TYPE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
GRANT ALTER ANY TRIGGER ON SCHEMA TARGET_SCHEMA TO USER_NAME;

    Autorizzazioni per accedere a tutti gli altri schemi:

    GRANT SELECT ANY TABLE TO USER_NAME;
GRANT EXECUTE ANY PROCEDURE TO USER_NAME;
GRANT EXECUTE ANY TYPE TO USER_NAME;
GRANT ALTER ANY TRIGGER TO USER_NAME;

    Sostituisci quanto segue:

    • USER_NAME: l'utente del database che vuoi configurare.
    • TARGET_SCHEMA: il nome dello schema Oracle a cui vuoi accedere.

Prerequisiti di networking

Per connetterti in modo sicuro a database esterni o origini dati cloud di terze parti con un indirizzo IP privato all'interno di una rete privata, è necessario un collegamento di rete per la connessione tramite Private Service Connect, in modo da consentire a BigQuery Data Transfer Service di accedere al tuo database.

Se ti connetti a un ambiente on-premise o a un'istanza ospitata nel cloud utilizzando un indirizzo IP pubblico, non è necessario un collegamento di rete.

Configura un connettore Oracle

Configura un connettore Oracle utilizzando la console Google Cloud o l'API.

Console

  1. Nella console Google Cloud , vai alla pagina Knowledge Catalog.

    Vai a Knowledge Catalog

  2. Nel menu di navigazione, nella sezione Gestisci, fai clic su Connettori.

  3. Fai clic su Aggiungi connessione.

  4. Nell'elenco Connettori, seleziona la scheda Oracle.

  5. Nella sezione Dettagli origine dati, fornisci i dettagli di connessione per la tua istanza Oracle:

    • Per Collegamento di rete, seleziona un collegamento di rete esistente, se necessario, o creane uno.
    • Inserisci Host, Porta, Nome database, Tipo di connessione, Nome utente e Password.
    • Se utilizzi TLS, seleziona una modalità TLS e fornisci un certificato PEM attendibile. Per saperne di più, consulta Configurazione TLS.
    • Per Oggetti di metadati Oracle da importare, fai clic su Sfoglia per selezionare gli oggetti.

  6. Nella sezione Impostazioni destinazione:

    • Fai clic su Sfoglia e seleziona un gruppo di voci di Knowledge Catalog esistente per archiviare i metadati importati oppure fai clic su Crea nuovo gruppo di voci.
    • Scegli se impostare le autorizzazioni per il gruppo di voci ora o in un secondo momento. Ti consigliamo di impostare le autorizzazioni in modo che gli utenti possano visualizzare i metadati importati. Se non hai concesso il ruolo Dataplex Entry Group Importer (roles/dataplex.entryGroupImporter) o l'autorizzazione dataplex.entryGroups.import all'agente di servizio BigQuery Data Transfer Service (service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com) a livello di progetto, devi concederlo a livello di gruppo di voci.

  7. Nella sezione Nome configurazione connettore, per Nome visualizzato, inserisci un nome per il job di importazione dei metadati.

  8. Nella sezione Opzioni di pianificazione, configura la frequenza del job di importazione dei metadati. Se selezioni On demand, il job viene eseguito solo quando lo attivi manualmente.

  9. (Facoltativo) Nella sezione Opzioni di notifica, configura le notifiche via email o Pub/Sub per gli errori dei job.

  10. (Facoltativo) Nella sezione Opzioni avanzate, configura le impostazioni di crittografia. Se selezioni una chiave di crittografia gestita dal cliente (CMEK), tieni presente che la chiave viene utilizzata per criptare i dati temporanei preparati prima di avviare i job di importazione dei metadati di Knowledge Catalog. Non viene utilizzata per criptare i metadati nel gruppo di voci Knowledge Catalog di destinazione.

  11. Fai clic su Salva.

REST

Utilizza il metodo projects.locations.transferConfigs.create. Nella risorsa TransferConfig, configura i seguenti campi:

  • Imposta il campo dataSourceId su "oracle".
  • Nel campo metadataDestination, compila l'oggetto dataplexConfiguration con il percorso della risorsa del gruppo di voci di Knowledge Catalog di destinazione: projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>

Dopo aver creato il job, Knowledge Catalog pianifica la prima esecuzione in base alla tua configurazione oppure puoi avviarlo manualmente.

Cerca e visualizza i metadati di Oracle

  1. Nella console Google Cloud , vai alla pagina Ricerca di Knowledge Catalog.

    Vai alla Ricerca

  2. Nel riquadro Filtri, puoi filtrare gli asset Oracle utilizzando le sezioni Progetto, Sistema e Alias tipo. Nella sezione Sistema, seleziona Contesto importato. Se selezioni questo filtro, si apre una sottosezione Connettori gestiti. Seleziona Oracle per filtrare tutti i metadati Oracle.

  3. Puoi utilizzare il campo di ricerca per eseguire query di ricerca. Puoi eseguire una ricerca per parola chiave o in linguaggio naturale. Ad esempio, per visualizzare tutte le tabelle Oracle tramite la ricerca per parole chiave, inserisci system=ORACLE AND type=TABLE.

    Per scoprire di più sulla ricerca di risorse, consulta Cerca risorse in Knowledge Catalog. Per scoprire di più sulle espressioni che puoi utilizzare nel campo di ricerca, consulta Sintassi di ricerca per Knowledge Catalog.

  4. Puoi anche utilizzare l'API LookupContext per recuperare il contesto LLM per risorse Oracle specifiche.

Passaggi successivi