データベースコードの大部分が人間ではなく AI エージェントによって書かれる世界が到来しつつあります。これはすでに現実のものとなっています。開発者は Claude、Copilot、Cursor などのツールに SQL の作成を依頼し、エージェントは一見正しそうなコードを生成します。従来のデータベースであれば、そのコードは通常正しく動作します。

しかし、ストリーミングデータベースにおいてはそうではありません。

AI エージェントは、学習データを通じて膨大な量のバッチ SQL を見てきました。彼らは PostgreSQL、MySQL、SQLite を熟知しています。しかし、ストリーミング SQL は異なります。セマンティクスもアーキテクチャも異なります。そして、その間違いは非常に巧妙です。クエリ自体は正しくパースされ実行されるものの、バックグラウンドで密かにデータを重複させたり、イベントを見逃したり、あるいは結果を一切出力しないようなパイプラインが構築されてしまうのです。

私たちは、この問題を根本から解決することにしました。より良いドキュメントを書いてエージェントが見つけてくれるのを待つのではなく、AI エージェントがすでに活動している場所に直接届く 3 つのツールを構築しました。

The Cloud CLI That Distributes Knowledge

RisingWave Cloud CLI (rwc) は、当初はクラスターの管理、認証設定、スナップショットの作成などを行うシンプルなインフラストラクチャツールとして始まりました。しかし、私たちは CLI こそがすべての RisingWave Cloud ユーザーがすでにインストールしている唯一のツールであることに気づきました。そこで、これを知識の配信チャネルへと進化させました。

rwc skill install --target claude-code

コマンド一つで、あなたの AI コーディングアシスタントが RisingWave を理解するようになります。リポジトリをクローンしたり、設定ファイルを編集したり、ドキュメントをブックマークしたりする必要はありません。知識はツールと共に移動します。

これが重要なのは、開発者ツールにおける最大の課題はツールを作ることではなく、それを開発者のワークフローに組み込んでもらうことだからです。CLI はすでにそこに存在していたのです。

Teaching Agents What LLMs Cannot Learn From Training Data

RisingWave Agent Skills は知識そのものです。これは、AI エージェントがコンテキストウィンドウに読み込むための、構造化されたリファレンスドキュメントのオープンソースパックです。

なぜこれが必要なのでしょうか？それは、LLM が学習してきたデータの中で、ストリーミング SQL が占める割合はごくわずかだからです。エージェントが RisingWave に遭遇すると、自分が知っているバッチ SQL のパターンに当てはめようとします。その結果は予測可能です。

CREATE SOURCE と書くべきところで CREATE TABLE を書き、TUMBLE が適切な場面で date_trunc を使用します。CDC を設定する際、一つの接続を共有するのではなく、ソースごとにテーブルを作成してインジェストコストを重複して発生させてしまいます。ウォーターマーク（watermark）の設定を忘れ、なぜタイムウィンドウが閉じないのかと頭を悩ませることになります。

これらはエージェントがデバッグできるようなバグではありません。コードの最初の一行に組み込まれたアーキテクチャ上の間違いなのです。

このスキルパックには、スキーマ設計、マテリアライズド・ビュー、ストリーミング SQL パターン、シンク（sink）設定、パフォーマンス最適化にわたる 14 のルールが凝縮されています。各ルールは、私たちがさまざまなコードベースで異なるエージェントが同じ間違いを繰り返すのを見てきた経験に基づいています。これらはオープンな Agent Skills specification に準拠しており、Claude Code、Cursor、GitHub Copilot、Windsurf、Gemini CLI、その他 18 以上のツールで動作します。

Giving Agents Eyes Into Your Database

静的な知識は必要ですが、十分ではありません。正しいパターンを知っているエージェントであっても、実際のスキーマや既存のマテリアライズド・ビュー、クラスターの状態を見ることはできません。

RisingWave MCP Server はこのギャップを埋めます. Model Context Protocol を通じて AI エージェントを稼働中の RisingWave インスタンスに直接接続し、クエリ、スキーマ検査、DDL 操作、ストリーミングジョブの監視、クラスター管理のための 100 以上のツールを提供します。

その違いは明確です。MCP Server がなければ、エージェントはすでに存在するマテリアライズド・ビューと重複するものを提案するかもしれません。しかし MCP Server があれば、エージェントは既存のビューを検査し、ソーススキーマを確認し、仮想的なシステムではなく実際のシステムに適合する SQL を書くことができます。

VS Code Copilot や Claude Desktop と統合されており、STDIO と HTTP の両方のトランスポートをサポートしています。

Three Layers, One Workflow

Layer	Tool	What it does
Infrastructure	`rwc` CLI	クラスターのプロビジョニング、認証管理、エージェント知識の配信
Knowledge	Agent Skills	正しいストリーミング SQL パターンをエージェントに学習させる
Live Access	MCP Server	データベースへのリアルタイムな可視性をエージェントに提供する

これらのツールは独立しており、個別に利用することも可能です。しかし、これらは連携するように設計されています。CLI がスキルをインストールし、スキルがエージェントの考え方を教え、MCP Server がエージェントに実際の状況を見せます。

Why This Matters Now

AI エージェントがどのようにストリーミング SQL を書くかを形作るチャンスは、今この瞬間にあります。今日確立されたパターンは、将来これらのエージェントが触れるすべてのコードベースで強化されていくでしょう。もしエージェントが間違ったパターンを学べば、そのパターンが拡散してしまいます。正しいパターンを学べば、AI アシスタントを使用するすべての開発者がその恩恵を受けることができます。

私たちがこれらのツールを構築しているのは、AI が生成するストリーミングコードの品質が、開発者のストリーミングシステムに関する専門知識に依存すべきではないと考えているからです。エージェント自身が何をすべきかを知っているべきなのです。それが私たちの目指すスタンダードです。

3 つのツールはすべてオープンソースであり、無料で利用できます：

Cloud CLI -- rwc をインストールして始めましょう
Agent Skills -- あなたの AI アシスタントにストリーミング SQL を教えましょう
MCP Server -- エージェントをライブインスタンスに接続しましょう

FAQ

これらのツールを使用するには RisingWave Cloud が必要ですか？ rwc CLI のみ Cloud アカウントが必要です。Agent Skills と MCP Server は、オープンソースのセルフホスト版を含む、あらゆる RisingWave デプロイメントで動作します。

どの AI コーディングアシスタントがサポートされていますか？ Agent Skills は Claude Code、Cursor、GitHub Copilot、Windsurf、Gemini CLI、その他 18 以上のツールで動作します。MCP Server は、あらゆる MCP 対応クライアントで動作します。

Agent Skills に貢献することはできますか？ はい。Agent Skills と MCP Server のリポジトリはどちらもオープンソースです。コミュニティからの貢献を歓迎します。