Charger tout – Guide de référence des erreurs
Lors d’une opération Charger tout pour une extraction, différentes erreurs peuvent survenir selon le système source, la configuration de la connexion ou les données traitées. Ce guide présente les erreurs les plus courantes, leurs causes et la manière de les résoudre.
Cause: DataSync n’a pas pu s’authentifier ou accéder à l’API source.
Solution: Vérifier les paramètres de connexion et les identifiants (clé/token API, utilisateur, permissions).
Cause: L’API source n’a pas pu traiter la requête.
Solution: Vérifier la configuration de la connexion source et les paramètres de la requête.
Cause: Les performances de l’API sont dégradées ou la requête a expiré lors d’un chargement volumineux.
Solution: Relancer le chargement ou réduire son volume à l’aide de filtres ou de plages de dates plus petites.
Cause: Le service est temporairement indisponible.
Solution: Consulter la Status page (uniquement disponible en anglais) et réessayer.
Cause: La connexion SQL Server a échoué pendant la phase de pré‑authentification (problème TLS/certificat ou interruption du service).
Solution: Vérifier l’accessibilité du SQL Server ainsi que les paramètres TLS/certificats. Pour les déploiements Cloud, consulter la Status page (uniquement disponible en anglais).
Cause: Une erreur interne de traitement est survenue dans DataSync.
Solution: Contacter le support Nectari.
Cause: Une interruption temporaire du SQL Server ou du réseau est survenue.
Solution: Vérifier la disponibilité et la connectivité du SQL Server. Pour les déploiements Cloud, consulter la Status page (uniquement disponible en anglais).
Cause: « Des clés dupliquées ont été détectées ont été détectées en raison d’un problème lié à un index ou à une clé unique.
Solution: Examiner la configuration de l’index ou de la clé unique de la table et s’assurer que la clé est réellement unique.
Cause: Une valeur dépasse la précision ou l’échelle du champ numérique de destination.
Solution: Augmenter la précision/l’échelle numérique ou ajuster le mappage.
Cause: La tâche a été interrompue avant d’être complétée.
Solution: Consulter les journaux et relancer la tâche.
Cause: Certaines partitions manquaient au moment d’exécuter le processus de nettoyage.
Solution: Charger les partitions manquantes, puis relancer le processus.
Cause: Le traitement des enregistrements supprimés a échoué pour une partition donnée.
Solution: Relancer le processus pour la partition affectée.
Cause: La base de données est hors ligne ou inaccessible.
Solution: Vérifier que la base de données est en ligne et que la connexion est valide. Pour les déploiements Cloud, consulter la Status page (uniquement disponible en anglais) et contacter le support Nectari.
Cause: Un interblocage s’est produit en raison de processus concurrents, comme une autre extraction, une activité OLAP ou des verrous sur les tables.
Solution: Relancer l’opération une fois le processus bloquant terminé.
Cause: Le script SQL post‑exécution est invalide et ne peut pas être validé, ce qui provoque l’échec de la tâche en fin d’exécution.
Solution: Examiner et corriger le SQL du script post‑exécution.
Cause: La valeur du filtre n’est pas du type attendu. Par exemple, SXA peut renvoyer des valeurs comme « (données non valides) 0.0000,50.6400 ».
Solution: Séparer la valeur afin qu’elle puisse être interprétée comme un décimal valide.
Cause: La valeur docparid requise est absente de la configuration de la connexion.
Solution: Vérifier que docparid est bien défini dans la connexion. Suivre les étapes décrites dans Configurer les connexions.
Cause: L’entrepôt de données a atteint sa limite d’espace allouée.
Solution: Contacter votre représentant commercial Nectari.
Cause: Un problème de configuration Cloud empêche de localiser l’entrée client associée au numéro de série.
Solution: Contacter votre administrateur ou le support Nectari.
Cause: Un problème technique est survenu lors du traitement.
Solution: Contacter le support Nectari.
Cause: SQL Server a retourné une erreur car le nom de table ou le schéma est invalide ou inexistant.
Solution: Vérifier que les noms de table et de schéma sont corrects dans la source ou la requête.
Cause: Une partition a rencontré une erreur durant le processus de chargement par partition.
Solution: Examiner la partition en échec afin d’identifier et de corriger la cause sous‑jacente.
Cause: Les informations d’identification de l’entrepôt de données sont invalides ou l’utilisateur ne dispose pas des autorisations requises.
Solution: Si le problème est lié aux autorisations, contacter le support Nectari.
Cause: La tâche a été annulée manuellement avant son achèvement.
Solution: Relancer la tâche si l’annulation n’était pas intentionnelle.
Cause: Un volume de données trop important est traité par rapport à la mémoire disponible.
Solution: Pour les déploiements Cloud, contacter le support Nectari.
Cause: La valeur est trop volumineuse pour la colonne de destination, ou une donnée binaire est insérée dans une colonne de type texte.
Solution: Augmenter la taille de la colonne de destination ou corriger le type de données à la source.
Cause: Un index unique ne peut pas être créé en raison de valeurs en double, ce qui indique un problème d’intégrité des données.
Solution: Contacter le support Nectari.
Cause: La connexion n’est pas valide ou ne peut pas être vérifiée.
Solution: Vérifier que tous les paramètres de la connexion source (nom d’utilisateur, mot de passe, nom du serveur, URL, etc.) sont correctement configurés.
Cause: L’opération a été annulée avant son achèvement.
Solution: Relancer l’opération une fois la cause de l’annulation résolue.
Cause: La période d’extraction est invalide. Ce message est retourné par Sage Intacct.
Solution: Vérifier les paramètres de période et s’assurer qu’ils correspondent à des périodes valides dans Sage Intacct.
Cause: L’entrepôt de données n’est pas disponible dans les environnements Cloud.
Solution: Contacter le support Nectari.
Cause: Les services Sage Intacct sont indisponibles ou connaissent une interruption.
Solution: Attendre le rétablissement des services Sage Intacct, puis réessayer l’opération.
Cause: Trop d’extractions utilisent la même connexion, ce qui épuise le pool de connexions.
Solution: Augmenter la propriété Max Pool Size dans les paramètres de connexion.
Cause: Certaines API appliquent des délais d’expiration stricts lorsque le temps de traitement dépasse les attentes. Par exemple, la passerelle de Sage Intacct expire après 15 minutes.
Solution: Si l’API source subit une dégradation de performance, ouvrir un billet de support auprès de Sage Intacct.
Cause: L’instance SQL Server est indisponible ou subit une interruption.
Solution: Confirmer que l’instance SQL Server est en ligne. Pour les déploiements Cloud, consulter la Status page (uniquement disponible en anglais).
Cause: La transaction a été désignée comme victime d’un interblocage en raison de processus concurrents (par exemple, une autre extraction, l’activité d’un cube OLAP ou des verrous de table).
Solution: Relancer la transaction.
Cause: L’utilisateur DataSync dans Sage Intacct ne dispose pas des autorisations nécessaires pour lire l’objet spécifié.
Solution: Mettre à jour les autorisations de l’utilisateur dans Sage Intacct.