本物のPostgreSQL 18
データは、その型、制約、トリガー、関数とともに PostgreSQL 内に存在します。
データベース
すべてのプロジェクト用の実際の PostgreSQL 18 データベース。流暢な SDK を使用してアプリからアクセスでき、行レベルのセキュリティで保護され、独自のスキーマから型指定されます。
import { createClient } from '@aurabase/aurabase-js'const aura = createClient('https://my-project.aurabase.cloud','aura_anon_xxx',)const { data, error } = await aura.db.from('posts').select('id,title,author:authors(*)').eq('published', true).order('created_at', 'desc').limit(10)
含まれるもの
データは、その型、制約、トリガー、関数とともに PostgreSQL 内に存在します。
等価性、範囲、パターン、配列、範囲タイプ、フルテキスト フィルター、順序付け、カウント、ページネーション。
author:authors(*) のような埋め込みを使用して、1 つのリクエストで関連する行をフェッチします。
PostgreSQL 関数をアプリに公開します。セットを返す関数はテーブルのようにフィルター処理します。
auth.uid() を使用して SQL にポリシーを記述し、各ユーザーが自分の行のみにアクセスできるようにします。これらを強制するのはクライアントではなくデータベースです。
スキーマからデータベース型を生成し、型指定された列、挿入、関数の引数を取得します。
pgvector 拡張機能は、類似性検索のためにデータベース イメージに付属しています。
スキーマ上で GraphQL API が必要な場合は、プロジェクトの pg_graphql をオンにします。
プロジェクトのエンジンとして MongoDB を選択します。分離では、行レベルのセキュリティの代わりにドキュメント所有者が使用されます。
仕組み
Studio テーブル エディターまたはプレーン SQL を使用します。
行レベルのセキュリティをオンにし、誰がどの行を参照できるかを記述します。
aurabase-gen を実行して、クライアントのデータベース タイプを取得します。
ユーザーのセッションを使用して、アプリから aura.db.from(…) を呼び出します。
REST API
SDK は、これらのルート上の薄い層です。リクエストごとにプロジェクトの API キーを送信します。
| 方法 | エンドポイント | 説明 |
|---|---|---|
| GET | /v1/db/{table} | フィルター、順序付け、埋め込みを使用して行を読み取ります。 |
| POST | /v1/db/{table} | 1 つまたは複数の行を挿入するか、更新/挿入します。 |
| PATCH | /v1/db/{table} | 行を更新します。 |
| DELETE | /v1/db/{table} | 行を削除します。 |
| POST | /v1/db/rpc/{function} | PostgreSQL 関数を呼び出します。 |
| GET | /v1/db/schema | プロジェクトのテーブルと関数をリストします。 |
| GET | /v1/db/functions | プロジェクトで定義されている関数をリストします。 |
| POST | /v1/db/raw | SQL ステートメントを実行します。サービスロールに予約されています。 |
質問
aura.db.sql() または Studio の SQL エディターを使用できます。匿名ユーザーやサインインしているユーザーは利用できないため、サーバー上に保存しておいてください。 npx aurabase-gen を実行して database.types.ts ファイルを書き込み、そのデータベース タイプを createClient に渡します。 limit() および offset() を使用します。カーソルのページネーションは、MongoDB プロジェクトとネイティブ エンジン パスでのみ使用できます。データを保存する準備はできましたか?
データベースはすべてのプロジェクトに含まれています。クレジットカードは必要ありません。