Guida alla risoluzione dei problemi di BigQuery Connector per SAP

Puoi risolvere i problemi relativi alla versione 2.8 (ultima) di BigQuery Connector per SAP utilizzando sia la registrazione delle applicazioni SAP LT Replication Server sia i log di Google Cloud per esaminare i messaggi di errore e di log.

BigQuery Connector per SAP invia tutti gli errori ai log dell'applicazione SAP LT Replication Server standard.

Puoi anche utilizzare il debug di SAP LT Replication Server per isolare i problemi.

Panoramica della risoluzione dei problemi

Quando risolvi i problemi relativi a BigQuery Connector per SAP, esistono diverse aree su cui potresti dover concentrare la tua attenzione, a seconda dell'area o dell'ambito del problema che stai esaminando:

  • L'infrastruttura, ad esempio la rete, l'hardware o il sistema operativo.
  • Il software SAP, incluso il server di origine e SAP LT Replication Server.
  • BigQuery Connector per SAP.
  • BigQuery, inclusa l'API BigQuery e la tabella di destinazione.

Coinvolgere i team giusti

La prima cosa da fare per risolvere un problema è determinare in quale delle aree precedenti si verifica e qual è il suo ambito.

Per risolvere un problema, potresti dover collaborare con più team, ad esempio gli amministratori Basis, gli amministratori di SAP LT Replication Server, i DBA o gli amministratori della sicurezza di Google Cloud.

Coinvolgere tempestivamente le competenze e i team giusti può aiutarti a risolvere i problemi più rapidamente.

Determinare la causa principale

Devi determinare la causa principale del problema e assicurarti che ciò che ritieni possa essere la causa non sia in realtà solo un sintomo di una causa principale che si trova altrove.

I sistemi SAP sono strettamente integrati, ma possono scrivere log e tracce in file in più posizioni diverse. Durante la risoluzione dei problemi, devi determinare i log e i file di traccia corretti da esaminare.

Verifica i requisiti e i prerequisiti del software

Assicurati che tutto il software di sistema sia in esecuzione nelle versioni minime richieste e che tutti i prerequisiti di BigQuery Connector per SAP siano soddisfatti.

Per informazioni sui prerequisiti per l'installazione di BigQuery Connector per SAP, consulta:

  • Se SAP LT Replication Server è in esecuzione su una VM Compute Engine, consulta Prerequisiti.

  • Se SAP LT Replication Server è in esecuzione su un host esterno a Google Cloud, consulta Prerequisiti.

Per i requisiti del software BigQuery Connector per SAP, consulta Requisiti del software.

Se utilizzi un software ECC precedente, assicurati che la versione di SAP LT Replication Server sia compatibile con la versione di ECC. Per ulteriori informazioni, consulta la Nota SAP 2577774 - Compatibilità delle versioni per i sistemi di origine e di destinazione - SLT.

Per il sistema di origine SAP e SAP LT Replication Server, assicurati di implementare tutte le note di correzione per la tecnologia di migrazione e replica basata su ABAP. Per ulteriori informazioni, consulta la SAP Note 3016862 - DMIS Note Analyzers with separated scenarios for ABAP-based Migration and Replication Technology.

Leggi la documentazione dell'assistenza SAP

Se hai un account utente SAP, puoi trovare la soluzione a molti problemi relativi al software SAP leggendo le note SAP e gli articoli della Knowledge Base SAP disponibili in SAP ONE Support Launchpad.

Logging

BigQuery Connector per SAP invia i messaggi di log a SAP LT Replication Server, dove puoi visualizzarli nei log dell'applicazione SAP LT Replication Server.

Questi messaggi includono i messaggi che BigQuery Connector per SAP riceve dall'API BigQuery.

I messaggi di log generali di BigQuery possono essere visualizzati nella console Google Cloud.

Log delle applicazioni di SAP LT Replication Server

Tutti i messaggi di errore vengono salvati nei log dell'applicazione SAP LT Replication Server standard. Controlla i log dell'applicazione per analizzare e risolvere i problemi relativi alla causa principale.

Puoi visualizzare i log delle applicazioni specifici per la configurazione di SAP LT Replication Server eseguendo la transazione LTRC, aprendo la configurazione e selezionando Log delle applicazioni.

