Installa e configura BigQuery Toolkit per SAP

Questo documento descrive come installare e configurare BigQuery Toolkit per SAP.

Installa BigQuery Toolkit per SAP

Quando installi la versione 1.9 della versione on-premise o di qualsiasi versione cloud di ABAP SDK for Google Cloud, lo strumento BigQuery Toolkit for SAP viene installato per impostazione predefinita. Per informazioni sui passaggi di installazione, consulta Installare e configurare la versione on-premise o qualsiasi versione cloud di ABAP SDK for Google Cloud.

Se utilizzi già la versione 1.8 o precedenti dell'SDK ABAP on-premise o di qualsiasi versione cloud dell'SDK ABAP per Google Cloud, devi aggiornare l'SDK all'ultima versione per ottenere BigQuery Toolkit per SAP. Per ulteriori informazioni, consulta Aggiornare ABAP SDK per Google Cloud.

Abilita l'API BigQuery

Devi attivare l'API BigQuery nel tuo progetto Google Cloud. Per informazioni su come abilitare le Google Cloud API, consulta Abilitazione delle API.

Configura l'autenticazione

Dopo aver configurato l'autenticazione per accedere alle Google Cloud API nella tua versione on-premise o cloud dell'SDK ABAP per Google Cloud, BigQuery Toolkit per SAP utilizza lo stesso metodo di autenticazione per accedere all'API BigQuery. Per informazioni su come configurare l'autenticazione nella versione on-premise o in qualsiasi versione cloud di ABAP SDK for Google Cloud, consulta la Panoramica dell'autenticazione.

Assicurati che l'account di servizio configurato nell'SDK ABAP per la configurazione della chiave client di Google Cloud abbia i seguenti ruoli:

  • Editor dati BigQuery
  • Utente job BigQuery

Prendi nota della chiave client che hai creato durante la configurazione dell'autenticazione. Utilizza questa chiave client per configurare il modulo di configurazione di BigQuery Data Transfer del BigQuery Toolkit per SAP nel tuo sistema SAP.

Crea un set di dati BigQuery

Per creare un set di dati BigQuery, il tuo account utente deve disporre delle autorizzazioni IAM appropriate per BigQuery. Per maggiori informazioni, consulta Autorizzazioni richieste.

Per creare un set di dati BigQuery, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina BigQuery:

    Vai a BigQuery

  2. Accanto all'ID progetto, fai clic sull'icona Visualizza azioni, quindi su Crea set di dati.

    Crea set di dati

  3. Nel campo Dataset ID (ID set di dati), inserisci un nome univoco. Per ulteriori informazioni, consulta Nominare i set di dati.

Per ulteriori informazioni sulla creazione di set di dati BigQuery, consulta Creare set di dati.

Configura il modulo BigQuery Data Transfer

Il modulo BigQuery Data Transfer di BigQuery Toolkit per SAP ti consente di creare una pipeline di dati dal tuo sistema SAP a BigQuery. In questo processo, crei una configurazione di trasferimento collettivo in cui puoi specificare le origini dati SAP da replicare, mappare i campi tra le tabelle SAP e BigQuery e ottimizzare le prestazioni configurando le impostazioni di replica dei dati.

Seleziona le opzioni di trasferimento collettivo iniziale

Seleziona la parte della configurazione del trasferimento collettivo che devi modificare.

Per selezionare la parte della configurazione del trasferimento collettivo:

  1. In SAP GUI, esegui il codice transazione /GOOG/SDK_IMG.

    In alternativa, esegui il codice transazione SPRO e poi fai clic su Immagine di riferimento SAP.

  2. Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > BigQuery Data Transfer: manutenzione delle impostazioni.

  3. Nel menu a discesa Tabella delle impostazioni, seleziona Trasferimenti collettivi.

    Per una nuova configurazione del trasferimento collettivo, lascia vuoto il campo Mass Transfer Key (Chiave trasferimento collettivo).

  4. Fai clic sull'icona Esegui. Viene visualizzata la schermata BigQuery Data Transfer Settings Maintenance - Mass Transfers (Manutenzione delle impostazioni di BigQuery Data Transfer - Trasferimenti collettivi).

Specifica la creazione della tabella e altri attributi generali

