Gérer BigQuery Toolkit pour les opérations SAP

On-premises or any cloud edition v1.9

• Édition SAP BTP v1.1
• Sur site ou dans n'importe quelle édition cloud v1.9

Ce document explique aux administrateurs SAP, aux développeurs SAP ou à d'autres personnes comment effectuer des tâches opérationnelles pour BigQuery Toolkit pour SAP.

Taille de fragment dynamique

Si vous rencontrez des erreurs, car la taille des fragments (en octets) dépasse la taille maximale des requêtes HTTP acceptées par BigQuery, vous devez réduire manuellement la taille des octets en réduisant la taille des fragments. La fonctionnalité de taille des fragments dynamiques vous permet de réduire automatiquement la taille des fragments et de relancer la réplication dans BigQuery lorsque la taille en octets d'un fragment dépasse la taille maximale en octets acceptée par BigQuery pour les requêtes HTTP. La taille des fragments dynamiques vous permet d'éviter la plupart des échecs de réplication dus à la taille en octets d'une requête. Vous pouvez recevoir une erreur uniquement si la taille des fragments atteint 1, mais que la taille des octets dépasse la limite en octets acceptée par BigQuery pour chaque requête HTTP.

La taille de fragment dynamique s'active dans la configuration de transfert de données d'une table à l'aide de la transaction /GOOG/BQTR_SETTINGS. La taille de fragment dynamique est un paramètre facultatif. Pour savoir comment activer la taille de fragment dynamique, consultez la section Spécifier la création de table et d'autres attributs généraux.

Lorsque BigQuery Toolkit pour SAP réduit la taille des fragments, le message d'information suivant est renvoyé à l'application ABAP appelante dans le paramètre et_return:

Dynamic chunking triggered. Chunk size reduced from INITIAL_CHUNK_SIZE_VALUE to FINAL_REDUCED_CHUNK_SIZE_VALUE

Acheminer les paramètres de transfert de masse vers l'environnement de production

Pour acheminer les paramètres de transfert de masse BigQuery Toolkit pour SAP vers l'environnement de production, vous devez commencer par exporter les paramètres depuis un système de développement, puis les importer dans le système de production.

Vous pouvez si vous le souhaitez importer deux parties distinctes des paramètres d'un transfert de masse dans votre environnement de production:

• Les paramètres de clé client de la table /GOOG/CLIENT_KEY, accessibles à l'aide de la transaction SM30.
• Les paramètres de transfert de masse de BigQuery Toolkit pour SAP, accessibles à l'aide de la transaction /GOOG/BQTR_SETTINGS.

Remarque : Avant de transférer les paramètres de transfert de masse vers l'environnement de production, validez-les dans un environnement de contrôle qualité ou de bac à sable.

Exporter les paramètres de transfert de masse à partir d'un système de développement

Dans votre système de développement SAP, exportez chaque partie des paramètres de transfert de masse:

1. Exportez les paramètres de transfert de masse de BigQuery Toolkit pour SAP:

   1. Dans l'interface utilisateur graphique de SAP, exécutez le code de transaction /GOOG/SDK_IMG.

      Vous pouvez également exécuter le code de transaction SPRO, puis cliquer sur SAP Reference IMG (IMG de référence SAP).

   2. Cliquez sur SDK ABAP pour Google Cloud > Paramètres de base > Transfert de données BigQuery: maintenance des paramètres.

   3. Dans le champ Tableau des paramètres, sélectionnez Transfert de masse.

   4. Sélectionnez les enregistrements de transfert de masse que vous transférez en production.

   5. Cliquez sur Acheminer les paramètres de transfert de masse.

   6. Dans la fenêtre Invite pour une requête de poste de travail, saisissez le numéro de requête de transport puis cliquez sur l'icône Continuer. Pour chaque enregistrement de transfert de masse sélectionné, les paramètres des tables de configuration personnalisée suivantes sont inclus dans le transport:

      • /GOOG/BQTR_MASTR
      • /GOOG/BQTR_TABLE
      • /GOOG/BQTR_FIELD

   Les paramètres de transfert de masse sont enregistrés dans une requête de transport.

