Guida alla risoluzione dei problemi di BigQuery Connector per SAP

Puoi risolvere i problemi relativi alla versione 2.7 (più recente) di BigQuery Connector per SAP utilizzando il logging dell'applicazione SAP LT Replication Server e 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 standard SAP LT Replication Server.

Puoi anche utilizzare il debug del server di replica SAP LT per isolare i problemi.

Panoramica della risoluzione dei problemi

Quando risolvi i problemi relativi a BigQuery Connector per SAP, esistono diverse aree in cui potresti dover concentrare l'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, inclusi il server di origine e SAP LT Replication Server.
  • BigQuery Connector per SAP.
  • BigQuery, incluse l'API BigQuery e la tabella di destinazione.

Coinvolgere i team giusti

La prima cosa da fare per la risoluzione di un problema è determinare in quale delle aree precedenti il problema si verifica e qual è l'ambito del problema.

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

Coinvolgere in anticipo 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 quello che ritieni possa essere la causa non sia in realtà solo un sintomo di una causa principale che risiede altrove.

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

Verificare i requisiti e i prerequisiti del software

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

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

  • Se il server di replica SAP LT è in esecuzione su una VM di Compute Engine, consulta i prerequisiti.

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

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

Se utilizzi un software ECC precedente, assicurati che la versione SAP LT Replication Server sia compatibile con la versione 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, vedi SAP Note 3016862 - Analizzatori di note DMIS con scenari separati per tecnologia di migrazione e replica basata su ABAP.

Leggi la documentazione di assistenza SAP

Se disponi di un account utente SAP, puoi trovare la soluzione a molti problemi relativi al software SAP leggendo le note su SAP e gli articoli della knowledge base SAP disponibili in SAP ONE Support Launchpad.

Logging

BigQuery Connector per SAP invia i relativi messaggi di log a SAP LT Replication Server, dove puoi visualizzarli nei log delle applicazioni SAP LT Replication Server.

Questi messaggi includono quelli 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 SAP LT Replication Server

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

Puoi visualizzare i log dell'applicazione specifici per la configurazione del server di replica SAP LT eseguendo la transazione LTRC, aprendo la configurazione e selezionando Log delle applicazioni.

Quando vengono visualizzati i log, seleziona una riga della tabella, quindi fai clic su un pulsante per visualizzare gli 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

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

Gli errori restituiti dall'API BigQuery hanno 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 di 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 degli errori, puoi abilitare la traccia HTTP nella transazione SMICM o ST05.

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

Debug

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

Per eseguire il debug del codice BAdI:

  1. Se non hai ancora le autorizzazioni SAP necessarie per il debug del codice BAdI, richiedile all'amministratore SAP.

  2. Attiva il debug digitando /h nel campo di immissione della transazione della GUI di SAP, quindi premendo Enter.

  3. Nel menu Impostazioni, seleziona Cambia profilo/ impostazioni debugger.

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

  5. Imposta punti di interruzione esterni nel codice in base alle esigenze.

Monitoraggio

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

  • Infrastruttura: rete, hardware e sistema operativo
  • Livello di database SAP
  • 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

Puoi controllare i conteggi dei record in tre punti:

  • La tabella di origine
  • Statistiche di replica o carico del server di replica SAP LT nella transazione LTRC
  • Tabella BigQuery target

Puoi utilizzare lo strumento Replication Validation per controllare e confrontare i conteggi dei record oppure puoi recuperare i record manualmente 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 per i problemi comuni che possono verificarsi durante l'impostazione e la configurazione iniziali di BigQuery Connector per SAP.

Supporto di SAP LT Replication Server per i tipi di dati dei 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 di SAP Note 1605140 - SAP Landscape Transformation Replication Server (SLT).

Problema: il comando OS 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 probabilmente è causato dalla mancata configurazione corretta delle variabili di ambiente necessarie per il comando del sistema operativo.

Risoluzione:verifica che il comando del sistema operativo 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 registrare le variabili.

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

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

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

