vsql_allow_preview_extensions = ON para instalar. Consulte Capabilities Preview para saber como habilitar o nível Preview e registrar uma capability.
O column storage permite que uma extensão registre um layout binário
personalizado em disco diretamente com o InnoDB para um de seus tipos
personalizados, em vez de rotear os bytes do tipo através do payload VARBINARY da
linha. Use-o quando o seu tipo precisa de um formato em disco que o VARBINARY não
consegue expressar — por exemplo, um array compactado de floats que precisa
residir em páginas dedicadas. Este é um recurso de capability: ele habilita novos
layouts de armazenamento, não é um botão de ajuste para os existentes.
Declarando as Capabilities
Duas capabilities Preview trabalham juntas:vsql::preview::storage— abre acesso à infraestrutura de armazenamento do InnoDB (mini-transações, segmentos, páginas). Declare umaStorageCapabilityno escopo do arquivo.vsql::preview::column_store— vincula uma implementação de armazenamento por tipo a um dos tipos personalizados da extensão. Declare umaColumnStoreCapabilityno escopo do arquivo usandomake_column_store<Ctx>(TYPE).…build().
.with() em make_extension():
make_column_store<MyCtx>(MY_TYPE) liga a implementação a um tipo personalizado
registrado na mesma extensão. Todos os sete slots são obrigatórios no momento do
build(), porque cada um mapeia para um ponto distinto no ciclo de vida da
coluna que o InnoDB alcançará durante a operação normal.
As Sete Funções de Armazenamento
Toda função recebestorage::Column::StorageCtx<MyCtx>*, cujo acessador user()
retorna o estado por coluna da extensão e cujo arena() fornece alocação
gerenciada pelo servidor para objetos auxiliares. Toda função retorna false em
caso de sucesso e true em caso de erro, escrevendo uma mensagem em error_msg
(capacidade error_msg_len). O servidor escreve essa mensagem no seu log de erros; um create ou insert que falha
faz a instrução falhar com ERROR 3219 (HY000): InnoDB: Custom type operation failed. See server error log for details.
mark_delete e purge são distintos porque o MVCC do InnoDB requer que as
linhas excluídas permaneçam legíveis por snapshots mais antigos até que o purge
seja executado.
Contexto por Coluna e a Arena
O SDK C++ constróiMyCtx por padrão antes de chamar create ou load —
ctx->user() já está populado quando a sua função é acionada. MyCtx deve ser
construível por padrão; o SDK C++ chama T() sem argumentos.
Use ctx->user() diretamente para inicializar o estado. Não chame
ctx->arena().construct<MyCtx>() — isso aloca uma segunda instância não utilizada
e ctx->user() não aponta para ela.
load segue o mesmo padrão — ctx->user() é pré-populado e storage_ref carrega
o valor compactado armazenado por ctx->set_ref() em create:
ctx->arena() apenas para alocar objetos auxiliares que são grandes demais ou
dinâmicos demais para embutir diretamente em MyCtx. O SDK C++ destrói a arena
(e chama ~MyCtx()) automaticamente após o retorno de drop, independentemente
de drop ter sucesso.
Utilitários de Acesso ao InnoDB
Inclua<villagesql/preview/storage_api.h> para os primitivos do InnoDB. Todas as
leituras e escritas de página devem ocorrer dentro de uma mini-transação:
create — veja os exemplos de
create e load em Contexto por Coluna acima para o padrão completo de
configuração. Durante as operações DML, obtenha uma referência de segmento a
partir da página raiz para alocar novas páginas:
mtr_ref para as chamadas de escrita para que o InnoDB registre a mudança:
Os acessadores de página rejeitam um offset dentro da região de cabeçalho ou de
trailer: um build de release pula a leitura ou a escrita, e um build sem
NDEBUG falha em um assert. O InnoDB usa esses intervalos de bytes para sua
própria contabilidade e checksum.