NOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Veja o changelog →

Banco de dados

PostgreSQL, a uma linha digitada de distância.

Um verdadeiro banco de dados PostgreSQL 18 para cada projeto, acessível a partir de seu aplicativo com um SDK fluente, protegido por segurança em nível de linha e digitado a partir de seu próprio esquema.

16
Versão PostgreSQL
2
motores: 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)

O que está incluído

Um banco de dados com o qual seu aplicativo pode se comunicar. Sem escrever uma API.

Motor

PostgreSQL 18 real

Seus dados residem no PostgreSQL, com seus tipos, restrições, gatilhos e funções.

Construtor de consultas

Consultas fluentes e digitadas

Filtros de igualdade, intervalo, padrão, matriz, tipo de intervalo e texto completo, ordenação, contagem e paginação.

Relações

Incorporações

Busque linhas relacionadas em uma solicitação com uma incorporação como autor:autores(*).

Funções

Chamar funções com rpc()

Exponha as funções do PostgreSQL ao seu aplicativo. Funções que retornam conjuntos filtram como tabelas.

Segurança

Segurança em nível de linha

Escreva políticas em SQL com auth.uid() para que cada usuário alcance apenas suas próprias linhas. O banco de dados os aplica, não o cliente.

Tipos

Tipos TypeScript gerados

Gere um tipo de banco de dados a partir do seu esquema e obtenha colunas digitadas, inserções e argumentos de função.

IA

Vetores com pgvector

A extensão pgvector acompanha a imagem do banco de dados, para pesquisa de similaridade.

Ativar

GraphQL por projeto

Ative pg_graphql para um projeto quando desejar uma API GraphQL em seu esquema.

Motor alternativo

MongoDB, se você preferir documentos

Escolha MongoDB como mecanismo para um projeto. O isolamento então usa proprietários de documentos em vez de segurança em nível de linha.

Como funciona

De uma tabela a uma consulta digitada.

  1. 1

    Crie uma tabela

    Use o editor de tabelas do Studio ou SQL simples.

  2. 2

    Adicionar uma política

    Ative a segurança em nível de linha e descreva quem pode ver quais linhas.

  3. 3

    Gerar tipos

    Execute aurabase-gen para obter um tipo de banco de dados para seu cliente.

  4. 4

    Consulta

    Chame aura.db.from(…) do seu aplicativo, com a sessão do usuário.

API REST

Prefere HTTP simples? Está tudo aqui.

O SDK é uma camada fina sobre essas rotas. Envie a chave API do seu projeto com cada solicitação.

MétodoPonto finalDescrição
GET/v1/db/{table}Leia linhas, com filtros, ordenação e incorporações.
POST/v1/db/{table}Insira uma ou várias linhas ou faça upsert.
PATCH/v1/db/{table}Atualizar linhas.
DELETE/v1/db/{table}Exclua linhas.
POST/v1/db/rpc/{function}Chame uma função PostgreSQL.
GET/v1/db/schemaListe as tabelas e funções do projeto.
GET/v1/db/functionsListe as funções definidas no projeto.
POST/v1/db/rawExecute uma instrução SQL. Reservado para a função de serviço.

Perguntas

É bom saber.

Este é o verdadeiro PostgreSQL?+
Sim. Os projetos executam o PostgreSQL 18 com a extensão pgvector, para que seu SQL, restrições, gatilhos e funções funcionem como foram escritos.
Como mantenho os usuários longe dos dados uns dos outros?+
Habilite a segurança em nível de linha em uma tabela e escreva uma política que compare uma coluna com auth.uid(). O banco de dados aplica-o a todas as solicitações feitas com o token de um usuário.
Posso executar SQL bruto?+
Sim, com a função de serviço, através de aura.db.sql() ou do editor SQL no Studio. Ele não está disponível para usuários anônimos ou conectados, portanto mantenha-o no servidor.
Recebo tipos TypeScript para minhas tabelas?+
Sim. Execute npx aurabase-gen para gravar um arquivo database.types.ts e, em seguida, passe seu tipo de banco de dados para createClient .
Como paginar os resultados?+
Use limit() e offset() . A paginação do cursor está disponível apenas em projetos MongoDB e no caminho do mecanismo nativo.
O que muda com o MongoDB?+
Não há segurança em nível de linha. As leituras dos usuários conectados são filtradas para os documentos de sua propriedade, e os documentos criados com a função de serviço não têm proprietário, portanto, os usuários não podem vê-los.

Pronto para armazenar dados?

Seu banco de dados está a um projeto de distância.

Um banco de dados está incluído em cada projeto. Não é necessário cartão de crédito.