VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
villagesql. O SDK cuida de todo o marshaling de FFI — você escreve Rust comum, e a macro extension! gera os pontos de entrada em C que o servidor chama no momento do carregamento.
Quando Escolher Rust
Rust é a escolha certa quando:- Você prefere Rust e não precisa de uma base de código em C++
- Você quer segurança de memória sem um garbage collector
- Você está construindo uma nova extensão e não tem nenhuma dependência existente em C++
Pré-requisitos
Você precisa de:- Toolchain estável do Rust — instale em rustup.rs
- cargo-vsql — o subcomando do Cargo para empacotar, instalar e testar
cargo-vsql a partir do repositório do SDK:
Configure um Novo Crate
Crie um crate de biblioteca, adicione o SDK e configure-o:Cargo.toml:
manifest.json ao lado de Cargo.toml:
Escreva uma Função
A página Construindo Extensões em Rust tem o passo a passo completo com o exemplo ROT-13. A versão resumida: implementefn(&[InValue]) -> VdfReturn, registre-a com func! e envolva tudo em extension!:
Teste Sua Extensão
Escreva um teste emmysql-test/t/basic.test:
[ pass ] para cada arquivo de teste.
Instale em SQL
Empacote e instale:Veja também
- Construindo Extensões em Rust — passo a passo completo com o exemplo ROT-13, empacotamento e detalhes de testes
- Tipos Personalizados em Rust — defina novos tipos de coluna com armazenamento binário e ordenação
- Referência da API Rust — InValue, VdfReturn e todas as macros
- Escrevendo Extensões em C++ — o caminho em C++ para a mesma tarefa