2. Exportez les paramètres de clé client en incluant manuellement le contenu de la table /GOOG/CLIENT_KEY dans la requête de transport.

3. Enregistrez les fichiers sur votre poste de travail local.

Importer des paramètres de transfert de masse dans un système de production

Importez la requête de transport contenant les paramètres de transfert de masse.

Dans le système de production SAP, importez chaque partie des paramètres de transfert de masse:

1. Dans l'IUG de SAP, importez la requête de transport contenant les paramètres de transfert de masse.

2. Dans l'interface utilisateur graphique de SAP, exécutez le code de transaction /GOOG/SDK_IMG.

   Vous pouvez également exécuter le code de transaction SPRO, puis cliquer sur SAP Reference IMG (IMG de référence SAP).

3. Cliquez sur SDK ABAP pour Google Cloud > Paramètres de base > Configurer la clé client.

4. Mettez à jour les paramètres de clé client en fonction des besoins de l'environnement de production.

5. Cliquez sur SDK ABAP pour Google Cloud > Paramètres de base > Transfert de données BigQuery: maintenance des paramètres.

6. Vérifiez que les transferts de masse corrects s'affichent bien sur l'écran Transferts de masse.

7. Dans les écrans suivants des paramètres de Tables et de Champs, mettez à jour les autres valeurs de la table et le mappage des champ pour l'environnement de production, le cas échéant.

8. Testez la configuration en exécutant votre programme de chargement de données qui appelle BigQuery Toolkit pour SAP.

Afficher les paramètres du service de transfert de données BigQuery

Pour afficher les paramètres de transfert de masse du module de transfert de données BigQuery, procédez comme suit:

1. Dans l'interface utilisateur graphique de SAP, exécutez le code de transaction /GOOG/SDK_IMG.

   Vous pouvez également exécuter le code de transaction SPRO, puis cliquer sur SAP Reference IMG (IMG de référence SAP).

2. Cliquez sur SDK ABAP pour Google Cloud > Paramètres de base > Transfert de données BigQuery: affichage des paramètres.

Vous pouvez également afficher les paramètres à l'aide de la transaction /GOOG/BQTR_SETTINGS.

Validation de la réplication

Lorsque vous spécifiez l'option Option pour les champs supplémentaires dans votre configuration de transfert groupé, BigQuery Toolkit pour SAP ajoute des colonnes supplémentaires au schéma de table dans BigQuery. Ces colonnes contiennent les informations suivantes:

• Informations sur le type de modification ayant déclenché la réplication pour chaque enregistrement.
• Code temporel indiquant à quel moment BigQuery Toolkit pour SAP a reçu la partie contenant cet enregistrement.

Grâce aux informations de ces colonnes, vous pouvez valider le processus de réplication, en veillant à l'intégrité et à la cohérence des données entre votre système SAP et BigQuery. Vous pouvez utiliser les types de modification et l'horodatage pour interroger les types de décompte d'enregistrements suivants :

• Nombre d'enregistrements chargés dans une table BigQuery lors d'un chargement initial.
• Nombre d'enregistrements répliqués dans une table BigQuery pendant un jour spécifié.
• Nombre total d'enregistrements uniques dans une table BigQuery.

Pour obtenir ces nombres, vous pouvez interroger directement la table BigQuery en envoyant des requêtes SQL dans la console Google Cloud.

Pour obtenir une présentation de l'option pour les champs supplémentaires, consultez la section Champs supplémentaires pour les modifications d'enregistrements et le décompte des requêtes.

Requêtes SQL pour le nombre d'enregistrements

Vous pouvez exécuter des requêtes SQL pour vérifier le nombre d'enregistrements dans vos tables BigQuery à l'aide de la page Éditeur SQL de BigQuery dans la console Google Cloud.

Paramètre de table requis pour le nombre d'enregistrements : les requêtes SQL de cette section nécessitent la spécification de l'option pour les champs supplémentaires lorsque vous spécifiez les options de tables BigQuery pendant la configuration de la réplication. Pour en savoir plus, consultez la section Champs supplémentaires pour les modifications d'enregistrement et les requêtes de décompte.

