Risoluzione dei problemi relativi a BigQuery Toolkit per SAP

Questo documento mostra ad amministratori SAP, sviluppatori SAP o altri come risolvere i problemi relativi a BigQuery Toolkit per SAP.

Problemi comuni

Questa sezione elenca i messaggi di errore comuni e la relativa risoluzione specifici per il BigQuery Toolkit per SAP.

Per informazioni sulla risoluzione dei problemi relativi all'SDK ABAP per Google Cloud in generale, consulta Risolvere i problemi dell'edizione on-premise o cloud dell'SDK ABAP per Google Cloud.

/GOOG/BQTR: Mass Transfer Key is required. Use Tcode /GOOG/BQTR_SETTINGS to maintain

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/BQTR: Mass Transfer Key is required. Use Tcode /GOOG/BQTR_SETTINGS to maintain.

Causa: la chiave di trasferimento collettivo non è fornita nel parametro IV_MASS_TR_KEY quando viene chiamata la classe di caricamento dei dati /GOOG/CL_BQTR_DATA_LOAD.

Soluzione:per risolvere il problema, passa una chiave di trasferimento collettivo salvata nella transazione /GOOG/BQTR_SETTINGS. Per ulteriori informazioni, consulta Chiama il metodo di replica dei dati.

/GOOG/BQTR: Data Source is required. Pass a dictionary object

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/BQTR: Data Source is required. Pass a dictionary object.

Causa: l'origine dati non è fornita nel parametro IV_DATA_SOURCE quando viene chiamata la classe di caricamento dei dati /GOOG/CL_BQTR_DATA_LOAD.

Risoluzione: per risolvere il problema, passa il nome dell'oggetto del dizionario, ad esempio la vista o la tabella CDS, come origine dati. Per ulteriori informazioni, consulta Chiama il metodo di replica dei dati.

/GOOG/BQTR: Mass Transfer Key MASS_TRANSFER_KEY not found. Use Tcode /GOOG/BQTR_SETTINGS to maintain

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/BQTR: Mass Transfer Key MASS_TRANSFER_KEY not found. Use Tcode /GOOG/BQTR_SETTINGS to maintain.

Causa: la chiave di trasferimento collettivo passata alla classe di caricamento dei dati /GOOG/CL_BQTR_DATA_LOAD non viene gestita nel modulo BigQuery Data Transfer.

Risoluzione: per risolvere il problema, mantieni una chiave di trasferimento collettivo utilizzando il codice transazione /GOOG/BQTR_SETTINGS. Per ulteriori informazioni, consulta Configurare il modulo BigQuery Data Transfer.

/GOOG/BQTR: DATA_SOURCE does not exist in data dictionary

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/BQTR: DATA_SOURCE does not exist in data dictionary.

Causa: l'origine dati passata alla classe di caricamento dei dati /GOOG/CL_BQTR_DATA_LOAD non è un oggetto del dizionario di dati valido.

Risoluzione: per risolvere il problema, passa il nome dell'origine dati esistente nel dizionario dei dati. Sono supportate solo tabelle, viste di dizionario e viste CDS.

/GOOG/BQTR: Nested Tables are not supported

Problema: ricevi il messaggio di errore /GOOG/BQTR: Nested Tables are not supported.

Causa: l'oggetto dizionario passato come input alla classe di caricamento dei dati /GOOG/CL_BQTR_DATA_LOAD non è una struttura piatta.

Soluzione:per risolvere il problema, utilizza un oggetto dizionario con una struttura piatta.

/GOOG/BQTR: Error creating target table definition

Problema: ricevi il messaggio di errore /GOOG/BQTR: Error creating target table definition.

Causa: BigQuery Toolkit for SAP non è in grado di creare la definizione della tabella di destinazione per l'origine dati specificata.

Soluzione:per risolvere il problema, verifica che l'origine di input sia un oggetto dizionario valido con uno o più campi.

/GOOG/BQTR: 400 - Table creation failed in BQ. Could not pull the table metadata from BQ

Problema: ricevi il messaggio di errore /GOOG/BQTR: 400 - Table creation failed in BQ. Could not pull the table metadata from BQ.

Causa:questo errore viene generato se il modulo BigQuery Data Transfer non riesce a recuperare la definizione della tabella da BigQuery. Questo potrebbe essere causato da un sovraccarico temporaneo del server in BigQuery.

Risoluzione:per risolvere il problema, riavvia l'operazione di caricamento dei dati BigQuery.

/GOOG/BQTR: 400 - Scope must be provided

Problema: ricevi il messaggio di errore /GOOG/BQTR: 400 - Scope must be provided.

Causa: nella configurazione della chiave client, l'ambito Google Cloud è vuoto.