Quando vengono visualizzati i log, seleziona una riga della tabella e poi fai clic su un pulsante per visualizzare eventuali messaggi di errore. Se fai clic sulla scheda Log delle applicazioni per una replica, puoi filtrare i messaggi di log di runtime pertinenti per la replica.

Messaggi generati da BigQuery Connector per SAP

Eventuali errori che si verificano in BigQuery Connector per SAP prima che i record vengano inviati a BigQuery sono preceduti dal prefisso /GOOG/SLT.

A tutti gli errori restituiti dall'API BigQuery viene preposto il prefisso /GOOG/MSG. Sono inclusi eventuali errori HTTP.

Se un errore non è preceduto da nessuno di questi valori, significa che è stato generato da SAP LT Replication Server.

Log di BigQuery

BigQuery scrive varie voci di log in Cloud Logging nella console Google Cloud.

Per visualizzare le voci dei log di BigQuery:

  1. Nella console Google Cloud, apri Logging:

    Vai a Esplora log

  2. Nell'editor Query, specifica una risorsa BigQuery. Ad esempio:

    resource.type="bigquery_dataset"

Per ulteriori informazioni sui log di BigQuery, consulta Log.

Traccia HTTP

Durante la risoluzione dei problemi, puoi attivare la traccia HTTP nella transazione SMICM o ST05.

Per limitare l'impatto sulle prestazioni, disattiva la traccia HTTP non appena hai finito.

Debug

Se disponi dell'autorizzazione richiesta, puoi eseguire il debug del codice del componente aggiuntivo Business (BAdI) di BigQuery Connector per SAP.

Per eseguire il debug del codice BAdI:

  1. Se non disponi già delle autorizzazioni SAP necessarie per il debugging del codice BAdI, richiedile all'amministratore SAP.

  2. Attiva il debug digitando /h nel campo di inserimento della transazione nella GUI di SAP e premendo Enter.

  3. Nel menu Impostazioni, seleziona Modifica profilo/ impostazioni del debugger.

  4. In Modalità di debug, assicurati che sia selezionata l'opzione Debug di sistema.

  5. Imposta i punti di interruzione esterni nel codice, se necessario.

Monitoraggio

Puoi monitorare diversi punti lungo il percorso dei dati dall'origine dati SAP alla tabella BigQuery di destinazione, tra cui:

  • Infrastruttura: rete, hardware e sistema operativo
  • Il livello del database SAP
  • Il livello di applicazione SAP
  • BigQuery Connector per SAP
  • BigQuery

Per ulteriori informazioni sul monitoraggio in ciascuno di questi punti, consulta la guida alle operazioni di BigQuery Connector per SAP.

Riconciliazione dei dati

Esistono tre punti in cui puoi controllare i conteggi dei record:

  • La tabella di origine
  • Le statistiche di caricamento o replica di SAP LT Replication Server nella transazione LTRC
  • La tabella di destinazione BigQuery

Puoi utilizzare lo strumento di convalida della replica per controllare e confrontare i conteggi dei record oppure puoi recuperare i record autonomamente eseguendo query SQL.

Per ulteriori informazioni sulla riconciliazione dei dati, consulta la guida alle operazioni di BigQuery Connector per SAP.

Problemi di configurazione comuni

Questa sezione contiene le soluzioni ai problemi comuni che possono verificarsi durante la configurazione iniziale di BigQuery Connector per SAP.

Supporto di SAP LT Replication Server per i tipi di dati di database

A seconda delle versioni del software SAP, SAP LT Replication Server potrebbe non supportare alcuni tipi di dati in un database di origine. Per ulteriori informazioni, consulta la sezione Considerazioni importanti della Nota SAP 1605140 - SAP Landscape Transformation Replication Server (SLT).

Problema: il comando del sistema operativo per il token di accesso non funziona in SAP LT Replication Server

Problema: hai creato un comando del sistema operativo (OS) per stampare il token di accesso, ma non funziona in SAP LT Replication Server.

Causa: questo problema può essere causato da più problemi, ma è molto probabile che sia causato dalla mancata configurazione corretta delle variabili di ambiente necessarie per il comando del sistema operativo.

Risoluzione:verifica che il comando OS sia stato configurato correttamente.