Interroger le nombre d'enregistrements insérés en mode de chargement initial

Lorsqu'un schéma de table BigQuery inclut la colonne facultative operation_flag, les enregistrements insérés dans la table en mode de chargement initial incluent l'option d'opération L.

Pour obtenir le nombre d'enregistrements reçus par BigQuery lors d'un chargement initial, exécutez la requête suivante :

SELECT COUNT(*)
  FROM
      `PROJECT.DATASET.TABLE`
  WHERE operation_flag = 'L'

Interroger le nombre d'enregistrements insérés en mode de réplication

Lorsqu'un schéma de table BigQuery inclut la colonne operation_flag facultative, les enregistrements insérés dans la table en mode réplication incluent l'une des options d'opération suivantes :

• I : l'enregistrement a été inséré dans la table source.
• D : l'enregistrement a été supprimé de la table source.
• U : l'enregistrement a été mis à jour dans la table source.

Pour obtenir le nombre d'enregistrements reçus par BigQuery en mode de réplication, exécutez la requête suivante :

SELECT COUNT(*)
  FROM
      `PROJECT.DATASET.TABLE`
  WHERE operation_flag = 'I' | 'D' | 'U'

Interroger le nombre total d'enregistrements dans une table BigQuery

Lorsqu'un schéma de table BigQuery inclut la colonne facultative recordstamp, le champ recordstamp correspondant de chaque enregistrement inséré dans la table contient un code temporel indiquant à quel moment l'enregistrement a été envoyé par BigQuery Toolkit pour SAP vers BigQuery.

Pour obtenir le nombre total d'enregistrements dans une table BigQuery que vous pouvez comparer avec le nombre total d'enregistrements dans une table source, vous pouvez utiliser les champs recordstamp et is_deleted pour compter le nombre d'enregistrements uniques de la table BigQuery qui n'ont pas été supprimés de la table source.

Si la table source est activement mise à jour ou si la réplication est active lorsque vous interrogez les enregistrements, le nombre d'enregistrements dans les tables sources et cibles peut ne pas correspondre exactement.

Pour obtenir le nombre actuel d'enregistrements uniques dans la table cible BigQuery, exécutez la requête suivante :

SELECT COUNT(*)
  FROM (
    SELECT
      *,
      ROW_NUMBER() OVER (PARTITION BY KEY_FIELD_1, ..., KEY_FIELD_N ORDER BY recordstamp DESC) row_num
    FROM
      `PROJECT.DATASET.TABLE` )
  WHERE row_num = 1 AND is_deleted = false

Modifier le mappage de champ BigQuery dans un fichier CSV

Les sections suivantes décrivent comment exporter le mappage de champ par défaut afin que les ingénieurs de données ou les administrateurs BigQuery puissent modifier les valeurs des champs cibles sans avoir besoin d'accéder au système SAP.

Lorsque vous modifiez les valeurs du champ cible, respectez les règles suivantes:

• Ne modifiez pas les valeurs des colonnes Nom de la source de données SAP et Nom du champ SAP.
• Dans la colonne Envoyer un indicateur non compressé, pour activer la compression des enregistrements, marquez le champ avec un seul X. Sinon, laissez le champ vide.

Créer une feuille de calcul ou un fichier texte des mappages de champs par défaut

Pour créer un fichier CSV à modifier en dehors de votre serveur SAP, procédez comme suit:

1. Dans l'interface utilisateur graphique de SAP, exécutez le code de transaction /GOOG/SDK_IMG.

   Vous pouvez également exécuter le code de transaction SPRO, puis cliquer sur SAP Reference IMG (IMG de référence SAP).

2. Cliquez sur SDK ABAP pour Google Cloud > Paramètres de base > Transfert de données BigQuery: maintenance des paramètres.

3. Dans l'écran Maintenance des paramètres de transfert de données BigQuery, spécifiez les valeurs suivantes:

   • Dans le champ Paramètres de la table, spécifiez Champs.
   • Dans le champ Clé de transfert de masse, spécifiez l'ID du transfert de masse que vous mettez à jour.
   • Dans le champ Nom de la table, laissez le champ vide pour utiliser tous les champs de toutes les tables ou spécifiez un nom de table pour utiliser une table spécifique.
   • Laissez tous les autres champs vides.

