v1.2adapters/sqlite
Tile.JS
Tile.JS
Adapters

Adapter padrão (BSON local)

Use o adapter local em BSON com persistência automática em .tile/database.

Adapter padrão (BSON local)

O adapter padrão é a forma mais simples de usar o Tile Database.

Ele já vem junto com @tile.js/database, grava documentos em BSON, mantém metadados em JSON e não exige nenhuma dependência externa.

Uso implícito ou explícito

import { Database } from "@tile.js/database";

const database = new Database({
  dbName: "app",
});
import { Database, defaultAdapter } from "@tile.js/database";

const database = new Database({
  storage: defaultAdapter({
    dbName: "app",
    storage: "workspace",
    compression: false,
  }),
});

Configuração do adapter

Prop

Type

Onde os arquivos ficam

_schema.json
_collection_index_email.json
68526dba05db8ec36dcb33d8.bson

workspace vs global

workspace

Salva os dados em process.cwd()/.tile/database/<dbName>.

É a opção ideal para aplicações, APIs e projetos onde os dados precisam acompanhar o diretório atual do app.

global

Salva os dados em ~/.tile/database/<dbName>.

É útil para CLIs, ferramentas de linha de comando e cenários onde você quer compartilhar a mesma base entre múltiplos projetos do mesmo usuário.

Índices e metadados

  • cada campo com unique: true gera um índice local em JSON
  • o schema descrito é salvo em _schema.json
  • o adapter prepara a collection automaticamente na primeira utilização

Flush e encerramento do processo

O adapter local acumula operações de escrita/remoção e faz flush assíncrono. Chamar database.disconnect() é a forma mais segura de garantir persistência antes do encerramento da aplicação.

Quando usar

  • protótipos e MVPs
  • CLIs e automações
  • apps locais ou embarcadas
  • testes de integração sem depender de um banco remoto

Próximo passo

On this page