Nella sezione iniziale di una configurazione del trasferimento collettivo BigQuery, identifica la configurazione del trasferimento collettivo e specifica la chiave client associata, nonché alcune proprietà relative alla creazione della tabella BigQuery di destinazione.

Il server SAP salva la configurazione del trasferimento collettivo come record nella tabella di configurazione personalizzata /GOOG/BQTR_MASTR.

I campi specificati nei passaggi che seguono sono obbligatori per una configurazione di trasferimento collettivo.

Per specificare gli attributi della tabella:

  1. Nella schermata BigQuery Data Transfer Settings Maintenance - Mass Transfers (Manutenzione delle impostazioni di BigQuery Data Transfer - Trasferimenti collettivi), fai clic sull'icona Aggiungi riga.

  2. Nella riga visualizzata, specifica le seguenti impostazioni:

    1. Nel campo Mass Transfer Key (Chiave trasferimento collettivo), definisci un nome per questo trasferimento. Questo nome diventa la chiave primaria del trasferimento collettivo.
    2. Per utilizzare le etichette o le descrizioni brevi dei campi di origine come nomi per i campi di destinazione in BigQuery, fai clic sulla casella di controllo Usa indicatore per i nomi personalizzati. Per ulteriori informazioni sui nomi dei campi, consulta Opzioni di denominazione predefinite per i campi.

    3. Per memorizzare il tipo di modifica che ha attivato un'inserzione e per attivare la convalida dei conteggi dei record tra la tabella di origine, le statistiche del server SAP e la tabella BigQuery, seleziona la casella di controllo Extra Fields Flag.

      Quando questo flag è impostato, BigQuery Toolkit for SAP aggiunge colonne allo schema della tabella BigQuery. Per ulteriori informazioni, vedi Campi aggiuntivi per le modifiche ai record e le query di conteggio.

    4. Per interrompere l'invio dei dati quando viene rilevato un record con un errore, la casella di controllo Interrompi al primo indicatore di errore è selezionata per impostazione predefinita. Ti consigliamo di lasciarla selezionata. Per ulteriori informazioni, consulta la sezione Flag BREAK.

    5. Se vuoi, per ridurre automaticamente le dimensioni del chunk quando le dimensioni in byte di un chunk superano le dimensioni in byte massime per le richieste HTTP accettate da BigQuery, fai clic sulla casella di controllo Dynamic Chunk Size Flag. Per ulteriori informazioni sulle dimensioni dei chunk dinamici, consulta Dimensioni dei chunk dinamici.

    6. Quando viene rilevato un record con un errore nei dati, per saltarlo e continuare a inserire record nella tabella BigQuery, fai clic sulla casella di controllo Salta indicatore record non validi. Ti consigliamo di lasciare questa opzione deselezionata. Per ulteriori informazioni, vedi Il flag SKIP.

    7. Nel campo Nome della chiave Google Cloud, inserisci il nome della configurazione della chiave client corrispondente.

      BigQuery Toolkit per SAP recupera l' Google Cloud identificatore del progetto dalla configurazione della chiave client.

    8. Nel campo Set di dati BigQuery, inserisci il nome del set di dati BigQuery di destinazione che hai creato nella sezione Creare un set di dati BigQuery.

    9. Nel campo Is Setting Active Flag (È un flag di impostazione attivo), attiva la configurazione del trasferimento collettivo facendo clic sulla casella di controllo.

    10. Fai clic su Salva.

      Un record di trasferimento collettivo viene aggiunto alla tabella/GOOG/BQTR_MASTR e i campi Modificato da, Modificato il e Modificato il vengono compilati automaticamente.

    11. Fai clic su Visualizza tabella.

      Viene visualizzato il nuovo record di trasferimento collettivo, seguito dal riquadro di immissione degli attributi della tabella.

Specifica gli attributi della tabella

Puoi specificare gli attributi della tabella, come il nome e la suddivisione della tabella, nonché il numero di record da includere in ogni trasmissione o frammento inviato a BigQuery.

Le impostazioni specificate vengono memorizzate come record nella tabella di configurazione /GOOG/BQTR_TABLE.

Queste impostazioni sono facoltative per una configurazione di trasferimento collettivo.

