Installa e configura BigQuery Toolkit per SAP

On-premises or any cloud edition v1.11keyboard_arrow_down

• Edizione SAP BTP v1.1
• Versione on-premise o qualsiasi versione cloud v1.11

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

Installa BigQuery Toolkit per SAP

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

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

Abilita l'API BigQuery

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

Configura l'autenticazione

Una volta configurata l'autenticazione per accedere alle API nell'edizione on-premise o cloud di ABAP SDK for Google Cloud, BigQuery Toolkit for SAP utilizza lo stesso metodo di autenticazione per accedere all'API BigQuery. Google Cloud Per informazioni su come configurare l'autenticazione nella versione on-premise o in qualsiasi edizione cloud di ABAP SDK for Google Cloud, consulta la panoramica dell'autenticazione.

Assicurati che il account di servizio configurato nella configurazione della chiave client di ABAP SDK for Google Cloud disponga dei seguenti ruoli:

• BigQuery Data Editor
• BigQuery Job User

Prendi nota della chiave client che hai creato nell'ambito della configurazione dell'autenticazione. Utilizzi questa chiave client quando configuri il modulo di configurazione di BigQuery Data Transfer Service di 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 la sezione Autorizzazioni richieste.

Per creare un set di dati BigQuery:

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

   Vai a BigQuery

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

   

3. Nel campo ID set di dati, inserisci un nome univoco. Per ulteriori informazioni, vedi Denominare i set di dati.

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

Configurare 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 in blocco in cui puoi specificare quali origini dati SAP 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, segui questi passaggi:

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

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

2. Fai clic su ABAP SDK for Google Cloud > Basic Settings > BigQuery Data Transfer: Settings Maintenance.

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

   Per una nuova configurazione di trasferimento collettivo, lascia vuoto il campo Chiave di trasferimento collettivo.

4. Fai clic sull'icona Esegui. Viene visualizzata la schermata Manutenzione delle impostazioni di BigQuery Data Transfer Service - Trasferimenti collettivi.

Specifica la creazione della tabella e altri attributi generali

Nella sezione iniziale di una configurazione di trasferimento collettivo BigQuery, identifichi la configurazione di trasferimento collettivo e specifichi la chiave client associata, nonché determinate 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 seguenti sono necessari per una configurazione di trasferimento collettivo.

Per specificare gli attributi della tabella:

1. Nella schermata 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 Chiave di 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 Utilizza flag 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 inserimento 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 Flag campi aggiuntivi.

      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 di dati, la casella di controllo Interrompi al primo errore è selezionata per impostazione predefinita. Ti consigliamo di lasciare questa casella selezionata. Per ulteriori informazioni, vedi Il flag BREAK.

   5. (Facoltativo) Per ridurre automaticamente le dimensioni del chunk quando le dimensioni in byte di un chunk superano le dimensioni massime in byte per le richieste HTTP che BigQuery accetta, seleziona la casella di controllo Flag per le dimensioni dinamiche dei chunk. Per ulteriori informazioni sulle dimensioni dinamiche dei chunk, vedi Dimensioni dinamiche dei chunk.

   6. Quando viene rilevato un record con un errore nei dati, per ignorarlo e continuare a inserire record nella tabella BigQuery, seleziona la casella di controllo Ignora flag record non validi. Ti consigliamo di lasciare questa casella deselezionata. Per ulteriori informazioni, vedi Il flag SKIP.

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

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

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

   9. Nel campo Is Setting Active Flag (Il 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 nella tabella /GOOG/BQTR_MASTR e i campi Modificato da, Modificato il e Modificato alle vengono compilati automaticamente.

   11. Fai clic su Mostra tabella.

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

Specifica gli attributi della tabella

Puoi specificare gli attributi della tabella, come il nome e il partizionamento, nonché il numero di record da includere in ogni trasmissione o blocco 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 dizionario SAP di origine, ad esempio tabelle, viste 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 crea la tabella con questo nome. Per le convenzioni di denominazione di BigQuery per le tabelle, consulta Denominazione delle tabelle.

4. Per inviare dati non compressi per tutti i campi di una tabella, seleziona Invia flag non compresso. Se questa impostazione è abilitata, BigQuery Toolkit for SAP replica tutti i campi vuoti nei record di origine con i valori con cui i campi vengono inizializzati nella tabella di origine. Per ottenere prestazioni migliori, non selezionare questo flag.

   Se devi inviare dati non compressi solo per campi specifici, non selezionare Invia flag 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, vedi Modificare la compressione dei record a livello di campo.

   Per maggiori informazioni sul comportamento della compressione dei record, vedi Compressione dei record.

5. (Facoltativo) Nel campo Dimensione chunk, specifica il numero massimo di record da includere in ogni chunk inviato a BigQuery. Ti consigliamo di utilizzare la dimensione predefinita del blocco con BigQuery Toolkit for SAP, ovvero 10.000 record. Se necessario, puoi aumentare la dimensione del blocco fino a 50.000 record, che è la dimensione massima del blocco consentita da BigQuery Toolkit for 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 dei chunk. In questo caso, prova a ridurre le dimensioni del blocco per ridurre le dimensioni in byte. Per maggiori informazioni, vedi Dimensioni dei blocchi di trasferimento dei dati. In alternativa, per regolare automaticamente le dimensioni dei segmenti, attiva le dimensioni dinamiche dei segmenti. Per ulteriori informazioni, vedi Dimensioni dinamiche dei chunk.

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, vedi Partizionamento delle tabelle.

7. (Facoltativo) Nel campo Campo di partizionamento, specifica il nome di un campo nella tabella BigQuery di destinazione che contiene un timestamp da utilizzare per il partizionamento. Quando specifichi Campo partizione, devi anche specificare Tipo di partizione. Per ulteriori informazioni, vedi Partizionamento delle tabelle.

8. Nel campo Is Setting Active Flag, 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 predefinita del chunk e nessuna partizione.

9. Fai clic su Salva.

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

10. Fai clic su Mostra campi.

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

Personalizzare la mappatura campi predefinita

Se la tabella SAP di origine contiene campi timestamp o booleani, modifica il mapping predefinito dei tipi di dati 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 di destinazione.

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

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

Per personalizzare il mapping predefinito per i campi BigQuery di destinazione:

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

2. Modifica i tipi di dati target predefiniti nella colonna Elemento di dati esterni in base alle tue esigenze. 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 target predefinito da STRING a BOOLEAN.
   • Esadecimali. Modifica il tipo di dati target predefinito da STRING a BYTES.

   Per modificare la mappatura predefinita dei tipi di dati:

   1. Nella riga del campo da modificare, fai clic sul campo Elemento di dati esterni.
   2. Nella finestra di dialogo per i tipi di dati, seleziona il tipo di dati BigQuery di cui hai bisogno.
   3. Conferma le modifiche, quindi 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 in base alle esigenze.

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

4. Modifica le descrizioni predefinite dei campi target nella colonna Descrizione campo in base alle necessità.

5. (Facoltativo) Esporta la mappatura dei campi per la modifica esterna. Per istruzioni, vedi Modificare la mappatura dei campi BigQuery in un file CSV.

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

7. Fai clic su Salva.

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

Modificare la compressione dei record a livello di campo

Per migliorare il rendimento della replica, BigQuery Toolkit per 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 loro valori iniziali in BigQuery continuando a utilizzare la compressione dei record, puoi selezionare Invia flag non compresso per questi campi specifici.

Per maggiori informazioni sul comportamento della compressione dei record, vedi 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 per la tabella di cui stai configurando il trasferimento collettivo.

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

3. Fai clic su Salva.

Assistenza

Google Cloud offre assistenza per problemi e domande relativi all'installazione, alla configurazione, al funzionamento e alla manutenzione di BigQuery Toolkit per SAP.

Per i problemi derivanti da componenti gestiti da SAP, come Operational Data Provisioning (ODP), Data Migration Server (DMIS), Core Data Services (CDS), Internet Communication Manager (ICM) o software di terze parti, Google Cloud Customer Care si impegna al massimo per identificare la causa principale. Per risolvere questi problemi, contatta il fornitore o il provider di assistenza pertinente.

Per risolvere i problemi relativi a BigQuery Toolkit for SAP, consulta Risoluzione dei problemi relativi a BigQuery Toolkit for SAP.

Se hai bisogno di aiuto per risolvere i problemi relativi all'ABAP SDK for Google Cloud, procedi nel seguente modo:

• Consulta la guida alla risoluzione dei problemi di ABAP SDK for Google Cloud.

• Poni le tue domande e discuti di ABAP SDK for Google Cloud con la community nei forum di Cloud.

• Raccogli tutte le informazioni diagnostiche disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare l'assistenza clienti, vedi Assistenza per SAP su Google Cloud.