Gestire BigQuery Toolkit per le operazioni SAP

On-premises or any cloud edition v1.9

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

Questo documento mostra ad amministratori SAP, sviluppatori SAP o altri utenti come eseguire attività operative per BigQuery Toolkit per SAP.

Dimensioni dei chunk dinamiche

Se riscontri errori perché la dimensione in byte dei chunk supera la dimensione massima in byte per le richieste HTTP accettate da BigQuery, devi ridurre manualmente la dimensione in byte diminuendo le dimensioni dei chunk. La funzionalità di dimensione del chunk dinamico consente di ridurre automaticamente la dimensione del chunk e di riprovare la replica in BigQuery quando la dimensione in byte di un chunk supera la dimensione in byte massima per le richieste HTTP accettate da BigQuery. La dimensione del chunk dinamico ti aiuta a evitare la maggior parte degli errori di replica dovuti al superamento della dimensione in byte di una richiesta. Potresti ricevere un errore solo se la dimensione del chunk raggiunge 1, ma la dimensione in byte rimane superiore al limite di BigQuery per il numero di byte in ogni richiesta HTTP.

Attiva la dimensione del chunk dinamico nella configurazione del trasferimento dati per una tabella utilizzando la transazione /GOOG/BQTR_SETTINGS. La dimensione del chunk dinamico è un'impostazione facoltativa. Per informazioni su come attivare la dimensione del chunk dinamico, consulta Specificare la creazione della tabella e altri attributi generali.

Quando BigQuery Toolkit for SAP riduce le dimensioni del chunk, il seguente messaggio di informazione viene restituito all'applicazione ABAP chiamante nel parametro et_return:

Dynamic chunking triggered. Chunk size reduced from INITIAL_CHUNK_SIZE_VALUE to FINAL_REDUCED_CHUNK_SIZE_VALUE

Trasferisci le impostazioni di trasferimento di massa in produzione

Per trasportare le impostazioni di BigQuery Toolkit per il trasferimento collettivo SAP in produzione, esporta prima le impostazioni da un sistema di sviluppo, quindi importale nel sistema di produzione.

Facoltativamente, puoi importare in produzione due parti separate delle impostazioni di un trasferimento collettivo:

• Le impostazioni della chiave client della tabella /GOOG/CLIENT_KEY, a cui è possibile accedere utilizzando la transazione SM30.
• Il set di strumenti BigQuery per le impostazioni di trasferimento collettivo SAP, a cui è possibile accedere utilizzando la transazione /GOOG/BQTR_SETTINGS.

Nota: prima di spostare le impostazioni di trasferimento collettivo in produzione, convalidale in un ambiente di QA o sandbox.

Esportare le impostazioni di trasferimento collettivo da un sistema di sviluppo

Nel sistema di sviluppo SAP, esporta ogni parte delle impostazioni del trasferimento collettivo:

1. Esporta le impostazioni di BigQuery Toolkit per il trasferimento collettivo di SAP:

   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 campo Settings Table (Tabella delle impostazioni), seleziona Mass Transfer (Trasferimento collettivo).

   4. Seleziona i record di trasferimento collettivo da trasportare in produzione.

   5. Fai clic su Trasferimento collettivo dei trasporti.

   6. In Richiesta di richiesta di Workbench, inserisci il numero della richiesta di trasporto e fai clic sull'icona Continua. Per ogni record di trasferimento collettivo selezionato, le impostazioni delle seguenti tabelle di configurazione personalizzata sono incluse nel trasferimento:

      • /GOOG/BQTR_MASTR
      • /GOOG/BQTR_TABLE
      • /GOOG/BQTR_FIELD

   Le impostazioni di trasferimento collettivo vengono salvate in una richiesta di trasporto.

2. Esporta le impostazioni della chiave client includendo manualmente i contenuti della tabella /GOOG/CLIENT_KEY nella richiesta di trasporto.

3. Salva i file nella tua workstation locale.

Importa le impostazioni di trasferimento collettivo in un sistema di produzione

Importa la richiesta di trasporto contenente le impostazioni di trasferimento collettivo.