Soluzione: per risolvere il problema, completa 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 di massa la cui transazione LTRC non è andata a buon fine, prendi nota del valore del campo Nome chiave Google Cloud.

  3. Inserisci la transazione SM30, 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 del campo Ambito corrisponda all'ambito di accesso menzionato in Specificare le impostazioni di accesso in /GOOG/CLIENT_KEY. Assicurati che nel campo non siano stati inseriti spazi.

  5. Esegui di nuovo la replica.

Problema: /GOOG/MSG : 400 - ICM_HTTP_CONNECTION_FAILED

Problema: il trasferimento dei dati non è riuscito a causa del 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 del percorso o Host di destinazione non è corretto.

Soluzione: per risolvere il problema, completa 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 di massa la cui transazione LTRC non è andata a buon fine, prendi nota del valore del campo Nome chiave Google Cloud.

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

  4. Per il valore del nome della 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 del percorso sia /bigquery/v2/.

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

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

    4. Per la destinazione RFC che si connette a IAM, assicurati che il valore del campo Target Host (Host di destinazione) 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 e viene visualizzato il messaggio di errore /GOOG/MSG : 401 - Unauthorized Request is missing required authentication credential. Expected OAuth 2 access to ken, login coo.

Causa: la configurazione della porta HTTP è mancante.

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

I metadati della VM vengono archiviati su un server di metadati, a cui è possibile accedere solo tramite una porta HTTP. Pertanto, devi assicurarti che sia stata creata e attiva una porta HTTP e una porta HTTPS per accedere ai metadati della VM.

Per risolvere il problema, completa i seguenti passaggi:

  1. Nella GUI di SAP, inserisci il codice della transazione SMICM.

  2. Nella barra dei menu, fai clic su Vai a > 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 l'articolo sulle impostazioni HTTP(S) in ICM.

Problema: /GOOG/MSG : 401 - ICM_HTTP_CONNECTION_BROKEN

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

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

Soluzione: per risolvere il problema, completa 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 di massa la cui transazione LTRC non è andata a buon fine, prendi nota del valore del campo Nome chiave Google Cloud.

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

  4. Per il valore del nome della 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 indicate nel passaggio precedente, segui questi passaggi:

    1. Vai alla scheda Accesso e sicurezza.

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

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

  6. Esegui di nuovo la replica.

Numero /GOOG/MSG: 110 - HTTPIO_PLG_CANCELED

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

Causa: la configurazione della porta HTTP è mancante.

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

I metadati della VM vengono archiviati su un server di metadati, a cui è possibile accedere solo tramite una porta HTTP. Devi quindi assicurarti che sia stata creata e attiva una porta HTTP e una porta HTTPS per accedere ai metadati della VM.

Per risolvere il problema, completa i seguenti passaggi:

  1. Nella GUI di SAP, inserisci il codice della transazione SMICM.

  2. Nella barra dei menu, fai clic su Vai a > 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 le impostazioni HTTP(S) in ICM.

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

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

Causa: per il 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.

Soluzione: per risolvere il problema, completa 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 di massa la cui transazione LTRC non è andata a buon fine, prendi nota del valore del campo Nome chiave Google Cloud.

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

  4. Per il valore del nome della 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 indicate nel passaggio precedente, segui questi passaggi:

    1. Vai alla scheda Accesso e sicurezza.

    2. Per il campo Certificato SSL, assicurati che sia selezionata l'opzione Client SSL DCM (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 e viene visualizzato il messaggio di errore /GOOG/MSG: 403 - Request had insufficient authentication scopes.

Causa: per il 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.

