Ridge Integrado API

Use o pacote ridge Grove quando um processo seed for proprietário do banco de dados. O identificador do banco de dados é um recurso somente de movimentação com limpeza determinística.

Aplicação mínima

use "ridge"

fn main() -> result<i64, ridge_error> {
    let mut db = ridge_open("./data/app", 4096 as usize)?
    db.create_table("items", 4096 as usize)?

    let payload = bytes.from("hello").or_abort()
    db.insert("items", 1, payload.view())?

    let found = db.get("items", 1)?
    match found {
        some(row) => print(f"row={row.id}")
        none => print("not found")
    }
    result.ok(0)
}

Execute as verificações atuais do compilador seed antes de copiar um exemplo em um aplicativo:

./seed/seed check path/to/application
./seed/seed test path/to/application

Operações principais

ridge_open / ridge_open_with_cache
db.create_table / db.insert / db.get / db.update / db.delete
db.count / db.scan / db.find_equal / db.create_unique_index
db.begin / db.try_begin / db.transaction_put / db.transaction_delete
db.commit / db.rollback
db.integrity / db.backup / ridge_validate_backup / ridge_restore
db.commit_stats / db.stats

A linha herdada direta API armazena uma chave primária i64 e uma carga útil binária segura. Os pacotes relacional e SQL fornecem linhas de múltiplas colunas digitadas na geração 2. Escolha um caminho de dados coerente para um aplicativo em vez de misturar suposições de visibilidade herdadas e relacionais.

Propriedade e erros

• Trate o banco de dados e os identificadores de transação como recursos próprios.
• Propague ridge_error com ? ou manipule-o explicitamente.
• Mantenha as visualizações de linha e buffer emprestadas dentro de seu escopo léxico válido.
• Nunca duplique ou edite arquivos de armazenamento Ridge enquanto o banco de dados estiver aberto.
• Use APIs de backup e restauração Ridge para cópias consistentes.

Use o seed-lang habilidade junto com ridgedb quando um agente de IA escreve ou revisa .sd código.

Observabilidade

db.commit_stats() retorna por commit WAL, página, cache, split/merge, reutilizar, I/O, sincronização, alocação e contadores de preparo. db.stats() retorna cache cumulativo e estatísticas de buffer de propriedade do mecanismo desde a abertura. Interprete-os como diagnósticos locais, não como telemetria da frota.