Prova a eseguire il comando printenv sia dal sistema operativo come SID_LCadm sia dalla transazione SAP SM69 e confronta l'output. Se le variabili restituite nella transazione SM69 sono incomplete, prova a riavviare SAP LT Replication Server per registrarle.

Problema: /GOOG/MSG: 400 - Bad Request Request contains an invalid argument

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/MSG: 400 - Bad Request Request contains an invalid argument.

Causa: per il tuo carico di lavoro SAP in esecuzione su Google Cloud, l'ambito di accesso 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/SLT_SETTINGS preceduta da /n:

    /n/GOOG/SLT_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 annotato in un passaggio precedente, assicurati che il valore del campo Ambito corrisponda all'ambito di accesso citato in Specificare le impostazioni di accesso in /GOOG/CLIENT_KEY. Assicurati che non siano presenti spazi nel campo.

  5. Esegui di nuovo la replica.

Problema: /GOOG/MSG : 400 - ICM_HTTP_CONNECTION_FAILED

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/MSG : 400 - ICM_HTTP_CONNECTION_FAILED.

Causa: nelle destinazioni RFC utilizzate da BigQuery Connector per SAP per connettersi alle API Google Cloud, il valore del campo Prefisso percorso o Host target non è corretto.

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

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

    /n/GOOG/SLT_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, prendi nota dei nomi delle destinazioni RFC.

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

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

    2. Per la destinazione RFC che si connette a BigQuery, assicurati che il valore del campo Host target sia bigquery.googleapis.com.

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

    4. Per la destinazione RFC che si connette a IAM, assicurati che il valore del campo Host target sia iamcredentials.googleapis.com.

  6. Esegui di nuovo la replica o il caricamento iniziale.

Problema: /GOOG/MSG : 401 - Unauthorized Request is missing required authentication credential. Expected OAuth 2 access to ken, login coo

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/MSG : 401 - Unauthorized Request is missing required authentication credential. Expected OAuth 2 access to ken, login coo.

Causa: manca la configurazione della porta HTTP.

Risoluzione: le porte HTTP e HTTPS devono essere create ed essere attive nel sistema SAP.

I metadati della VM vengono archiviati su un server metadati a cui è possibile accedere solo tramite una porta HTTP. Pertanto, per accedere ai metadati della VM devi assicurarti che una porta HTTP e una porta HTTPS siano create e attive.

Per risolvere il problema, svolgi i seguenti passaggi:

  1. In SAP GUI, inserisci il codice transazione SMICM.

  2. Nella barra dei menu, fai clic su Vai > Servizi.

  3. Assicurati che le porte HTTP e HTTPS siano create e attive. Un segno di spunta verde nella colonna Actv indica che le porte HTTP e HTTPS sono attive.

  4. Esegui di nuovo la replica.

Per informazioni sulla configurazione delle porte HTTP e HTTPS, vedi Impostazioni HTTP(S) in ICM.

Problema: /GOOG/MSG : 401 - ICM_HTTP_CONNECTION_BROKEN

Problema: durante il caricamento o la replica iniziale, nella transazione LTRC, il trasferimento dei dati non è riuscito con il messaggio di errore/GOOG/MSG : 401 - ICM_HTTP_CONNECTION_BROKEN.

Causa: per il tuo carico di lavoro SAP in esecuzione su Google Cloud, nelle destinazioni RFC utilizzate da BigQuery Connector per SAP per connettersi alle API Google Cloud, SSL non è attivato.

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

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

    /n/GOOG/SLT_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, prendi nota dei nomi delle destinazioni RFC.

  5. Inserisci la transazione SM59, quindi per le destinazioni RFC che hai annotato nel passaggio precedente, svolgi i seguenti passaggi:

    1. Vai alla scheda Accesso e sicurezza.

    2. Per il campo Certificato SSL, assicurati che sia selezionata l'opzione Client SSL predefinito (standard).

    3. Per il campo N.servizio, assicurati che sia specificato il valore 443.

  6. Esegui di nuovo la replica.

Problema /GOOG/MSG: 110 - HTTPIO_PLG_CANCELED

Problema: durante il caricamento o la replica iniziale, nella transazione LTRC, il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/MSG: 110 - HTTPIO_PLG_CANCELED.

Causa: manca la configurazione della porta HTTP.