Nel sistema di produzione SAP, importa ogni parte delle impostazioni del trasferimento collettivo:

1. In SAP GUI, importa la richiesta di trasporto contenente le impostazioni di trasferimento collettivo.

2. 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.

3. Fai clic su ABAP SDK for Google Cloud > Impostazioni di base > Configura chiave client.

4. Aggiorna le impostazioni della chiave client in base alle esigenze dell'ambiente di produzione.

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

6. Verifica che nella schermata Trasferimenti collettivi vengano visualizzati i trasferimenti collettivi corretti.

7. Nelle successive schermate di impostazioni Tables (Tabelle) e Fields (Campi), aggiorna gli altri valori per la mappatura delle tabelle e dei campi in base alle esigenze dell'ambiente di produzione.

8. Testa la configurazione eseguendo il programma di caricamento dei dati che chiama BigQuery Toolkit per SAP.

Visualizzare le impostazioni di BigQuery Data Transfer

Per visualizzare le impostazioni di trasferimento collettivo del modulo BigQuery Data Transfer, segui questi passaggi:

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: visualizzazione impostazioni.

In alternativa, puoi visualizzare le impostazioni utilizzando la transazione /GOOG/BQTR_SETTINGS.

Convalida della replica

Quando specifichi l'opzione Extra Fields Flag nella configurazione del trasferimento collettivo, BigQuery Toolkit for SAP aggiunge colonne aggiuntive allo schema della tabella in BigQuery. Queste colonne acquisiscono i seguenti dettagli:

• Informazioni sul tipo di modifica che ha attivato la replica per ogni record.
• Un timestamp che indica quando BigQuery Toolkit for SAP ha ricevuto la parte contenente il record.

Utilizzando le informazioni in queste colonne, puoi convalidare la procedura di replica, garantendo l'integrità e la coerenza dei dati tra il tuo sistema SAP e BigQuery. Puoi utilizzare i tipi di modifica e il timestamp per eseguire query sui seguenti tipi di conteggi dei record:

• Il numero di record caricati in una tabella BigQuery durante un caricamento iniziale.
• Il numero di record replicati in un giorno specificato in una tabella BigQuery.
• Il numero totale di record univoci in una tabella BigQuery.

Per ottenere questi conteggi, puoi eseguire query direttamente sulla tabella BigQuery inviando query SQL nella console Google Cloud.

Per una panoramica del flag per i campi aggiuntivi, consulta Campi aggiuntivi per le modifiche ai record e le query di conteggio.

Query SQL per i conteggi dei record

Puoi eseguire query SQL per controllare i conteggi dei record nelle tabelle BigQuery utilizzando la pagina Editor SQL di BigQuery nella console Google Cloud.

Impostazione della tabella obbligatoria per i conteggi dei record: le query SQL in questa sezione richiedono di specificare il flag per i campi aggiuntivi quando specifichi le opzioni della tabella BigQuery durante la configurazione della replica. Per ulteriori informazioni, consulta Campi aggiuntivi per le modifiche dei record e le query di conteggio.

Esegui una query sul conteggio dei record inseriti in modalità di caricamento iniziale

Quando lo schema di una tabella BigQuery include la colonna facoltativa operation_flag, i record inseriti nella tabella in modalità di caricamento iniziale includono il flag di operazione L.

Per ottenere il conteggio dei record ricevuti da BigQuery durante un caricamento iniziale, esegui la seguente query:

SELECT COUNT(*)
  FROM
      `PROJECT.DATASET.TABLE`
  WHERE operation_flag = 'L'

Esegui una query sul numero di record inseriti in modalità di replica

Quando lo schema di una tabella BigQuery include la colonna facoltativa operation_flag, i record inseriti nella tabella in modalità di replica includono uno dei seguenti flag di operazione:

• I: il record è stato inserito nella tabella di origine.
• D: il record è stato eliminato dalla tabella di origine.
• U: il record è stato aggiornato nella tabella di origine.

Per ottenere il conteggio dei record ricevuti da BigQuery in modalità di replica, esegui la seguente query:

SELECT COUNT(*)
  FROM
      `PROJECT.DATASET.TABLE`
  WHERE operation_flag = 'I' | 'D' | 'U'

