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

Puoi risolvere i problemi relativi alle versioni 2.0 e 2.1 di BigQuery Connector per SAP utilizzando il logging delle applicazioni del server di replica SAP LT 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 delle applicazioni del server di replica SAP LT 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, potresti dover concentrare la tua attenzione in diverse aree, a seconda dell'area o dell'ambito del problema che stai esaminando:

L'infrastruttura, ad esempio rete, hardware o sistema operativo.
Il software SAP, inclusi il server di origine e il server di replica SAP LT.
BigQuery Connector per SAP.
BigQuery, tra cui 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 precedenti aree si verifica il problema e qual è l'ambito del problema.

Per risolvere un problema, potrebbe essere necessario collaborare con più team, ad esempio gli amministratori di base, gli amministratori di SAP LT Replication Server, il proprio DBA o gli amministratori della sicurezza di Google Cloud.

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

Determina la causa principale

Devi determinare la causa principale del problema e assicurarti che quella che pensi potrebbe essere la causa non è in realtà solo un sintomo di una causa principale che risiede altrove.

I sistemi SAP sono strettamente integrati, ma possono scrivere log e tracce su 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 tutti i prerequisiti di BigQuery Connector per SAP siano stati soddisfatti.

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

Se il server di replica SAP LT è in esecuzione su una VM di Compute Engine, consulta la sezione Prerequisiti.
Se SAP LT Replication Server è in esecuzione su un host esterno a Google Cloud, consulta la sezione Prerequisiti.

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

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

Leggi la documentazione di assistenza SAP

Se hai un account utente SAP, puoi trovare la soluzione a molti problemi relativi al software SAP leggendo gli articoli della Knowledge Base di SAP Notes e degli articoli della knowledge base di SAP disponibili nel lancio dell'assistenza SAP ONE.

Logging

BigQuery Connector per SAP invia i propri messaggi di log a SAP LT Replication Server, dove puoi visualizzarli nei log delle applicazioni di 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 del server di replica SAP LT

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 dell'applicazione.

Quando vengono visualizzati i log, seleziona una riga della tabella, quindi 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

Gli errori che si verificano in BigQuery Connector per SAP prima dell'invio dei record a BigQuery sono preceduti da /GOOG/SLT.

Tutti gli errori restituiti dall'API BigQuery sono preceduti da /GOOG/MSG. Sono inclusi eventuali errori HTTP.

Se un errore non è preceduto da uno di questi valori, significa che è stato emesso 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:

Nella console Google Cloud, apri Logging:

Vai a Esplora log
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, disattiva 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:

Se non disponi già delle autorizzazioni SAP necessarie per il debug del codice BAdI, richiedile al tuo amministratore SAP.
Attiva il debug digitando /h nel campo di immissione della transazione della GUI di SAP, quindi premi Enter.
Nel menu Impostazioni, seleziona Modifica profilo/ impostazioni Debugger.
In Modalità di debug, assicurati che l'opzione Debug del sistema sia selezionata.
Imposta punti di interruzione esterni nel codice in base alle esigenze.

Monitoraggio

Puoi monitorare diversi punti lungo il percorso 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 del connettore BigQuery per SAP.

Riconciliazione dei dati

Puoi controllare il numero di record in tre punti:

La tabella di origine
Le statistiche di carico o di replica del server di replica SAP LT nella transazione LTRC
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 del connettore BigQuery per SAP.

Problemi di configurazione comuni

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

Supporto del server di replica SAP LT 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 di SAP Note 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 per stampare il token di accesso, ma il comando non funziona in SAP LT Replication Server.

Causa: questo problema può essere causato da più problemi, ma molto probabilmente è dovuto a un'errata configurazione delle variabili di ambiente necessarie per il comando del sistema operativo.

Soluzione: verifica che il comando del sistema operativo sia stato configurato correttamente. Per la procedura di configurazione, vedi 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 registrare le variabili.

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 blocco inviato da BigQuery Connector per SAP supera le dimensioni massime 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 fa sì che le dimensioni in byte di un blocco superino il limite di BigQuery.

Risoluzione: riduci le dimensioni dei blocchi inviati da BigQuery Connector per SAP per la tua tabella. Puoi regolare le dimensioni del blocco eseguendo la transazione /GOOG/SLT_SETTINGS.

Per informazioni sul dimensionamento dei blocchi, consulta Dimensioni blocco in BigQuery Connector for SAP.

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

Problema: il trasferimento dei dati non è riuscito a causa del 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, sia in esecuzione 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 a causa del 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
La dimensione in byte dei blocchi supera la dimensione massima in byte per le richieste HTTP accettate da BigQuery

handshake SSL non riuscito

Causa:si è verificato un errore nell'handshake SSL tra l'host del server di replica SAP LT 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 dal server di replica SAP LT, probabilmente perché l'invio lato client dell'estensione TLS facoltativa SNI non è implementato sul 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'SNI dell'estensione TLS. Inoltre, assicurati che il kernel NetWeaver implementi l'invio lato client dell'estensione TLS facoltativa SNI.

Per abilitare 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 saperne di più da SAP, consulta:

La dimensione in byte dei blocchi supera 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 in byte massima 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 fa sì che la dimensione in byte di un blocco superi il limite di BigQuery.

Risoluzione: riduci le dimensioni dei blocchi inviati da BigQuery Connector per SAP per questa tabella. Puoi regolare le dimensioni del blocco eseguendo la transazione /GOOG/SLT_SETTINGS. Per ulteriori informazioni, consulta Dimensioni blocco in BigQuery Connector for SAP.

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

Problema: quando tenti di convalidare la sicurezza di Google Cloud o di caricare dati in una tabella BigQuery, viene visualizzato 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 risoluzioni:

Conferma 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 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 di massa per l'ID trasferimento di massa specificato.
La configurazione della replica corrispondente non è attiva.

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

Esegui la transazione /GOOG/SLT_SETTINGS e verifica che l'ID trasferimento di massa sia specificato correttamente.
Esegui la transazione LTRC, quindi 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 restituiscono un valore booleano.

Soluzione: per risolvere il problema, utilizza la transazione /GOOG/SLT_SETTINGS per modificare il tipo di dati a cui è mappato il campo di origine o 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 oppure il campo di origine è mappato a un tipo di dati BigQuery che non è 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 o rimuovere la mappatura del tipo di dati e accettare la mappatura predefinita per il tipo di dati.

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

Problema: il caricamento o la replica non iniziano 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 oppure la transazione /GOOG/SLT_SETTINGS per correggere la specifica del valore della chiave client nella configurazione del trasferimento di massa.

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: numero errato di scritture in BigQuery

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

Causa: questo può avere più di una causa, inclusi i problemi di connessione transitorie che causano l'invio di record più volte dal server di replica SAP LT o il fatto che la tabella BigQuery accetti solo gli inserti e ogni modifica a un singolo record nell'origine viene inserita come voce separata nella tabella di destinazione.

Soluzione: se la differenza nei conteggi dei record non è estrema e non sono presenti meno record in BigQuery rispetto a quelli nella tabella di origine, si tratta di un comportamento previsto e non è un problema.

Per riconciliare accuratamente 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 numero di record.

Per ulteriori informazioni sulle possibili cause di questo problema, consulta Considerazioni speciali per origini/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 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 qualsiasi 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 modificata per errore, annulla la modifica 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 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 inviato da BigQuery durante l'inserimento di 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 mantenuta in un campo di tipo DATE, INTEGER o BOOLEAN.
- Una data non valida (00/00/0000) viene mantenuta in un campo di tipo DATE.
Nelle mappature dei campi nella transazione /GOOG/SLT_SETTINGS viene mantenuto un tipo di dati di destinazione errato.

BigQuery invia un messaggio di errore per ogni record contenente 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 ha cinque campi o meno, i contenuti di tutti i campi vengono inclusi in RECORD_KEYS.

Se i dati nel campo non sono compatibili con il tipo di dati in BigQuery, correggili 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.

Ricevi 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, vedi Ricevere assistenza per SAP su Google Cloud.