# HTTP POST経由でSQLを実行
$ curl -X POST "https://abc123-def456-sqlite-1.node-us-1.containers.hoody.com
/api/v1/sqlite/db?db=/data/app.db" \
-d '{
"transaction": [{
"statement": "INSERT INTO orders (product_id, qty) VALUES (42, 3)"
}]
}'
# 結果を含むレスポンス
HTTP/1.1 200 OK
{
"results": [
{
"success": true,
"rowsUpdated": 1
}
]
}
データベースサーバー不要。接続文字列不要。HTTPだけ。
SQLを実行して結果を確認。
SQLクエリ実行、TTL付きキーバリューペア設定、アトミックカウンターインクリメント。
リクエスト
GET /api/v1/sqlite/query
?db=/data/app.db
&sql=U0VMRUNUIHByb2R1Y3RfaWQsIENPVU5UKCopIEZST00gb3JkZXJzIEdST1VQIEJZIHByb2R1Y3RfaWQgTElNSVQgNQ==
# decodes to:
# SELECT product_id, COUNT(*) FROM orders
# GROUP BY product_id LIMIT 5
結果（5行）
| product_id | COUNT(*) |
|---|---|
| 1 | 42 |
| 2 | 38 |
| 3 | 27 |
| 4 | 19 |
| 5 | 11 |
事前計算済みの例の結果。product_idでグループ化したSELECTクエリ。
クエリ結果がチャートになる。
SQLクエリを実行し、即座に結果をチャート化。Base64 URLで共有可能。ドキュメントに埋め込み可能。
製品別注文数
例: SELECT product_id, COUNT(*) FROM orders GROUP BY product_id
KV操作（ops/秒）
例: 24時間のSETとGET操作スループット
共有可能なクエリURL
GET /api/v1/sqlite/query?db=/data/app.db&sql=U0VMRUNUIFN1bShjb3VudCkgRlJPTSBvcmRlcnM=
任意のSELECト文をBase64エンコードして読み取り専用クエリURLを共有。誰でもブラウザで結果を確認可能。
NoSQLの速度。SQLの信頼性。
アトミック操作、バッチ更新、タイムトラベル履歴 — すべてSQLiteに支えられています。
アトミックインクリメント
競合状態なしでカウンターをインクリメント。複数の同時リクエストが正しくシリアル化される。
POST /api/v1/sqlite/kv/views:homepage/incr
{ "key": "views:homepage", "value": 6, "previous": 5 }
100キーのバッチ
1回のアトミックHTTPリクエストで最大100キーをget、set、deleteする。すべての操作が成功するかすべてが失敗。
POST /api/v1/sqlite/kv/batch/set
{ "items": [{ "key": "user:1", "value": "Alice" }] }
TTL自動有効期限
任意のキーにTTLを設定すると期限切れ時に自動削除。セッション、キャッシュ、一時データに最適。
PUT /api/v1/sqlite/kv/session:abc?ttl=3600
{ "status": "ok", "key": "session:abc", "created": true }
タイムトラベル履歴
すべてのキー変更が記録される。履歴を表示し、任意のタイムスタンプでスナップショット値を取得、またはロールバック。
GET /api/v1/sqlite/kv/config:timeout/history
{ "operations": [{ "op_number": 12, "op_type": "set" }], "total": 12 }
HTTPが接続文字列を上回る。
Hoody SQLiteは従来のデータベースサーバーの運用オーバーヘッドを排除します。
| 機能 | HTTP経由のHoody SQLite | Postgres |
|---|---|---|
| サーバーインストール | 不要 | サーバープロセス |
| 接続文字列 | URLだけ | ホスト/ポート/ユーザー/パスワード |
| 言語ドライバー | 任意のHTTPクライアント | pg, mysql2 |
| AIエージェントアクセス | ネイティブHTTP | ドライバーが必要 |
| タイムトラベル | 組み込みKV履歴 | 手動マイグレーション |
| アトミックKV操作 | incr/decr/push/pop | アプリレベルのみ |
| 共有可能URL | Base64 GET | 利用不可 |
| 同時コンテナ | SQLite Drive FUSE | サービスごとのプール |
エンドポイント 23。HTTP 上の SQL と KV。
完全な SQL トランザクション、Key-Value の CRUD、アトミック操作、バッチ操作、タイムトラベル——すべて素の HTTP で。SDK は不要です。
SQL 操作
3 エンドポイントPOST https://abc123-def456-sqlite-1.node-us-1.containers.hoody.com/api/v1/sqlite/db
KV Core
5 エンドポイントGET https://abc123-def456-sqlite-1.node-us-1.containers.hoody.com/api/v1/sqlite/kv/{key}
アトミック & バッチ
5 エンドポイントPOST https://abc123-def456-sqlite-1.node-us-1.containers.hoody.com/api/v1/sqlite/kv/{key}/incr
バッチ操作
3 エンドポイントPOST https://abc123-def456-sqlite-1.node-us-1.containers.hoody.com/api/v1/sqlite/kv/batch/set
タイムトラベルと履歴
10 エンドポイントGET https://abc123-def456-sqlite-1.node-us-1.containers.hoody.com/api/v1/sqlite/kv/{key}/history
ヘルス & ドキュメント
4 エンドポイントGET https://abc123-def456-sqlite-1.node-us-1.containers.hoody.com/api/v1/sqlite/health
データベースが必要とするすべて。それ以外は何もない。
完全なデータベースツールキット：SQLトランザクション、キーバリューストア、アトミック操作、チャート化。
WebデータベースUI
ブラウザのビジュアルSQLクエリインターフェース。クエリ実行、スキーマ閲覧、結果チャート化。
SQLトランザクション
HTTP POST経由でアトミックSQLトランザクションを実行。複数ステートメント、パラメーター化クエリ。
キーバリューストア
SQLiteでのNoSQLスタイルGET/SET/DELETE操作。設定、セッション、キャッシュに最適。
アトミック操作
スレッドセーフなincr、decr、push、pop。競合状態なし。高並行性でも正確に動作。
バッチ操作
1回のアトミックリクエストで最大100キーをget・setする。全成功か全失敗のセマンティクス。100倍の速度向上。
SQLite Drive FUSE
マルチコンテナアクセスのため/hoody/databases/にデータベースを保存。同時書き込み安全なWALモード。