Esegui una query sul conteggio totale dei record in una tabella BigQuery

Quando lo schema di una tabella BigQuery include la colonna facoltativa recordstamp, il campo recordstamp corrispondente di ogni record inserito nella tabella contiene un timestamp che indica quando il record è stato inviato da BigQuery Toolkit per SAP a BigQuery.

Per ottenere un conteggio totale dei record in una tabella BigQuery che puoi confrontare con il conteggio totale dei record in una tabella di origine, puoi utilizzare i campi recordstamp e is_deleted per conteggiare i record unici nella tabella BigQuery che non sono stati eliminati dalla tabella di origine.

Se la tabella di origine viene aggiornata attivamente o se la replica è attiva quando esegui query sui record, il conteggio dei record nelle tabelle di origine e di destinazione potrebbe non corrispondere esattamente.

Per ottenere il conteggio corrente dei record univoci nella tabella di destinazione BigQuery, esegui la seguente query:

SELECT COUNT(*)
  FROM (
    SELECT
      *,
      ROW_NUMBER() OVER (PARTITION BY KEY_FIELD_1, ..., KEY_FIELD_N ORDER BY recordstamp DESC) row_num
    FROM
      `PROJECT.DATASET.TABLE` )
  WHERE row_num = 1 AND is_deleted = false

Modificare la mappa dei campi BigQuery in un file CSV

Le sezioni seguenti descrivono come esportare la mappatura dei campi predefinita in modo che i data engineer o gli amministratori di BigQuery possano modificare i valori dei campi target senza dover accedere al sistema SAP.

Quando modifichi i valori del campo target, rispetta le seguenti regole:

• Non modificare i valori nelle colonne Nome origine dati SAP e Nome campo SAP.
• Nella colonna Send Uncompressed Flag (Invia indicatore non compresso), per attivare la compressione dei record, contrassegna il campo solo con X. In caso contrario, lascia vuoto il campo.

Crea un foglio di lavoro o un file di testo delle mappature dei campi predefinite

Per creare un file CSV da modificare al di fuori del server SAP, svolgi i seguenti passaggi:

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. Nella schermata Manutenzione delle impostazioni di BigQuery Data Transfer, specifica i seguenti valori:

   • Nel campo Settings Table (Tabella delle impostazioni), specifica Fields (Campi).
   • Nel campo Mass Transfer Key (Chiave trasferimento collettivo), specifica l'ID del trasferimento collettivo che stai aggiornando.
   • Nel campo Nome tabella, lascia vuoto il campo per lavorare con tutti i campi di tutte le tabelle o specifica un nome tabella per lavorare con una tabella specifica.
   • Lascia vuoti tutti gli altri campi.

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

5. Nella schermata BigQuery Data Transfer Settings Maintenance - Fields (Manutenzione delle impostazioni di trasferimento dati di BigQuery - Campi), nascondi tutte le colonne tranne quelle nell'elenco seguente facendo clic con il tasto destro del mouse sulle intestazioni delle colonne e selezionando Nascondi dal menu a discesa:

   • Nome origine dati SAP
   • Nome campo SAP
   • Elemento dati esterni
   • Nome campo esterno
   • Descrizione campo
   • Invia flag non compresso

6. Con le sei colonne rimanenti visualizzate, fai clic sull'icona Esporta.

7. Dal menu Esporta, seleziona una delle seguenti opzioni:

   • Foglio di lavoro
   • File locale. Per facilitare la conversione dei contenuti del file in formato CSV, consigliamo di salvarlo nel formato Testo con tabulazioni.

8. Salva le mappature dei campi predefinite facendo clic sull'icona Spunta.

Converti il foglio di lavoro o il file di testo in formato CSV

Per caricare le mappature dei campi modificate utilizzando la transazione personalizzata/GOOG/BQTR_SETTINGS, le mappature dei campi devono essere in formato CSV.

Se utilizzi un foglio di lavoro, salvalo come file CSV prima di caricarlo.

Se utilizzi un file locale in un formato separato da tabulazioni o in qualsiasi altro formato, devi modificarlo in modo che sia conforme al formato CSV.

