본문으로 건너뛰기
아우라베이스 로고
아우라베이스

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()는 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 녹#

terminalbash
# 프로젝트 스키마에서 Deserialize/Serialize 구조체 및 열거형을 생성합니다.
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 스타일 청크

더 나아가려면#