4. Cliquez sur l'icône Exécuter. L'écran Maintenance des paramètres de transfert de données BigQuery – Champs s'affiche.

5. Dans l'écran Maintenance des paramètres de transfert de données BigQuery – Champs, masquez toutes les colonnes sauf celles de la liste suivante en effectuant un clic droit sur les en-têtes de colonne et en sélectionnant Masquer dans le menu déroulant:

   • Nom de la source de données SAP
   • Nom du champ SAP
   • Élément de données externe
   • Nom du champ externe
   • Description du champ
   • Envoyer un indicateur non compressé

6. Une fois les six colonnes restantes affichées, cliquez sur l'icône Exporter.

7. Dans le menu Exporter, sélectionnez l'une des options suivantes :

   • Spreadsheet
   • Fichier local. Pour faciliter la conversion du contenu du fichier au format CSV, nous vous recommandons de l'enregistrer au format Texte avec tabulations.

8. Enregistrez les mappages de champs par défaut en cliquant sur l'icône Case à cocher.

Convertir la feuille de calcul ou le fichier texte au format CSV

Pour importer des mappages de champs modifiés à l'aide de la transaction personnalisée /GOOG/BQTR_SETTINGS, les mappages de champs doivent être au format CSV.

Si vous utilisez une feuille de calcul, enregistrez-la au format CSV avant d'importer le fichier.

Si vous utilisez un fichier local séparé par des tabulations ou un autre format, vous devez le modifier pour qu'il soit conforme au format CSV.

Exemple :

SAP Table,SAP Field Name,External Data Element,External Field Name,Field Description, Send Uncompressed Flag
SAP_TABLE_NAME,SAP_FIELD_NAME1,BIGQUERY_DATA_TYPE,BIGQUERY_FIELD_NAME1,BIGQUERY_FIELD_DESCRIPTION1, SEND_UNCOMPRESSED_FLAG1
SAP_TABLE_NAME,SAP_FIELD_NAME2,BIGQUERY_DATA_TYPE,BIGQUERY_FIELD_NAME2,BIGQUERY_FIELD_DESCRIPTION2, SEND_UNCOMPRESSED_FLAG2
SAP_TABLE_NAME,SAP_FIELD_NAME3,BIGQUERY_DATA_TYPE,BIGQUERY_FIELD_NAME3,BIGQUERY_FIELD_DESCRIPTION3, SEND_UNCOMPRESSED_FLAG3

Importer le fichier CSV

Pour importer un fichier CSV modifié, procédez comme suit:

1. Dans l'interface utilisateur graphique de SAP, exécutez le code de transaction /GOOG/SDK_IMG.

   Vous pouvez également exécuter le code de transaction SPRO, puis cliquer sur SAP Reference IMG (IMG de référence SAP).

2. Cliquez sur SDK ABAP pour Google Cloud > Paramètres de base > Transfert de données BigQuery: maintenance des paramètres.

3. Dans l'écran BigQuery Data Transfer: Maintenance des paramètres, spécifiez les valeurs suivantes:

   • Dans le champ Paramètres de la table, spécifiez Champs.
   • Dans le champ Clé de transfert de masse, spécifiez l'ID du transfert de masse que vous mettez à jour.
   • Cochez la case Importer depuis un fichier.

4. Cliquez sur l'icône Exécuter. La boîte de dialogue Sélectionner un fichier à importer s'ouvre.

5. Dans la boîte de dialogue Sélectionner un fichier à importer, sélectionnez le fichier CSV contenant les valeurs de champ modifiées.

6. Cliquez sur Ouvrir.

7. Si vous recevez un avertissement de sécurité, cliquez sur Autoriser. Le fichier se charge et les valeurs modifiées apparaissent dans les lignes correspondantes de l'écran Maintenance des paramètres BigQuery – Champs.

8. Cliquez sur l'icône Enregistrer.