Ad esempio:

SAP Table,SAP Field Name,External Data Element,External Field Name,Field Description, Send Uncompressed Flag
SAP_TABLE_NAME,SAP_FIELD_NAME1,BIGQUERY_DATA_TYPE,BIGQUERY_FIELD_NAME1,BIGQUERY_FIELD_DESCRIPTION1, SEND_UNCOMPRESSED_FLAG1
SAP_TABLE_NAME,SAP_FIELD_NAME2,BIGQUERY_DATA_TYPE,BIGQUERY_FIELD_NAME2,BIGQUERY_FIELD_DESCRIPTION2, SEND_UNCOMPRESSED_FLAG2
SAP_TABLE_NAME,SAP_FIELD_NAME3,BIGQUERY_DATA_TYPE,BIGQUERY_FIELD_NAME3,BIGQUERY_FIELD_DESCRIPTION3, SEND_UNCOMPRESSED_FLAG3

Carica il file CSV

Per caricare un file CSV modificato:

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. Nella schermata BigQuery Data Transfer: Settings Maintenance (BigQuery Data Transfer: manutenzione impostazioni), specifica i seguenti valori:

   • Nel campo Settings Table (Tabella delle impostazioni), specifica Fields (Campi).
   • Nel campo Mass Transfer Key (Chiave trasferimento collettivo), specifica l'ID del trasferimento collettivo che stai aggiornando.
   • Seleziona la casella di controllo Carica da file.

4. Fai clic sull'icona Esegui. Viene visualizzata la finestra di dialogo Seleziona file da caricare.

5. Nella finestra di dialogo Seleziona file da caricare, seleziona il file CSV che contiene i valori dei campi modificati.

6. Fai clic su Apri.

7. Se ricevi un avviso di sicurezza, fai clic su Consenti. Il file viene caricato e i valori modificati nel file vengono visualizzati nelle righe applicabili nella schermata BigQuery Settings Maintenance - Fields.

8. Fai clic sull'icona Salva.

9. Per verificare che i valori siano applicati, confrontali con quelli nel file CSV con quelli visualizzati nel sistema SAP.

Gestione degli errori nei dati di origine

Quando l'API BigQuery Streaming riceve un blocco di record da BigQuery Toolkit per SAP, controlla la presenza di errori nei dati prima di inserire i record nella tabella BigQuery.

Puoi controllare la modalità di risposta dell'API BigQuery e del Toolkit BigQuery per SAP quando vengono rilevati errori nei dati specificando i seguenti flag nelle impostazioni del trasferimento collettivo:

• Il flag Skip Invalid Records (SKIP)
• Il flag Break at First Error Flag (BREAK)

Il flag SKIP

Se specifichi il flag SKIP, quando l'API BigQuery riceve un chunk di record e ne trova uno con un errore nei dati, lo ignora o lo salta e continua a inserire tutti gli altri record del chunk nella tabella BigQuery.

Se non specifichi il flag SKIP, quando BigQuery trova un record con un errore nei dati, ignora l'intero chunk senza inserire alcun record nella tabella BigQuery. Questo comportamento è predefinito.

La specifica del flag SKIP è ideale per gli ambienti di sviluppo e QA e non è consigliata per gli ambienti di produzione.

Puoi specificare il flag SKIP nella transazione /GOOG/BQTR_SETTINGS quando configuri la replica. La specifica è memorizzata nella tabella di configurazione /GOOG/BQTR_MASTR.

Per sapere in che modo le specifiche SKIP interagiscono con le specifiche BREAK, consulta la tabella della matrice per le interazioni SKIP e BREAK.

Il flag BREAK

Se specifichi il flag BREAK, quando BigQuery Toolkit for SAP riceve una notifica dall'API BigQuery che indica che è stato rilevato un errore nei dati di un record, BigQuery Toolkit for SAP interrompe l'invio dei record a BigQuery e termina il job di replica. Questo comportamento è predefinito.

Se non specifichi il flag BREAK, quando BigQuery Toolkit for SAP viene informato da BigQuery che è stato rilevato un errore nei dati di un record, BigQuery Toolkit for SAP continua a inviare record a BigQuery inviando il chunk successivo e il job di replica continua.

