新しいPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2変更履歴を参照 →

データベース

PostgreSQL は 1 行入力できます。

すべてのプロジェクト用の実際の PostgreSQL 18 データベース。流暢な SDK を使用してアプリからアクセスでき、行レベルのセキュリティで保護され、独自のスキーマから型指定されます。

16
PostgreSQLのバージョン
2
エンジン: PostgreSQL、MongoDB
db.tsTS
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)

含まれるもの

アプリが通信できるデータベース。 API を書かずに。

エンジン

本物のPostgreSQL 18

データは、その型、制約、トリガー、関数とともに PostgreSQL 内に存在します。

クエリビルダー

流暢で入力されたクエリ

等価性、範囲、パターン、配列、範囲タイプ、フルテキスト フィルター、順序付け、カウント、ページネーション。

関係

埋め込む

author:authors(*) のような埋め込みを使用して、1 つのリクエストで関連する行をフェッチします。

機能

rpc() で関数を呼び出す

PostgreSQL 関数をアプリに公開します。セットを返す関数はテーブルのようにフィルター処理します。

セキュリティ

行レベルのセキュリティ

auth.uid() を使用して SQL にポリシーを記述し、各ユーザーが自分の行のみにアクセスできるようにします。これらを強制するのはクライアントではなくデータベースです。

種類

生成された TypeScript タイプ

スキーマからデータベース型を生成し、型指定された列、挿入、関数の引数を取得します。

AI

pgvector を使用したベクトル

pgvector 拡張機能は、類似性検索のためにデータベース イメージに付属しています。

オプトイン

プロジェクトごとのGraphQL

スキーマ上で GraphQL API が必要な場合は、プロジェクトの pg_graphql をオンにします。

代替エンジン

MongoDB、ドキュメントを好む場合

プロジェクトのエンジンとして MongoDB を選択します。分離では、行レベルのセキュリティの代わりにドキュメント所有者が使用されます。

仕組み

テーブルから型付きクエリへ。

  1. 1

    テーブルを作成する

    Studio テーブル エディターまたはプレーン SQL を使用します。

  2. 2

    ポリシーを追加する

    行レベルのセキュリティをオンにし、誰がどの行を参照できるかを記述します。

  3. 3

    型を生成する

    aurabase-gen を実行して、クライアントのデータベース タイプを取得します。

  4. 4

    クエリ

    ユーザーのセッションを使用して、アプリから aura.db.from(…) を呼び出します。

REST API

プレーンな HTTP をお好みですか? すべてここにあります。

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/rawSQL ステートメントを実行します。サービスロールに予約されています。

質問

知っておいてよかったです。

これは本物の PostgreSQL ですか?+
はい。プロジェクトは pgvector 拡張機能を備えた PostgreSQL 18 を実行するため、SQL、制約、トリガー、関数は記述どおりに機能します。
ユーザーがお互いのデータにアクセスできないようにするにはどうすればよいですか?+
テーブルの行レベルのセキュリティを有効にし、列を auth.uid() と比較するポリシーを作成します。データベースは、ユーザーのトークンを使用して行われたすべてのリクエストにそれを適用します。
生の SQL を実行できますか?+
はい。サービス ロールを使用すると、 aura.db.sql() または Studio の SQL エディターを使用できます。匿名ユーザーやサインインしているユーザーは利用できないため、サーバー上に保存しておいてください。
テーブルの TypeScript タイプを取得できますか?+
はい。 npx aurabase-gen を実行して database.types.ts ファイルを書き込み、そのデータベース タイプを createClient に渡します。
結果をページ分割するにはどうすればよいですか?+
limit() および offset() を使用します。カーソルのページネーションは、MongoDB プロジェクトとネイティブ エンジン パスでのみ使用できます。
MongoDB では何が変わりますか?+
行レベルのセキュリティはありません。サインインしているユーザーによる読み取りは、そのユーザーが所有するドキュメントにフィルターされます。サービス ロールで作成されたドキュメントには所有者がないため、ユーザーはそれらのドキュメントを表示できません。

データを保存する準備はできましたか?

データベースは 1 プロジェクト離れています。

データベースはすべてのプロジェクトに含まれています。クレジットカードは必要ありません。