Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
As extensões do VillageSQL podem ser escritas em Rust usando o crate 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++
Se você tem uma base de código existente em C++ ou precisa da API de construção de tipos personalizados mais completa disponível hoje, consulte Escrevendo Extensões em C++.
A API é estável para o desenvolvimento de extensões, mas a API de construção de tipos personalizados ainda está amadurecendo.

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
Instale o cargo-vsql a partir do repositório do SDK:

Configure um Novo Crate

Crie um crate de biblioteca, adicione o SDK e configure-o:
Em seguida, defina o tipo do crate em Cargo.toml:
Adicione 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: implemente fn(&[InValue]) -> VdfReturn, registre-a com func! e envolva tudo em extension!:
Para tipos personalizados (armazenamento binário, ordenação, hashing), consulte Tipos Personalizados em Rust.

Teste Sua Extensão

Escreva um teste em mysql-test/t/basic.test:
Defina o diretório de build do seu VillageSQL, gere os resultados esperados e então execute:
Uma execução bem-sucedida imprime [ pass ] para cada arquivo de teste.

Instale em SQL

Empacote e instale:
Em seguida, em SQL:

Veja também