Partager via


Gestion des erreurs

Important

La capture des changements de données pour Oracle d'Attunity est désormais déconseillé. Pour les détails, référez-vous à l'annonce.

Une instance Oracle CDC exploite les modifications d'une base de données source Oracle (un cluster Oracle RAC est considéré comme une seule base de données) et écrit les modifications validées dans les tables de modifications dans une base de données CDC de l'instance SQL Server cible.

Une instance de capture de données modifiées conserve son état dans une table système appelée cdc.xdbcdc_state. Cette table peut être interrogée à tout moment pour trouver l'état de l'instance de capture de données modifiées. Pour plus d’informations sur la table cdc.xdbcdc_state, consultez cdc.xdbcdc_state.

Le tableau ci-dessous décrit les états de l'instance de capture de données modifiées dans la table xdbcdc_state.

Pour chaque état, les deux indications suivantes s'affichent pour les colonnes correspondantes dans la table cdc.xdbcdc_state :

  • L'instance n'est pas active (elle n'est actuellement gérée par aucun processus Windows). Si la valeur de la colonne active est 1, un sous-processus du service de capture de données modifiées Oracle gérant cette instance Oracle CDC spécifique est en cours d’exécution.

  • Si la valeur de la colonne d’erreur est 0, l’instance Oracle CDC n’est pas dans une condition d’erreur. Si la valeur de la colonne d’erreur est 1, il existe une erreur qui empêche l’instance Oracle CDC de traiter les modifications.

    Si la colonne d’erreur a la valeur 1 et la valeur de la colonne active est également 1, une erreur récupérable se produit pour l’instance Oracle CDC, qui peut être résolue automatiquement. Si la colonne d'erreur a la valeur 1 et la colonne active a la valeur 0, dans la plupart des cas une solution de contournement manuelle peut être nécessaire pour résoudre le problème avant la reprise du traitement.

Le tableau suivant décrit les différents codes d'état que l'instance Oracle CDC peut signaler dans sa table d'état.

Statut Code d'état actif Code d'état d'erreur Description Sous-état
ABORTED 0 1 L'instance Oracle CDC ne s'exécute pas. Le sous-état ABORTED indique que l'instance Oracle CDC était ACTIVE, puis s'est arrêtée de façon inattendue. Le sous-état ABORTED est établi par l'instance principale de service de capture de données modifiées Oracle lorsqu'elle détecte que l'instance Oracle CDC ne s'exécute pas alors que son état est ACTIVE.
ERROR 0 1 L'instance Oracle CDC ne s'exécute pas. L'état ERROR indique que l'instance de capture de données modifiées était ACTIVE, mais a rencontré une erreur qui n'est pas récupérable et s'est désactivée elle-même. MISCONFIGURED : Une erreur de configuration irrécupérable a été détectée.

PASSWORD-REQUIRED : Il n'existe aucun mot de passe défini pour le concepteur de capture de données modifiées pour Oracle par Attunity ou le mot de passe configuré n'est pas valide. Cela peut être dû à une modification apportée au mot de passe de la clé asymétrique du service.
RUNNING 1 0 L'instance de capture de données modifiées s'exécute et traite les enregistrements de modification. IDLE : Tous les enregistrements de modification ont été traités et stockés dans les tables de contrôle cibles ( _CT). Aucune transaction n'est active avec les tables de contrôle.

PROCESSING : Il existe des enregistrements de modification en cours de traitement qui ne sont pas encore écrits dans les tables de contrôle ( _CT).
STOPPED 0 0 L'instance CDC n'est pas en cours d'exécution. Le sous-état STOP indique que l'instance de capture de données modifiées était ACTIVE et a été arrêtée correctement.
SUSPENDED 1 1 L'instance de capture de données modifiées s'exécute, mais le traitement est interrompu en raison d'une erreur récupérable. DISCONNECTED : Il est impossible d'établir la connexion à la base de données Oracle source. Le traitement se poursuit une fois la connexion restaurée.

STORAGE : le stockage est saturé. Le traitement se poursuit une fois le stockage disponible. Dans certains cas, cet état n'apparaît pas, car il est impossible de mettre à jour la table d'état.

LOGGER : Le journal est connecté à Oracle, mais il ne peut pas lire les journaux des transactions Oracle en raison d'un problème temporaire.
DATAERROR x x Ce code d’état est utilisé uniquement pour la table xdbcdc_trace . Il n’apparaît pas dans la table xdbcdc_state . Les enregistrements de trace avec cet état indiquent un problème avec un enregistrement de journal Oracle. L’enregistrement de journal incorrect est stocké dans la colonne data en tant que BLOB. BADRECORD : Impossible d'analyser l'enregistrement du journal joint.

CONVERT-ERROR : Impossible de convertir les données de certaines colonnes en colonnes cibles dans la table de capture. Cet état apparaît uniquement si la configuration spécifie que les erreurs de conversion doivent produire des enregistrements de trace.

Étant donné que l'état du service de capture de données modifiées Oracle est stocké dans SQL Server, il peut y avoir des cas où la valeur d'état dans la base de données ne reflète pas l'état réel du service. Le scénario le plus courant est lorsque le service perd sa connexion à SQL Server et ne peut pas la rétablir (pour une raison quelconque). Dans ce cas, l’état stocké dans cdc.xdbcdc_state devient obsolète. Si la valeur de l'horodateur de dernière mise à jour (UTC) date de plus d'une minute, l'état est probablement obsolète. Dans ce cas, utilisez l'Observateur d'événements Windows pour rechercher des informations supplémentaires sur l'état du service.

Gestion des erreurs

Cette section décrit comment le service de capture de données modifiées Oracle gère les erreurs.

Journalisation

Le service de capture de données modifiées Oracle crée des informations d'erreur dans l'un des emplacements suivants.

  • Le journal des événements Windows, qui est utilisé avec la journalisation des erreurs et pour indiquer les événements de cycle de vie de service de capture de données modifiées Oracle (démarrage, arrêt, reconnexion à l'instance SQL Server cible).

  • La table MSXDBCDC.dbo.xdbcdc_trace, utilisée pour la journalisation et le suivi généraux par le processus principal du service de capture de données modifiées Oracle.

  • La table <cdc-database>.cdc.xdbcdc_trace, utilisée pour la journalisation et le suivi généraux par les instances Oracle CDC. Cela signifie que les erreurs liées à une instance Oracle CDC spécifique sont enregistrées dans la table de trace de cette instance.

Les informations sont enregistrées par le service de capture de données modifiées Oracle lorsque le service :

  • est démarré ou arrêté par le gestionnaire de contrôle des services ;

  • ne peut pas se connecter à l'instance SQL Server associée et lorsqu'il établit avec succès une connexion après un échec ;

  • rencontre une erreur lors du démarrage des instances de service de capture de données modifiées Oracle ;

  • détecte qu'une instance Oracle CDC s'est interrompue ;

  • rencontre une erreur inattendue.

Les informations sont enregistrées par l'instance de capture de données modifiées lorsque l'instance :

  • est activée ou désactivée ;

  • rencontre une erreur ;

  • récupère à partir d'une erreur récupérable.

La table de trace est également utilisée pour consigner les informations de trace détaillées en vue du dépannage.

Gestion des erreurs de connexion Oracle à la source

Le service de capture de données modifiées Oracle a besoin d'une connexion permanente à la base de données Oracle source. De nombreuses erreurs de connexion qui ne sont pas liées à la configuration du service (telles que les erreurs réseau) sont considérées comme étant transitoires. Par conséquent, si le service de capture de données modifiées Oracle ne peut pas établir de connexion à la base de données Oracle (lors du démarrage ou pendant le travail suivant une déconnexion), le service change son état en SUSPENDED/DISCONNECTED et entre dans une boucle de tentatives où la connexion est retentée à intervalles réguliers. Lorsque la connexion est rétablie, le traitement continue.

D'autres types d'erreurs de connexion ne sont pas transitoires (par exemple, informations d'identification incorrectes, privilèges insuffisants et adresse de base de données incorrecte). Lorsque ces erreurs se produisent, l'état du service de capture de données modifiées Oracle est défini à ERROR/MISCONFIGURED ou à ERROR/PASSWORD-REQUIRED et le service est désactivé. Lorsque l'utilisateur corrige l'erreur sous-jacente, l'instance Oracle CDC doit être réactivée manuellement pour que le traitement continue.

Lorsqu'il n'apparaît pas clairement si l'erreur est temporaire, il est préférable de supposer qu'elle est temporaire.

Gestion des erreurs de connexion à l'instance SQL Server cible

Le service de capture de données modifiées Oracle a besoin d'une connexion permanente à l'instance SQL Server cible. Cette connexion sert à :

  • Vérifier qu'il n'y a aucun autre service portant le même nom actuellement utilisé avec cette instance SQL Server .

  • Vérifier quelle instance Oracle CDC est activée ou désactivée et démarrer (ou arrêter) son sous-processus.

Lorsque le service établit une connexion à l'instance SQL Server cible et vérifie qu'il s'agit du seul service de capture de données modifiées Oracle portant ce nom qui fonctionne, il peut vérifier les instances Oracle CDC qui sont activées et démarrer leurs processus de gestion (après le service arrête ces processus lorsqu'elles sont désactivées). Les instances Oracle CDC utilisent leurs connexions SQL Server pour utiliser la base de données CDC de l'instance Oracle CDC.

Le mode de gestion des erreurs en cas d'échec de la connexion à l'instance SQL Server cible varie selon que les erreurs sont temporaires ou non.

Pour les erreurs non temporaires (telles que informations d'identification incorrectes, privilèges insuffisants, informations de connexion incorrectes), le service enregistre une erreur dans le journal des événements Windows et s'arrête (il ne peut pas écrire dans la table de trace, car il ne peut pas se connecter à SQL Server). Dans ce cas, l'utilisateur doit résoudre l'erreur et redémarrer le service Windows de capture de données modifiées Oracle.

Pour les erreurs temporaires et les erreurs inattendues, l'opération est retentée plusieurs fois et si l'erreur persiste pendant une période significative, le service de capture de données modifiées arrête les sous-processus de l'instance CDC et revient à sa tentative de connexion initiale (à ce moment-là, un service de capture de données modifiées Oracle sur un autre ordinateur peut déjà avoir pris le contrôle du service de capture de données modifiées nommé).

Gestion des erreurs de stockage saturé sur l'instance SQL Server cible

Lorsque le service de capture de données modifiées Oracle détecte qu'il ne peut pas insérer de nouvelles données dans la base de données CDC SQL Server cible, il écrit un avertissement dans le journal des événements et tente d'insérer un enregistrement de trace (bien que cette opération puisse échouer pour la même raison). Il effectue une nouvelle tentative dans un intervalle spécifique jusqu'à ce que l'opération réussisse.

Gestion des erreurs Oracle CDC

L'instance Oracle CDC lit le journal des transactions Oracle et le traite. Si le traitement CDC rencontre une erreur, il apparaît dans la table cdc.xdbcdc_state et l’utilisateur doit intervenir manuellement selon l’erreur signalée.

Par exemple, l'instance Oracle CDC ne peut pas être active pour une durée étendue et les journaux des transactions Oracle requis ne sont plus disponibles. Dans ce cas, l'administrateur de base de données Oracle doit restaurer les journaux requis de façon à ce que l'instance Oracle CDC continue le traitement.

Gestion des échecs inattendus d'instance Oracle CDC

Le service de capture de données modifiées Oracle surveille ses sous-processus d'instance CDC. Lorsqu'un sous-processus d'instance de capture de données modifiées s'interrompt, le service de capture de données modifiées le désactive dans la table MSXDBCDC.dbo.xdbcdc_databases et met à jour l'état cdc.xdbcdc_state vers ABORTED. Dans ce cas, la boîte de dialogue Rapport d'erreurs Windows est utilisée pour signaler cette erreur en vue d'une analyse ultérieure.

Voir aussi

Concepteur de capture de données modifiées pour Oracle par Attunity
Instance CDC Oracle