Soluzione: per risolvere il problema, completa 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 di massa la cui transazione LTRC non è andata a buon fine, prendi nota del valore del campo Nome chiave Google Cloud.

  3. Inserisci la transazione SM30, 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 il server di replica SAP LT.

  7. Fai clic su Arresta, quindi segui le istruzioni per arrestare l'istanza VM.

  8. Fai clic su Modifica, modifica l'Ambiti di accesso dell'account di servizio per abilitare l'accesso a BigQuery, quindi fai clic su Salva.

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

  10. Assicurati che il server di replica SAP LT 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 e viene visualizzato il messaggio di errore /GOOG/MSG: 403 - Access Denied: Dataset PROJECT_ID:DATASET_NAME: Permission bigquery.tables.created denied on dataset.

Causa: per il 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.

Soluzione: per risolvere il problema, completa 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 di massa la cui transazione LTRC non è andata a buon fine, prendi nota del valore del campo Nome chiave Google Cloud.

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

  4. Per il valore del Nome chiave Google Cloud che hai annotato in un passaggio precedente, nota 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 previsto in Google Cloud Identity and Access Management.

  8. Esegui di nuovo la replica.

Problema: /GOOG/MSG: 404 - Not Found

Problema: il trasferimento dei dati non è riuscito e viene visualizzato 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.

Soluzione: per risolvere il problema, completa 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 di massa la cui transazione LTRC non è andata a buon fine, prendi nota del valore del campo Nome chiave Google Cloud.

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

  4. Per il valore del nome della 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 del percorso sia /bigquery/v2/.
    • Per la destinazione RFC che si connette a IAM, assicurati che il valore del campo Prefisso del 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 e viene visualizzato 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 di Google Cloud, il valore specificato nel campo Target Host (Host di destinazione) non corrisponde ad alcun nome DNS in Cloud DNS.

Soluzione: per risolvere il problema, completa i seguenti passaggi:

  1. Nella GUI di SAP, inserisci il codice della transazione SE38 e apri il report /GOOG/R_SLT_SETTINGS.

  2. Per la transazione LTRC eseguita, apri l'ID del trasferimento di massa e 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 nella 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.

  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 Host di destinazione.

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

    Vai a Cloud DNS

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

  9. Assicurati che esista un record DNS, con un nome DNS corrispondente, per ciascuno dei valori dell'host di destinazione 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 e viene visualizzato il messaggio di errore /GOOG/MSG: 404 - Not Found Requested entity was not found.

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

Soluzione: per risolvere il problema, completa 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 di massa la cui transazione LTRC non è andata a buon fine, prendi nota del valore del campo Nome chiave Google Cloud.

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

  4. Nel 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 di dati non riuscito con messaggio di errore da SAP

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

Causa: per il carico di lavoro SAP 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 per stampare il token di accesso, ma non l'hai aggiunto alle impostazioni di accesso nella tabella delle chiavi client /GOOG/CLIENT_KEY.

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

Soluzione: 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.

RFC non è configurata correttamente

Causa: per il 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 di destinazione non è corretto.

Soluzione:per risolvere il problema:

  1. Nella GUI di SAP, inserisci la transazione SE38, quindi apri il report /GOOG/R_SLT_SETTINGS.

  2. Per la transazione LTRC eseguita, apri l'ID del trasferimento di massa e prendi nota del valore di Google Cloud Key Name.

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

  4. Cerca nella 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.

  5. Inserisci il codice transazione SM59, quindi apri le destinazioni RFC indicate nel passaggio precedente.

  6. Nel campo Target Host (Host di destinazione), 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 e viene visualizzato il messaggio di errore /GOOG/MSG: 413 - Request Entity Too Large.

Causa: questo problema può verificarsi quando la dimensione in byte del blocco inviato da BigQuery Connector per SAP supera la dimensione massima in byte per le richieste HTTP accettate da BigQuery. Questo può verificarsi quando la dimensione dei record della tabella o la quantità di dati contenuti nei record determina un aumento della dimensione in byte di un blocco oltre il limite di BigQuery.

Soluzione: riduci la dimensione dei blocchi inviati da BigQuery Connector per SAP per la tua tabella. Puoi regolare la dimensione del blocco eseguendo la transazione /GOOG/SLT_SETTINGS o abilitando la dimensione dinamica del blocco per regolare automaticamente la dimensione del blocco. Per ulteriori informazioni, consulta:

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

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

