bkend-data

bkend.ai データベースガイド

カラムタイプ（7種類）

タイプ	説明	例
String	テキスト	name, email
Number	数値	age, price
Boolean	真偽値	isActive
Date	日時	birthDate
Array	配列	tags: ["a","b"]
Object	ネストされたオブジェクト	address: {city, zip}
Mixed	任意の型	metadata

制約

• required：フィールドに値が必要です
• unique：重複する値は許可されません
• default：値が指定されていない場合のデフォルト値です

自動システムフィールド

フィールド	タイプ	説明
id	String	自動生成される一意の ID
createdBy	String	作成者のユーザー ID
createdAt	Date	作成日時
updatedAt	Date	最終更新日時

重要：bkend のすべての API レスポンスでは、_id ではなく id が使用されます。

MCP テーブル管理ツール

ツール	目的	スコープ
backend_table_create	テーブルを作成	table:create
backend_table_list	テーブル一覧を取得	table:read
backend_table_get	テーブルの詳細とスキーマを取得	table:read
backend_table_delete	テーブルを削除	table:delete
backend_field_manage	フィールドを追加／変更／削除	table:update
backend_index_manage	インデックスを管理	table:update
backend_schema_version_list	スキーマのバージョン履歴	table:read
backend_schema_version_get	スキーマのバージョン詳細	table:read
backend_schema_version_apply	スキーマのバージョンを適用（ロールバック）	table:update
backend_index_version_list	インデックスのバージョン履歴	table:read
backend_index_version_get	インデックスのバージョン詳細	table:read

MCP データ CRUD ツール

ツール	目的	主なパラメーター
backend_data_list	レコード一覧を取得（フィルター、ソート、ページネーション）	tableId, page?, limit?, sortBy?, sortDirection?, andFilters?, orFilters?
backend_data_get	単一のレコードを取得	tableId, recordId
backend_data_create	レコードを作成	tableId, data: { field: value }
backend_data_update	レコードを部分更新	tableId, recordId, data: { field: value }
backend_data_delete	レコードを削除	tableId, recordId

すべてのデータ CRUD ツールには、organizationId、projectId、environmentId（get_context から取得）が必要です。

フィルター演算子

演算子	意味	例
$eq	等しい	{ "status": { "$eq": "active" } }
$ne	等しくない	{ "role": { "$ne": "admin" } }
$gt / $gte	より大きい／以上	{ "age": { "$gt": 18 } }
$lt / $lte	より小さい／以下	{ "price": { "$lt": 100 } }
$in / $nin	配列に含まれる／含まれない	{ "tag": { "$in": ["a","b"] } }

MCP ガイドドキュメント（search_docs 経由）

search_docs ツールを使って、以下のガイドにアクセスできます。

ドキュメント ID	内容
4_howto_implement_data_crud	CRUD の実装パターン
7_code_examples_data	CRUD とファイルアップロードのコード例

get_operation_schema を使用すると、任意のツールの入力／出力スキーマを取得できます。

REST データ API

メソッド	エンドポイント	説明
GET	/v1/data/{table}	一覧を取得（フィルター、ソート、ページ、limit）
POST	/v1/data/{table}	作成
GET	/v1/data/{table}/{id}	単一のレコードを取得
PATCH	/v1/data/{table}/{id}	部分更新
DELETE	/v1/data/{table}/{id}	削除

フィルタリング

• テキスト検索：?search=keyword
• AND フィルター：?filter[field1]=value1&filter[field2]=value2
• 比較演算子：$eq、$ne、$gt、$gte、$lt、$lte、$in、$nin
• ソート：?sort=field:asc（または desc）
• ページネーション：?page=1&limit=20（デフォルトは 20、最大 100）

リレーションと JOIN

• テーブル間のリレーションを設定
• 関連データを取得する JOIN クエリ

インデックス管理

• 単一インデックス／複合インデックスの作成
• MCP の backend_index_manage で管理
• クエリのパフォーマンス最適化に不可欠です

公式ドキュメント（最新の参照先）

最新のデータベースドキュメントは、WebFetch を使用してください。

• MCP データツール：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/mcp/05-data-tools.md
• MCP テーブルツール：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/mcp/04-table-tools.md
• データベースガイド：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/database/01-overview.md
• 目次全体：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md