Pianificare un trasferimento Oracle

Il connettore BigQuery Data Transfer Service per Oracle consente di pianificare e gestire automaticamente i job di caricamento ricorrenti da Oracle in BigQuery.

Limitazioni

I trasferimenti di Oracle sono soggetti alle seguenti limitazioni:

  • Il numero massimo di connessioni simultanee a un database Oracle è limitato e, di conseguenza, il numero di esecuzioni di trasferimento simultanee a un singolo database Oracle è limitato a questo valore massimo.
  • Devi configurare un allegato di rete nei casi in cui non è disponibile un IP pubblico per una connessione al database Oracle, con i seguenti requisiti:
    • L'origine dati deve essere accessibile dalla subnet in cui risiede l'attacco alla rete.
    • Il collegamento di rete non deve trovarsi nella subnet nell'intervallo240.0.0.0/24.
    • I collegamenti di rete non possono essere eliminati se sono presenti connessioni attive al collegamento. Per eliminare un collegamento di rete, contatta l'assistenza clienti Google Cloud.
    • Per la regione multipla us, il collegamento di rete deve trovarsi nella regione us-central1. Per la regione multipla eu, il collegamento di rete deve trovarsi nella regione europe-west4.
  • La console Google Cloud supporta solo l'utilizzo del ruolo utente NORMAL Oracle per il connettore Oracle a BigQuery Data Transfer Service. Devi utilizzare l'interfaccia a riga di comando BigQuery per connetterti utilizzando i ruoli utente Oracle SYSDBA e SYSOPER.
  • L'intervallo di tempo minimo tra i trasferimenti ricorrenti di Oracle è di 15 minuti. L'intervallo predefinito per un trasferimento ricorrente è di 24 ore.

Prima di iniziare

Le sezioni seguenti descrivono i passaggi da seguire prima di creare un trasferimento Oracle.

Prerequisiti di Oracle

Quando crei un trasferimento Oracle, devi disporre anche delle seguenti informazioni sul database Oracle.

Nome parametro Descrizione
database Nome del database.
host

Nome host o indirizzo IP del database.
port

Numero di porta del database.
username

Nome utente per accedere al database.
password

Password per accedere al database.
connectionType

Il tipo di connessione. Può essere SERVICE, SID o TNS.

oracleObjects

Elenco di oggetti Oracle da trasferire.

Prerequisiti di BigQuery

Ruoli BigQuery obbligatori

Per ottenere le autorizzazioni necessarie per creare un trasferimento, chiedi all'amministratore di concederti il ruolo IAM Amministratore BigQuery (roles/bigquery.admin). Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per creare un trasferimento sono necessarie le seguenti autorizzazioni:

  • bigquery.transfers.update sull'utente
  • bigquery.datasets.get nel set di dati di destinazione
  • bigquery.datasets.update nel set di dati di destinazione

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

Configurare un trasferimento di dati Oracle

Seleziona una delle seguenti opzioni:

Console

  1. Vai alla pagina Trasferimenti dati nella console Google Cloud.

    Vai a Trasferimenti dati

  2. Fai clic su Crea trasferimento.

  3. Nella sezione Tipo di origine, seleziona Oracle in Origine.

  4. Nella sezione Dettagli origine dati:

    • Per Collegamento di rete, seleziona un collegamento di rete esistente o fai clic su Crea collegamento di rete.
    • In Host, inserisci il nome host o l'IP del database.
    • In Porta, inserisci il numero di porta utilizzato dal database Oracle per le connessioni in entrata, ad esempio 1520.
    • In Nome database, inserisci il nome del database Oracle.
    • In Tipo di connessione, inserisci il tipo di URL di connessione, SERVICE, SID o TNS.
    • In Nome utente, inserisci il nome utente dell'utente che avvia la connessione al database Oracle.
    • In Password, inserisci la password dell'utente che avvia la connessione al database Oracle.

    • Per gli oggetti Oracle da trasferire, fai clic su Sfoglia per selezionare le eventuali tabelle da trasferire al set di dati di destinazione BigQuery.

      • In questo campo puoi anche inserire manualmente gli oggetti da includere nel trasferimento dei dati.

      Configura la configurazione del trasferimento Oracle

  5. Nella sezione Impostazioni di destinazione, per Set di dati, seleziona il set di dati che hai creato per archiviare i dati.

  6. Nella sezione Nome configurazione di trasferimento, in Nome visualizzato, inserisci un nome per il trasferimento dei dati.

  7. Nella sezione Opzioni di programmazione:

    • Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la frequenza con cui viene eseguito questo trasferimento di dati. Per specificare una frequenza di ripetizione personalizzata, seleziona Personalizzata. Se selezioni On demand, questo trasferimento viene eseguito quando attivi manualmente il trasferimento.

    • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e fornisci una data di inizio e un'ora di esecuzione.

  8. Nel menu Account di servizio, seleziona un account di servizio associato al tuo progetto Google Cloud. L'account di servizio selezionato deve avere i ruoli richiesti per eseguire questo trasferimento di dati.

    Se hai eseguito l'accesso con un'identità federata, è necessario un account di servizio per creare un trasferimento di dati. Se hai eseguito l'accesso con un Account Google, un account di servizio per il trasferimento è facoltativo.

    Per ulteriori informazioni sull'utilizzo degli account di servizio con i trasferimenti di dati, consulta Utilizzare gli account di servizio.

  9. (Facoltativo) Nella sezione Opzioni di notifica, segui questi passaggi:

    • Per attivare le notifiche via email, fai clic sull'opzione di attivazione/disattivazione Notifica via email. Se attivi questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un'esecuzione del trasferimento non va a buon fine.
    • Per attivare le notifiche di esecuzione del trasferimento Pub/Sub per questo trasferimento, fai clic sul pulsante di attivazione/disattivazione Notifiche Pub/Sub. Puoi selezionare il nome del tuo argomento oppure fare clic su Crea un argomento per crearne uno.

  10. Fai clic su Salva.

bq

Inserisci il comando bq mk e specifica il flag di creazione del trasferimento --transfer_config:

bq mk \
    --transfer_config \
    --project_id=PROJECT_ID \
    --data_source=DATA_SOURCE \
    --display_name=DISPLAY_NAME \
    --target_dataset=DATASET \
    --params='PARAMETERS'

Dove:

  • PROJECT_ID (facoltativo): l'ID del tuo progetto Google Cloud. Se non viene fornito --project_id per specificare un determinato progetto, viene utilizzato il progetto predefinito.
  • DATA_SOURCE: l'origine dati oracle.
  • DISPLAY_NAME: il nome visualizzato per la configurazione del trasferimento. Il nome del trasferimento dati può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.
  • DATASET: il set di dati di destinazione per la configurazione del trasferimento.

  • PARAMETERS: i parametri per la configurazione del trasferimento creata in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Di seguito sono riportati i parametri per un trasferimento di dati Oracle:

    • connector.networkAttachment (facoltativo): nome dell'attacco di rete per connettersi al database Oracle.
    • connector.authentication.Username: nome utente dell'account Oracle.
    • connector.authentication.Password: password dell'account Oracle.
    • connector.database: il nome del database Oracle.
    • connector.endpoint.host: l'IP o il nome host del database.
    • connector.endpoint.port: il numero di porta utilizzato dal database Oracle per le connessioni in entrata, ad esempio 1520.
    • connector.connectionType: il tipo di URL di connessione, SERVICE, SID o TNS.
    • assets: il percorso degli oggetti Oracle da trasferire a BigQuery, utilizzando il formato: DATABASE_NAME/SCHEMA_NAME/TABLE_NAME

Ad esempio, il seguente comando crea un trasferimento di dati Oracle nel progetto predefinito con tutti i parametri richiesti:

bq mk \
    --transfer_config \
    --target_dataset=mydataset \
    --data_source=oracle \
    --display_name='My Transfer' \
    --params='{"assets":["DB1/USER1/DEPARTMENT","DB1/USER1/EMPLOYEES"], \
        "connector.authentication.username": "User1", \
        "connector.authentication.password":"ABC12345", \
        "connector.database":"DB1", \
        "Connector.endpoint.host":"192.168.0.1", \
        "Connector.endpoint.port":"1520", \
        "connector.connectionType":"SERVICE", \
        "connector.networkAttachment": \
        "projects/dev-project1/regions/us-central1/networkattachments/na1"}'

API

Utilizza il metodo projects.locations.transferConfigs.create e fornisci un'istanza della risorsa TransferConfig.

Risolvere i problemi di configurazione del trasferimento

Se hai problemi a configurare il trasferimento dei dati, consulta Problemi di trasferimento di Oracle.

Prezzi

Il trasferimento dei dati Oracle in BigQuery non prevede costi mentre questa funzionalità è in fase di anteprima.

Passaggi successivi