9. Pour confirmer que les valeurs sont appliquées, comparez les valeurs du fichier CSV avec les valeurs affichées dans votre système SAP.

Gérer les erreurs dans les données sources

Lorsque l'API de streaming BigQuery reçoit un fragment d'enregistrements de BigQuery Toolkit pour SAP, elle recherche les erreurs de données avant d'insérer des enregistrements dans la table BigQuery.

Pour contrôler la manière dont l'API BigQuery et BigQuery Toolkit pour SAP réagissent lorsque des erreurs de données sont détectées, spécifiez les options suivantes dans les paramètres de transfert de masse:

• L'option Skip Invalid Records (SKIP)
• L'option Break at First Error Flag (BREAK)

L'option SKIP

Si l'option SKIP est spécifiée, lorsque l'API BigQuery reçoit un fragment d'enregistrements et trouve un enregistrement avec une erreur de données, elle supprime ou ignore l'enregistrement contenant l'erreur et continue d'insérer tous les autres enregistrements du fragment dans la table BigQuery.

Si vous ne spécifiez pas l'option SKIP lorsque BigQuery trouve un enregistrement avec une erreur de données, l'intégralité du fragment est supprimée sans insérer d'enregistrements de cette table dans la table BigQuery. Il s'agit du comportement par défaut.

L'option SKIP est préférable pour les environnements de développement et de contrôle qualité, mais elle n'est pas recommandée pour les environnements de production.

Vous pouvez spécifier l'option SKIP dans la transaction /GOOG/BQTR_SETTINGS lorsque vous configurez la réplication. Les spécifications sont stockées dans la table de configuration /GOOG/BQTR_MASTR.

Pour savoir comment les spécifications SKIP interagissent avec les spécifications BREAK, consultez la page Table de matrice pour les interactions SKIP et BREAK.

L'option BREAK

Si vous spécifiez l'option BREAK, lorsque BigQuery Toolkit pour SAP est informé par l'API BigQuery qu'une erreur de données a été détectée dans un enregistrement, BigQuery Toolkit pour SAP cesse d'envoyer des enregistrements à BigQuery et met fin à la tâche de réplication. Il s'agit du comportement par défaut.

Si vous ne spécifiez pas l'option BREAK, lorsque BigQuery Toolkit pour SAP est informé par BigQuery qu'une erreur de données a été détectée dans un enregistrement, BigQuery Toolkit pour SAP continue d'envoyer des enregistrements à BigQuery en passant au fragment suivant afin de ne pas interrompre la tâche de réplication.

Il est recommandé de spécifier l'option BREAK dans les environnements de production.

Vous pouvez spécifier l'option BREAK dans la transaction /GOOG/BQTR_SETTINGS lorsque vous configurez la réplication. Lorsque vous créez une clé de transfert de masse, l'indicateur BREAK est activé par défaut.

La spécification est stockée dans la table de configuration /GOOG/BQTR_MASTR.

Pour savoir comment les spécifications BREAK interagissent avec les spécifications SKIP, consultez la page Table de matrice pour les interactions SKIP et BREAK.

Table de matrice pour les interactions SKIP et BREAK

Vous pouvez configurer le module de transfert de données BigQuery afin de gérer les erreurs de données de différentes manières:

Option SKIP	Option BREAK	Comportement
FAUX	TRUE	BigQuery supprime le fragment actuel sans insérer le moindre enregistrement dans la table BigQuery. BigQuery Toolkit pour SAP n'envoie plus aucun fragment de la partie actuelle et met fin à la tâche de réplication. Il s'agit du paramètre par défaut, qui est également le plus recommandé.
FAUX	FAUX	BigQuery supprime le fragment actuel sans insérer le moindre enregistrement dans la table BigQuery. BigQuery Toolkit pour SAP envoie tous les fragments restants de la partie actuelle et récupère la partie suivante. BigQuery Toolkit pour SAP n'interrompt pas la tâche de réplication.
TRUE	TRUE	BigQuery ne supprime que l'enregistrement contenant l'erreur et insère les autres enregistrements du fragment actuel dans la table BigQuery. BigQuery Toolkit pour SAP n'envoie plus aucun fragment de la partie actuelle et met fin à la tâche de réplication.
TRUE	FAUX	BigQuery ne supprime que l'enregistrement contenant l'erreur et insère les autres enregistrements du fragment actuel dans la table BigQuery. BigQuery Toolkit pour SAP envoie tous les fragments restants de la partie actuelle et récupère la partie suivante. BigQuery Toolkit pour SAP n'interrompt pas la tâche de réplication.

