跳到内容
光环标志
光环基地

Rust SDK

aurabase crate — Tokio/axum/actix 的类型化异步客户端。

参考8分钟 读取级别 参考修改于 2026年4月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) 将方向作为第二个参数; execute() 返回一个 AuraResponse,其 data 是行列表。与 JavaScript SDK 一样,在 AuraResponse.error中报告 HTTP 错误,而不是在 Err中报告:调用 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 风格的块

为了走得更远#