Lo specificare il flag BREAK è consigliato negli ambienti di produzione.

Puoi specificare il flag BREAK nella transazione /GOOG/BQTR_SETTINGS quando configuri la replica. Quando crei una nuova chiave per il trasferimento collettivo, il flag BREAK è attivato per impostazione predefinita.

La specifica è memorizzata nella tabella di configurazione /GOOG/BQTR_MASTR.

Per sapere in che modo le specifiche BREAK interagiscono con le specifiche SKIP, consulta la tabella della matrice per le interazioni SKIP e BREAK.

Tabella di matrice per le interazioni di SKIP e BREAK

Puoi configurare il modulo BigQuery Data Transfer per gestire gli errori di dati nei modi seguenti:

SKIP flag	BREAK flag	Comportamento
FALSO	VERO	BigQuery ignora il chunk corrente di record senza inserire alcun record del chunk corrente nella tabella BigQuery. BigQuery Toolkit for SAP non invia più blocchi di record dalla parte corrente e termina il job di replica. Si tratta dell'impostazione predefinita e consigliata.
FALSO	FALSO	BigQuery ignora il chunk corrente di record senza inserire alcun record del chunk corrente nella tabella BigQuery. BigQuery Toolkit per SAP invia gli eventuali blocchi rimanenti di record dalla parte corrente e recupera la parte successiva. BigQuery Toolkit per SAP non termina il job di replica.
VERO	VERO	BigQuery ignora solo il record contenente l'errore e inserisce il resto dei record nel chunk corrente nella tabella BigQuery. BigQuery Toolkit per SAP non invia più blocchi di record dalla parte corrente e termina il job di replica.
VERO	FALSO	BigQuery ignora solo il record contenente l'errore e inserisce il resto dei record nel chunk corrente nella tabella BigQuery. BigQuery Toolkit per SAP invia gli eventuali blocchi rimanenti di record dalla parte corrente e recupera la parte successiva. BigQuery Toolkit per SAP non termina il job di replica.

Modifiche alla struttura degli oggetti del dizionario SAP

Questa sezione spiega come gestire le modifiche alla definizione degli oggetti del dizionario in SAP.

Aggiungere una colonna all'oggetto dizionario

Se aggiungi una colonna a un oggetto dizionario:

1. Interrompi l'applicazione di replica dei dati personalizzati che utilizza la classe di caricamento dei dati /GOOG/CL_BQTR_DATA_LOAD.
2. Aggiungi una nuova colonna all'oggetto del dizionario in SAP.
3. Facoltativamente, aggiorna la mappatura a livello di campo nella transazione /GOOG/BQTR_SETTINGS.
4. Riavvia l'applicazione di replica dei dati personalizzati.
5. Convalida il risultato della replica in BigQuery.

Eliminare una colonna dall'oggetto dizionario

Per eliminare una colonna esistente da un oggetto dizionario:

1. Interrompi l'applicazione di replica dei dati personalizzati che utilizza la classe di caricamento dei dati /GOOG/CL_BQTR_DATA_LOAD.
2. Elimina una colonna dall'oggetto dizionario.
3. In BigQuery, elimina la colonna dalla tabella BigQuery di destinazione. Per ulteriori informazioni sulla procedura per eliminare una colonna da una tabella esistente, consulta la documentazione di BigQuery.
4. Facoltativamente, aggiorna la mappatura a livello di campo nella transazione /GOOG/BQTR_SETTINGS.
5. Riavvia l'applicazione di replica dei dati personalizzati.
6. Convalida il risultato della replica in BigQuery.

Modificare il tipo di dati di una colonna esistente

Quando modifichi il tipo di dati di una colonna esistente nell'oggetto del dizionario SAP, devi seguire passaggi specifici a seconda che il tipo di dati sia compatibile o meno con la tabella BigQuery di destinazione.