Modifications apportées à la structure des objets de dictionnaire SAP

Cette section explique comment gérer les modifications apportées à la définition de vos objets de dictionnaire dans SAP.

Ajouter une colonne à un objet de dictionnaire

Si vous ajoutez une colonne à un objet dictionnaire, procédez comme suit:

1. Arrêtez votre application de réplication de données personnalisée qui utilise la classe de chargement de données /GOOG/CL_BQTR_DATA_LOAD.
2. Ajoutez une colonne à l'objet du dictionnaire dans SAP.
3. Vous pouvez éventuellement mettre à jour le mappage au niveau des champs dans la transaction /GOOG/BQTR_SETTINGS.
4. Redémarrez votre application de réplication de données personnalisée.
5. Validez le résultat de la réplication dans BigQuery.

Supprimer une colonne de l'objet dictionnaire

Pour supprimer une colonne existante d'un objet dictionnaire, procédez comme suit:

1. Arrêtez votre application de réplication de données personnalisée qui utilise la classe de chargement de données /GOOG/CL_BQTR_DATA_LOAD.
2. Supprimez une colonne de l'objet dictionnaire.
3. Dans BigQuery, supprimez la colonne de la table BigQuery cible. Pour en savoir plus sur la procédure à suivre pour supprimer une colonne d'une table existante, consultez la documentation BigQuery.
4. Vous pouvez éventuellement mettre à jour le mappage au niveau des champs dans la transaction /GOOG/BQTR_SETTINGS.
5. Redémarrez votre application de réplication de données personnalisée.
6. Validez le résultat de la réplication dans BigQuery.

Modifier le type de données d'une colonne existante

Lorsque vous modifiez le type de données d'une colonne existante dans l'objet de dictionnaire SAP, vous devez suivre des étapes spécifiques selon s'il s'agit d'un type de données compatible ou non avec la table BigQuery cible.

Un type de données est compatible avec le type de données de la table BigQuery cible lorsque le type de données existant et le nouveau type de données d'une colonne existante correspondent au même type de données dans la table BigQuery cible. Par exemple, si le type de données d'une colonne passe de INT1 à INT2 dans une table source, les deux types de données sont compatibles avec le type de données INTEGER dans la table BigQuery cible.

Pour en savoir plus sur le mappage des types de données dans le module de transfert de données BigQuery, consultez la section Mappage des types de données.

Modifier le type de données pour le remplacer par un type de données compatible

Pour remplacer le type de données d'une colonne existante par un type de données compatible, procédez comme suit:

1. Vous pouvez également arrêter votre application de réplication de données personnalisée qui utilise la classe de chargement de données /GOOG/CL_BQTR_DATA_LOAD.
2. Remplacez le type de données par un type compatible dans le système source.
3. Vous pouvez éventuellement mettre à jour le mappage au niveau des champs dans la transaction /GOOG/BQTR_SETTINGS.
4. Si vous avez arrêté l'application de réplication de données personnalisée, redémarrez-la.
5. Validez le résultat de la réplication dans BigQuery.

Modifier le type de données pour le remplacer par un type de données non compatible

Pour remplacer le type de données d'une colonne existante par un type de données non compatible, procédez comme suit:

1. Arrêtez votre application de réplication de données personnalisée qui utilise la classe de chargement de données /GOOG/CL_BQTR_DATA_LOAD.
2. Dans BigQuery, supprimez la table cible.
3. Modifiez le type de données dans le système source.
4. Vous pouvez éventuellement mettre à jour le mappage au niveau des champs dans la transaction /GOOG/BQTR_SETTINGS.
5. Lancez votre application de réplication de données personnalisée. Si nécessaire, vous devrez peut-être lancer un chargement initial des données existantes.

