claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 1h ago
スキルOfficialdevelopment

🗄️idmp-datasource

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

説明

IDMP データソーススキル。接続一覧の表示・確認、本格的なメタデータ読み込みの前に接続確認を行う、データベースやテーブルが見えないといった問題を診断するなどの場面で活用します。単なる接続一覧の表示にとどまらず、より詳しい調査が可能です。

原文を表示

IDMP datasource skill. Use it to list and inspect connections, verify connectivity before deeper metadata reads, and diagnose database or table visibility issues instead of stopping at the connection list.

ユースケース

  • ✓接続一覧を表示・確認するとき
  • ✓メタデータ読み込み前に接続確認するとき
  • ✓データベースやテーブルが見えない問題を診断するとき
  • ✓接続に関する詳しい調査を行うとき

本文（日本語訳）

データソース

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

このスキルの対象範囲

  • データソース接続の検査、非表示化された接続情報、接続確認プローブ（接続状態を検証するツール）、データベースとテーブルの探索、カラムのメタデータ確認。
  • 読み取り専用のメタデータ診断と、データ変更を伴うインポートワークフローを分離して管理。

推奨参考資料

先に明確にしておくべき情報

  • 認証情報の出所。
  • 再度の確認実施。
  • 対象となるデータソース接続または環境。
  • トレース対象のデータベース、テーブル、またはステーブル（TDengineの時系列テーブル）。
  • メタデータのみ必要か、それともソースとモデルのマッピング詳細まで必要か。

制約のある動作仕様

  • datasource connections get は非表示化されたシークレット情報を返す可能性があります。
  • datasource check list は安全なヘルスチェック手段です。
  • datasource columninfo create はメタデータ確認的なプローブです。
  • 接続情報は非表示化されていても診断に使用可能です。
  • 接続確認プローブは到達可能性を検証するもので、スキーマの正確性ではありません。
  • メタデータ探索は常に順序を守ります：接続 → 接続確認 → データベース → テーブル → カラム。
  • ソース‐モデル間の説明は、推測ではなく実際にマップされたフィールドを使用します。

実行フロー

  1. idmp-cli datasource connections list で開始し、connections get で正確な接続を特定します。
  2. より詳しい診断の前に idmp-cli datasource check list を実行し、接続の健全性の境界を明確にします。
  3. 対象接続が確定してから idmp-cli datasource connectivity create --ack-risk --data を実行します。スキーマ確認ではなく、実際の到達可能性の証明として扱います。
  4. データベース一覧 → テーブル一覧 → カラム情報 の順に進め、すべてのメタデータが同じデータベースとテーブル範囲に基づいていることを確認します。
  5. 発見されたソースフィールドを、推測ではなく実際のモデルマッピングと比較して完了します。

完了の判定基準

  • 接続診断は、接続の再確認とヘルスチェックプローブが同じ接続IDを参照して初めて完全です。
  • メタデータの主張は、同じデータベースとテーブルが データベース一覧 → テーブル一覧 → カラム情報 の全プロセスで確認されて初めて完全です。
  • 非表示化された接続情報は有効な証拠です。隠されたシークレット情報を欠落データとして扱わないでください。

主要なコマンド

  1. idmp-cli datasource connections list で対象接続を検索。
  2. idmp-cli datasource connections get --params で選択した接続の詳細を確認。
  3. idmp-cli datasource check list でデータソース健全性サマリーを表示。
  4. idmp-cli datasource connectivity create --ack-risk --data で実際の到達可能性を検証。
  5. idmp-cli datasource dbnames list --params でデータベースを列挙。
  6. idmp-cli datasource tablenames list --params でテーブルを列挙。
  7. idmp-cli datasource columninfo create --ack-risk --params で最終的なメタデータ構成を確定。

例外的な処理

  • 接続確認が失敗した場合は、欠落テーブルをモデル問題と解釈する前に中止します。
  • カラムメタデータが欠落している場合は、失敗したデータベースとテーブルの境界を明示します。
  • 接続情報のシークレット情報を非表示化解除またはログに記録しません。

検証シナリオ

1. 接続の探索

idmp-cli datasource connections list で開始し、1つの接続を選択して詳しく確認します。次のステップは常に対象を限定した get コマンドです。

