Définir le but de la source
Spécifiez la source exacte, le propriétaire, la classification des données et le flux de travail commercial prévu. Un connecteur générique n'est pas une permission de balayage arbitraire des tables ou des points d'extrémité.
Partez d'un usage concret : quelle question métier a besoin de quels champs, issus de quelle source ? Consignez le responsable, la destination approuvée, la classification des données et les hypothèses de conservation. Choisissez le plus petit périmètre de source qui répond à la question. Les identifiants sont un mécanisme d'accès, pas une autorisation d'étendre la collecte au-delà de cette finalité.
- Choisissez un adaptateur pris en charge et une destination explicite.
- Utilisez les champs et l'étendue des lignes minimaux autorisés.
- Gardez les identifiants sources dans le plan de données client.
Examiner la limite d'ingestion
Accordez la pseudonymisation, les adresses autorisées, les mappages de champs et les échéances avant d’activer la collecte. Enregistrez le schéma source et les empreintes digitales afin de rendre les dérives visibles.
Examinez la forme et le sens des données autant que leur transport. Identifiez le temps métier, les identifiants d'entités, l'ordre et les éventuelles valeurs manquantes. Un lot syntaxiquement valide peut tout de même porter une mauvaise sémantique métier. Conservez les identités de schéma et de correspondance afin de détecter et d'examiner les changements ultérieurs.
Garde locale à la source et ingestion contrôlée
Partez de la vue, du flux, de l'endpoint ou du journal exact approuvé.
- Conserver l'identité de la source et le temps d’activité commercial.
- Lignes, octets, pages et durée de la requête limités.
- Examiner les modifications des sources plutôt que d'élargir silencieusement la collecte.
Répétez une interruption de livraison
Une connexion à la source nécessite un accusé de réception fiable et un comportement de récupération. Testez les accusés de réception perdus, les redémarrages et les générations de sources modifiées contre le profil de connecteur déclaré.
Un connecteur peut livrer un lot avec succès mais perdre l'accusé de réception. La reprise doit distinguer ce cas d'un lot jamais arrivé. Répétez l'interruption avec le profil exact pris en charge, en conservant l'identité des entrées, le reçu et le comportement du point de contrôle, plutôt que de supposer que toutes les sources ont la même sémantique de relecture.
Qu'une source de sinistres vérifiée doit-elle apporter à un modèle ?
Sélectionnez les identifiants de dossiers, transitions de statut et horodatages métier autorisés dans une vue source approuvée. Consignez les correspondances et les références des entrées, puis testez un lot interrompu face au contrat du profil.
Vérifiez si les enregistrements admis prennent en charge le workflow visé. Une lecture réussie ne prouve ni une couverture complète des sinistres ni une intégration native avec la plateforme de gestion des sinistres.
- Inspectez le comportement outbox et checkpoint.
- Vérifiez le digest d'entrée reconnu.
- Conservez l'origine des captures d'écran et des sources.
Choisir un profil, puis qualifier la source
Le catalogue des profils de source mis en œuvre comprend les journaux d'événements, les vues SQLite, les vues PostgreSQL, PostgreSQL CDC, les flux Redis, les lectures REST délimitées et les lectures MCP organisationnelles. Chaque profil a son propre contrat d'exploitation.
PostgreSQL CDC est un profil de laboratoire isolé. Un adaptateur générique n'établit pas la compatibilité native avec une application d'éditeur, le réseau du client ou la capture de changements en production. Qualifiez la source, les identifiants, le schéma et le déploiement exacts avant d'en élargir l'usage.
Examiner la frontière avant la collecte
| Frontière | Question à résoudre | Preuves à conserver |
|---|---|---|
| Périmètre de la source | Quels enregistrements et champs exacts sont autorisés ? | Finalité et correspondance de la source vérifiées. |
| Garde des identifiants | Où sont conservés les identifiants et qui en assure la rotation ? | Références du responsable et de la garde, sans secrets. |
| Livraison interrompue | Comment ce profil reconnaît-il un lot déjà admis ? | Identité des entrées, reçu et preuves de point de contrôle. |
- Consignez les versions de l'adaptateur et de la source.
- Tenez les identifiants à l'écart des prompts et des sorties du modèle.
- Distinguez une connexion de laboratoire réussie de l'acceptation en production.
Préserver la traçabilité à travers le changement
Les données deviennent des preuves utiles lorsqu'un relecteur peut identifier leur origine et la manière dont elles sont entrées dans le modèle. Conservez avec le modèle les références des sources, l'identité de l'instantané, les correspondances vérifiées et les limites de collecte pertinentes.
Traitez tout changement de génération de source, de schéma ou de destination comme un événement de revue. Ne réinterprétez pas silencieusement d'anciens enregistrements via une nouvelle correspondance. Préservez les preuves antérieures afin qu'un écart ultérieur puisse être rattaché à la source, à la correspondance ou au modèle plutôt que deviné.
Gardez les preuves et leurs conditions ensemble. Un succès ultérieur n'efface pas un échec antérieur et n'élargit pas le périmètre d'origine.
- Conservez les identités de la source et de la correspondance.
- Expliquez les lacunes, les doublons et les hypothèses d'ordre.
- Examinez les changements de collecte avec le responsable.
Préparer une note d'intégration de source
Réunissez le responsable de la source et l'équipe plateforme autour de la plus petite connexion utile. Convenez des données autorisées, de la finalité, du profil, du comportement en cas de défaillance et des preuves à conserver avant de connecter une source sensible.
Utilisez des entrées synthétiques ou dûment approuvées pour répéter le contrat. Gardez la décision d'acceptation distincte de la checklist : cocher un élément ici n'enregistre aucun connecteur et n'accorde aucun accès à un système.
Préparation de la revue
0 / 6 préparé- Désignez le responsable de la source et des identifiants.
- Définissez les limites de collecte et de reprise.
- Consignez le travail de qualification client restant.