Sorties optimisées

Le BigQuery Toolkit pour SAP fournit plusieurs points d'amélioration dans son code afin de permettre aux développeurs ABAP d'insérer du code pour ajouter des fonctionnalités personnalisées.

Important :Vous êtes responsable de tout code personnalisé écrit lors de l'implémentation de ces points d'amélioration. Nous vous recommandons vivement de tester votre code personnalisé dans un environnement hors production avant de le déployer en production. Google Cloud n'est pas compatible avec les fonctionnalités personnalisées.

Classes

Le tableau suivant répertorie les fonctions compatibles avec les points d'amélioration, les méthodes et la classe contenant ce point d'amélioration.

Fonction	Classe	Méthode	Spot	Option
Mettre à jour le mappage pour un champ (nom de champ externe et type de données, par exemple)	/GOOG/CL_BQTR_DATA_LOAD_BASE	CREATE_FLD_MAPPINGS	/GOOG/ES_BQTR_DATA_LOAD_BASE	/GOOG/UPDATE_FIELD_MAPPING
Mettre à jour le mappage de la table de champs en ajoutant ou en supprimant des champs.	/GOOG/CL_BQTR_DATA_LOAD_BASE	CREATE_FLD_MAPPINGS	/GOOG/ES_BQTR_DATA_LOAD_BASE	/GOOG/UPDATE_FIELD_MAPPINGS
Modifier la valeur d'un champ source avant qu'il ne soit converti en champ cible.	/GOOG/CL_BQTR_DATA_LOAD	FILL_TARGET_RECORDS	/GOOG/ES_BQTR_DATA_LOAD	/GOOG/CHANGE_SOURCE_FIELD
Après avoir converti un champ source en champ cible dans la table cible, modifier la valeur du champ cible.	/GOOG/CL_BQTR_DATA_LOAD	FILL_TARGET_RECORDS	/GOOG/ES_BQTR_DATA_LOAD	/GOOG/FILL_TARGET_FIELD
Ajouter un champ à la table cible qui n'existe pas dans la table source, au moment de la conversion de la table source vers la table cible.	/GOOG/CL_BQTR_DATA_LOAD	FILL_TARGET_RECORDS	/GOOG/ES_BQTR_DATA_LOAD	/GOOG/FILL_EXTRA_FIELD
Préparer un champ de schéma BigQuery avant la création de la table BigQuery.	/GOOG/CL_BQTR_CLIENT_BQ_BASE	PREP_BQ_TABLE_SCHEMA	/GOOG/ES_BQTR_CLIENT_BQ	/GOOG/PREPARE_SCHEMA_FIELD
En cas d'erreurs HTTP provenant du côté serveur BigQuery, vous pouvez collecter les données de journalisation après les appels HTTP à l'API BigQuery pour résoudre le problème.	/GOOG/CL_BQTR_CLIENT_BQ_REPL	INSERT_TABLEDATA	/GOOG/ES_BQTR_CLIENT_BQ_REPL	/GOOG/LOG_INSERT_ERROR

Rapports

Le tableau suivant répertorie les fonctions compatibles avec les points d'amélioration, les méthodes et les rapports qui contiennent ce point d'amélioration.

Fonction	Rapport	Méthode	Spot	Option
Pour ajouter des vérifications d'autorisation au programme de paramètres du service de transfert de données BigQuery.	/GOOG/R_BQTR_SETTINGS	AUTHORITY_CHECK	/GOOG/ES_BQTR_SETTINGS	/GOOG/AUTHORITY_CHECK

Paramètres avancés

Vous pouvez également modifier les paramètres avancés de BigQuery Toolkit pour SAP. Nous vous recommandons de modifier les paramètres avancés uniquement après avoir effectué une analyse complète et mesuré l'impact des nouvelles valeurs sur les performances. Vous êtes responsable de vous assurer que les nouveaux paramètres avancés de BigQuery Toolkit pour SAP ne provoquent pas d'échecs ni de problèmes de performances.

Avertissement :Ne modifiez pas les paramètres avancés de BigQuery Toolkit pour SAP lorsqu'un chargement initial est en cours.