Risoluzione: le porte HTTP e HTTPS devono essere create ed essere attive nel sistema SAP.

I metadati della VM vengono archiviati su un server metadati, a cui è possibile accedere solo tramite una porta HTTP. Pertanto, devi assicurarti che una porta HTTP e una porta HTTPS siano create e attive per accedere ai metadati della VM.

Per risolvere il problema, svolgi i seguenti passaggi:

  1. In SAP GUI, inserisci il codice transazione SMICM.

  2. Nella barra dei menu, fai clic su Vai > Servizi.

  3. Assicurati che le porte HTTP e HTTPS siano create e attive. Un segno di spunta verde nella colonna Actv indica che le porte HTTP e HTTPS sono attive.

  4. Esegui di nuovo la replica.

Per informazioni sulla configurazione delle porte HTTP e HTTPS, consulta Impostazioni HTTP(S) in ICM.

Problema: /GOOG/MSG: 403 - SSL is required to perform this operation

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/MSG: 403 - SSL is required to perform this operation.

Causa: per il tuo carico di lavoro SAP in esecuzione su Google Cloud, nelle destinazioni RFC utilizzate da BigQuery Connector per SAP per connettersi alle API Google Cloud, SSL non è attivato.

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

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

    /n/GOOG/SLT_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, prendi nota dei nomi delle destinazioni RFC.

  5. Inserisci la transazione SM59, quindi per le destinazioni RFC che hai annotato nel passaggio precedente, svolgi i seguenti passaggi:

    1. Vai alla scheda Accesso e sicurezza.

    2. Per il campo Certificato SSL, assicurati che sia selezionata l'opzione Client SSL predefinito (standard).

    3. Per il campo N.servizio, assicurati che sia specificato il valore 443.

  6. Esegui di nuovo la replica.

Problema: /GOOG/MSG: 403 - Request had insufficient authentication scopes

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/MSG: 403 - Request had insufficient authentication scopes.

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 dell'ambito richiesto per accedere a BigQuery.

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

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

    /n/GOOG/SLT_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, assicurati che il valore specificato per il campo Nome account di servizio sia default.

  5. Nella console Google Cloud, vai alla pagina Istanze VM di Compute Engine.

    Vai a Istanze VM

  6. Fai clic sull'istanza VM che ospita SAP LT Replication Server.

  7. Fai clic su Interrompi e segui le istruzioni per arrestare l'istanza VM.

  8. Fai clic su Modifica, modifica gli Ampi di accesso dell'account di servizio per attivare l'accesso a BigQuery e poi fai clic su Salva.

  9. Fai clic su Avvia / Riprendi per riavviare l'istanza VM.

  10. Assicurati che SAP LT Replication Server sia in esecuzione.

  11. Esegui di nuovo la replica.

Problema: /GOOG/MSG: 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/MSG: 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/SLT_SETTINGS preceduta da /n:

    /n/GOOG/SLT_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 Connector per SAP per accedere a BigQuery, come indicato in Identity and Access Management di Google Cloud.

  8. Esegui di nuovo la replica.

Problema: /GOOG/MSG: 404 - Not Found

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

Causa: nelle destinazioni RFC utilizzate da BigQuery Connector per SAP 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/SLT_SETTINGS preceduta da /n:

    /n/GOOG/SLT_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, prendi nota dei 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.

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

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

Causa: nelle destinazioni RFC utilizzate da BigQuery Connector per SAP 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 SE38 e poi apri il report/GOOG/R_SLT_SETTINGS.

  2. Per la transazione LTRC eseguita, apri l'ID trasferimento collettivo e poi prendi nota del valore nella colonna Nome chiave Google Cloud.

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

  4. 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 delle destinazioni RFC specificati.

  5. Inserisci il codice transazione SM59.

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

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

    Vai a Cloud DNS

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

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

  10. Esegui di nuovo la replica.

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

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

Causa: per il tuo carico di lavoro in esecuzione su Google Cloud, l'account di 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/SLT_SETTINGS preceduta da /n:

    /n/GOOG/SLT_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 campo Nome account di servizio, assicurati che il valore specificato sia l'indirizzo email dell'account di servizio creato per BigQuery Connector per SAP nel passaggio Crea un account di servizio.

  5. Esegui di nuovo la replica.