Un tipo di dati è compatibile con il tipo di dati nella tabella BigQuery di destinazione quando il tipo di dati esistente e il nuovo tipo di dati di una colonna esistente mappano allo stesso tipo di dati nella tabella BigQuery di destinazione. Ad esempio, se il tipo di dati di una colonna viene modificato da INT1 in INT2 in una tabella di origine, entrambi i tipi di dati sono compatibili con il tipo di dati INTEGER nella tabella BigQuery di destinazione.

Per ulteriori informazioni sulla mappatura dei tipi di dati nel modulo BigQuery Data Transfer, consulta Mappatura dei tipi di dati.

Modificare il tipo di dati in un tipo di dati compatibile

Per modificare il tipo di dati di una colonna esistente in un tipo di dati compatibile:

1. Se vuoi, interrompi l'applicazione di replica dei dati personalizzati che utilizza la classe di caricamento dei dati /GOOG/CL_BQTR_DATA_LOAD.
2. Modifica il tipo di dati in un tipo di dati compatibile nel sistema di origine.
3. Facoltativamente, aggiorna la mappatura a livello di campo nella transazione /GOOG/BQTR_SETTINGS.
4. Se hai interrotto l'applicazione di replica dei dati personalizzati, riavviala.
5. Convalida il risultato della replica in BigQuery.

Modificare il tipo di dati in un tipo di dati non compatibile

Per modificare il tipo di dati di una colonna esistente in un tipo di dati non compatibile:

1. Interrompi l'applicazione di replica dei dati personalizzati che utilizza la classe di caricamento dei dati /GOOG/CL_BQTR_DATA_LOAD.
2. In BigQuery, elimina la tabella di destinazione.
3. Modifica il tipo di dati nel sistema di origine.
4. Facoltativamente, aggiorna la mappatura a livello di campo nella transazione /GOOG/BQTR_SETTINGS.
5. Avvia l'applicazione di replica dei dati personalizzati. Se necessario, potresti dover avviare un caricamento iniziale dei dati esistenti.

Uscite del miglioramento

Il BigQuery Toolkit per SAP fornisce diversi punti di miglioramento nel codice in cui uno sviluppatore ABAP può inserire codice per aggiungere funzionalità personalizzate.

Importante: sei responsabile di qualsiasi codice personalizzato scritto nell'implementazione di questi punti di miglioramento. Ti consigliamo vivamente di testare accuratamente il codice personalizzato in un ambiente non di produzione prima di eseguirlo in produzione. Google Cloud non fornisce assistenza per le funzionalità personalizzate.

Classi

La tabella seguente elenca le funzioni supportate dai punti di miglioramento, i metodi e la classe che contiene il punto di miglioramento.

Funzione	Classe	Metodo	Spot	Opzione
Aggiorna la mappatura di un campo, ad esempio il nome del campo esterno e il tipo di dati.	/GOOG/CL_BQTR_DATA_LOAD_BASE	CREATE_FLD_MAPPINGS	/GOOG/ES_BQTR_DATA_LOAD_BASE	/GOOG/UPDATE_FIELD_MAPPING
Aggiorna la mappatura per la tabella dei campi aggiungendo o rimuovendo campi.	/GOOG/CL_BQTR_DATA_LOAD_BASE	CREATE_FLD_MAPPINGS	/GOOG/ES_BQTR_DATA_LOAD_BASE	/GOOG/UPDATE_FIELD_MAPPINGS
Modifica il valore di un campo di origine prima che venga convertito in un campo di destinazione.	/GOOG/CL_BQTR_DATA_LOAD	FILL_TARGET_RECORDS	/GOOG/ES_BQTR_DATA_LOAD	/GOOG/CHANGE_SOURCE_FIELD
Dopo aver convertito un campo di origine in un campo di destinazione nella tabella di destinazione, modifica il valore del campo di destinazione.	/GOOG/CL_BQTR_DATA_LOAD	FILL_TARGET_RECORDS	/GOOG/ES_BQTR_DATA_LOAD	/GOOG/FILL_TARGET_FIELD
Aggiungi alla tabella di destinazione un campo che non esiste nella tabella di origine durante la conversione della tabella di origine in quella di destinazione.	/GOOG/CL_BQTR_DATA_LOAD	FILL_TARGET_RECORDS	/GOOG/ES_BQTR_DATA_LOAD	/GOOG/FILL_EXTRA_FIELD
Prepara un campo dello schema BigQuery prima della creazione della tabella BigQuery.	/GOOG/CL_BQTR_CLIENT_BQ_BASE	PREP_BQ_TABLE_SCHEMA	/GOOG/ES_BQTR_CLIENT_BQ	/GOOG/PREPARE_SCHEMA_FIELD
In caso di errori HTTP provenienti dal lato server di BigQuery, per risolvere il problema, puoi raccogliere i dati di log dopo le chiamate HTTP all'API BigQuery.	/GOOG/CL_BQTR_CLIENT_BQ_REPL	INSERT_TABLEDATA	/GOOG/ES_BQTR_CLIENT_BQ_REPL	/GOOG/LOG_INSERT_ERROR

