コンテンツへスキップ
オーラベースのロゴ
オーラベース

Rust SDK

aurabase クレート — Tokio/axum/actix 用の型付き非同期クライアント。

リファレンス8 分 読み取りレベル 参照2026/04/15 に改訂

このページは自動翻訳されました。英語版が正式です。

貨物#

Cargo.tomltoml
[dependencies]
aurabase = "0.1"
tokio = { version = "1", features = ["full"] }
serde = { version = "1", features = ["derive"] }
注意

重大な変更は、リリースの 30 日前までに変更ログで発表されます。

デフォルトのクライアント#

src/aurabase.rsrust
use aurabase::AuraClient;
use std::env;

pub fn client() -> AuraClient {
    AuraClient::new(
        &env::var("NEXT_PUBLIC_AURABASE_URL").expect("NEXT_PUBLIC_AURABASE_URL"),
        &env::var("AURABASE_SERVICE_ROLE_KEY").expect("AURABASE_SERVICE_ROLE_KEY"),
        None, // AuraClientOptions (認証ストア)
    )
}

型付き選択#

行タイプは from::<Row>()に与えられます。 order(column, direction) は 2 番目の引数として方向を受け取ります。 execute() は、data が行のリストである AuraResponse を返します。 JavaScript SDK と同様に、HTTP エラーは Errではなく AuraResponse.errorで報告されます。 into_result()? を呼び出して Errに変換します。そうでない場合、 data の unwrap_or_default() は拒否されたキーを空のリストの後ろに隠します。

src/handlers.rsrust
use aurabase::{AuraClient, AuraError};
use serde::{Deserialize, Serialize};

#[derive(Debug, Deserialize, Serialize)]
pub struct Todo {
    pub id: i64,
    pub title: String,
    pub done: bool,
}

pub async fn recent(aura: &AuraClient) -> Result<Vec<Todo>, AuraError> {
    let res = aura
        .from::<Todo>("todos")
        .select("id,title,done")
        .order("created_at", "desc")
        .limit(5)
        .execute()
        .await?
        .into_result()?; // HTTP エラー (無効なキー、 RLS、テーブルがありません…) は「Err」になります。
    Ok(res.unwrap_or_default())
}

aura db 生成 --lang Rust#

terminalbash
# プロジェクト スキーマから逆シリアル化/シリアル化構造体と列挙型を生成します
aura db generate --lang rust > src/aurabase_types.rs

APIはまだまだ進化中#

これらの表面はまだ変更される可能性があります。 Cargo.toml の unstable 機能の背後にある条件付きコンパイル。

  • aura.channel() — WebSocket/SSE クライアント
  • aura.functions.invoke() — エッジ関数呼び出し
  • aura.storage.upload_resumable() — tus スタイルのチャンク

さらに進むには#