Per specificare gli attributi della tabella:

  1. Fai clic sull'icona Aggiungi riga.

  2. Nel campo Nome origine dati SAP, inserisci il nome degli oggetti del dizionario SAP di origine, ad esempio tabelle, viste del dizionario, viste CDS o entità CDS.

  3. Nel campo Nome tabella esterna, inserisci il nome della tabella BigQuery di destinazione. Se la tabella di destinazione non esiste già, BigQuery Toolkit for SAP la crea con questo nome. Per le convenzioni di denominazione delle tabelle BigQuery, consulta Nomi delle tabelle.

  4. Per inviare dati non compressi per tutti i campi di una tabella, seleziona Invia flag non compresso. Con questa impostazione abilitata, BigQuery Toolkit per SAP replica tutti i campi vuoti nei record di origine con i valori con cui vengono inizializzati nella tabella di origine. Per migliorare il rendimento, non selezionare questo flag.

    Se devi inviare dati non compressi solo per campi specifici, non selezionare Invia indicatore non compresso a livello di tabella. Seleziona invece Invia flag non compresso per questi campi specifici a livello di campo. Questa opzione ti consente di conservare i valori iniziali di campi specifici durante la replica dei dati in BigQuery, anche se comprimi il resto dei dati della tabella. Per informazioni su come modificare la compressione dei record a livello di campo, consulta Modificare la compressione dei record a livello di campo.

    Per ulteriori informazioni sul comportamento della compressione dei record, consulta Compressione dei record.

  5. Facoltativamente, nel campo Dimensione chunk, specifica il numero massimo di record da includere in ogni chunk inviato a BigQuery. Ti consigliamo di utilizzare la dimensione del chunk predefinita con BigQuery Toolkit per SAP, ovvero 10.000 record. Se necessario, puoi aumentare la dimensione del chunk fino a 50.000 record, che è la dimensione massima consentita da BigQuery Toolkit per SAP.

    Se i record di origine hanno un numero elevato di campi, il numero di campi può aumentare le dimensioni complessive in byte dei chunk, il che può causare errori nei chunk. In questo caso, prova a ridurre le dimensioni del chunk per ridurre le dimensioni in byte. Per ulteriori informazioni, vedi Dimensioni dei blocchi di trasferimento dei dati. In alternativa, per regolare automaticamente le dimensioni dei chunk, attiva la dimensione dei chunk dinamica. Per ulteriori informazioni, consulta Dimensioni dei chunk dinamici.

  6. (Facoltativo) Nel campo Tipo di partizione, specifica un incremento di tempo da utilizzare per il partizionamento. I valori validi sono HOUR, DAY, MONTH o YEAR. Per ulteriori informazioni, consulta Partizionamento delle tabelle.

  7. Facoltativamente, nel campo Campo partizione, specifica il nome di un campo nella tabella BigQuery di destinazione che contiene un timestamp da utilizzare per la partizione. Quando specifichi Campo partizione, devi anche specificare Tipo partizione. Per ulteriori informazioni, consulta Partizionamento delle tabelle.

  8. Nel campo Is Setting Active Flag (È un indicatore di impostazione attivo), attiva gli attributi della tabella facendo clic sulla casella di controllo. Se la casella Is Setting Active Flag non è selezionata, BigQuery Toolkit for SAP crea la tabella BigQuery con il nome della tabella di origine SAP, la dimensione del chunk predefinita e nessuna partizione.

  9. Fai clic su Salva.

    Gli attributi vengono archiviati come record nella tabella di configurazione /GOOG/BQTR_TABLE e i campi Modificato da, Modificato il e Modificato il vengono compilati automaticamente.

  10. Fai clic su Mostra campi.

    Viene visualizzato il nuovo record dell'attributo della tabella, seguito dal riquadro di immissione della mappatura dei campi.

Personalizzare la mappatura dei campi predefinita

Se la tabella SAP di origine contiene campi timestamp o booleani, modifica la mappatura del tipo di dati predefinito in modo che rifletta con precisione il tipo di dati nella tabella BigQuery di destinazione.

Puoi anche modificare altri tipi di dati, nonché i nomi utilizzati per i campi target.

Puoi modificare la mappatura predefinita direttamente in SAP GUI oppure esportarla in un foglio di lavoro o in un file di testo in modo che altri utenti possano modificarne i valori senza richiedere l'accesso al server SAP.

Per ulteriori informazioni sulla mappatura dei campi predefinita e sulle modifiche che puoi apportare, consulta Mappatura dei campi.

