Skip to main content
jelou databases provisiona e opera os bancos de dados gerenciados da Jelou. O alias jelou datum funciona em todos os lugares onde jelou databases funciona: mesmos subcomandos, mesmas flags, mesmos exit codes.
Existem dois produtos com o nome “Datum”. O alias jelou datum aponta para o produto atual de Bancos de dados da Jelou (o que esta CLI gerencia). Há um produto de banco de dados legado separado, acessível apenas pelo Studio, que esta CLI não pode administrar.

​
Bancos de dados

databases delete é irreversível: cada coleção, registro e arquivo desaparece, sem lixeira nem rollback. Execute databases show primeiro e confirme a contagem com o usuário.

​
Coleções

collections create aceita --field "<nome>:<tipo>" (repetível, define as colunas) e --type base|view (tipo de coleção; o padrão é base).
collections create é get-or-create: se já existir uma coleção com esse nome e o mesmo esquema, ela é reutilizada e a resposta traz reused: true em vez de falhar. Se existir uma com esse nome mas um esquema diferente, a operação é rejeitada com exit code 2 e um diff campo a campo — ela nunca é modificada silenciosamente.

​
API keys

Cada key é criada com habilidades granulares, combináveis por vírgula: records:read, records:write, records:delete, files:read, files:write. Presets comuns: read_only, read_write, all.
Repetir api-keys create com um nome que já existe não cria uma segunda key: falha com exit code 2 e ALREADY_EXISTS, incluindo details.never_used para você saber se a key existente já foi usada — isso indica se rotacioná-la com api-keys regenerate é seguro.
files:write requer records:write (os arquivos vivem dentro de registros) — a CLI rejeita a combinação localmente. Os tokens levam o prefixo db_ e são exibidos uma única vez ao serem criados: guarde-os imediatamente. api-keys regenerate rotaciona o token imediatamente; qualquer serviço com o token antigo receberá 401 na próxima requisição. Por isso ela pede confirmação antes de executar; em CI ou com --agent é preciso passar --yes explicitamente.

​
Triggers

Webhooks que disparam diante de eventos de uma coleção (create, update, delete). triggers create/update também aceitam --method "<verbo>" (verbo HTTP, padrão POST) e, para eventos update, --update-scope fields --columns "<col1,col2>" para disparar somente quando essas colunas mudarem (o escopo padrão é all).
triggers pause causa perda de dados silenciosa: o destino deixa de receber eventos sem que um erro seja reportado a montante. Sempre mencione resume como caminho de recuperação.