Problema: /GOOG/MSG: 418 - Trasferimento dati non riuscito con messaggio di errore da SAP

Problema: il trasferimento dei dati non è riuscito con un messaggio di errore di SAP, ad esempio No OS command defined for the key.

Causa: per il tuo carico di lavoro SAP che non è in esecuzione su Google Cloud, questo problema può essere causato dalle seguenti circostanze:

Il comando del sistema operativo che stampa il token di accesso non è configurato correttamente

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

  • Hai creato un comando del sistema operativo (OS) per stampare il token di accesso, ma non lo hai aggiunto alle impostazioni di accesso nella tabella delle chiavi client /GOOG/CLIENT_KEY.

  • Il comando OS che hai creato nella transazione SM69 non è riuscito a recuperare un token di accesso da Google Cloud.

Risoluzione: nella tabella delle chiavi client /GOOG/CLIENT_KEY, per il campo Nome comando, assicurati che il valore inserito corrisponda al nome del comando che hai creato per stampare il token di accesso.

L'RFC non è configurato correttamente

Causa: per il tuo carico di lavoro SAP in esecuzione su Google Cloud, nelle destinazioni RFC utilizzate da BigQuery Connector per SAP per connettersi alle API Google Cloud, il valore del campo Host target non è corretto.

Soluzione:per risolvere il problema:

  1. In SAP GUI, inserisci la transazione SE38 e poi apri il report /GOOG/R_SLT_SETTINGS.

  2. Per la transazione LTRC eseguita, apri l'ID trasferimento collettivo e prendi nota del valore di Nome chiave Google Cloud.

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

  4. 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 delle destinazioni RFC specificati.

  5. Inserisci il codice transazione SM59 e poi apri le destinazioni RFC che hai annotato nel passaggio precedente.

  6. Per il campo Host target, correggi l'URL specificato.

  7. Esegui di nuovo la replica.

Problema: /GOOG/MSG: 413 - Request Entity Too Large

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

Causa: questo problema può verificarsi quando la dimensione in byte del chunk inviato da BigQuery Connector 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 Connector per SAP per la tua tabella. Puoi regolare le dimensioni dei chunk eseguendo la transazione /GOOG/SLT_SETTINGS o attivando le dimensioni dei chunk dinamiche per regolare automaticamente le dimensioni dei chunk. Per ulteriori informazioni, vedi:

Problema: /GOOG/MSG: 503 - HTTP Communication Failure - SSL client SSL Client (Standard)

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/MSG: 503 - HTTP Communication Failure - SSL client SSL Client (Standard).

Causa: per il tuo carico di lavoro SAP in esecuzione su Google Cloud, nelle destinazioni RFC utilizzate da BigQuery Connector per SAP per connettersi alle API Google Cloud, il valore del campo Host target non è corretto.

Soluzione:per risolvere il problema, consulta la procedura di risoluzione in L'RFC non è configurato correttamente.

Problema: /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the request sending

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the request sending.

Causa: questo problema può essere causato da problemi di connessione o di rete.

Soluzione: convalida la connessione e assicurati che la rete sia configurata correttamente, funzioni senza errori e non sia congestionata.

Problema: /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the response receiving

Problema: il trasferimento dei dati non è riuscito con il messaggio di errore /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the response receiving.

Questo problema può essere causato dalle seguenti circostanze:

SSL non è attivato nelle destinazioni RFC

Causa: nelle destinazioni RFC utilizzate da BigQuery Connector per SAP per connettersi alle API Google Cloud, l'opzione di sicurezza per l'utilizzo del certificato SSL non è attivata.

Soluzione: per risolvere il problema, consulta i passaggi per la risoluzione descritti in Problema: /GOOG/MSG: 403 - Per eseguire questa operazione è richiesto SSL.

Handshake SSL non riuscito

Causa: quando l'handshake SSL non è riuscito tra l'host SAP LT Replication Server e l'endpoint dell'API BigQuery. Questo si verifica quando il certificato presentato dal server TLS non è valido per il nome host di destinazione fornito da SAP LT Replication Server, probabilmente perché l'invio lato client dell'estensione TLS facoltativa SNI non è implementato nel kernel NetWeaver.

