Versione 2.0: guida alla risoluzione dei problemi BigQuery Connector per SAP

Puoi risolvere i problemi relativi alle versioni 2.0 e 2.1 di BigQuery Connector per SAP utilizzando sia i log 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.

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. Per la procedura di configurazione, consulta Creare un comando del sistema operativo per stampare il token di accesso.

Prova a eseguire il comando printenv sia dal sistema operativo come sidadm 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: 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 del chunk eseguendo la transazione /GOOG/SLT_SETTINGS.

Per informazioni su come determinare le dimensioni dei chunk, consulta Dimensioni dei chunk in BigQuery Connector per SAP.

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:

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 del chunk eseguendo la transazione /GOOG/SLT_SETTINGS. Per ulteriori informazioni, consulta Dimensione del chunk in BigQuery Connector per SAP.

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.

Problemi operativi comuni

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

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.

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.