새로운Publication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2변경 내역 보기 →

데이터베이스

PostgreSQL, 한 줄만 입력하면 됩니다.

모든 프로젝트에 대한 실제 PostgreSQL 18 데이터베이스는 Fluent 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에 있습니다.

쿼리 빌더

유창하고 입력된 쿼리

동등, 범위, 패턴, 배열, 범위 유형 및 전체 텍스트 필터, 순서 지정, 계산 및 페이지 매기기.

관계

삽입

작성자:작성자(*)와 같은 삽입을 사용하여 한 요청에서 관련 행을 가져옵니다.

기능

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}하나 또는 여러 행을 삽입하거나 upsert합니다.
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에는 어떤 변화가 있나요?+
행 수준 보안은 없습니다. 로그인한 사용자가 읽은 내용은 자신이 소유한 문서로 필터링되며, 서비스 역할로 생성된 문서에는 소유자가 없으므로 사용자는 해당 문서를 볼 수 없습니다.

데이터를 저장할 준비가 되셨나요?

귀하의 데이터베이스는 하나의 프로젝트 떨어져 있습니다.

모든 프로젝트에는 데이터베이스가 포함되어 있습니다. 신용 카드가 필요하지 않습니다.