Risoluzione: nella transazione SMICM, cerca il codice di resoSSLERR_SERVER_CERT_MISMATCH. Se trovi il codice di ritornoSSLERR_SERVER_CERT_MISMATCH, devi attivare l'invio dell'estensione TLS SNI. Inoltre, assicurati che il kernel NetWeaver implementi l'invio lato client della SNI dell'estensione TLS facoltativa.

Per attivare l'invio dell'SNI dell'estensione TLS, imposta il parametro del profilo icm/HTTPS/client_sni_enabled o ssl/client_sni_enabled su TRUE, a seconda della versione del kernel NetWeaver. Per ulteriori informazioni di SAP, consulta:

La dimensione in byte dei chunk ha superato la dimensione massima in byte per le richieste HTTP accettate da BigQuery

Causa: quando le dimensioni in byte del chunk inviato da BigQuery Connector per SAP hanno superato le dimensioni in byte massime 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 frammento oltre il limite di BigQuery.

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

Problema: /GOOG/MSG: 404 - Not found: Dataset DATASET_NAME

Problema: quando provi a convalidare la sicurezza di Google Cloud o a caricare dati in una tabella BigQuery, ricevi il messaggio /GOOG/MSG: 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 in SAP LT Replication Server 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.
  • Esegui la transazione LTRC e disattiva e riattiva la configurazione della replica.

Problema: Mass Transfer Key can not be found for Mass Transfer ID XXX

Problema: ricevi l'errore /GOOG/SLT: Mass Transfer Key can not be found for Mass Transfer ID XXX.

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

  • Non esiste una configurazione di trasferimento collettivo per l'ID trasferimento collettivo specificato.
  • La configurazione di replica corrispondente non è attiva.

Risoluzione:per risolvere il problema, esegui una delle seguenti azioni:

  • Esegui la transazione /GOOG/SLT_SETTINGS e verifica che l'ID trasferimento collettivo sia specificato correttamente.
  • Esegui la transazione LTRC e disattiva e riattiva la configurazione della replica.

Problema: /GOOG/SLT : Unable to interpret VALUE as a BOOLEAN

Problema: il caricamento o la replica di un record non riesce con il messaggio/GOOG/SLT : 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/SLT_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.

Problema: /GOOG/SLT: 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/SLT: 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/SLT_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.

Problema: /GOOG/MSG : Client key is not found in /GOOG/CLIENT_KEY table

Problema: un caricamento o una replica non si avvia con il messaggio /GOOG/MSG: Client key is not found in /GOOG/CLIENT_KEY table.

Causa: la chiave client non esiste o è stata specificata erroneamente nella configurazione del trasferimento collettivo della transazione /GOOG/SLT_SETTINGS.

Risoluzione: per risolvere il problema, utilizza la transazione SM30 per creare la chiave client o la transazione /GOOG/SLT_SETTINGS per correggere la specifica del valore della chiave client nella configurazione del trasferimento collettivo.

Problema: /GOOG/MSG: 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/MSG: 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/SLT_SETTINGS. Quando il flag BREAK non è impostato, BigQuery Connector per SAP continua a inviare record a BigQuery inviando il chunk successivo anche quando si verifica un errore.

Risoluzione: Prova le seguenti risoluzioni:

Problema: DESCRIPTION_OF_ISSUE while signing JWT using profile KEY_FILE_NAME.pse. Check JWT config in STRUST

Problema: ricevi l'errore DESCRIPTION_OF_ISSUE while signing JWT using profile KEY_FILE_NAME .pse. Check JWT config in STRUST.

Causa: le impostazioni di configurazione JWT e della chiave dell'account di servizio non sono configurate correttamente in STRUST.

Risoluzione:verifica che la configurazione JWT e la chiave dell'account di servizio siano configurate come spiegato in Autenticazione tramite JWT per ottenere token di accesso.

Problema: Bad Request invalid_grant. Invalid JWT Signature

Problema: ricevi l'errore Bad Request invalid_grant. Invalid JWT Signature.

Causa: il file della chiave PSE o P12 importato in STRUST non appartiene all'account di servizio utilizzato per firmare il JWT.

Risoluzione: assicurati di importare il file della chiave dell'account di servizio corretto in STRUST. Per informazioni sull'importazione della chiave dell'account di servizio in STRUST, consulta Importare la chiave dell'account di servizio in STRUST.