Risoluzione:per risolvere il problema, specifica l'ambito corrispondente nel campo Ambito Google Cloud per la configurazione della chiave client in uso, ad esempio https://www.googleapis.com/auth/cloud-platform.

/GOOG/BQTR: 400 - Schema mismatch for table TABLE_NAME

Problema: ricevi il messaggio di errore /GOOG/BQTR: 400 - Schema mismatch for table TABLE_NAME. Please delete the table from BigQuery and try again.

Causa: è stata inserita una delle seguenti modifiche per una tabella BigQuery esistente:

  • Eliminazione di un campo
  • Ridenominazione di un campo
  • Modifica del tipo di dati di un campo
  • Modifica del tipo di partizione di una tabella

Le modifiche precedenti non possono essere applicate a una tabella BigQuery esistente.

Risoluzione:se devi modificare uno di questi attributi di campo in una tabella esistente, devi eliminare la tabella esistente e ricaricare i record in una nuova tabella.

Messaggi di errore relativi a dati non validi

Problema: nei log dell'applicazione viene visualizzato il messaggio di errore: /GOOG/BQTR/: DESCRIPTION_OF_INVALID_DATA error occurred in FIELD_NAME in record RECORD_KEYS.

Causa: questo messaggio di errore viene emesso da BigQuery quando vengono inseriti i record con dati non validi nella tabella di destinazione. I dati potrebbero non essere validi per uno dei seguenti motivi:

  • I dati nel campo di un determinato record non sono compatibili con il tipo di dato in BigQuery. Ad esempio, BigQuery genera messaggi di errore quando:
    • Una stringa viene gestita in un campo di tipo DATE, INTEGER o BOOLEAN.
    • Una data non valida (00/00/0000) viene mantenuta in un campo di tipo DATE.
  • Un tipo di dati di destinazione errato viene mantenuto nelle mappature dei campi nella transazione /GOOG/BQTR_SETTINGS.

BigQuery genera un messaggio di errore per ogni record che contiene un campo con dati non validi.

Risoluzione: analizza il messaggio di errore,DESCRIPTION_OF_INVALID_DATA, per comprendere la possibile causa dei dati non validi. Per identificare il record con il campo che contiene i dati non validi, utilizza RECORD_KEYS, che include i contenuti dei primi cinque campi del record. Se la tabella contiene al massimo cinque campi, i contenuti di tutti i campi sono inclusi in RECORD_KEYS.

  • Se i dati nel campo non sono compatibili con il tipo di dato in BigQuery, correggi i dati nella tabella di origine.
  • Se l'errore si è verificato a causa di una mancata corrispondenza tra i dati e il tipo di dati, utilizza la transazione /GOOG/BQTR_SETTINGS per specificare un tipo di dati appropriato.

/GOOG/BQTR: 403 - Access Denied: Dataset PROJECT_ID:DATASET_NAME: Permission bigquery.tables.created denied on dataset

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/BQTR: 403 - Access Denied: Dataset PROJECT_ID:DATASET_NAME: Permission bigquery.tables.created denied on dataset.

Causa: per il tuo carico di lavoro SAP in esecuzione su Google Cloud, nella tabella /GOOG/CLIENT_KEY, l'account di servizio specificato non dispone delle autorizzazioni necessarie per accedere all'API BigQuery.

Risoluzione:per risolvere il problema, svolgi i seguenti passaggi:

  1. Nella GUI di SAP, inserisci la transazione /GOOG/BQTR_SETTINGS preceduta da /n:

    /n/GOOG/BQTR_SETTINGS

  2. Per l'ID trasferimento collettivo non riuscito nella transazione LTRC, prendi nota del valore del campo Nome chiave Google Cloud.

  3. Inserisci la transazione SM30 e poi apri la tabella /GOOG/CLIENT_KEY.

  4. Per il valore Nome chiave Google Cloud che hai annotato in un passaggio precedente, annota il valore specificato per il campo Nome account di servizio.

  5. Nella console Google Cloud, vai alla pagina Account di servizio di Identity and Access Management.

    Vai ad Account di servizio

  6. Seleziona l'account di servizio che hai annotato in un passaggio precedente.

  7. Assicurati che l'account di servizio disponga dei ruoli IAM richiesti da BigQuery Toolkit per SAP per accedere a BigQuery, come indicato in Configurare l'autenticazione.

  8. Esegui di nuovo la replica.

/GOOG/BQTR: 404 - Not Found

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/BQTR: 404 - Not Found.

Causa: nelle destinazioni RFC utilizzate dall'SDK ABAP per Google Cloud per connettersi alle API Google Cloud , il prefisso del percorso non è corretto.

