SKILLOfficialdevelopment

idmp-workflow-datasource-diagnose

プラグイン: idmp-plugin
ソース: GitHub で見る ↗

説明

**IDMP データソース診断ワークフロー** 接続の確認、接続性の検証、データベースとメタデータ（データの構造や属性に関する情報）の検査、モデルのマッピング（対応づけ）の比較を行います。プローブ（接続状態の確認）または書き込み操作のあとは、毎回その結果を再度読み込んで確認します。

原文を表示

IDMP datasource diagnosis workflow. Read the connection, probe connectivity, inspect databases and metadata, compare model mappings, and reread after every probe or write.

ユースケース

接続の確認と検証をするとき
データベースとメタデータを検査するとき
モデルのマッピングを比較するとき
プローブ後に結果を確認するとき
書き込み操作後に結果を再度確認するとき

本文（日本語訳）

ワークフロー: データソース診断

まず最初に ../idmp-shared/SKILL.md をお読みください。

推奨される参考資料

先に確認が必要な情報

認証情報（どこから取得するのか）
読み込み直しの内容
オペレータが問題と考えている接続先・データベース・テーブル
トラブルの内容が「接続の到達可能性」「メタデータの見える範囲」「データ形式のズレ」のどれなのか
どの要素またはテンプレートマッピングをソースのメタデータと照らし合わせるべきか

動作上の制限

connections get の結果を connectivity create にコピーしてはいけない
組み込みの TDengine リスナー（監視役）については datasource check list を使用する
書き込みを伴う検査やインポート後は、必ず読み込み直しを行う
接続可能性の検査前に接続オブジェクトを読み込む
追加プロパティとメタデータは参考情報であり、実際の接続可能性の検査に代わるものではない
メタデータ診断は順序を守る: 接続 → 検査 → データベース → テーブル → カラム → データモデルマッピング

実行の流れ

何らかの検査を行う前に、idmp-cli datasource connections list と idmp-cli datasource connections get --params を読み込む
idmp-cli datasource additional-properties list-get --params でデータソース側の背景情報を収集する
idmp-cli datasource check list を読み込み直してから idmp-cli datasource connectivity create --ack-risk --data を実行し、全体的な状態と実際の接続可能性を分けて評価する
idmp-cli datasource dbnames list --params、idmp-cli datasource tablenames list --params、idmp-cli datasource columninfo create --ack-risk --params でメタデータの範囲を確定させる
そのメタデータを idmp-cli attr-template elements attributes --params と照らし合わせ、診断に書き込みを伴う CSV 検査が含まれる場合だけ idmp-cli datasource csv create --ack-risk --params を使う
診断がインポートやエクスポートの履歴に関わる場合は、idmp-cli data records list を読み込み直す

例外的な対応

接続可能性の検査が失敗した場合、メタデータ読み込みと datasource check list に戻り、テーブルの欠落をスキーマのバグと解釈する前に判断する
メタデータが存在するのにデータモデルが合わない場合は、カラムまたはマッピングの具体的なズレを報告する
記録の履歴がない場合は、その原因が「データ取り込み時点の欠落」なのか「データソース側の見える範囲の問題」なのかを述べ、接続性が根本原因かどうかを確認する

検証シナリオ

1. リスナー（監視役）の健全性確認

idmp-cli datasource connections list と idmp-cli datasource connections get --params から始め、その後 idmp-cli datasource check list を実行する

2. マスク済みペイロードの接続障害の特定

マスク対応の接続読み込み後、idmp-cli datasource connectivity create --ack-risk --data を使用する。到達可能性の障害から機密情報を探し出すことのないようにする

3. メタデータとデータモデルのズレ

idmp-cli datasource columninfo create --ack-risk --params と idmp-cli attr-template elements attributes --params を組み合わせる。結果は具体的なマッピングのズレを示すべき

4. テーブル発見の失敗

idmp-cli datasource dbnames list --params と idmp-cli datasource tablenames list --params を順番に実行する。失敗した段階がそのまま報告の対象となる

5. 診断中の CSV インポート履歴

データソースの問題がデータ取り込みに関わる場合、idmp-cli data records list を読み込み直す。記録の履歴と接続性の情報は分けて管理する

原文（English）を表示

workflow: datasource diagnose

Read ../idmp-shared/SKILL.md first.

Recommended references

Missing context to resolve first

Credential source.
Verification rereads.
The target connection, database, or table that the operator thinks is broken.
Whether the complaint is reachability, metadata visibility, or model mismatch.
Which element or template mapping should be compared back to source metadata.

Constrained live behaviors

Do not copy connections get into connectivity create.
datasource check list for the built-in TDengine listener.
After any write-like probe or import, reread.
Read the connection object before probing reachability.
Additional properties and metadata are evidence; they do not replace a live connectivity probe.
Metadata diagnosis stays ordered: connection -> probe -> db -> table -> column -> model mapping.

Execution flow

Read idmp-cli datasource connections list and idmp-cli datasource connections get --params before any probe.
Use idmp-cli datasource additional-properties list-get --params to capture datasource-side context.
Reread idmp-cli datasource check list and then run idmp-cli datasource connectivity create --ack-risk --data to separate summary health from live reachability.
Use idmp-cli datasource dbnames list --params, idmp-cli datasource tablenames list --params, and idmp-cli datasource columninfo create --ack-risk --params to lock the metadata boundary.
Compare that metadata with idmp-cli attr-template elements attributes --params, and use idmp-cli datasource csv create --ack-risk --params only when the diagnosis includes a write-like CSV probe.
Reread idmp-cli data records list if the diagnosis also touches import or export traces.

Exception paths

If the connectivity probe fails, fall back to datasource check list plus metadata reads before interpreting missing tables as schema bugs.
If metadata exists but the model does not match, report the exact column or mapping mismatch.
If record traces are absent, say whether the gap is ingestion history or datasource visibility. Capture whether the root cause is connectivity.

Validation scenarios

1. Listener health confirmation

Start with idmp-cli datasource connections list and idmp-cli datasource connections get --params. Only then run idmp-cli datasource check list.

2. Redacted-payload connectivity failure isolation

Use idmp-cli datasource connectivity create --ack-risk --data after a redaction-aware connection read. Reachability failures should not trigger secret hunting.

3. Metadata versus model mismatch

Pair idmp-cli datasource columninfo create --ack-risk --params with idmp-cli attr-template elements attributes --params. The result should name the exact mapping mismatch.

4. Table discovery failure

Walk idmp-cli datasource dbnames list --params and idmp-cli datasource tablenames list --params in order. The failing step should become the reported boundary.

5. CSV import trace during diagnosis

If the datasource complaint touches ingestion, reread idmp-cli data records list. Keep record-trace evidence separate from connectivity evidence.

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。