Utilisation de Openflow Connector for Veeva Vault¶

Note

Ce connecteur est soumis aux conditions d’utilisation de Snowflake Connector.

Ce chapitre décrit les tâches types que vous devrez peut-être effectuer après l’installation et la configuration de Openflow Connector for Veeva Vault.

Forcer un rechargement complet¶

Le connecteur conserve un état interne pour suivre les fichiers Direct Data qui ont déjà été traités. Dans certaines situations, vous pouvez avoir besoin de forcer le connecteur à effectuer un nouvel instantané complet, par exemple après avoir résolu un problème lié aux données ou après que le connecteur a été arrêté pendant une longue période.

Pour forcer un rechargement complet :

Arrêtez tous les processeurs du flux en faisant un clic droit sur le groupe de processus du connecteur et en sélectionnant Stop.
Assurez-vous qu’aucun FlowFiles actif est en cours de traitement. Vous pouvez le faire en vérifiant que toutes les files d’attente du flux sont vides.
Faites un clic droit sur le canevas et sélectionnez. Disable all controller services.
Rendez-vous dans Controller services et localisez le service du contrôleur nommé Veeva Vault Client Service.
Dans le processeur List Veeva Vault Files, sélectionnez View state, puis sélectionnez Clear state.
Faites un clic droit sur le canevas et sélectionnez Enable all controller services, puis démarrez tous les processeurs pour relancer le connecteur.

Le connecteur considère un état réinitialisé comme un nouveau départ et traite le dernier fichier Direct Data complet lors de l’exécution suivante.

Surveillance¶

Pour suivre la quantité de données synchronisées de Veeva Vault vers Snowflake, interrogez le tableau des événements. L’exemple de requête suivant récupère les journaux pertinents des 30 dernières minutes :

SELECT
  timestamp,
  Deployment_ID,
  Runtime_Key,
  parsed_log:level as log_level,
  parsed_log:loggerName as logger,
  parsed_log:formattedMessage as message,
  parsed_log
FROM (
  SELECT
    timestamp,
    resource_attributes:"openflow.dataplane.id" as Deployment_ID,
    resource_attributes:"k8s.namespace.name" as Runtime_Key,
    TRY_PARSE_JSON(value) as parsed_log
  FROM OPENFLOW.TELEMETRY.EVENTS
  WHERE true
    AND timestamp > dateadd('minutes', -30, sysdate())
    AND record_type = 'LOG'
    AND resource_attributes:"k8s.namespace.name" like 'runtime-%'
  ORDER BY timestamp DESC
)
WHERE true
  AND logger LIKE '%veeva%';

Pour plus d’informations sur la surveillance des flux Openflow, consultez Surveiller Openflow à l’aide de données de télémétrie.

Résolution des problèmes¶

Utilisez les informations suivantes pour résoudre les problèmes courants liés au connecteur.

Direct Data n’est pas activé¶

Si le connecteur échoue avec une erreur indiquant que les fichiers Direct Data ne peuvent pas être récupérés, vérifiez que Direct Data est activé sur votre Vault. Contactez votre administrateur Veeva Vault pour activer cette fonctionnalité dans les paramètres d’administration de Vault.

Échecs d’authentification¶

Si le connecteur signale des échecs d’authentification :

Vérifiez que les paramètres Veeva Vault Username et Veeva Vault Password sont corrects.
Vérifiez que le compte de service dispose de l’accès API activé et dispose des autorisations requises.
Vérifiez si le compte est verrouillé ou désactivé dans Veeva Vault.

Vous pouvez vérifier les identifiants de connexion en cliquant avec le bouton droit de la souris sur le canevas, en sélectionnant Controller services, en localisant le Veeva Vault Client Service, puis en sélectionnant Verify Properties. Cela déclenche un contrôle de connexion et d’authentification par rapport au Vault configuré.

Expiration de la session lors d’opérations longues¶

Le connecteur gère automatiquement l’expiration de la session en s’authentifiant de nouveau lorsqu’il reçoit une erreur INVALID_SESSION_ID de l’API Vault. Aucune intervention manuelle n’est nécessaire. Si vous voyez des messages d’expiration de session répétés dans le tableau des événements, vérifiez qu’aucun autre processus n’utilise les mêmes identifiants de connexion de compte de service, car des sessions simultanées peuvent entraîner l’invalidation de la session précédente.

Aucune nouvelle donnée n’apparaît dans Snowflake¶

Si le connecteur fonctionne, mais qu’aucune nouvelle donnée n’apparaît dans Snowflake :

Vérifiez que de nouveaux fichiers Direct Data sont publiés par Veeva Vault. Le connecteur ne peut traiter que les archives qui existent.
Vérifiez que le Veeva Vault Ingestion Mode est correctement défini. S’il est défini sur INCREMENTAL et qu’aucune archive incrémentielle n’existe après l’heure de début configurée, aucune donnée n’est traitée.
Vérifiez le tableau des événements pour trouver les messages d’erreur qui peuvent indiquer des échecs dans les zones de préparation de téléchargement, de décompression ou de chargement.

Erreurs d’autorisation Snowflake¶

Si le connecteur signale des erreurs d’autorisation lors de la création de tables ou du chargement de données :

Vérifiez que le rôle Snowflake configuré dans le connecteur dispose de USAGE sur la base de données et le schéma de destination, de CREATE TABLE sur le schéma, ainsi que de USAGE et OPERATE sur l’entrepôt.
Pour Openflow - BYOC Deployments, vérifiez que l’utilisateur du service dispose du bon rôle attribué et que la clé publique RSA est correctement configurée.