CData CLI を使用して Claude Code CLI と Microsoft Dataverse のデータ を連携する方法
Claude Code は Anthropic が開発したエージェント型コマンドラインツールで、AI によるアシスタント機能を開発ワークフローに直接組み込みます。ターミナル上でネイティブに動作し、ファイルの読み取り、コマンドの実行、プロジェクト全体にわたる意思決定といった複数ステップのタスクを、常に手動で介在することなく計画・実行できます。エージェントスキルファイルの読み込みと追従に対応しているため、Claude Code は構造化されたワークフローに適しており、CData CLI のようなツールを通じて外部データソースに接続する用途にぴったりです。データに対してやりたいことを自然な言葉で伝えるだけで、Claude Code がドライバーのセットアップ、接続の設定、クエリの実行を自動で処理します。
この記事では、CData CLI を通じて Microsoft Dataverse のデータ を Claude Code CLI に接続する手順を、ステップごとに詳しく説明します。
前提条件
Microsoft Dataverse データ連携について
CData は、Microsoft Dataverse(旧 Common Data Service)のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:
- Dataverse エンティティと Dataverse システムテーブルの両方にアクセスし、必要なデータを正確に扱うことができます。
- Microsoft Entra ID、Azure マネージド サービス ID 認証情報、クライアントシークレットまたは証明書を使用した Azure サービスプリンシパルなど、さまざまな方法で Microsoft Dataverse に安全に認証できます。
- SQL ストアドプロシージャを使用して、Microsoft Dataverse エンティティを管理できます。エンティティ間の関連付けの一覧表示、作成、削除などが可能です。
CData のお客様は、データをデータウェアハウスにレプリケートしたい場合(他のデータソースと併せて)や、Microsoft エコシステム内のお気に入りのデータツール(Power BI、Excel など)または外部ツール(Tableau、Looker など)からライブ Dataverse データを分析したい場合など、さまざまな理由で当社の Dataverse 接続ソリューションを使用しています。
はじめに
ステップ 1: スキルをダウンロードする(初回のみのセットアップ)
CData CLI は、必ず公式スキルと組み合わせて使用しましょう。
- GitHub 上の公式 CData CLI スキルは、ターミナルから npx skills を使ってダウンロードできます:
npx skills add CDataSoftware/cli-skills
- ターミナルに表示されるプロンプトに従って、Claude Code 向けにインストールします
ステップ 2: プロジェクトディレクトリをセットアップする
プロジェクトファイルをまとめて格納するためのプロジェクトディレクトリを作成します。
ターミナルで目的のディレクトリに移動し、claude コマンドでセッションを開始します。
ステップ 3: ドライバーと接続を設定する
このセッションで CLI と Microsoft Dataverse のデータ データを使って何を実現したいのかを伝えます。例えば、次のようなプロンプトを試してみてください:
Microsoft Dataverse のデータ に接続して Accounts からの更新を確認するコマンドラインアプリを作りたいです。AccountId や Name といった重要なカラムのデータも必ず含めてください。
このプロンプトを入力すると、自動的にスキルが読み込まれ、以下のプロセスが開始されます。次の各ステップは、エージェントに手動で個別にプロンプトを送ることもできます。
- ドライバーのセットアップ: Claude Code は既存の CData Microsoft Dataverse ドライバーを確認し、なければ新しいドライバーを検索してダウンロードします:
cdatacli drivers list
cdatacli drivers search --driver "Microsoft Dataverse"
cdatacli drivers download --artifact-id <artifact-id>
- アクティベーション: 1 つのコマンドで Microsoft Dataverse ドライバーをトライアルライセンスまたは正規ライセンスでアクティベートします:
cdatacli drivers activate "Microsoft Dataverse" --name "<name>" --email "<email>" --trial
cdatacli drivers activate "Microsoft Dataverse" --name "<name>" --email "<email>" --key "<product-key>"
- Microsoft Dataverse の接続を確立する: 既存の Microsoft Dataverse 接続を確認するか、新しい接続を作成します:
cdatacli connection list
cdatacli connection create --driver "Microsoft Dataverse" --name my_cds_connection --connectionstring "Prop1=value1;Prop2=value2;..."
- Microsoft Dataverse スキルを作成する(該当する場合): CData は主要なデータソース向けのドライバー手順書を提供しており、これを使ってデータソース固有のスキルファイルを生成することで、ドライバーのベストプラクティスに沿ってエージェントを導けます。
次のコマンドを実行してスキルファイルを生成し、出力をスキルディレクトリに保存します。スキルはプロジェクト単位またはグローバルのいずれかに保存できます。(注: 「No instructions available for Microsoft Dataverse」というメッセージが返された場合は、そのドライバー用の手順書が存在しないため、メインのドライバースキルをそのまま使用できます)
cdatacli drivers skill "Microsoft Dataverse" > ~/skills/cdata-cds/SKILL.md
ステップ 4: Microsoft Dataverse のデータ データをクエリする
CData ドライバーの構成がすべて完了したら、エージェントはリアルタイムの Microsoft Dataverse データに対してクエリを実行したり、コードを書いたりできるようになります。
cdatacli query sql --connection my_cds_connection --sql "SELECT * FROM Accounts"
CData CLI でターミナルから直接 Microsoft Dataverse データをクエリする
Claude Code と CData CLI を組み合わせれば、カスタムのミドルウェアやスケジュール同期、各ステップでの手作業なしに、AI コーディングエージェントがリアルタイムの Microsoft Dataverse データへ直接アクセスできる道筋が手に入ります。やりたいことを伝えるだけで、エージェントがドライバーの構成、接続のセットアップ、クエリの実行までをターミナル上で最初から最後まで処理します。
無料の CData CLI をダウンロードして、CData JDBC Driver for Microsoft Dataverse の 30 日間無償トライアルを今日から始めましょう。