Causa: per il 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 di destinazione non è corretto.

Risoluzione:per risolvere questo problema, consulta i passaggi per la risoluzione in RFC non configurata correttamente.

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

Problema: il trasferimento dei dati non è riuscito e viene visualizzato un 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, che sia in esecuzione senza errori e che non sia congestionata.

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

Problema: il trasferimento dei dati non è riuscito e viene visualizzato un 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 in Problema: /GOOG/MSG: 403 - per eseguire questa operazione è necessario il protocollo SSL.

handshake SSL non riuscito

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

Soluzione: nella transazione SMICM, cerca il codice di reso SSLERR_SERVER_CERT_MISMATCH. Se trovi il codice restituito SSLERR_SERVER_CERT_MISMATCH, devi abilitare l'invio dell'estensione TLS SNI. Inoltre, assicurati che il kernel NetWeaver implementi l'invio lato client dell'estensione TLS facoltativa SNI.

Per abilitare l'invio dell'estensione TLS SNI, 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 da SAP, vedi:

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

Causa: quando la dimensione in byte del blocco inviato da BigQuery Connector per SAP supera la dimensione massima in byte per le richieste HTTP accettate da BigQuery. Questo può verificarsi quando la dimensione dei record della tabella o la quantità di dati contenuti nei record determina un aumento della dimensione in byte di un blocco oltre il limite di BigQuery.

Soluzione: riduci le dimensioni dei blocchi inviati da BigQuery Connector per SAP per questa tabella. Puoi regolare la dimensione del blocco eseguendo la transazione /GOOG/SLT_SETTINGS o abilitando la dimensione dinamica del blocco per regolare automaticamente la dimensione del blocco. Per ulteriori informazioni, consulta:

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

Problema: quando tenti di convalidare la sicurezza di Google Cloud o di caricare i 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 di massa.
  • La configurazione della replica in SAP LT Replication Server deve essere attivata.

Risoluzione. Prova le seguenti soluzioni:

  • Verifica che il set di dati sia stato creato in BigQuery.
  • Verifica che il nome del set di dati nella configurazione del trasferimento di massa corrisponda al nome del set di dati in BigQuery.
  • Esegui la transazione LTRC, quindi disattiva e riattiva la configurazione di 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 del trasferimento di massa per l'ID del trasferimento di massa specificato.
  • La configurazione di replica corrispondente non è attiva.

Soluzione:per risolvere il problema, esegui una delle seguenti operazioni:

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

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

Problema: il caricamento o la replica di un record non riesce e viene visualizzato 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 vengono convertiti in un valore booleano.

Soluzione: per risolvere il problema, utilizza transaction /GOOG/SLT_SETTINGS per modificare il tipo di dati a cui è mappato il campo di origine oppure rimuovere la mappatura dei tipi 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 e viene visualizzato 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 oppure il campo di origine è mappato a un tipo di dati BigQuery che non rappresenta una mappatura valida per i dati contenuti nel campo di origine.

Soluzione: per risolvere il problema, utilizza la transazione /GOOG/SLT_SETTINGS per modificare il tipo di dati a cui è mappato il campo di origine oppure 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 in modo errato nella configurazione del trasferimento di massa della transazione /GOOG/SLT_SETTINGS.

Soluzione: 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 di massa.

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 blocco 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 per il blocco che non è stato possibile replicare in BigQuery viene mostrato con l'indice iniziale e finale del blocco.

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

Risoluzione. Prova le seguenti soluzioni:

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: la configurazione JWT e le impostazioni della chiave dell'account di servizio non sono configurate correttamente in STRUST.

Soluzione: 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.

Soluzione: assicurati di importare il file delle chiavi 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: 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.

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

Problema: per le lingue di accesso diverse dall'inglese, le descrizioni dei campi risultano incomprensibili quando carichi i dati utilizzando un file CSV

