源の目的を定義する
正確なソース、オーナー、データ分類、および意図されたビジネスワークフローを指定します. 一般的なコネクターは、任意のテーブルや端点をスキャンすることを許可されません。
具体的な用途から始めましょう。どのビジネス上の問いに、どのソースのどのフィールドが必要なのか。オーナー、承認済みの送信先、データ分類、保持に関する前提を記録します。問いを支えられる最小限のソーススコープを選びます。認証情報はアクセスの手段であり、その目的を超えて収集範囲を広げる許可ではありません。
- サポートされたアダプターと明確な目的地を選択します。
- 最低限の許可されたフィールドと順番範囲を使用します。
- クライアントデータプランにソース認証を保持します。
入力制限を検討する
pseudonymization, permitted addresses, field mappings and deadlines before enabling collection. ソーススケジュールを記録し、指紋を表示してドライフが目に見えるようにします。
データの転送方法だけでなく、その形と意味もレビューしましょう。業務上の時刻、エンティティの識別子、順序、欠損値を確認します。構文的に正しいバッチでも、誤ったビジネスセマンティクスにマッピングされることがあります。スキーマとマッピングの ID を保持しておけば、後の変更を検出してレビューできます。
ソース側での管理と、制御された取り込み
承認済みの具体的なビュー、ストリーム、エンドポイント、ジャーナルから始めます。
- ソースアイデンティティとビジネスタイムを保存します。
- 制限行、バイト、ページ、およびリクエストの期間。
- コレクションを静かに拡張する代わりに、レビューソースの変更。
交付中断の回復
ソース接続には、信頼性の高い認識と回復行動が必要です テストは、認定を失い、再起動し、宣言されたコネクタープロファイルに対してソース世代を変更します。
コネクターがバッチの配信に成功しても、確認応答が失われることがあります。リカバリーでは、そのケースと、バッチがそもそも届かなかったケースを区別する必要があります。すべてのソースが同じリプレイの仕組みを持つと想定するのではなく、サポート対象の具体的なプロファイルを使って中断をリハーサルし、入力の ID、レシート、チェックポイントの挙動を保持しましょう。
レビュー済みの保険金請求ソースは、モデルに何をもたらすべきか?
承認済みのソースビューから、許可されたケース識別子、ステータスの遷移、業務上のタイムスタンプを選択します。マッピングと入力の参照を記録し、中断されたバッチをプロファイルの契約に照らしてテストします。
取り込まれた記録が、想定するワークフローを支えられるかをレビューします。読み取りに成功しても、保険金請求の完全なカバーや、保険金請求プラットフォームとのネイティブな統合が証明されるわけではありません。
- オートボックスとチェックポイントの行動をチェックする。
- 認定入力の消化を確認する
- 収入とソーススナップショットの出身を保持します。
プロファイルを選び、ソースを認定する
実装済みのソースプロファイルカタログには、イベントジャーナル、SQLite ビュー、PostgreSQL ビュー、PostgreSQL CDC、Redis ストリーム、範囲を限定した REST の読み取り、組織内 MCP の読み取りが含まれます。各プロファイルには、それぞれ独自の運用契約があります。
PostgreSQL CDC は分離されたラボ用プロファイルです。汎用アダプターがあるからといって、ベンダーのアプリケーション、お客様のネットワーク、本番環境での変更データキャプチャとのネイティブな互換性が確立されるわけではありません。利用を広げる前に、具体的なソース、認証情報、スキーマ、デプロイを認定してください。
収集の前に境界をレビューする
| 境界 | 解決する問題 | 保持すべきエビデンス |
|---|---|---|
| ソースのスコープ | どの記録とフィールドが許可されているか? | レビュー済みのソースの目的とマッピング。 |
| 認証情報の管理 | 認証情報はどこで保持され、誰がローテーションするか? | オーナーと管理の参照(シークレットは含まない)。 |
| 中断された配信 | このプロファイルは、取り込み済みのバッチをどのように識別するか? | 入力の ID、レシート、チェックポイントのエビデンス。 |
- アダプターとソースのバージョンを記録します。
- 認証情報をプロンプトやモデルの出力に含めないようにします。
- ラボでの接続成功と、本番環境での受け入れを区別します。
変更を経ても系譜を保つ
データは、レビュー担当者がその出所とモデルへの取り込み経路を特定できてはじめて、有用なエビデンスになります。ソースの参照、スナップショットの ID、レビュー済みのマッピング、関連する収集の制限を、モデルとあわせて保持しましょう。
ソースの世代、スキーマ、送信先の変更は、レビューの契機として扱います。古い記録を新しいマッピングで黙って再解釈してはいけません。以前のエビデンスを保持しておけば、後の不一致を推測ではなく、ソース、マッピング、モデルのいずれかまでたどることができます。
エビデンスとその条件をひとまとめに保ちます。後の成功が以前の失敗を消したり、元のスコープを広げたりすることはありません。
- ソースとマッピングの ID を保持します。
- ギャップ、重複、順序に関する前提を説明します。
- 収集の変更を、責任者とともにレビューします。
ソースのオンボーディングブリーフを準備する
ソースのオーナーとプラットフォームチームが協力し、最小限の有用な接続について検討しましょう。機密性の高いソースを接続する前に、許可するデータ、目的、プロファイル、障害時の挙動、保持するエビデンスについて合意します。
合成データ、または適切に承認された入力を使って契約をリハーサルします。受け入れの判断はチェックリストとは切り離してください。ここで項目を選択しても、コネクターが登録されたり、システムへのアクセスが付与されたりすることはありません。
レビューの準備
0 / 6 準備済み- ソースと認証情報のオーナーを明記します。
- 収集とリカバリーの制限を定義します。
- 残っているお客様環境での認定作業を記録します。