Version 2.0 : Guide de dépannage de BigQuery Connector pour SAP

Vous pouvez résoudre les problèmes liés aux versions 2.0 et 2.1 de BigQuery Connector pour SAP en consultant la journalisation de l'application SAP LT Replication Server et les journaux Google Cloud pour examiner les messages d'erreur et les messages de journal.

BigQuery Connector pour SAP envoie toutes les erreurs aux journaux d'application SAP LT Replication Server standards.

Vous pouvez également utiliser le débogage SAP LT Replication Server pour isoler les problèmes.

Présentation de la section de dépannage

Lorsque vous corrigez des problèmes liés à BigQuery Connector pour SAP, vous devez vous concentrer sur différents aspects en fonction de la zone ou du champ d'application du problème que vous étudiez :

L'infrastructure, telle que le réseau, le matériel ou le système d'exploitation.
Le logiciel SAP, y compris le serveur source et SAP LT Replication Server.
BigQuery Connector pour SAP
BigQuery, y compris l'API BigQuery et la table cible.

Impliquer les bonnes équipes

Lors de la résolution d'un problème, la première étape consiste à déterminer l'origine et l'ampleur du problème.

Pour résoudre un problème, vous devrez peut-être collaborer avec plusieurs équipes, telles que vos administrateurs de base, vos administrateurs SAP LT Replication Server, vos administrateurs de bases de données ou vos administrateurs de sécurité Google Cloud.

Impliquer rapidement les équipes et les compétences appropriées peut vous aider à résoudre vos problèmes plus rapidement.

Déterminer la cause principale

Vous devez déterminer la cause première de votre problème et vous assurer que ce que vous pensez être la cause n'est pas simplement un symptôme d'une cause qui se trouve ailleurs.

Les systèmes SAP sont étroitement intégrés, mais peuvent écrire des journaux et des traces dans des fichiers situés à différents emplacements. Lors du dépannage, vous devez déterminer les journaux et les fichiers de trace corrects à examiner.

Vérifier la configuration requise et les prérequis

Assurez-vous que tous les logiciels système s'exécutent avec les versions minimales requises et que toutes les conditions préalables à l'utilisation de BigQuery Connector pour SAP sont remplies.

Pour en savoir plus sur les conditions préalables à l'installation de BigQuery Connector pour SAP, consultez le section suivantes :

Si SAP LT Replication Server s'exécute sur une VM Compute Engine, consultez la section Prérequis.
Si SAP LT Replication Server s'exécute sur un hôte externe à Google Cloud, consultez la section Prérequis.

Pour connaître la configuration logicielle requise pour BigQuery Connector pour SAP, consultez la section Configuration logicielle requise.

Si vous utilisez un ancien logiciel ECC, assurez-vous que votre version de SAP LT Replication Server est compatible avec votre version. Pour en savoir plus, référez-vous à la note SAP 2577774 - Compatibilité des versions pour les systèmes sources et cibles - SLT.

Lire la documentation d'assistance SAP

Si vous disposez d'un compte utilisateur SAP, vous trouverez la résolution de nombreux problèmes logiciels SAP en lisant les notes SAP et les articles de la base de connaissances SAP disponibles sur le tremplin de lancement de l'assistance SAP ONE.

Logging

BigQuery Connector pour SAP envoie ses messages de journal à SAP LT Replication Server, où vous pouvez les afficher dans les journaux de l'application SAP LT Replication Server.

Ces messages incluent les messages que BigQuery Connector pour SAP reçoit de l'API BigQuery.

Les messages de journal généraux de BigQuery peuvent être consultés dans Google Cloud Console.

Journaux d'application SAP LT Replication Server

Tous les messages d'erreur sont enregistrés dans les journaux d'application standards de SAP LT Replication Server. Consultez les journaux d'application pour analyser et résoudre la cause première des problèmes.

Vous pouvez afficher les journaux d'application spécifiques à votre configuration SAP LT Replication Server en exécutant la transaction LTRC, en ouvrant votre configuration et en sélectionnant Journaux d'application.

Lorsque les journaux sont affichés, sélectionnez une ligne de table, puis cliquez sur un bouton pour afficher les messages d'erreur. Si vous cliquez sur l'onglet Journaux d'application pour une réplication, vous pouvez filtrer les messages de journal d'exécution pertinents pour la réplication.

Messages générés par BigQuery Connector pour SAP

Le préfixe /GOOG/SLT est ajouté pour toute erreur survenant dans BigQuery Connector pour SAP avant que les enregistrements ne soient envoyés à BigQuery.

Le nom des erreurs renvoyées par l'API BigQuery est précédé de /GOOG/MSG. Cela inclut toutes les erreurs HTTP.

Si une erreur n'est pas précédée de l'une de ces valeurs, l'erreur a été émise par SAP LT Replication Server.

Journaux BigQuery

BigQuery écrit diverses entrées de journal dans Cloud Logging dans Google Cloud Console.

Pour afficher les entrées de journal BigQuery, procédez comme suit :

Dans la console Google Cloud, ouvrez la page Logging :

Accéder à l'explorateur de journaux
Dans l'éditeur Requête, spécifiez une ressource BigQuery. Exemple :
```
resource.type="bigquery_dataset"
```

Pour en savoir plus sur les journaux BigQuery, consultez la page Journaux.

Trace HTTP

Lors de la résolution des erreurs, vous pouvez activer la trace HTTP dans la transaction SMICM ou ST05.

Pour limiter l'impact sur les performances, désactivez la trace HTTP dès que vous avez terminé.

Debugger

Si vous disposez des autorisations requises, vous pouvez déboguer le code Business Add-In (BAdI) de BigQuery Connector pour SAP.

Pour déboguer le code BAdI, procédez comme suit :

Si vous ne disposez pas déjà des autorisations SAP requises pour déboguer le code BAdI, demandez-les à votre administrateur SAP.
Activez le débogage en saisissant /h dans le champ de saisie de transaction de l'IUG de SAP, puis en appuyant sur Enter.
Dans le menu Paramètres, sélectionnez Modifier le profil/les paramètres du débogueur.
Sous Modes de débogage, assurez-vous que l'option Débogage du système est sélectionnée.
Définissez des points d'arrêt externes dans le code selon les besoins.

Monitoring

Vous pouvez surveiller plusieurs points sur le chemin entre la source de données SAP et la table BigQuery cible, y compris les éléments suivants :

Infrastructure : réseau, matériel et système d'exploitation
La couche de base de données SAP
La couche d'application SAP
BigQuery Connector pour SAP
BigQuery

Pour en savoir plus sur la surveillance à chacun de ces points, consultez le guide des opérations BigQuery Connector pour SAP.

Rapprochement des données

Vous pouvez vérifier le nombre d'enregistrements à trois emplacements :

Au niveau de la table source
Au niveau des statistiques de réplication ou de chargement SAP LT Replication Server dans la transaction LTRC
Au niveau de la table cible BigQuery

Vous pouvez vérifier et comparer le nombre d'enregistrements en utilisant l'outil de validation de réplication, ou récupérer les enregistrements vous-même en exécutant des requêtes SQL.

Pour en savoir plus sur le rapprochement des données, consultez le Guide des opérations BigQuery Connector pour SAP.

Problèmes de configuration courants

Cette section contient les solutions aux problèmes courants pouvant survenir lors de l'installation et de la configuration initiales de BigQuery Connector pour SAP.

Compatibilité de SAP LT Replication Server avec les types de données de base de données

Selon vos versions du logiciel SAP, SAP LT Replication Server risque de ne pas accepter certains types de données dans une base de données source. Pour en savoir plus, consultez la section Remarques importantes de la note SAP 1605140 - SAP Landscape Transformation Replication Server (SLT).

Problème : la commande du système d'exploitation pour le jeton d'accès ne fonctionne pas dans SAP LT Replication Server.

Problème : vous avez créé une commande de système d'exploitation (OS) pour imprimer le jeton d'accès, mais elle ne fonctionne pas dans SAP LT Replication Server.

Cause : ce problème peut être causé par plusieurs problèmes, mais il est très probablement dû au fait que les variables d'environnement requises pour la commande du système d'exploitation ne sont pas configurées correctement.

Résolution : vérifiez que la commande du système d'exploitation a été correctement configurée. Pour connaître la procédure de configuration, consultez la page Créer une commande de système d'exploitation pour imprimer le jeton d'accès.

Essayez d'exécuter la commande printenv à partir du système d'exploitation en tant que sidadm et de la transaction SAP SM69, puis comparez la sortie.

Si les variables renvoyées dans la transaction SM69 sont incomplètes, essayez de redémarrer SAP LT Replication Server pour les enregistrer.

Problème : `/GOOG/MSG: 413 - Request Entity Too Large`

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG: 413 - Request Entity Too Large.

Cause : ce problème peut survenir lorsque la taille en octets du fragment envoyé par BigQuery Connector pour SAP dépasse la taille maximale acceptées par BigQuery pour les requêtes HTTP. Cela peut se produire lorsque, en raison de la taille des enregistrements de table ou de la quantité de données contenues dans les enregistrements, la taille en octets d'un fragment dépasse la limite BigQuery.

Résolution : réduisez la taille des fragments envoyés par BigQuery Connector pour SAP pour votre table. Vous pouvez ajuster la taille des fragments en exécutant la transaction /GOOG/SLT_SETTINGS.

Pour en savoir plus sur le dimensionnement des fragments, consultez la section Taille des fragments dans BigQuery Connector pour SAP.

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

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the request sending.

Cause : ce problème peut être dû à des problèmes de connexion ou de réseau.

Résolution : vérifiez votre connexion et assurez-vous que votre réseau est correctement configuré, qu'il s'exécute sans erreur et qu'il n'est pas encombré.

Problème : `/GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the response receiving`

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the response receiving.

Ce problème peut être dû aux circonstances suivantes :

Échec du handshake SSL.
La taille en octets des fragments dépasse la taille maximale acceptée par BigQuery pour les requêtes HTTP.

Échec du handshake SSL

Cause : le handshake SSL a échoué entre l'hôte SAP LT Replication Server et le point de terminaison de l'API BigQuery. Cela se produit lorsque le certificat présenté par le serveur TLS n'est pas valide pour le nom d'hôte cible fourni par SAP LT Replication Server, peut-être parce que l'envoi côté client de l'extension TLS facultative d'indication de nom de serveur (SNI) n'est pas implémenté sur votre noyau NetWeaver.

Résolution : dans la transaction SMICM, recherchez le code de retour, SSLERR_SERVER_CERT_MISMATCH. Si vous trouvez ce code de retour SSLERR_SERVER_CERT_MISMATCH, vous devez activer l'envoi de l'extension TLS SNI. En outre, assurez-vous que votre noyau NetWeaver implémente l'envoi côté client de l'extension TLS facultative SNI.

Pour activer l'envoi de l'extension TLS SNI, définissez le paramètre de profil icm/HTTPS/client_sni_enabled ou ssl/client_sni_enabled sur TRUE, selon votre version de noyau NetWeaver. Pour en savoir plus sur SAP, consultez les pages suivantes :

La taille en octets des fragments dépasse la taille maximale acceptée par BigQuery pour les requêtes HTTP

Cause : la taille en octets du fragment envoyé par BigQuery Connector pour SAP dépasse la taille maximale acceptée par BigQuery pour les requêtes HTTP. Cela peut se produire lorsque, en raison de la taille des enregistrements de table ou de la quantité de données contenues dans les enregistrements, la taille en octets d'un fragment dépasse la limite BigQuery.

Résolution : réduisez la taille des fragments envoyés par BigQuery Connector pour SAP pour cette table. Vous pouvez ajuster la taille des fragments en exécutant la transaction /GOOG/SLT_SETTINGS. Pour en savoir plus, consultez la section Taille des fragments dans BigQuery Connector pour SAP.

Problème : `/GOOG/MSG: 404 - Not found: Dataset DATASET_NAME`

Problème : Lorsque vous tentez de valider la sécurité Google Cloud ou de charger des données dans une table BigQuery, vous recevez le message /GOOG/MSG: 404 - Not found: Dataset DATASET_NAME.

Cause : ce problème peut être dû aux circonstances suivantes :

L'ensemble de données BigQuery n'a pas encore été créé.
Le nom de l'ensemble de données n'est pas spécifié correctement dans la configuration du transfert de masse.
La configuration de réplication dans SAP LT Replication Server doit être activée.

Résolution : essayez les solutions suivantes :

Vérifiez que l'ensemble de données a été créé dans BigQuery.
Vérifiez que le nom de l'ensemble de données dans la configuration du transfert de masse est identique au nom de l'ensemble de données dans BigQuery.
Exécutez la transaction LTRC, puis désactivez et réactivez la configuration de réplication.

Problème : `Mass Transfer Key can not be found for Mass Transfer ID XXX`

Problème : vous recevez l'erreur /GOOG/SLT: Mass Transfer Key can not be found for Mass Transfer ID XXX.

Cause : ce problème peut être dû aux circonstances suivantes :

Il n'existe aucune configuration de transfert de masse pour l'ID de transfert de masse spécifié.
La configuration de réplication correspondante n'est pas active.

Résolution : pour résoudre le problème, effectuez l'une des opérations suivantes :

Exécutez la transaction /GOOG/SLT_SETTINGS et vérifiez que l'ID de transfert de masse est correctement spécifié.
Exécutez la transaction LTRC, puis désactivez et réactivez la configuration de réplication.

Problème : `/GOOG/SLT : Unable to interpret VALUE as a BOOLEAN`

Problème : le chargement ou la réplication d'un enregistrement échoue avec le message /GOOG/SLT : Unable to interpret VALUE as a BOOLEAN.

Cause : ce problème est causé par le mappage d'un champ de la table source sur le type de données BigQuery BOOLEAN, mais les données du champ source ne sont pas converties en une valeur booléenne.

Résolution : Pour résoudre le problème, utilisez la transaction /GOOG/SLT_SETTINGS pour modifier le type de données auquel le champ source est mappé ou supprimez le mappage de type de données et acceptez le type de données par défaut.

Problème : `/GOOG/SLT: Failed to convert field SAP_FIELD_NAME value to field BIGQUERY_FIELD_NAME: ERROR_DETAILS`

Problème : le chargement ou la réplication d'un enregistrement échoue avec le message /GOOG/SLT: Failed to convert field SAP_FIELD_NAME value to field BIGQUERY_FIELD_NAME: ERROR_DETAILS.

Cause : le champ source contient une valeur non valide ou le champ source est mappé sur un type de données BigQuery qui n'est pas un mappage valide pour les données contenues dans le champ source.

Résolution : pour résoudre le problème, utilisez la transaction /GOOG/SLT_SETTINGS afin de modifier le type de données sur lequel le champ source est mappé ou supprimez le mappage de type de données et acceptez le mappage par défaut pour le type de données

Problème : `/GOOG/MSG : Client key is not found in /GOOG/CLIENT_KEY table`

Problème : un chargement ou une réplication ne commence pas par le message /GOOG/MSG: Client key is not found in /GOOG/CLIENT_KEY table.

Cause : la clé client n'existe pas, ou elle a été spécifiée de manière incorrecte dans la configuration du transfert de masse de la transaction /GOOG/SLT_SETTINGS.

Résolution : pour résoudre le problème, utilisez la transaction SM30 pour créer la clé client ou la transaction /GOOG/SLT_SETTINGS pour corriger la spécification de la valeur de la clé client dans la configuration de transfert de masse.

Problèmes opérationnels courants

Cette section contient les solutions aux problèmes courants pouvant survenir après la configuration initiale de BigQuery Connector pour SAP.

Problème : nombre d'écritures incorrect dans BigQuery

Problème : le nombre d'enregistrements écrits dans BigQuery est supérieur au nombre d'enregistrements affichés dans les journaux SAP LT Replication Server.

Cause : plusieurs causes sont possibles, y compris des problèmes de connexion transitoires qui font que SAP LT Replication Server envoie des enregistrements plusieurs fois ou le fait que la table BigQuery n'accepte que les insertions, et chaque modification apportée à un seul enregistrement de la source est insérée en tant qu'entrée distincte dans la table cible.

Résolution : si la différence du nombre d'enregistrements n'est pas extrême et qu'il n'y a pas moins d'enregistrements dans BigQuery que dans la table source, il s'agit d'un comportement normal, et non d'un problème.

Pour rapprocher avec précision le nombre d'enregistrements dans BigQuery avec le nombre d'enregistrements dans la table source, interrogez la table BigQuery comme décrit dans la section Requêtes SQL pour le nombre d'enregistrements.

Pour en savoir plus sur les causes possibles de ce problème, consultez la page Remarques spéciales concernant les sources et cibles ABAP sur HANA.

Problème : `/GOOG/MSG : 400 - Schema mismatch for table TABLE_NAME`

Problème : vous recevez le message d'erreur /GOOG/MSG : 400 - Schema mismatch for table TABLE_NAME. Please delete the table from BigQuery and try again.

Cause : l'une des modifications suivantes a été saisie pour une table BigQuery existante :

Supprimer un champ
Renommer un champ
Modifier le type de données d'un champ
Modifier le type de partition d'une table

Les modifications précédentes ne peuvent pas être appliquées à une table BigQuery existante.

Résolution : si vous devez modifier l'un de ces attributs de champ dans une table existante, vous devez supprimer la table existante et recharger les enregistrements dans une nouvelle table.

Si la modification est une erreur, annulez la modification dans SAP LT Replication Server.

Pour en savoir plus sur la configuration des champs et des partitions dans une table BigQuery cible, consultez la section Configurations de réplication BigQuery.

Problème : Messages d'erreur liés à des données non valides

Problème : Dans les journaux de l'application, vous recevez un message d'erreur : /GOOG/MSG/: DESCRIPTION_OF_INVALID_DATA error occurred in FIELD_NAME in record RECORD_KEYS.

Cause : ce message d'erreur est émis par BigQuery lors de l'insertion des enregistrements contenant des données non valides dans la table cible. Les données peuvent ne pas être valides pour l'une des raisons suivantes :

Les données du champ d'un enregistrement particulier ne sont pas compatibles avec le type de données dans BigQuery. Par exemple, BigQuery génère des messages d'erreur dans les cas suivants :
- Une chaîne est conservée dans un champ de type DATE, INTEGER ou BOOLEAN.
- Une date non valide (00/00/0000) est conservée dans un champ de type DATE.
Un type de données cible incorrect est conservé dans les mappages de champs dans la transaction /GOOG/SLT_SETTINGS.

Un message d'erreur est émis par BigQuery pour chaque enregistrement contenant un champ avec des données non valides.

Résolution : analysez le message d'erreur DESCRIPTION_OF_INVALID_DATA pour comprendre la cause possible des données non valides. Pour identifier l'enregistrement avec le champ qui contient les données non valides, utilisez RECORD_KEYS, qui inclut le contenu des cinq premiers champs de l'enregistrement. Si la table comporte cinq champs ou moins, le contenu de tous les champs est inclus dans le champ RECORD_KEYS.

Si les données du champ ne sont pas compatibles avec le type de données dans BigQuery, corrigez les données de la table source.
Si l'erreur s'est produite en raison d'une erreur de correspondance entre les données et le type de données, utilisez la transaction /GOOG/SLT_SETTINGS pour spécifier un type de données approprié. Pour en savoir plus sur le mappage des types de données, consultez la section Mappage des types de données.

Obtenir de l'aide

Si vous avez besoin d'aide pour résoudre des problèmes liés à la réplication et à BigQuery Connector pour SAP, collectez toutes les informations de diagnostic disponibles et contactez Cloud Customer Care.

Pour en savoir plus sur la manière de contacter Cloud Customer Care, consultez la page Obtenir de l'aide concernant SAP sur Google Cloud.