Problema: per le lingue di accesso diverse dall'inglese, quando carichi i tipi di campi delle tabelle di destinazione BigQuery e le descrizioni dei campi utilizzando l'opzione di caricamento file, le descrizioni dei campi dal file CSV non vengono caricate in modo accurato. Nelle descrizioni caricate sono presenti caratteri e simboli incomprensibili.

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

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

Problemi operativi comuni

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

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

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

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

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

Problema: numero di scritture errato in BigQuery

Problema: il numero di record scritti in BigQuery è superiore al numero di record visualizzato nei log del server di replica SAP LT.

Causa: questo può avere più di una causa, inclusi problemi di connessione transitoria che causano l'invio di record SAP LT Replication Server più di una volta o il fatto che la tabella BigQuery accetta solo gli inserimenti e ogni modifica a un singolo record nell'origine viene inserita come voce separata nella tabella di destinazione.

Soluzione: se la differenza nel numero di record non è eccessiva e il numero di record in BigQuery non è inferiore a quello nella tabella di origine, si tratta di un comportamento previsto e non di un problema.

Per riconciliare in modo accurato 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 i conteggi dei record.

Per ulteriori informazioni sulle possibili cause di questo problema, consulta Considerazioni speciali per le origini/i target 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 immessa una delle seguenti modifiche per una tabella BigQuery esistente:

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

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

Soluzione: 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 apportata per 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 BigQuery.

Problema: messaggi di errore relativi a dati non validi

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

Causa: questo messaggio di errore viene visualizzato da BigQuery quando inserisce 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 dati in BigQuery. Ad esempio, BigQuery genera messaggi di errore quando:
    • Una stringa viene gestita in un campo di tipo DATE, INTEGER o BOOLEAN.
    • È stata mantenuta una data non valida (00/00/0000) in un campo di tipo DATE.
  • Nelle mappature dei campi della transazione /GOOG/SLT_SETTINGS viene mantenuto un tipo di dati di destinazione errato.

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

Soluzione: analizza il messaggio di errore DESCRIPTION_OF_INVALID_DATA per capire 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 non ha più di cinque campi, i contenuti di tutti i campi vengono inclusi nella RECORD_KEYS.

  • Se i dati nel campo non sono compatibili con il tipo di dati 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 saperne di più 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 dal valore mostrato in BigQuery

Problema: in alcuni casi, il valore di un campo visualizzato nella transazione SE16 o SE16N è diverso dal valore 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 condizioni di join, che includono molte altre tabelle sottostanti.

Quando una tabella con una visualizzazione compatibilità è configurata in SLT per la replica in BigQuery, questo non replica i dati dalla visualizzazione compatibilità. SLT replica invece i 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. Questo è un comportamento SLT standard.

Soluzione: per risolvere il problema, completa i seguenti passaggi:

  1. Nella GUI di SAP, inserisci il codice della transazione LTRS.
  2. Seleziona le impostazioni del trasferimento di massa per la replica di BigQuery.
  3. Vai a Impostazioni di replica avanzate > Impostazioni tabella.
  4. Seleziona la tabella che utilizza le visualizzazioni compatibilità. Se la tabella che ti serve non è in elenco, aggiungila.

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

    • Visualizza per caricamento iniziale: il valore della visualizzazione Compatibilità per la tabella nel periodo SE16 o SE16N.
    • Visualizza per replica: il valore della visualizzazione Compatibilità per la tabella nel periodo SE16 o SE16N.

  6. Salva le impostazioni.

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

Per ulteriori informazioni da SAP su alcune tabelle note e sulle relative visualizzazioni di compatibilità, vedi SAP Note 2595627: l'accesso alla tabella da SE16/SE16N mostra risultati diversi rispetto al database SAP HANA.

Richiedi assistenza

Se hai bisogno di aiuto per risolvere i problemi di replica e di 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 Ottenere assistenza per SAP su Google Cloud.