Risoluzione:per risolvere il problema, svolgi i seguenti passaggi:

  1. Nella GUI di SAP, inserisci la transazione /GOOG/BQTR_SETTINGS preceduta da /n:

    /n/GOOG/BQTR_SETTINGS

  2. Per l'ID trasferimento collettivo non riuscito nella transazione LTRC, prendi nota del valore del campo Nome chiave Google Cloud.

  3. Inserisci la transazione SM30 e poi apri la tabella /GOOG/SERVIC_MAP.

  4. Per il valore Nome chiave Google Cloud che hai annotato in un passaggio precedente, annota i nomi delle destinazioni RFC.

  5. Inserisci la transazione SM59, quindi completa i seguenti passaggi:

    • Per la destinazione RFC che si connette a BigQuery, assicurati che il valore del campo Prefisso percorso sia /bigquery/v2/.
    • Per la destinazione RFC che si connette a IAM, assicurati che il valore del campo Prefisso percorso sia /v1/.

  6. Esegui di nuovo la replica.

/GOOG/BQTR: 404 - Table PROJECT_ID:DATASET_NAME.TABLE_NAME not found

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/BQTR: 404 - Table PROJECT_ID:DATASET_NAME.TABLE_NAME not found.

Causa: nelle destinazioni RFC utilizzate dall'SDK ABAP per Google Cloud per connettersi alle API Google Cloud , il valore specificato per il campo Host target non corrisponde a nessun nome DNS in Cloud DNS.

Risoluzione:per risolvere il problema, svolgi i seguenti passaggi:

  1. In SAP GUI, inserisci il codice transazione /GOOG/BQTR_SETTINGS.

  2. Inserisci la chiave del trasferimento collettivo per la quale hai ricevuto questo errore.

  3. Fai clic sull'icona Esegui. Prendi nota del valore nella colonna Nome della chiave Google Cloud.

  4. Inserisci la transazione SM30 e apri la tabella /GOOG/CLIENT_KEY in modalità di visualizzazione.

  5. Cerca la tabella /GOOG/SERVIC_MAP utilizzando il nome della chiave Google Cloud che hai annotato in un passaggio precedente, quindi prendi nota dei nomi di destinazione RFC specificati.

  6. Inserisci il codice transazione SM59.

  7. Per le destinazioni RFC che utilizzi per connetterti alle API BigQuery e IAM, prendi nota del valore specificato per il campo Target Host.

  8. Nella console Google Cloud, vai alla pagina Cloud DNS di Servizi di rete.

    Vai a Cloud DNS

  9. Fai clic sulla zona privata contenente i record DNS per gli endpoint Private Service Connect che hai creato per consentire a BigQuery Toolkit for SAP di connettersi in privato alle API BigQuery e IAM.

  10. Assicurati che esista un record DNS con nome DNS corrispondente per ciascuno dei valori host target che hai annotato in un passaggio precedente.

  11. Esegui di nuovo la replica.

/GOOG/BQTR: 404 - Not Found Requested entity was not found

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/BQTR: 404 - Not Found Requested entity was not found.

Causa:per il tuo carico di lavoro in esecuzione su Google Cloud, l'account servizio utilizzato nella tabella delle chiavi client /GOOG/CLIENT_KEY non è valido.

Risoluzione:per risolvere il problema, svolgi i seguenti passaggi:

  1. Nella GUI di SAP, inserisci la transazione /GOOG/BQTR_SETTINGS preceduta da /n:

    /n/GOOG/BQTR_SETTINGS

  2. Inserisci la chiave di trasferimento collettivo per la quale hai ricevuto questo errore.

  3. Fai clic sull'icona Esegui. Prendi nota del valore nella colonna Nome della chiave Google Cloud.

  4. Inserisci la transazione SM30 e poi apri la tabella /GOOG/CLIENT_KEY.

  5. Per il campo Nome account di servizio, assicurati che il valore specificato sia l'indirizzo email dell'account di servizio creato per BigQuery Toolkit per SAP.

  6. Esegui di nuovo la replica.

/GOOG/BQTR: 413 - Request Entity Too Large

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/BQTR: 413 - Request Entity Too Large.

Causa: questo problema può verificarsi quando la dimensione in byte del chunk inviato da BigQuery Toolkit per SAP ha superato la dimensione massima in byte per le richieste HTTP accettate da BigQuery. Ciò può verificarsi quando le dimensioni dei record della tabella o la quantità di dati contenuti nei record fanno aumentare le dimensioni in byte di un chunk oltre il limite di BigQuery.

Risoluzione: riduci le dimensioni dei chunk inviati da BigQuery Toolkit per SAP per la tua tabella. Puoi regolare le dimensioni dei chunk eseguendo la transazione /GOOG/BQTR_SETTINGS o attivando le dimensioni dei chunk dinamiche per regolare automaticamente le dimensioni dei chunk. Per ulteriori informazioni, vedi:

/GOOG/BQTR: 404 - Not found: Dataset DATASET_NAME

Problema: quando provi a convalidare la Google Cloud sicurezza o a caricare i dati in una tabella BigQuery, ricevi il messaggio/GOOG/BQTR: 404 - Not found: Dataset DATASET_NAME.

Causa: questo problema può essere causato dalle seguenti circostanze:

  • Il set di dati BigQuery non è stato ancora creato.
  • Il nome del set di dati non è specificato correttamente nella configurazione del trasferimento collettivo.
  • La configurazione della replica nel modulo BigQuery Data Transfer deve essere attivata.

Risoluzione: prova le seguenti risoluzioni:

  • Verifica che il set di dati sia stato creato in BigQuery.
  • Verifica che il nome del set di dati nella configurazione del trasferimento collettivo sia uguale al nome del set di dati in BigQuery.

/GOOG/BQTR : Unable to interpret VALUE as a BOOLEAN

Problema: il caricamento o la replica di un record non riesce con il messaggio/GOOG/BQTR : Unable to interpret VALUE as a BOOLEAN.

Causa: questo problema è causato dalla mappatura di un campo nella tabella di origine al tipo di dati BigQuery BOOLEAN, ma i dati nel campo di origine non risolvono in un valore booleano.

Risoluzione: per risolvere il problema, utilizza la transazione /GOOG/BQTR_SETTINGS per modificare il tipo di dati a cui è mappato il campo di origine o per rimuovere la mappatura del tipo di dati e accettare il tipo di dati predefinito.

/GOOG/BQTR: Failed to convert field SAP_FIELD_NAME value to field BIGQUERY_FIELD_NAME: ERROR_DETAILS

Problema: il caricamento o la replica di un record non riesce con il messaggio/GOOG/BQTR: Failed to convert field SAP_FIELD_NAME value to field BIGQUERY_FIELD_NAME: ERROR_DETAILS.

Causa: il campo di origine contiene un valore non valido o è mappato a un tipo di dati BigQuery che non è una mappatura valida per i dati contenuti nel campo di origine.

Risoluzione: per risolvere il problema, utilizza la transazione /GOOG/BQTR_SETTINGS per modificare il tipo di dati a cui è mappato il campo di origine o rimuovi la mappatura del tipo di dati e accetta la mappatura predefinita per il tipo di dati.

/GOOG/BQTR: DESCRIPTION_OF_ISSUE error occurred in chunk ranging START_INDEX_OF_FAILED_CHUNK - END_INDEX_OF_FAILED_CHUNK

Problema: la replica di un chunk non è riuscita con un messaggio di errore/GOOG/BQTR: DESCRIPTION_OF_ISSUE error occurred in chunk ranging START_INDEX_OF_FAILED_CHUNK - END_INDEX_OF_FAILED_CHUNK.

Causa: può avere più di una causa, tra cui Invalid JSON Payload, Quota Exceeded, Request Entity Too Large o HTTP Communication Failure. Il messaggio di errore relativo al chunk di cui non è riuscita la replica in BigQuery viene visualizzato con l'indice iniziale e finale del chunk.

Questo messaggio di errore viene visualizzato se non hai impostato il flag BREAK nella transazione /GOOG/BQTR_SETTINGS. Quando il flag BREAK non è impostato, BigQuery Toolkit per SAP continua a inviare record a BigQuery inviando il chunk successivo anche quando si verifica un errore.

Risoluzione: Prova le seguenti risoluzioni:

  • Per problemi relativi a Quota Exceeded, Request Entity Too Large o HTTP Communication Failure, segui i passaggi per la risoluzione dei problemi relativi a /GOOG/BQTR: 413 - Request Entity Too Large.
  • Interrompi il caricamento corrente, elimina la tabella di destinazione da BigQuery e riavvia un nuovo caricamento.
  • Per interrompere l'invio di dati a BigQuery e terminare il job di replica quando viene rilevato un chunk con un errore, imposta il flag BREAK, che è consigliato negli ambienti di produzione.

Per informazioni sulla configurazione del flag BREAK, consulta Specificare la creazione della tabella e altri attributi generali.

Ricevere assistenza dalla community

Poni le tue domande e discuti di BigQuery Toolkit per SAP con la community nei forum di Cloud.

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.

Se hai bisogno di aiuto per risolvere i problemi relativi a BigQuery Toolkit per SAP, raccogli tutte le informazioni di diagnostica disponibili e contatta l'assistenza clienti Google Cloud.

Per ulteriori informazioni su come contattare l'assistenza clienti di Cloud, consulta Ricevere assistenza per SAP su Google Cloud.