Le flux peut générer des erreurs lors de l'exécution.
- Certaines erreurs, telles qu'un mot de passe incorrect dans la base de données source, peuvent être récupérées, ce qui signifie qu'elles peuvent être corrigées et que le flux reprend automatiquement.
- Les erreurs peuvent avoir un impact sur un seul objet, comme un événement contenant des types de données non compatibles. D'autres erreurs peuvent avoir un impact sur plusieurs objets ou sur l'ensemble du flux, par exemple lorsque Datastream ne parvient pas à se connecter à la base de données source.
- Selon l'erreur, des informations sont fournies sur les pages Flux ou Détails du flux de l'UI Datastream. Vous pouvez également utiliser les API de Datastream pour récupérer des informations sur l'erreur.
Pour résoudre un problème, accédez au flux pour afficher l'erreur, puis suivez la procédure décrite dans le message d'erreur.
Cette page contient des informations sur les erreurs de configuration, de connectivité, Oracle et MySQL, ainsi que la procédure à suivre pour les résoudre.
Erreurs de configuration et de connectivité
| Erreur | Procédure de dépannage |
|---|---|
| Échec de la connexion à la base de données source (générique). | Cette situation peut se produire pour diverses raisons. Pour résoudre ce problème :
Le flux reprend automatiquement. |
| Échec de la connexion à la base de données source (liste d'adresses IP autorisées). | Cela peut se produire si la méthode de connectivité choisie est Liste d'autorisation d'adresses IP, mais qu'une ou plusieurs adresses IP sortantes de Datastream n'ont pas été correctement ajoutées à la base de données source. Assurez-vous que les adresses IP sortantes affichées dans le profil de connexion Datastream sont configurées sur le pare-feu réseau afin que le serveur de base de données source puisse accepter les connexions provenant de ces adresses IP. Une fois le problème résolu, le flux reprend automatiquement. |
| Échec de la connexion à la base de données source (tunnel SSH de transfert). | Cela peut se produire en cas de problème avec le tunnel SSH de transfert. Vérifiez l'état du tunnel. Si le tunnel est arrêté, il doit être démarré. Une fois le problème résolu, le flux reprend automatiquement. |
| Datastream ne peut pas se connecter à un hôte bastion via un tunnel SSH de transfert. | Vérifiez que la configuration du tunnel SSH de transfert est correcte dans le profil de connexion source et que le port est ouvert sur le serveur du tunnel SSH. |
| Échec de la connexion à la base de données source en raison de certificats incorrects. | Cela peut se produire en cas de problème avec les certificats fournis lors de la définition du profil de connexion source. Accédez à la page Profils de connexion, puis sélectionnez le profil de connexion concerné. Vérifiez que les certificats sont correctement configurés. Une fois les modifications apportées, enregistrez le profil de connexion. Le flux reprend automatiquement. |
| Échec de la connexion à la base de données source à l'aide de la connectivité privée. | Cette erreur concerne la méthode de connectivité privée "Appairage de VPC".
|
| Échec de la connexion à la base de données source à l'aide de l'interface Private Service Connect. |
|
| Le type de connectivité STATIC_SERVICE_IP_CONNECTIVITY n'est pas autorisé lorsque la règle d'administration constraints/datastream.disablePublicConnectivity est activée. | Vous avez sélectionné les méthodes de connectivité réseau de la liste d'autorisation d'adresses IP publiques ou du tunnel SSH de transfert pour le profil de connexion que vous créez. Toutefois, la règle d'administration Bloquer les méthodes de connectivité publique pour Datastream est activée. Vous ne pouvez donc pas sélectionner de méthodes de connectivité publiques pour votre profil de connexion. Pour résoudre ce problème, sélectionnez la méthode de connectivité réseau privée Appairage de VPC ou Interfaces Private Service Connect, ou désactivez la règle d'administration. Pour désactiver la règle d'administration, procédez comme suit :
|
| Lorsque je configure la base de données source pour mon flux, je ne trouve pas les tables et les schémas que je souhaite transférer dans la liste des objets à inclure. | Cela peut se produire si votre base de données comporte des milliers de tables et de schémas. Il est possible que certains d'entre eux ne soient pas inclus dans la liste des objets à extraire lorsque vous configurez la source pour le flux dans la console Google Cloud . Au lieu de sélectionner Schémas et tables spécifiques dans la section Sélectionner des objets à inclure, sélectionnez Personnalisé. Dans le champ Critères de correspondance des objets, saisissez les schémas et les tables que vous souhaitez extraire avec Datastream. |
| J'ai ajouté plusieurs tables à mon flux à l'aide du menu Objets à inclure. Toutefois, lorsque je consulte l'onglet Objets dans Détails du flux, je constate que certaines tables sont manquantes. | Assurez-vous qu'il y a au moins une mise à jour CDC pour chacune de ces tables afin que Datastream puisse reconnaître les modifications et inclure automatiquement les tables dans le flux. |
| Échec du chargement de la liste des objets lorsque vous utilisez le menu Objets à inclure dans la console Google Cloud . | Cela peut se produire si votre base de données comporte plus de 5 000 schémas et tables. Utilisez une autre méthode pour spécifier les objets à inclure ou utilisez l'API Datastream. Pour en savoir plus, consultez Configurer des bases de données sources. |
| Événements supprimés lors du streaming et non répliqués dans la destination. | Datastream peut supprimer les événements non compatibles lors de la diffusion. Pour résoudre le problème, vous pouvez effectuer les actions suivantes :
|
| Le délai de connexion à la source de données a expiré. Vérifiez que le nom d'hôte et la configuration du port sont corrects, et que la source de données est accessible. | Étant donné que le réseau Datastream ne peut pas être appairé directement avec un réseau de services privés (par exemple, une instance Cloud SQL) lorsque vous utilisez l'appairage de VPC, vous devez utiliser une VM de traduction d'adresse réseau (NAT) pour établir la connectivité entre Datastream et votre ressource. Pour savoir comment configurer une VM NAT, consultez Configurer l'appairage de réseaux VPC. |
| Le schéma de l'objet OBJECT_NAME est trop volumineux pour que Datastream puisse le traiter. | Datastream ne permet pas de répliquer les événements dont les schémas sources correspondants dépassent 2 621 440 caractères Unicode. Ces événements sont supprimés avec le code de motif suivant : UNSUPPORTED_LARGE_SCHEMA. Vous pouvez exclure certaines colonnes ou les renommer. Vous pouvez également exclure l'objet avec le schéma volumineux. |
| L'état du flux a changé. | Plusieurs raisons peuvent expliquer cette erreur, mais un problème sous-jacent courant est une configuration de source non valide. Si votre flux ne démarre pas et que ce message d'erreur s'affiche, vérifiez la configuration de votre source pour détecter les clés ou les noms de tables en double, les incohérences de données ou les conflits de schéma. Vous pouvez résoudre la plupart des problèmes en modifiant les paramètres du flux ayant échoué directement dans la console Google Cloud et en ajustant les entrées pour les objets inclus et exclus. Pour en savoir plus, consultez Modifier les informations de configuration concernant la base de données source. |
Erreurs Oracle
| Erreur | Procédure de dépannage |
|---|---|
| La journalisation supplémentaire est mal configurée dans la base de données source. | Une erreur de récupération des données de capture des données modifiées (CDC) en cours peut se produire si la configuration de la journalisation supplémentaire n'est pas correcte dans la base de données source. Vérifiez que la journalisation supplémentaire est correctement configurée. Plus précisément, vérifiez que la journalisation supplémentaire est activée pour les tables de base de données qui sont insérées par flux depuis la source vers la destination. Le flux reprend automatiquement. |
| Impossible de reprendre la réplication, car la position du journal est perdue. | Cette erreur peut se produire lorsque le processus de réplication est suspendu pendant une longue période, ce qui entraîne la perte de la position dans le journal. Les flux ne doivent pas être mis en pause pendant des périodes proches de la durée de conservation des journaux. Recréez le flux. |
| Les fichiers journaux sont partiellement ou entièrement manquants. | Il est possible que les fichiers journaux aient été supprimés. Oracle supprime les fichiers journaux dès que possible, sauf si vous spécifiez une période de rotation minimale pour les conserver.
Sur le serveur Oracle, définissez la durée de conservation des fichiers journaux. Par exemple, utilisez
Pour un déploiement RDS, utilisez |
| La liste d'exclusion est basée sur la liste d'inclusion. | La liste d'inclusion est entièrement contenue dans la liste d'exclusion. Par conséquent, la liste des objets que Datastream extrait de la source est vide. Modifiez la sélection d'objets, puis réessayez. |
| Le mode de journalisation pour la base de données Oracle n'est pas défini sur ARCHIVELOG. | Modifiez le mode de journalisation, puis réessayez. |
Datastream renvoie un message d'erreur ORA-00942: table or view does not exist, mais tout est correctement configuré. |
Cela peut être dû à la mise en cache sur le serveur Oracle. Recréer l'utilisateur de la base de données devrait résoudre le problème de mise en cache. |
| Les modifications apportées à une source Oracle ne sont pas répercutées dans la destination lorsque le flux est déjà en cours d'exécution. | Si vous utilisez LogMiner comme méthode de CDC, Datastream lit les fichiers journaux de rétablissement archivés. Dans ce cas, les modifications que vous apportez à la source ne sont pas répercutées dans la destination tant que le journal n'est pas archivé. Pour afficher les modifications dans la destination, définissez la méthode CDC sur "Lecteur de journaux binaires", modifiez la règle d'archivage des journaux ou forcez manuellement un changement de journal. Pour en savoir plus, consultez Utiliser les fichiers journaux de rétablissement de base de données Oracle. |
| Échec de la validation de la configuration Oracle CDC. | Vous avez sélectionné une méthode CDC pour laquelle votre base de données source n'a pas été configurée. Sélectionnez une autre méthode ou terminez la configuration de votre méthode CDC. Pour en savoir plus, consultez Configurer une base de données Oracle source. |