VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
Quando Escolher C++
C++ é a escolha certa quando:- Sua equipe já tem uma base de código em C++ e quer manter a extensão na mesma linguagem
- Você precisa de tipos personalizados com layouts binários precisos (o type builder em C++ é a API mais completa)
- Você está trabalhando com bibliotecas C++ existentes que quer expor como funções SQL
Pré-requisitos
Antes de escrever o código da extensão, você precisa de um build do VillageSQL — as extensões são vinculadas aos headers do SDK e à árvore de build do servidor. Você também precisa de:- Compilador C++17 — GCC 8+, Clang 8+ ou MSVC 2019+
- CMake 3.18+ — o template de extensão usa CMake
Configuração do CMake
A forma mais rápida de começar é com o vsql-extension-template. Faça um fork ou clone-o:CMakeLists.txt do template cuida da configuração de build do VEF para você — copie o template e adapte-o em vez de escrever o CMake do zero. Configure o diretório de build com -DVillageSQL_BUILD_DIR:
-DVillageSQL_BUILD_DIR informa ao CMake onde fica o seu build do VillageSQL para que ele encontre os headers do SDK. Isso produz um arquivo .veb na saída do build. Consulte Criando Extensões e o vsql-extension-template para a configuração completa do CMake.
Uma VDF Mínima em C++
Inclua o header do VEF SDK e use a API de builder para registrar a sua função. Aqui está uma extensão completa que implementa uma função de inversão de string:- Inclua
<villagesql/vsql.h>, não<villagesql/extension.h>(esse é o header antigo da V1) - Os wrappers de argumento tipados (
StringArg,IntArg,RealArg) verificam nulos e expõem valores tipados — sem aritmética de pointer bruta out.set_null(),out.warning(msg)eout.error(msg)são os três retornos que não são de sucessoVEF_GENERATE_ENTRY_POINTSrecebe um buildermake_extension(), não uma struct bruta
.deterministic() à cadeia do builder:
.deterministic() apenas quando isso for realmente verdade.
Compilando
Após a etapa de configuração do cmake da seção de configuração do CMake acima, compile e instale:make install copia o arquivo .veb para o diretório de extensões do seu VillageSQL.
Instalando e Testando
Conecte-se ao VillageSQL e instale a extensão:mysql-test/t/:
Veja também
- Criando Extensões — referência completa do SDK C++: wrappers tipados, tipos personalizados, agregados, variáveis de sistema
- Referência da API de Extensão — contratos de VDF, tratamento de nulos, dimensionamento de buffer, semântica de erros
- Escrevendo Extensões em Rust — o caminho em Rust para a mesma tarefa