Les paramètres avancés de BigQuery Toolkit pour SAP sont appliqués au niveau du système et sont communs à toutes les clés de transfert de masse. Si les paramètres avancés ne sont pas modifiés, BigQuery Toolkit pour SAP fonctionne avec les paramètres par défaut.

Pour modifier les paramètres avancés, procédez comme suit:

1. Dans l'interface utilisateur graphique de SAP, exécutez le code de transaction /GOOG/SDK_IMG.

   Vous pouvez également exécuter le code de transaction SPRO, puis cliquer sur SAP Reference IMG (IMG de référence SAP).

2. Cliquez sur SDK ABAP pour Google Cloud > Paramètres de base > Transfert de données BigQuery: maintenance des paramètres.

3. Dans le menu déroulant Tableau des paramètres, sélectionnez Paramètres.

4. Cliquez sur l'icône Exécuter. L'écran Maintenance des paramètres de transfert de données BigQuery – Paramètres s'affiche.

5. Cliquez sur l'icône Insérer une ligne.

6. Sur la ligne affichée, spécifiez les paramètres suivants :

   1. Dans le champ Nom du paramètre, saisissez le nom du paramètre. La description du paramètre est renseignée automatiquement.

   2. Dans le champ Valeur du paramètre, saisissez une valeur.

      Pour en savoir plus sur les paramètres avancés, consultez la section Paramètres avancés.

7. Cliquez sur Enregistrer.

   Vos paramètres avancés sont stockés sous forme d'enregistrement dans la table de configuration /GOOG/BQ_PARAM et les champs Modifié par, Modifié le et Modifié à sont automatiquement renseignés.

Paramètres avancés

Le tableau suivant présente les paramètres avancés du BigQuery Toolkit pour SAP.

Nom du paramètre	Description	Valeur par défaut	Valeur valide
CHUNK_SIZE_DEF	Ce paramètre correspond à la taille de fragment par défaut acceptée par BigQuery Toolkit pour SAP. Si aucune taille de fragment n'est définie dans les paramètres, c'est la taille de fragment par défaut qui est utilisée.	10 000	La valeur doit respecter les limites de quota BigQuery.
PERC_REDUC_DEF	La réduction de la taille de fragment, exprimée en pourcentage. Si la taille des fragments dynamiques est activée, leur taille est réduite de ce pourcentage jusqu'à ce qu'une taille idéale soit atteinte et que les données contenues dans les fragments soient transférées vers BigQuery.	50	La valeur doit être comprise entre 1 et 99.

Obtenir de l'aide

Google Cloud propose une assistance pour les problèmes et les questions liés à l'installation, à la configuration, à l'exploitation et à la maintenance du kit d'outils BigQuery pour SAP. Toutefois, l'assistance est limitée à la boîte à outils elle-même.

Google Cloud n'est pas compatible avec d'autres composants de l'environnement, tels que l'infrastructure réseau, les bases de données, les systèmes d'exploitation ou les logiciels tiers. Pour les problèmes liés à d'autres composants de l'environnement que le kit d'outils BigQuery pour SAP, contactez le fournisseur ou le prestataire d'assistance approprié.

Pour les fonctionnalités fournies par SAP, telles que le provisionnement de données opérationnelles (ODP) et SAP Landscape Transformation (SLT), contactez l'assistance SAP pour obtenir de l'aide.

Pour résoudre les problèmes liés au BigQuery Toolkit pour SAP, consultez Résoudre les problèmes liés au BigQuery Toolkit pour SAP.

Procédez comme suit si vous avez besoin d'aide pour résoudre les problèmes liés au SDK ABAP pour Google Cloud :

• Consultez le guide de dépannage du SDK ABAP pour Google Cloud.

• Posez vos questions concernant le SDK ABAP pour Google Cloud et discutez de celui-ci avec la communauté sur les forums Cloud.

• Recueillez toutes les informations de diagnostic disponibles et contactez Cloud Customer Care. Pour savoir comment contacter le service client, consultez la page Obtenir de l'aide pour SAP sur Google Cloud.