CData CLI を使用して Codex CLI と Smartsheet のデータ を連携する方法

Justin Floyd
Justin Floyd
Product Business Analyst
CData CLI を使用すると、AI コーディングエージェントが数百種類のデータソースに対応した CData ドライバーに、コマンドラインからネイティブに直接アクセスできます。ターミナルを離れることなく、ライセンスの管理、接続の構成、SQL クエリの実行、スキーマメタデータの探索を行えます。

Codex CLI は OpenAI が開発したオープンソースの AI コーディングエージェントで、速度と効率性を重視した Rust で構築されており、ターミナルからローカルで実行されます。自然言語の指示によって、マシン上のコードの読み取り、修正、実行を行い、複数ファイルの編集、シェルコマンドの実行、コード変更のレビュー、Codex Cloud タスクの起動といった操作に対応しています。インテグレーション、エージェントスキル、AGENTS.md 設定ファイルに対応しているため、構造化されたツール駆動型のワークフローに適しており、CData CLI を通じて外部データソースに接続する用途にぴったりです。

データに対してやりたいことを自然な言葉で伝えるだけで、Codex CLI がドライバーの構成からライセンスのアクティベーション、接続の作成、クエリの実行まで、各ステップで手作業を挟むことなくセットアップ全体を処理してくれます。

この記事では、CData CLI を通じて Smartsheet のデータ を Codex CLI に接続する手順を、ステップごとに詳しく説明します。

前提条件

  1. Codex CLI がインストールされていること
  2. CData CLI がインストールされていること
  3. Smartsheet へのアクセス権があること

Smartsheet データ連携について

CData は、Smartsheet のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:

  • 添付ファイル、カラム、コメント、ディスカッションの読み取りと書き込みができます。
  • 個々のセルのデータを表示したり、セルの履歴をレポートしたりできます。
  • 添付ファイルの削除やダウンロード、シートの作成・コピー・削除・移動、行の別のシートへの移動やコピーなど、Smartsheet 固有のアクションを実行できます。

ユーザーは、Tableau、Crystal Reports、Excel などの分析ツールと Smartsheet を統合しています。また、当社のツールを活用して Smartsheet データをデータベースやデータウェアハウスにレプリケートしているお客様もいます。


はじめに


ステップ 1: スキルをダウンロードする(初回のみのセットアップ)

CData CLI は、必ず公式スキルと組み合わせて使用しましょう。

  1. GitHub 上の公式 CData CLI Skill は、ターミナルから npx skills を使ってインストールできます。

    npx skills add CDataSoftware/cli-skills

  2. ターミナルに表示されるプロンプトに従って、Codex 向けにインストールします。

ステップ 2: プロジェクトディレクトリをセットアップする

プロジェクトファイルをまとめて格納するためのプロジェクトディレクトリを作成します。

  1. ターミナルで目的のディレクトリに移動し、codex コマンドでセッションを開始します。

ステップ 3: ドライバーと接続を設定する

このセッションで CLI と Smartsheet データを使って何を実現したいのかを伝えます。

Smartsheet に接続して Sheet_Event_Plan_Budget からの更新を確認するコマンドラインアプリを作りたいです。TaskName や Progress といった重要なカラムのデータも必ず含めてください。

このプロンプトを入力すると、自動的にスキルが読み込まれ、以下のプロセスが開始されます。次の各ステップは、エージェントに手動で個別にプロンプトを送ることもできます。

  1. ドライバーのセットアップ: Codex CLI は既存の CData Smartsheet ドライバーを確認し、なければ新しいドライバーを検索してダウンロードします。
    • cdatacli drivers list
    • cdatacli drivers search --driver "Smartsheet"
    • cdatacli drivers download --artifact-id <artifact-id>
  2. アクティベーション: 1 つのコマンドで Smartsheet ドライバーをトライアルライセンスまたは正規ライセンスでアクティベートします。
    • cdatacli drivers activate "Smartsheet" --name "<name>" --email "<email>" --trial
    • cdatacli drivers activate "Smartsheet" --name "<name>" --email "<email>" --key "<product-key>"
  3. 接続を確立する: 既存の Smartsheet 接続を確認するか、新しい接続を作成します。
    • cdatacli connection list
    • cdatacli connection create --driver Smartsheet --name my_smartsheet_connection --connectionstring "Prop1=value1;Prop2=value2;..."
  4. Smartsheet スキルを作成する(該当する場合): CData は主要なデータソース向けのドライバー手順書を提供しており、これを使ってデータソース固有のスキルファイルを生成することで、ドライバーのベストプラクティスに沿ってエージェントを導けます。
    • 次のコマンドを実行してスキルファイルを生成し、出力をスキルディレクトリに保存します。スキルはプロジェクト単位またはグローバルのいずれかに保存できます。(注: 「No instructions available for Smartsheet」というメッセージが返された場合は、そのドライバー用の手順書が存在しないため、メインのドライバースキルをそのまま使用できます)
      cdatacli drivers skill "Smartsheet" > ~/skills/cdata-smartsheet/SKILL.md

ステップ 4: Smartsheet データをクエリする

CData ドライバーの構成がすべて完了したら、エージェントはリアルタイムの Smartsheet データに対してクエリを実行したり、コードを書いたりできるようになります。

cdatacli query sql --connection my_smartsheet_connection --sql "SELECT * FROM Sheet_Event_Plan_Budget"


CData CLI でターミナルから直接 Smartsheet データをクエリする

Codex CLI と CData CLI を組み合わせれば、カスタムのミドルウェアやスケジュール同期、各ステップでの手作業なしに、AI コーディングエージェントがリアルタイムの Smartsheet データへ直接アクセスできる道筋が手に入ります。やりたいことを伝えるだけで、エージェントがドライバーの構成、接続のセットアップ、クエリの実行までをターミナル上で最初から最後まで処理します。

無料の CData CLI をダウンロードして、CData JDBC Driver for Smartsheet の 30 日間無償トライアルを今日から始めましょう。

はじめる準備はできましたか?

Smartsheet Driver の無料トライアルをダウンロードしてお試しください:

 ダウンロード

詳細:

Smartsheet Icon Smartsheet JDBC Driver

Java/J2EE アプリケーションからSmartsheet データへの連携機能を実装して、Contacts、Folders、Groups、Users などのデータをアプリから利用。