Versione 2.0: guida alla risoluzione dei problemi del connettore BigQuery per SAP

Puoi risolvere i problemi relativi alle versioni 2.0 e 2.1 del BigQuery Connector per SAP utilizzando entrambi Logging delle applicazioni SAP LT Replication Server e log di Google Cloud per esaminare i messaggi di errore e di log.

BigQuery Connector per SAP invia tutti gli errori allo standard Log delle applicazioni 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, è necessario diverse aree su 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, 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 è stabilire in quali delle aree precedenti si verifica il problema e l'ambito del problema.

Per risolvere un problema, potrebbe essere necessario lavorare con più come gli amministratori di base, il server di replica SAP LT amministratori di database, i tuoi database o la tua sicurezza Google Workspace for Education.

Coinvolgere 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 la causa non è solo il sintomo di una radice causa che si trova altrove.

I sistemi SAP sono strettamente integrati, ma possono scrivere log e tracce per i file più località 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 funzioni al minimo richiesto 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 SAP LT Replication Server è in esecuzione su una VM di Compute Engine, consulta Prerequisiti.

  • Se SAP LT Replication Server è in esecuzione su un host esterno al per 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 il server di replica SAP LT sia compatibile con la versione ECC in uso. Per ulteriori informazioni, consulta la Nota SAP 2577774 - Compatibilità delle versioni 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 le note su SAP e gli articoli della knowledge base SAP disponibili nel 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 quelli che BigQuery Connector per SAP che riceve dall'API BigQuery.

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

Log delle applicazioni SAP LT Replication Server

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

Puoi visualizzare i log dell'applicazione specifici per il tuo 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 e fai clic su un 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 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 saperne di più 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 componente aggiuntivo aziendale (BAdI) di BigQuery Connector per SAPP.

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 Cambia profilo/ impostazioni debugger.

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

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

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

Puoi controllare i conteggi dei record in tre punti:

  • 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 Guida alle operazioni di BigQuery Connector per SAP.

Problemi di configurazione comuni

Questa sezione contiene soluzioni per problemi comuni che possono verificarsi durante l'impostazione iniziale e la configurazione 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 Sezione Considerazioni importanti della nota SAP 1605140 - SAP Panorama Transformer 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 OS sia stato configurato correttamente. Per i passaggi 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 riavviando 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 di BigQuery Connector per SAP ha superato la dimensione massima in byte per le richieste HTTP accettate da BigQuery. Ciò può verificarsi quando la dimensione record di tabelle o la quantità di dati contenuti nei record determina la dimensione in byte per superare il limite di BigQuery.

Risoluzione: riduci la dimensione 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 sui blocchi di dimensionamento, consulta Dimensioni del blocco nel connettore BigQuery per SAP.

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

Problema: il trasferimento dei dati non è riuscito con 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 impostata. correttamente, è in esecuzione senza errori e non è congestionata.

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

Problema: il trasferimento dei dati non è riuscito con un 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 ritorno SSLERR_SERVER_CERT_MISMATCH, devi attivare l'invio dell'estensione TLS SNI. Inoltre, assicurati che il kernel NetWeaver implementi l'invio lato client dell'estensione TLS facoltativa SNI.

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

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 la dimensione 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, vedi Dimensioni del blocco nel connettore BigQuery per SAP.

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

Problema: durante il tentativo di convalidare la sicurezza di Google Cloud o caricare i dati in una tabella BigQuery, riceverai 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 è stata 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 collettivo sia uguale al nome del set di dati in BigQuery.
  • Esegui la transazione LTRC, quindi disattiva e riattiva la replica configurazione.

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, quindi disattiva e riattiva la replica configurazione.

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 origine contiene un valore non valido oppure l'origine è mappato a un tipo di dati BigQuery non valido 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.

Soluzione: per risolvere il problema, utilizza la transazione SM30 per crea la chiave client o utilizza 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 soluzioni per problemi comuni che possono verificarsi dopo la configurazione iniziale di BigQuery Connector per SAP.

Problema: numero di scritture errato in BigQuery

Problema: il numero di record scritti in BigQuery è superiore al numero di record mostrati in 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 accuratamente il numero di record in BigQuery con il numero di record nella tabella di origine, esegui una query come descritto in Query SQL per i conteggi dei record.

Per ulteriori informazioni sulle possibili cause di questo problema, consulta la sezione Speciali considerazioni 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 un elemento esistente Tabella BigQuery:

  • 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 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 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 è stato emesso da BigQuery quando inserisci 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 del 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.
  • Un tipo di dati di destinazione errato viene mantenuto nelle mappature dei campi nella transazione /GOOG/SLT_SETTINGS.

BigQuery visualizza 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 non ha più di cinque campi: i contenuti di tutti i campi sono inclusi nel RECORD_KEYS.

  • Se i dati nel campo non sono compatibili con i dati digita in BigQuery, quindi 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, quindi utilizza la transazione /GOOG/SLT_SETTINGS per specificare un tipo di dati appropriato. Per ulteriori informazioni sul tipo di dati consulta la sezione 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.