2. 非表示化を考慮した接続確認

idmp-cli datasource connections get --params を使用し、隠されたシークレット情報を受け入れます。認証情報を露出させずに診断を進められます。

3. 組み込みヘルスチェック

idmp-cli datasource check list と idmp-cli datasource connectivity create --ack-risk --data を組み合わせて実行します。サマリーチェックと実際の到達可能性確認を分けて扱います。

4. データベースとテーブルの探索

idmp-cli datasource dbnames list --params と idmp-cli datasource tablenames list --params を順番に実行します。検証済みのテーブルを特定せずにカラムに直接ジャンプしません。

5. メタデータの完成確認

idmp-cli datasource columninfo create --ack-risk --params で完了します。データベース一覧 → テーブル一覧 → カラム情報 の完全なプロセス成功を、実際のメタデータ完成として扱います。

原文（English）を表示

datasource

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

What this skill covers

  • Inspect datasource connections, redacted connection details, connectivity probes, database and table discovery, and column metadata.
  • Keep read-first metadata diagnosis separate from mutating import workflows.

Recommended reference

Missing context to resolve first

  • Credential source.
  • Verification rereads.
  • Which datasource connection or environment is in scope.
  • Which database, table, or stable must be traced.
  • Whether the operator wants metadata only or a full model-to-source mapping explanation.

Constrained live behaviors

  • datasource connections get can return redacted secrets.
  • datasource check list is the safe health probe.
  • datasource columninfo create is a write-like metadata probe.
  • Connection reads can be redacted and still be usable for diagnosis.
  • Connectivity probes validate reachability, not schema correctness.
  • Metadata walks should stay ordered: connection -> connectivity -> databases -> tables -> columns.
  • Source-to-model explanations must use the real mapped fields, not guessed TDengine column names.

Execution flow

  1. Start with idmp-cli datasource connections list, then lock the exact connection through connections get.
  2. Run idmp-cli datasource check list before deeper diagnosis so connection-health boundaries are explicit.
  3. Use idmp-cli datasource connectivity create --ack-risk --data only after the target connection is fixed; treat it as live reachability proof, not schema proof.
  4. Walk dbnames -> tablenames -> columninfo in order so every metadata claim stays grounded in the same database and table scope.
  5. Finish by comparing the discovered source fields against the real model mapping rather than guessed TDengine column names.

Evidence of completion

  • A connection diagnosis is only complete when the connection reread and the health probe refer to the same connection ID.
  • A metadata claim is only complete when the same database and table survive the dbnames -> tablenames -> columninfo chain.
  • Redacted connection reads are still valid evidence; never treat masked secrets as missing data.

Key commands

  1. idmp-cli datasource connections list to find the target connection.
  2. idmp-cli datasource connections get --params to inspect the selected connection object.
  3. idmp-cli datasource check list to read built-in datasource health summaries.
  4. idmp-cli datasource connectivity create --ack-risk --data to probe live reachability.
  5. idmp-cli datasource dbnames list --params to enumerate databases.
  6. idmp-cli datasource tablenames list --params to enumerate tables or stables.
  7. idmp-cli datasource columninfo create --ack-risk --params to lock the final metadata shape.

Exception paths

  • If connectivity fails, stop before interpreting missing tables as modeling problems.
  • If column metadata is missing, show the exact database and table boundary that failed.
  • Never unredact or log credentials from a connection read.

Validation scenarios

1. Connection discovery

Start with idmp-cli datasource connections list, then pick one connection for deeper reads. The next step should always be a targeted get.

2. Redaction-aware connection read

Use idmp-cli datasource connections get --params and accept masked secrets. Diagnosis can continue without exposing credentials.

3. Built-in health check

Run idmp-cli datasource check list and idmp-cli datasource connectivity create --ack-risk --data together. Separate summary checks from a live reachability probe.

4. Database and table discovery

Walk idmp-cli datasource dbnames list --params and idmp-cli datasource tablenames list --params in order. Do not jump straight to columns without a verified table target.

5. Metadata closure

Finish with idmp-cli datasource columninfo create --ack-risk --params. Treat successful dbnames -> tablenames -> columninfo as a real metadata closure.

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

idmp-plugin:idmp-datasource — Anthropic公式 Claude Skill 日本語版