Guia oficial · release atual

Seu primeiro banco, sem adivinhar etapas.

Siga uma única sequência: instalar o OtsarDB, configurar o acesso ao seu storage S3-compatible, definir o endereço do banco e executar SQL.

01, 05instalar / configurar / usar
Release disponível agoraWindows x64 · versão publicada na release

Ubuntu 24.04 ainda não possui pacote publicado. Não há comando de instalação Linux oficial nesta release.

Caminho recomendado

Windows x64 + qualquer storage S3-compatible

Este é o procedimento oficial para o pacote que existe hoje. Você não inicia um servidor: o primeiro comando SQL cria o banco no storage informado.

01

Instalar

Baixe e extraia o OtsarDB

Abra o PowerShell e execute exatamente os comandos abaixo. Ele consulta as releases públicas e baixa o pacote Windows publicado; a variável $otsardb guarda o caminho do executável nesta janela.

PowerShell
$release = Invoke-RestMethod "https://api.github.com/repos/notrevetecnologia/otsardb/releases" | Where-Object { -not $_.draft } | Select-Object -First 1
$package = $release.assets | Where-Object { $_.name -match "windows" } | Select-Object -First 1

if (-not $package) { throw "Pacote Windows não publicado na release atual." }

$installDir = "$env:LOCALAPPDATA\OtsarDB"
$archive = Join-Path $env:TEMP $package.name

New-Item -ItemType Directory -Force -Path $installDir | Out-Null
Invoke-WebRequest -Uri $package.browser_download_url -OutFile $archive
Expand-Archive -Path $archive -DestinationPath $installDir -Force

$otsardb = "$installDir\otsardb.exe"
& $otsardb --version
>
Resultado esperadoOtsarDB + versão publicada
02

Conexão

Informe endpoint, região e credenciais

Este é o método universal do OtsarDB. Troque os quatro valores pelos dados fornecidos pelo seu provedor. Os comandos salvam as variáveis para o usuário do Windows e também as ativam na janela atual.

PowerShell · configuração universal
$settings = @{
  OTSARDB_S3_ENDPOINT   = "https://s3.us-east-1.amazonaws.com"
  OTSARDB_S3_REGION     = "us-east-1"
  OTSARDB_S3_ACCESS_KEY = "SUA-ACCESS-KEY"
  OTSARDB_S3_SECRET_KEY = "SUA-SECRET-KEY"
}

foreach ($name in $settings.Keys) {
  [Environment]::SetEnvironmentVariable($name, $settings[$name], "User")
  Set-Item -Path "Env:$name" -Value $settings[$name]
}
AWS S3https://s3.us-east-1.amazonaws.comregion: us-east-1
Cloudflare R2https://ACCOUNT_ID.r2.cloudflarestorage.comregion: auto
Outro compatívelcopie o endpoint do painel do provedoruse a região informada pelo provedor
Onde fica configuradoVariáveis de ambiente do usuário do Windows
03

Endereço

Escolha o bucket e o nome do banco

Crie o bucket no painel do seu provedor antes de continuar. O trecho depois do bucket é o nome lógico do banco. Neste exemplo, o banco será apps/primeiro-banco.

PowerShell
$bucket = "troque-por-um-bucket-seu"
$database = "s3://$bucket/apps/primeiro-banco"

& $otsardb --health $database
$bucketbucket que já existe no provedor
$databaseendereço completo do banco
04

Criar o banco

Execute o primeiro SQL

OtsarDB não usa init e não inicia um servidor. O primeiro CREATE TABLE abre ou cria o banco no endereço definido acima.

PowerShell · CREATE
& $otsardb $database `
  "CREATE TABLE IF NOT EXISTS users (
    id INTEGER PRIMARY KEY,
    name TEXT NOT NULL,
    email TEXT NOT NULL
  );"
Banco criado. Se o comando terminar sem erro, a tabela foi persistida no object storage.
05

Usar o banco

Insira, consulte, altere e remova

Todos os comandos usam o mesmo $database. Cada execução abre o banco, executa o SQL e publica o estado durável.

PowerShell · INSERT / SELECT / UPDATE / DELETE
# INSERT
& $otsardb $database `
  "INSERT INTO users(name, email)
   VALUES('Ana', 'ana@example.com');"

# SELECT
& $otsardb $database `
  "SELECT id, name, email FROM users;"

# UPDATE
& $otsardb $database `
  "UPDATE users
   SET email = 'ana@otsardb.org'
   WHERE id = 1;"

# DELETE
& $otsardb $database `
  "DELETE FROM users WHERE id = 1;"
O SELECT imprime1|Ana|ana@example.com

Modelo mental

Executável + credenciais + endereço + SQL.

É só isso. As credenciais identificam quem acessa o S3; o endereço identifica qual banco abrir; o SQL define o que fazer.