データベース
PostgreSQL 18、組織のクラスター上のプロジェクトごとの専用データベース、分離スキーマ、自動生成された TypeScript タイプ、ネイティブ RLS。フォークや書き換えプロキシは必要ありません。拡張機能、トリガー、PL/pgSQL はそのまま動作します。
Postgres 18、抽象化なし#
aura-db サービスは、PostgreSQL 18 の上に汎用 CRUD を公開します。各プロジェクトには、組織の PostgreSQL クラスター (エンタープライズ オファーの単一プロジェクト専用のクラスター) でホストされる独自のデータベースがあります。各 SDK 呼び出しは、セッションに挿入された RLS policies を尊重するシンレイヤーを介してネイティブ SQL に変換されます。
SDK をバイパスして、データベースで psql、Prisma、Drizzle、Kysely、Metabase、または pg_dump を指定することもできます。これは、標準の PostgreSQL ワイヤー プロトコル、TLS、プロジェクトのデータベースにのみ到達できるロールです。以下の 直接接続 を参照してください。 (PostgreSQL ポートを公開しないデプロイメントでは、Studio › 設定 › 接続: SDK、REST API、SQL エディター、または CLI の aura db rawを使用してください。)
pg_dump は、完全なデータベース (スキーマ、データ、拡張機能、ポリシー) を提供します。ロックインがなく、アウトバウンド移行も簡単です。
SDK は PostgRESTを呼び出し、これにより Postgres が呼び出されます。#
内部では、SDK は .from().select()… 呼び出しを PostgREST サイドカーに委任する aura-db への HTTP リクエストにシリアル化します。 PostgREST は SQL に変換され、PgBouncer を介して、注入されたプロジェクトの search_path とのプールされた接続を開きます。
SDK → HTTPS GET /v1/db/sensors?select=id,name
Gateway → aura-db Session verification & routing
aura-db → PgBouncer → PostgreSQL 18
# search_path プロジェクトとの接続
SET LOCAL search_path = project_a7f3_, public;
SET LOCAL request.jwt.claims = '{ "sub": "u_9k2", "tenant": "t_4c" }';
SELECT id, name, temperature FROM sensors WHERE active = true LIMIT 50;
RLS ポリシーは、 auth.uid()、 auth.role()、 auth.tenant()にアクセスできます。これらのヘルパーは、ゲートウェイによって挿入された request.jwt.claims を読み取ります。クライアント側で改ざんすることは不可能です。
6つのネイティブアビリティ#
- プロジェクトごとのスキーマ。 PostgreSQLによって適用されるパーティション化: tenant_id 列なし、プロジェクトごとに 1 つの接続ロール、権限は PUBLIC に開かれることはありません。
- バージョン管理された移行。 バージョン管理された SQL、アトミック ロールバック、ゼロ ダウンタイム。 TypeScript タイプは移行のたびに再生成されます。
- コード生成 TypeScript および Rust。 ライブ スキーマからのテーブル、ビュー、列挙型、および RPC 関数の型の自動生成。
- ネイティブ RLS。 テスト可能な宣言型ポリシー。 SDK は、クレーム テナントを各接続に挿入します。
- 許可リストに登録された拡張機能。 プロジェクトの作成時にプラットフォームによってインストールされる 14 個の拡張機能:
pgvector、pgcrypto、uuid-ossp、pg_trgm、pg_graphql、pg_stat_statements、citext、hstore、ltree、unaccent、btree_gin、btree_gist、fuzzystrmatch、intarray。 - データベースのブランチ。
aura branch createは、プロジェクト (スキーマ、ポリシー、関数、トリガー、ビュー、行) を独自の URL とキーを持つ新しいプロジェクトにコピーし、存続期間が経過すると自動的に削除されます。ライブレプリカではなく、作成時に作成されるコピー。
CRUD が完了し、入力されました#
4 つの基本操作は同じ .from(table)表面を共有します。返される型はスキーマから推論されます。IDE を開くと、オートコンプリートが列、結合、戻り値で機能します。
// 最近の 50 個のアクティブなセンサーをリストします。
const { data, error } = await aura
.from('sensors')
.select('id, name, temperature, location!inner(city)')
.eq('active', true)
.order('captured_at', { ascending: false })
.limit(50)
より複雑な SQL が必要ですか? Postgres 関数を作成し、 aura.rpc('function_name', args)経由で呼び出します。関数はテーブルと同じ RLS ポリシーの恩恵を受けます。
ホワイトリストに登録された 14 個の拡張機能が用意されています#
14 個のホワイトリストに登録された拡張機能、すべての新しいプロジェクトで使用可能
プラットフォームは、プロジェクトの作成時にそれらをインストールします (プロジェクト ロールは CREATE EXTENSION 自体を実行できないため、忘れるアクティベーション手順はありません)。 aura db extensions list または Studio › データベース › 拡張機能でインストールされるものをリストします。 aura db extensions enable <name> および POST /v1/db/{project_id}/schema/extensions は、許可されたものを再適用します。
- pgvector (
vector) - pg_graphql ( GraphQLを有効にするときにインストールされます)
- pg_stat_statements
- pgcrypto
- uuid-ossp
- pg_trgm
- citext
- hストア
- lツリー
- アクセントのない
- btree_gin
- btree_gist
- ファジーストラマッチ
- インアレイ
postgis、 pg_cron、 timescaledb、 pgmq、および pg_partman は、標準マネージド イメージにはバンドルされていません。スケジュールされたワークロードの場合、 Cronの cron スケジュールでエッジ関数をトリガーします。この変更前に作成されたプロジェクトには、プラットフォームが次のスキーマ更新を実行するまで、5 つの過去の拡張機能 (vector、 pgcrypto、 uuid-ossp、 pg_trgm、 pg_graphql) のみが含まれます。他のものはデータベース オペレータだけがインストールできるため、自分で追加することはできません。
直接接続: psql、Prisma、Drizzle、pg_dump#
各プロジェクトには、独自の PostgreSQL ログイン ロール (proj_xxxxxxxx) と、ポート 5432 上の <project-slug>.db.<your-domain> 形式のホストがあります。パスワードはオンデマンドで発行され、一度表示されます。プラットフォームはパスワードを暗号化しないので、失われたパスワードは置き換えられ、回復されることはありません。
# リンクされたプロジェクトのホスト、ポート、データベース、役割 (パスワードなし)
aura db connection
# パスワードを発行し、完全な接続文字列を出力します (以前のパスワードを取り消します)。
aura db connection --new-password
# psql を開きます (psql はパスワードを要求します)
aura connect
aura db connection --new-password は、どこにでも貼り付けることができる文字列を出力します。
postgresql://proj_ef13db60:<password>@my-app-ab12cd34.db.example.com:5432/project_694efb7f_...?sslmode=require
同じカードが Studio › 設定 › 接続 › データベース (パスワードの生成 / パスワードのリセット) に存在します。
- TLS が必要です。 エンドポイントは平文接続 (
sslmode=require) を拒否します。ローカル k3d スタックでは証明書は自己署名 (*.db.localhost) であるため、仕様によりそこでsslmode=verify-fullは失敗します。実稼働環境では、*.db.<your-domain>に対して発行された証明書が使用されます。 - プロジェクトに限定されます。 ルーターはロール名からデータベースを選択し、それを強制します。別のデータベース名を要求しても依然としてデータベース名が使用され、別のプロジェクトのホストでロールを提示することは拒否されます。あなたの役割はスーパーユーザーではないため、 RLSをバイパスしません。テーブル所有者として移行を実行するには、
BEGIN; SET LOCAL ROLE tenant_<project-uuid>_admin; …; COMMIT;を使用します。 - ここで作成するテーブルはプラットフォームに対してプライベートです。 行レベル セキュリティは、この接続経由で作成されたテーブル (PostgreSQL スーパーユーザーが必要ですが、マネージド プロジェクトが公開することはありません) に対して自動的に切り替えることができないため、公開キーにはそのテーブルに対する特権が与えられません。REST API は anon キーとサインイン ユーザーに対して
permission deniedで応答しますが、service_roleキー、Studio および独自のロールはその読み取りと書き込みを行います。これを SDK に公開するには、 RLSを有効にして付与し、ポリシーを追加します (行レベル セキュリティを参照):ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT ON posts TO aura_anon; CREATE POLICY …。 PostgREST は、NOTIFY pgrst, 'reload schema'を実行すると新しいテーブルについて学習します。このルールが存在する前にこの接続を介して作成されたテーブルは、すでに RLS が有効になっている場合を除き、次回パスワード (aura db connection --new-password) を発行したときに閉じられます。 - トランザクション プーラー。 接続はトランザクション モードで PgBouncer を経由します。セッション状態は、あるトランザクションから次のトランザクションに引き継がれません。トランザクション内で
SET LOCALを使用し、名前付きプリペアド ステートメント、LISTEN、およびセッション レベルの勧告ロックが信頼できないことを予期します (Prisma: URL にpgbouncer=trueを追加します)。 - クライアントのバージョン。
pg_dumpは、それ自体よりも新しいサーバーを拒否します。 PostgreSQL 18 クライアント (pg_dump --version) を使用してください。
直接アクセスは、PostgreSQL ポートを公開する展開によって異なります。これは、ローカル k3d スタックと、Helm 値がそれを有効にするデプロイメント ( ingress-nginx の背後のingress.tcp.enabled または pgproxy.nodePort) に対してオンになります。そうでない場合は、Studio と aura db connection が通知します。