Problema: /GOOG/MSG : 400 - Bad Request invalid_grant Invalid grant: account not found

Problema: non riesci a connetterti alle API Google Cloud.

Causa: l'account di servizio utilizzato per la firma JWT non è corretto o non dispone delle autorizzazioni richieste.

Soluzione:assicurati che l'account di servizio specificato per il recupero dei token basati su JWT sia gestito correttamente in base al parametro JWT_SERVC_ACCT nella tabella /GOOG/BQ_PARAM. Per saperne di più, vedi Attivare la firma JWT per l'account di servizio sull'host del server di replica SAP LT.

Problema: OAuth RFC HTTP Destination not maintained in /GOOG/SERVIC_MAP

Problema: ricevi l'errore OAuth RFC HTTP Destination not maintained in /GOOG/SERVIC_MAP.

Causa: la destinazione RFC per OAuth 2.0 non è disponibile nella tabella di mappatura dei servizi /GOOG/SERVIC_MAP.

Risoluzione: aggiorna la destinazione RFC per OAuth 2.0 nella tabella di mappatura dei servizi /GOOG/SERVIC_MAP ed esegui di nuovo il caricamento. Per informazioni su come specificare le destinazioni RFC, consulta Specificare le destinazioni RFC in /GOOG/SERVIC_MAP.

Problema: per le lingue di accesso diverse dall'inglese, le descrizioni dei campi vengono visualizzate in modo illeggibile quando carichi i dati utilizzando un file CSV

Problema: per le lingue di accesso diverse dall'inglese, quando carichi i tipi di campi e le descrizioni dei campi della tabella di destinazione BigQuery utilizzando l'opzione di caricamento dei file, le descrizioni dei campi del file CSV non vengono caricate con precisione. Nelle descrizioni caricate trovi caratteri e simboli illeggibili.

Causa: per le lingue di accesso diverse dall'inglese, l'utilità di caricamento dei file non è in grado di interpretare con precisione i caratteri nel file CSV.

Risoluzione: per caricare i tipi di campi e le descrizioni dei campi della tabella di destinazione BigQuery in una lingua diversa dall'inglese, utilizza il formato di codifica UTF-8 con il Byte Order Mark (BOM) per il file CSV. Salva il file CSV in formato UTF-8 con BOM e caricalo.

Problemi operativi comuni

Questa sezione contiene le soluzioni ai problemi comuni che possono verificarsi dopo la configurazione iniziale di BigQuery Connector per SAP.

Problema: le tabelle di origine vuote in SAP non vengono create nel set di dati BigQuery

Problema: le tabelle di origine vuote in SAP non vengono create nel set di dati BigQuery.

Causa: per le tabelle di origine vuote in SAP, SAP SLT impedisce la creazione di tabelle di destinazione in BigQuery.

Risoluzione: per creare tabelle di destinazione nel set di dati BigQuery per le tabelle di origine vuote in SAP, puoi utilizzare lo strumento Crea tabella. Per informazioni su come eseguire lo strumento Crea tabella, consulta Strumento Crea tabella.

Problema: numero errato di scritture in BigQuery

Problema: il numero di record scritti in BigQuery è superiore al numero di record mostrato nei log di SAP LT Replication Server.

Causa: il problema può avere più cause, tra cui problemi di connessione transitori che causano l'invio di record più volte da parte di SAP LT Replication Server o il fatto che la tabella BigQuery accetti solo inserimenti e ogni modifica a un singolo record nell'origine viene inserita come voce separata nella tabella di destinazione.

Risoluzione: se la differenza nel numero di record non è estrema e non ci sono meno record in BigQuery rispetto alla tabella di origine, si tratta di un comportamento previsto e non di un problema.

Per riconciliare con precisione il numero di record in BigQuery con il numero di record nella tabella di origine, esegui una query sulla tabella BigQuery come descritto in Query SQL per il conteggio dei record.

Per ulteriori informazioni sulle possibili cause di questo problema, consulta Considerazioni particolari per origini/destinazioni ABAP su HANA.

Problema: /GOOG/MSG : 400 - Schema mismatch for table TABLE_NAME

Problema: ricevi il messaggio di errore /GOOG/MSG : 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.

Se la modifica è stata un errore, annullala in SAP LT Replication Server.