Report

La tabella seguente elenca le funzioni supportate dai punti di miglioramento, i metodi e i report che contengono il punto di miglioramento.

Funzione	Report	Metodo	Spot	Opzione
Per aggiungere controlli dell'autorità al programma delle impostazioni di BigQuery Data Transfer.	/GOOG/R_BQTR_SETTINGS	AUTHORITY_CHECK	/GOOG/ES_BQTR_SETTINGS	/GOOG/AUTHORITY_CHECK

Impostazioni avanzate

Se vuoi, puoi modificare le impostazioni avanzate di BigQuery Toolkit per SAP. Ti consigliamo di modificare i parametri delle impostazioni avanzate solo dopo un'analisi completa e l'impatto dei nuovi valori sul rendimento. È tua responsabilità assicurarti che le nuove impostazioni avanzate di BigQuery Toolkit per SAP non causino errori e problemi di prestazioni.

Avviso: non modificare le impostazioni avanzate di BigQuery Toolkit per SAP quando è in corso un caricamento iniziale.

Le impostazioni avanzate di BigQuery Toolkit per SAP vengono applicate a livello di sistema e sono comuni per tutte le chiavi di trasferimento collettivo. Se i parametri delle impostazioni avanzate non vengono modificati, BigQuery Toolkit per SAP funziona con le impostazioni predefinite.

Per modificare i parametri delle impostazioni avanzate:

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 Settings Table (Tabella delle impostazioni), seleziona Parameters (Parametri).

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

5. Fai clic sull'icona Inserisci riga.

6. Nella riga visualizzata, specifica le seguenti impostazioni:

   1. Nel campo Nome parametro, inserisci il nome del parametro. La descrizione del parametro viene compilata automaticamente.

   2. Nel campo Valore parametro, inserisci un valore.

      Per informazioni sui parametri delle impostazioni avanzate, consulta Parametri delle impostazioni avanzate.

7. Fai clic su Salva.

   Le impostazioni avanzate vengono memorizzate come record nella tabella di configurazione /GOOG/BQ_PARAM e i campi Modificato da, Modificato il e Modificato il vengono compilati automaticamente.

Parametri delle impostazioni avanzate

La tabella seguente mostra i parametri delle impostazioni avanzate per BigQuery Toolkit per SAP.

Nome parametro	Descrizione	Valore predefinito	Valore valido
CHUNK_SIZE_DEF	Questa impostazione è la dimensione del chunk predefinita supportata da BigQuery Toolkit for SAP. Se nelle impostazioni non viene impostata una dimensione del chunk, viene utilizzata la dimensione predefinita.	10.000	Il valore deve rientrare nei limiti di quota di BigQuery.
PERC_REDUC_DEF	La riduzione percentuale delle dimensioni dei chunk. Se la dimensione del chunk dinamico è abilitata, la dimensione del chunk viene ridotta di questa percentuale fino a raggiungere una dimensione ideale del chunk e i dati nel chunk vengono trasferiti correttamente a BigQuery.	50	Il valore deve essere compreso tra 1 e 99.

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:

• Fai riferimento alla guida alla risoluzione dei problemi dell'ABAP SDK for Google Cloud.

• Fai le tue domande e discuti dell'ABAP SDK per 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 il servizio clienti, vedi Ricevere assistenza per SAP su Google Cloud.