Per personalizzare la mappatura predefinita per i campi BigQuery di destinazione:

  1. Nella schermata BigQuery Data Transfer Settings Maintenance - Fields (Manutenzione delle impostazioni di BigQuery Data Transfer - Campi), visualizza le mappature dei campi predefinite per il trasferimento collettivo che stai configurando.

  2. Modifica i tipi di dati target predefiniti nella colonna Elemento dati esterni come necessario. In particolare, modifica il tipo di dati di destinazione per i seguenti tipi di dati:

    • Timestamp. Modifica il tipo di dati di destinazione predefinito da NUMERIC a TIMESTAMP o TIMESTAMP (LONG).
    • Valori booleani. Modifica il tipo di dati di destinazione predefinito da STRING a BOOLEAN.
    • Numeri esadecimali. Modifica il tipo di dati di destinazione predefinito da STRING a BYTES.

    Per modificare la mappatura del tipo di dati predefinito:

    1. Nella riga del campo da modificare, fai clic sul campo Elemento dati esterni.
    2. Nella finestra di dialogo dei tipi di dati, seleziona il tipo di dato BigQuery di cui hai bisogno.
    3. Conferma le modifiche e fai clic su Salva.

  3. Se hai specificato il flag Nomi personalizzati nella schermata Manutenzione delle impostazioni di BigQuery Data Transfer, modifica i nomi dei campi di destinazione predefiniti nella colonna Nome campo temporaneo, se necessario.

    I valori specificati sostituiscono i nomi predefiniti visualizzati nella colonna Nome campo esterno.

  4. Modifica le descrizioni dei campi target predefiniti nella colonna Descrizione campo come necessario.

  5. Se vuoi, esporta la mappa dei campi per la modifica esterna. Per istruzioni, consulta Modificare la mappa dei campi BigQuery in un file CSV.

  6. Una volta completate tutte le modifiche e caricati eventuali valori modificati esternamente, verifica che la casella di controllo Is Setting Active Flag sia selezionata. Se l'opzione Is Setting Active Flag non è selezionata, BigQuery Toolkit for SAP crea le tabelle di destinazione con i valori predefiniti.

  7. Fai clic su Salva.

    Le modifiche vengono memorizzate nella tabella di configurazione /GOOG/BQTR_FIELD e i campi Modificato da, Modificato il e Modificato il vengono compilati automaticamente.

Modificare la compressione dei record a livello di campo

Per migliorare le prestazioni della replica, BigQuery Toolkit for SAP comprime i record omettendo tutti i campi vuoti nel record di origine, che vengono poi inizializzati con null nella tabella di destinazione in BigQuery. Tuttavia, se devi replicare alcuni campi vuoti con i relativi valori iniziali in BigQuery continuando a utilizzare la compressione dei record, puoi selezionare Invia indicatore non compresso per questi campi specifici.

Per ulteriori informazioni sul comportamento della compressione dei record, consulta Compressione dei record.

Per modificare la compressione dei record a livello di campo:

  1. Nella schermata BigQuery Data Transfer Settings Maintenance - Fields (Manutenzione delle impostazioni di BigQuery Data Transfer - Campi), visualizza l'elenco dei campi della tabella di cui stai configurando il trasferimento collettivo.

  2. Per inviare dati non compressi per un campo, seleziona Invia indicatore non compresso corrispondente al campo.

  3. Fai clic su Salva.

Richiedi assistenza

Google Cloud offre assistenza per problemi e domande relativi all'installazione, alla configurazione, al funzionamento e alla manutenzione di BigQuery Toolkit per SAP. Tuttavia, l'assistenza è limitata al toolkit stesso.

Google Cloud non supporta altri componenti dell'ambiente come l'infrastruttura di rete, i database, i sistemi operativi o il software di terze parti. Per problemi relativi a componenti dell'ambiente diversi da BigQuery Toolkit per SAP, contatta il fornitore o il provider di assistenza appropriato.

Per le funzionalità fornite da SAP, come Operational Data Provisioning (ODP) e SAP Landscape Transformation (SLT), contatta l'assistenza SAP per ricevere assistenza.

Per risolvere i problemi relativi a BigQuery Toolkit per SAP, consulta Risolvere i problemi relativi a BigQuery Toolkit per SAP.

Se hai bisogno di aiuto per risolvere i problemi relativi all'SDK ABAP per Google Cloud, segui questi passaggi: