Guide de dépannage de BigQuery Connector pour SAP

Vous pouvez résoudre les problèmes liés à la version 2.7 (dernière version) de BigQuery Connector pour SAP en utilisant à la fois la journalisation des applications SAP LT Replication Server et les journaux Google Cloud pour examiner les messages d'erreur et 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.

Pour le système source SAP et SAP LT Replication Server, veillez à implémenter toutes les notes de correction pour la technologie de migration et de réplication basée sur ABAP. Pour en savoir plus, consultez la note SAP 3016862 : Analyseurs de notes DMIS avec des scénarios distincts pour la technologie de migration et de réplication basée sur ABAP.

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 :

  1. Dans la console Google Cloud, ouvrez la page Logging :

    Accéder à l'explorateur de journaux

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

  1. Si vous ne disposez pas déjà des autorisations SAP requises pour déboguer le code BAdI, demandez-les à votre administrateur SAP.

  2. Activez le débogage en saisissant /h dans le champ de saisie de transaction de l'IUG de SAP, puis en appuyant sur Enter.

  3. Dans le menu Paramètres, sélectionnez Modifier le profil/les paramètres du débogueur.

  4. Sous Modes de débogage, assurez-vous que l'option Débogage du système est sélectionnée.

  5. 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.

Essayez d'exécuter la commande printenv à partir du système d'exploitation en tant que SID_LCadm 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: 400 - Bad Request Request contains an invalid argument

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG: 400 - Bad Request Request contains an invalid argument.

Cause : pour votre charge de travail SAP exécutée sur Google Cloud, le niveau d'accès utilisé dans la table de clés client /GOOG/CLIENT_KEY n'est pas valide.

Résolution : pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez la transaction /GOOG/SLT_SETTINGS précédée de /n :

    /n/GOOG/SLT_SETTINGS
  2. Pour l'ID de transfert de masse ayant échoué dans la transaction LTRC, notez la valeur du champ Nom de la clé Google Cloud.

  3. Saisissez la transaction SM30, puis ouvrez la table /GOOG/CLIENT_KEY.

  4. Pour la valeur Nom de la clé Google Cloud que vous avez notée à une étape précédente, assurez-vous que la valeur du champ Champ d'application correspond au niveau d'accès mentionné dans la section Spécifiez les paramètres d'accès dans /GOOG/CLIENT_KEY. Assurez-vous de ne pas saisir d'espace dans le champ.

  5. Réexécutez votre réplication.

Problème : /GOOG/MSG : 400 - ICM_HTTP_CONNECTION_FAILED

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG : 400 - ICM_HTTP_CONNECTION_FAILED.

Cause : dans les destinations RFC que BigQuery Connector pour SAP utilise pour se connecter aux API Google Cloud, la valeur du préfixe de chemin d'accès ou le champ Hôte cible est incorrect.

Résolution : pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez la transaction /GOOG/SLT_SETTINGS précédée de /n :

    /n/GOOG/SLT_SETTINGS
  2. Pour l'ID de transfert de masse ayant échoué dans la transaction LTRC, notez la valeur du champ Nom de la clé Google Cloud.

  3. Saisissez la transaction SM30, puis ouvrez la table /GOOG/SERVIC_MAP.

  4. Pour la valeur Nom de la clé Google Cloud que vous avez notée lors d'une étape précédente, notez les noms des destinations RFC.

  5. Saisissez la transaction SM59, puis procédez comme suit :

    1. Pour la destination RFC qui se connecte à BigQuery, assurez-vous que la valeur du champ Préfixe de chemin d'accès est /bigquery/v2/.

    2. Pour la destination RFC qui se connecte à BigQuery, assurez-vous que la valeur du champ Hôte cible est bigquery.googleapis.com.

    3. Pour la destination RFC qui se connecte à IAM, assurez-vous que la valeur du champ Préfixe de chemin d'accès est /v1/.

    4. Pour la destination RFC qui se connecte à IAM, assurez-vous que la valeur du champ Hôte cible est iamcredentials.googleapis.com.

  6. Réexécutez votre réplication ou votre chargement initial.

Problème : /GOOG/MSG : 401 - Unauthorized Request is missing required authentication credential. Expected OAuth 2 access to ken, login coo

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG : 401 - Unauthorized Request is missing required authentication credential. Expected OAuth 2 access to ken, login coo.

Cause : la configuration du port HTTP est manquante.

Résolution : les ports HTTP et HTTPS doivent être créés et être actifs dans votre système SAP.

Les métadonnées de VM sont stockées sur un serveur de métadonnées, qui n'est accessible que via un port HTTP. Par conséquent, vous devez vous assurer qu'un port HTTP et un port HTTPS sont créés et actifs pour accéder aux métadonnées de la VM.

Pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez le code de transaction SMICM.

  2. Dans la barre de menu, cliquez sur Goto > Services (Accéder à > Services).

  3. Assurez-vous que les ports HTTP et HTTPS sont créés et actifs. Une coche verte dans la colonne Actv indique que les ports HTTP et HTTPS sont actifs.

  4. Réexécutez votre réplication.

Pour en savoir plus sur la configuration des ports HTTP et HTTPS, consultez la page Paramètres HTTP(S) dans ICM.

Problème : /GOOG/MSG : 401 - ICM_HTTP_CONNECTION_BROKEN

Problème : lors du chargement initial ou de la réplication, le transfert de données a échoué dans la transaction LTRC avec le message d'erreur /GOOG/MSG : 401 - ICM_HTTP_CONNECTION_BROKEN.

Cause : pour votre charge de travail SAP exécutée sur Google Cloud, le protocole SSL n'est pas activé dans les destinations RFC utilisées par BigQuery Connector pour SAP pour se connecter aux API Google Cloud.

Résolution : pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez la transaction /GOOG/SLT_SETTINGS précédée de /n :

    /n/GOOG/SLT_SETTINGS
  2. Pour l'ID de transfert de masse ayant échoué dans la transaction LTRC, notez la valeur du champ Nom de la clé Google Cloud.

  3. Saisissez la transaction SM30, puis ouvrez la table /GOOG/SERVIC_MAP.

  4. Pour la valeur Nom de la clé Google Cloud que vous avez notée lors d'une étape précédente, notez les noms des destinations RFC.

  5. Saisissez la transaction SM59, puis procédez comme suit pour les destinations RFC que vous avez indiquées à l'étape précédente :

    1. Accédez à l'onglet Connexion et sécurité.

    2. Pour le champ Certificat SSL, assurez-vous que l'option Client SSL par défaut (standard) est sélectionnée.

    3. Dans le champ Numéro de service, assurez-vous que la valeur 443 est spécifiée.

  6. Réexécutez votre réplication.

Problème /GOOG/MSG: 110 - HTTPIO_PLG_CANCELED

Problème : lors du chargement initial ou de la réplication, le transfert de données a échoué dans la transaction LTRC avec le message d'erreur /GOOG/MSG: 110 - HTTPIO_PLG_CANCELED.

Cause : la configuration du port HTTP est manquante.

Résolution : les ports HTTP et HTTPS doivent être créés et être actifs dans votre système SAP.

Les métadonnées de VM sont stockées sur un serveur de métadonnées, qui n'est accessible que via un port HTTP. Par conséquent, vous devez vous assurer qu'un port HTTP et un port HTTPS sont créés et actifs pour accéder aux métadonnées de la VM.

Pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez le code de transaction SMICM.

  2. Dans la barre de menu, cliquez sur Goto > Services (Accéder à > Services).

  3. Assurez-vous que les ports HTTP et HTTPS sont créés et actifs. Une coche verte dans la colonne Actv indique que les ports HTTP et HTTPS sont actifs.

  4. Réexécutez votre réplication.

Pour en savoir plus sur la configuration des ports HTTP et HTTPS, consultez la page Paramètres HTTP(S) dans ICM.

Problème : /GOOG/MSG: 403 - SSL is required to perform this operation

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG: 403 - SSL is required to perform this operation.

Cause : pour votre charge de travail SAP exécutée sur Google Cloud, le protocole SSL n'est pas activé dans les destinations RFC utilisées par BigQuery Connector pour SAP pour se connecter aux API Google Cloud.

Résolution : pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez la transaction /GOOG/SLT_SETTINGS précédée de /n :

    /n/GOOG/SLT_SETTINGS
  2. Pour l'ID de transfert de masse ayant échoué dans la transaction LTRC, notez la valeur du champ Nom de la clé Google Cloud.

  3. Saisissez la transaction SM30, puis ouvrez la table /GOOG/SERVIC_MAP.

  4. Pour la valeur Nom de la clé Google Cloud que vous avez notée lors d'une étape précédente, notez les noms des destinations RFC.

  5. Saisissez la transaction SM59, puis procédez comme suit pour les destinations RFC que vous avez indiquées à l'étape précédente :

    1. Accédez à l'onglet Connexion et sécurité.

    2. Pour le champ Certificat SSL, assurez-vous que l'option Client SSL par défaut (standard) est sélectionnée.

    3. Dans le champ Numéro de service, assurez-vous que la valeur 443 est spécifiée.

  6. Réexécutez votre réplication.

Problème : /GOOG/MSG: 403 - Request had insufficient authentication scopes

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG: 403 - Request had insufficient authentication scopes.

Cause : pour votre charge de travail SAP exécutée sur Google Cloud, le compte de service spécifié ne dispose pas du champ d'application requis pour accéder à BigQuery dans la table /GOOG/CLIENT_KEY.

Résolution : pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez la transaction /GOOG/SLT_SETTINGS précédée de /n :

    /n/GOOG/SLT_SETTINGS
  2. Pour l'ID de transfert de masse ayant échoué dans la transaction LTRC, notez la valeur du champ Nom de la clé Google Cloud.

  3. Saisissez la transaction SM30, puis ouvrez la table /GOOG/CLIENT_KEY.

  4. Pour la valeur Nom de la clé Google Cloud que vous avez notée à une étape précédente, assurez-vous que la valeur spécifiée pour le champ Nom du compte de service champ estdefault.

  5. Dans la console Google Cloud, accédez à la page Instances de VM Compute Engine.

    Accéder à la page "Instances de VM"

  6. Cliquez sur l'instance de VM qui héberge votre serveur SAP LT Replication Server.

  7. Cliquez sur Arrêter, puis suivez les instructions pour arrêter l'instance de VM.

  8. Cliquez sur Modifier, modifiez les niveaux d'accès du compte de service pour activer l'accès à BigQuery, puis cliquez sur Enregistrer.

  9. Cliquez sur Démarrer/Reprendre pour redémarrer la VM.

  10. Assurez-vous que SAP LT Replication Server est en cours d'exécution.

  11. Réexécutez votre réplication.

Problème : /GOOG/MSG: 403 - Access Denied: Dataset PROJECT_ID:DATASET_NAME: Permission bigquery.tables.created denied on dataset

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG: 403 - Access Denied: Dataset PROJECT_ID:DATASET_NAME: Permission bigquery.tables.created denied on dataset.

Cause : pour votre charge de travail SAP exécutée sur Google Cloud, dans le tableau /GOOG/CLIENT_KEY, le compte de service spécifié ne dispose pas des autorisations requises pour accéder à l'API BigQuery.

Résolution : pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez la transaction /GOOG/SLT_SETTINGS précédée de /n :

    /n/GOOG/SLT_SETTINGS
  2. Pour l'ID de transfert de masse ayant échoué dans la transaction LTRC, notez la valeur du champ Nom de la clé Google Cloud.

  3. Saisissez la transaction SM30, puis ouvrez la table /GOOG/CLIENT_KEY.

  4. Pour la valeur Nom de la clé Google Cloud que vous avez notée à une étape précédente, notez la valeur spécifiée pour le champ Nom du compte de service.

  5. Dans la console Google Cloud, accédez à la page Comptes de service IAM (Identity and Access Management).

    Accéder à la page "Comptes de service"

  6. Sélectionnez le compte de service que vous avez noté lors d'une étape précédente.

  7. Assurez-vous que le compte de service dispose des rôles IAM requis par BigQuery Connector pour SAP afin d'accéder à BigQuery, comme indiqué dans la section Google Cloud Identity and Access Management.

  8. Réexécutez votre réplication.

Problème : /GOOG/MSG: 404 - Not Found

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG: 404 - Not Found.

Cause : Dans les destinations RFC que BigQuery Connector pour SAP utilise pour se connecter aux API Google Cloud, le préfixe de chemin d'accès est incorrect.

Résolution : pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez la transaction /GOOG/SLT_SETTINGS précédée de /n :

    /n/GOOG/SLT_SETTINGS
  2. Pour l'ID de transfert de masse ayant échoué dans la transaction LTRC, notez la valeur du champ Nom de la clé Google Cloud.

  3. Saisissez la transaction SM30, puis ouvrez la table /GOOG/SERVIC_MAP.

  4. Pour la valeur Nom de la clé Google Cloud que vous avez notée lors d'une étape précédente, notez les noms des destinations RFC.

  5. Saisissez la transaction SM59, puis procédez comme suit :

    • Pour la destination RFC qui se connecte à BigQuery, assurez-vous que la valeur du champ Préfixe de chemin d'accès est /bigquery/v2/.
    • Pour la destination RFC qui se connecte à IAM, assurez-vous que la valeur du champ Préfixe de chemin d'accès est /v1/.
  6. Réexécutez votre réplication.

Problème : /GOOG/MSG: 404 - Table PROJECT_ID:DATASET_NAME.TABLE_NAME not found

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG: 404 - Table PROJECT_ID:DATASET_NAME.TABLE_NAME not found.

Cause : Dans les Destinations RFC utilisées par le connecteur BigQuery pour SAP pour se connecter aux API Google Cloud, la valeur que vous avez spécifiée pour l'Hôte cible ne correspond à aucun nom DNS dans Cloud DNS.

Résolution : pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez le code de transaction SE38, puis ouvrez le rapport /GOOG/R_SLT_SETTINGS.

  2. Pour la transaction LTRC exécutée, ouvrez l'ID de transfert de masse, puis notez la valeur dans la colonne Nom de la clé Google Cloud.

  3. Saisissez la transaction SM30, puis ouvrez la table /GOOG/CLIENT_KEY en mode d'affichage.

  4. Recherchez le nom de la clé Google Cloud que vous avez précédemment noté dans la table /GOOG/SERVIC_MAP, puis notez les noms de destination RFC spécifiés.

  5. Saisissez le code de transaction SM59.

  6. Pour les destinations RFC que vous utilisez pour vous connecter aux API BigQuery et IAM, notez la valeur spécifiée pour le champ Hôte cible.

  7. Dans la console Google Cloud, accédez à la page Services DNS du service réseau.

    Accéder à Cloud DNS

  8. Cliquez sur la zone privée contenant les enregistrements DNS des points de terminaison Private Service Connect, que vous avez créés pour permettre à BigQuery Connector pour SAP de se connecter en mode privé aux API BigQuery et IAM.

  9. Assurez-vous qu'il existe un enregistrement DNS, avec un nom DNS correspondant, pour chacune des valeurs d'hôte cible que vous avez notées lors d'une précédente étape.

  10. Réexécutez votre réplication.

Problème : /GOOG/MSG: 404 - Not Found Requested entity was not found

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG: 404 - Not Found Requested entity was not found.

Cause : pour votre charge de travail exécutée sur Google Cloud, le compte de service utilisé dans la table de clé client /GOOG/CLIENT_KEY n'est pas valide.

Résolution : pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez la transaction /GOOG/SLT_SETTINGS précédée de /n :

    /n/GOOG/SLT_SETTINGS
  2. Pour l'ID de transfert de masse ayant échoué dans la transaction LTRC, notez la valeur du champ Nom de la clé Google Cloud.

  3. Saisissez la transaction SM30, puis ouvrez la table /GOOG/CLIENT_KEY.

  4. Pour le champ Nom du compte de service assurez-vous que la valeur spécifiée correspond à l'adresse e-mail du compte de service créé pour BigQuery Connector pour SAP à l'étape Créer un compte de service.

  5. Réexécutez votre réplication.

Problème : /GOOG/MSG: 418 – Échec du transfert de données avec un message d'erreur de SAP

Problème : le transfert de données a échoué avec un message d'erreur de SAP, par exemple No OS command defined for the key.

Cause : pour votre charge de travail SAP qui ne s'exécute pas sur Google Cloud, ce problème peut être causé par les circonstances suivantes :

La commande de système d'exploitation qui affiche le jeton d'accès n'est pas correctement configurée.

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

  • Vous avez créé une commande de système d'exploitation (OS) pour imprimer le jeton d'accès, mais vous ne l'avez pas ajoutée aux paramètres d'accès de la table de clés cliente /GOOG/CLIENT_KEY.

  • La commande de système d'exploitation que vous avez créée dans la transaction SM69 n'a pas réussi à récupérer de jeton d'accès à partir de Google Cloud.

Résolution : dans la table de clés client /GOOG/CLIENT_KEY, pour le champ Command name (Nom de la commande), assurez-vous que la valeur saisie correspond au nom de la commande que vous avez créée pour imprimer le jeton d'accès.

Le document RFC n'est pas correctement configuré

Cause : pour votre charge de travail SAP exécutée sur Google Cloud, dans les destinations RFC utilisées par BigQuery Connector pour SAP pour se connecter aux API Google Cloud, la valeur du champ Hôte cible est incorrecte.

Solution : pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez la transaction SE38, puis ouvrez le rapport /GOOG/R_SLT_SETTINGS.

  2. Pour la transaction LTRC exécutée, ouvrez l'ID de transfert de masse et notez la valeur de Nom de la clé Google Cloud.

  3. Saisissez la transaction SM30, puis ouvrez la table /GOOG/CLIENT_KEY en mode d'affichage.

  4. Recherchez le nom de la clé Google Cloud que vous avez précédemment noté dans la table /GOOG/SERVIC_MAP, puis notez les noms de destination RFC spécifiés.

  5. Saisissez le code de transaction SM59, puis ouvrez les destinations RFC que vous avez notées à l'étape précédente.

  6. Dans le champ Hôte cible, corrigez l'URL spécifiée.

  7. Réexécutez votre réplication.

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, ou activer la taille de fragment dynamique pour ajuster automatiquement la taille des fragments. Pour en savoir plus, consultez les pages suivantes :

Problème : /GOOG/MSG: 503 - HTTP Communication Failure - SSL client SSL Client (Standard)

Problème : le transfert de données a échoué en renvoyant le message d'erreur /GOOG/MSG: 503 - HTTP Communication Failure - SSL client SSL Client (Standard).

Cause : pour votre charge de travail SAP exécutée sur Google Cloud, dans les destinations RFC utilisées par BigQuery Connector pour SAP pour se connecter aux API Google Cloud, la valeur du champ Hôte cible est incorrecte.

Solution : pour résoudre ce problème, consultez les étapes de résolution dans la section le document RFC n'est pas correctement configuré.

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 :

SSL n'est pas activé dans vos destinations RFC

Cause : dans les destinations RFC que le connecteur BigQuery pour SAP utilise pour se connecter aux API Google Cloud, l'option de sécurité permettant d'utiliser le certificat SSL n'est pas activée.

Solution : pour résoudre ce problème, consultez les étapes de résolution de la section Problème : /GOOG/MSG: 403 - le protocole SSL est requis pour effectuer cette opération.

É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, ou activer la taille de fragment dynamique pour ajuster automatiquement la taille des fragments. Pour en savoir plus, consultez les pages suivantes :

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ème : /GOOG/MSG: DESCRIPTION_OF_ISSUE error occurred in chunk ranging START_INDEX_OF_FAILED_CHUNK - END_INDEX_OF_FAILED_CHUNK

Problème : la réplication d'un fragment a échoué avec un message d'erreur /GOOG/MSG: DESCRIPTION_OF_ISSUE error occurred in chunk ranging START_INDEX_OF_FAILED_CHUNK - END_INDEX_OF_FAILED_CHUNK.

Cause : il peut y avoir plusieurs causes, y compris Invalid JSON Payload, Quota Exceeded, Request Entity Too Large ou HTTP Communication Failure. Le message d'erreur associé au fragment qui n'a pas été dupliqué vers BigQuery s'affiche avec les index de début et de fin du fragment.

Ce message d'erreur s'affiche si vous n'avez pas défini l'option BREAK dans la transaction /GOOG/SLT_SETTINGS. Lorsque l'option BREAK n'est pas définie, BigQuery Connector pour SAP continue d'envoyer des enregistrements à BigQuery en envoyant le fragment suivant même lorsqu'une erreur se produit.

Résolution : essayez les solutions suivantes :

Problème : DESCRIPTION_OF_ISSUE while signing JWT using profile KEY_FILE_NAME.pse. Check JWT config in STRUST

Problème : vous recevez l'erreur DESCRIPTION_OF_ISSUE while signing JWT using profile KEY_FILE_NAME .pse. Check JWT config in STRUST.

Cause : les paramètres de configuration JWT et de clé de compte de service ne sont pas configurés correctement dans STRUST.

Résolution : vérifiez que la configuration de JWT et la clé de compte de service sont configurées, comme expliqué dans la section Authentification à l'aide de JWT pour obtenir des jetons d'accès.

Problème : Bad Request invalid_grant. Invalid JWT Signature

Problème : vous recevez l'erreur Bad Request invalid_grant. Invalid JWT Signature.

Cause : le fichier de clé PSE ou P12 importé dans STRUST n'appartient pas au compte de service que vous avez utilisé pour signer le jeton JWT.

Résolution : veillez à importer le fichier de clé de compte de service approprié dans STRUST. Pour obtenir des informations sur l'importation de la clé de compte de service dans STRUST, consultez la section Importer la clé de compte de service dans STRUST.

Problème : OAuth RFC HTTP Destination not maintained in /GOOG/SERVIC_MAP

Problème : vous recevez l'erreur OAuth RFC HTTP Destination not maintained in /GOOG/SERVIC_MAP.

Cause : la destination RFC pour OAuth 2.0 n'est pas disponible dans la table de mappage de service /GOOG/SERVIC_MAP.

Résolution : mettez à jour la destination RFC pour OAuth 2.0 dans la table de mappage de service /GOOG/SERVIC_MAP, puis réexécutez la charge. Pour obtenir des informations sur la spécification des destinations RFC, consultez la section Spécifier des destinations RFC dans /GOOG/SERVIC_MAP.

Problème : pour les langues d'ouverture de session autres que l'anglais, les descriptions de champs sont altérées lorsque vous importez des données à partir d'un fichier CSV.

Problème : pour les langues d'ouverture de session autres que l'anglais, lorsque vous importez des types de champs de table cible BigQuery, et les descriptions de champs associées, à l'aide de l'option d'importation de fichiers, les descriptions de champs issues du fichier CSV ne sont pas importées correctement. Vous allez constater des caractères erronés et des symboles dans les descriptions importées.

Cause : pour les langues d'ouverture de session autres que l'anglais, l'utilitaire d'importation de fichiers n'est pas en mesure d'interpréter avec précision les caractères présents dans le fichier CSV.

Résolution : pour importer des types de champs de table cible BigQuery, et les descriptions de champs associées, qui ont été rédigés dans une langue autre que l'anglais, utilisez le format d'encodage UTF-8 avec l'indicateur d'ordre des octets (BOM) pour votre fichier CSV. Enregistrez le fichier CSV au format UTF-8 avec indicateur BOM, puis importez-le.

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 : les tables sources vides dans SAP ne sont pas créées dans l'ensemble de données BigQuery

Problème : les tables sources vides dans SAP ne sont pas créées dans l'ensemble de données BigQuery.

Cause : pour les tables sources vides dans SAP, SAP SLT empêche la création de tables cibles dans BigQuery.

Solution : pour créer des tables cibles dans l'ensemble de données BigQuery pour les tables sources vides dans SAP, vous pouvez utiliser l'outil de création de table. Pour en savoir plus sur l'exécution de l'outil de création de table, consultez Outil de création de table.

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.

Problème : la valeur d'un champ affiché dans la transaction SE16 ou SE16N est différente de celle affichée dans BigQuery

Problème : dans certains cas, la valeur d'un champ affiché dans la transaction SE16 ou SE16N est différente de la valeur affichée dans BigQuery.

Cause : dans le système source SAP S/4HANA, les tables telles que MARD, MARC, MBEW et MBEWH ont des vues de compatibilité qui affichent des valeurs dans la transaction SE16 ou SE16N. Pour ces tables, les valeurs affichées dans la transaction SE16 ou SE16N sont calculées dans les vues de compatibilité à l'aide de conditions de jointure, qui incluent plusieurs autres tables sous-jacentes.

Lorsqu'une table avec une vue de compatibilité est configurée dans SLT pour la réplication vers BigQuery, SLT ne réplique pas les données de la vue de compatibilité. Au lieu de cela, SLT réplique les données de chacune des tables sous-jacentes séparément. Vous remarquerez donc que certains champs ont des valeurs différentes dans SE16 ou SE16N par rapport à celles présentées dans BigQuery Il s'agit d'un comportement SLT standard.

Résolution : pour résoudre ce problème, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez le code de transaction LTRS.
  2. Sélectionnez les paramètres de transfert de masse pour la réplication BigQuery.
  3. Accédez à Paramètres avancés de la réplication > Paramètres de la table.
  4. Sélectionnez la table qui utilise des vues de compatibilité. Si la table dont vous avez besoin n'est pas répertoriée, ajoutez-la.
  5. Dans la section Paramètres de traitement, saisissez des valeurs pour les champs suivants:

    • Afficher pour le chargement initial: valeur de la vue de compatibilité pour la table à partir de SE16 ou SE16N.
    • Vue pour la réplication : valeur de la vue de compatibilité pour la table à partir de SE16 ou SE16N.
  6. Enregistrez les paramètres.

Vous pouvez également répliquer toutes les tables sous-jacentes de la vue de compatibilité dans BigQuery. Dans BigQuery, associez ces tables en utilisant les mêmes conditions de jointure que la vue de compatibilité.

Pour en savoir plus sur certaines tables bien connues et leurs vues de compatibilité, consultez la note SAP 2595627 - Accéder à la table à partir de SE16/SE16N affiche des résultats différents pour la base de données SAP HANA.

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.