Per ulteriori informazioni sulla configurazione di campi e partizioni in una tabella BigQuery di destinazione, consulta Configurazioni di replica di BigQuery.

Problema: messaggi di errore relativi a dati non validi

Problema: nei log dell'applicazione viene visualizzato il messaggio di errore: /GOOG/MSG/: 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/SLT_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/SLT_SETTINGS per specificare un tipo di dati appropriato. Per ulteriori informazioni sulla mappatura dei tipi di dati, consulta Mappatura dei tipi di dati.

Problema: il valore di un campo visualizzato nella transazione SE16 o SE16N è diverso da quello mostrato in BigQuery

Problema: in alcuni casi, il valore di un campo visualizzato nella transazioneSE16 o SE16N è diverso da quello mostrato in BigQuery.

Causa: nel sistema di origine SAP S/4HANA, tabelle come MARD, MARC, MBEW e MBEWH hanno visualizzazioni di compatibilità che mostrano i valori nella transazione SE16 o SE16N. Per queste tabelle, i valori visualizzati nella transazione SE16 o SE16N vengono calcolati all'interno delle visualizzazioni di compatibilità utilizzando le condizioni di join, che includono diverse altre tabelle sottostanti.

Quando una tabella con una vista di compatibilità è configurata in SLT per la replica in BigQuery, SLT non replica i dati della vista di compatibilità. Al contrario, SLT esegue la replica dei dati da ciascuna delle tabelle sottostanti separatamente e, di conseguenza, potresti notare che alcuni campi hanno valori diversi in SE16 o SE16N rispetto a quanto mostrato in BigQuery. Si tratta di un comportamento standard di SLT.

Risoluzione: per risolvere il problema, segui i passaggi riportati di seguito:

  1. In SAP GUI, inserisci il codice transazione LTRS.
  2. Seleziona le impostazioni di trasferimento collettivo per la replica di BigQuery.
  3. Vai a Impostazioni di replica avanzate > Impostazioni tabella.
  4. Seleziona la tabella che utilizza le visualizzazioni di compatibilità. Se la tabella di cui hai bisogno non è presente nell'elenco, aggiungila.

  5. Nella sezione Impostazioni di elaborazione, inserisci i valori per i seguenti campi:

    • Visualizzazione per il caricamento iniziale: il valore della visualizzazione di compatibilità per la tabella da SE16 o SE16N.
    • Visualizzazione per la replica: il valore della visualizzazione di compatibilità per la tabella da SE16 o SE16N.

  6. Salva le impostazioni.

In alternativa, replica tutte le tabelle sottostanti della visualizzazione di compatibilità in BigQuery. In BigQuery, unisci queste tabelle utilizzando le stesse condizioni di join della vista di compatibilità.

Per ulteriori informazioni di SAP su alcune tabelle ben note e sulle relative visualizzazioni di compatibilità, consulta la nota SAP 2595627 - Accessing table from SE16/SE16N shows different results to SAP HANA database.

Problema: Failed to create proxy table TARGET_TABLE_NAME for object SOURCE_TABLE_NAME

Problema: durante il trasferimento dei dati da SAP HANA a BigQuery utilizzando BigQuery Connector per SAP, il caricamento della tabella non è riuscito con il messaggio di errore Failed to create proxy table TARGET_TABLE_NAME for object SOURCE_TABLE_NAME.

Causa: il numero di caratteri in uno o più campi della tabella di origine supera la limitazione di 30 caratteri impostata da SLT.

Risoluzione: prova le seguenti risoluzioni:

  • Se il numero di caratteri nei campi chiave di una tabella supera i 30, non puoi caricare o replicare queste tabelle. Si tratta di una limitazione nota di SLT.
  • Se il numero di caratteri in altri campi di una tabella supera i 30, crea una visualizzazione per mappare i nomi di campo che superano i 30 caratteri a nomi di campo più brevi.

Per ulteriori informazioni, consulta la nota SAP 1768805 - SAP Landscape Transformation Replication Server (SLT): Non ABAP-based Sources.

Assistenza

Se hai bisogno di aiuto per risolvere i problemi relativi alla replica e a BigQuery Connector 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 Google Cloud, consulta Ricevere assistenza per SAP su Google Cloud.