vsql_allow_preview_extensions = ON 才能安装。有关如何启用预览层和注册功能,请参阅预览功能。
列存储允许扩展直接向 InnoDB 注册自定义的磁盘布局,用于其自定义类型之一,而不是将该类型的数据通过行的 VARBINARY 负载进行路由。当您的类型需要一种 VARBINARY 无法表达的磁盘布局时,请使用它——例如,必须存储在专用页中的打包浮点数组。这是一个功能特性:它启用了新的存储布局,而不是用于现有布局的调整旋钮。
声明功能
两个预览功能协同工作:vsql::preview::storage— 开放对 InnoDB 存储基础设施的访问(微事务、段、页)。在文件范围内声明一个StorageCapability。vsql::preview::column_store— 将每个类型的存储实现绑定到扩展的自定义类型之一。在文件范围内使用make_column_store<Ctx>(TYPE).…build()声明一个ColumnStoreCapability。
make_extension() 上的 .with():
make_column_store<MyCtx>(MY_TYPE) 将实现绑定到在同一扩展上注册的一个自定义类型。所有七个槽位都必须在 build() 时提供,因为每个槽位都映射到列生命周期中的一个不同点,InnoDB 在正常操作期间会到达该点。
七个存储函数
每个函数都接受storage::Column::StorageCtx<MyCtx>*,其 user() 访问器返回扩展的每个列状态,并且其 arena() 提供服务器管理的辅助对象分配。每个函数在成功时返回 false,在出错时返回 true,并将消息写入 error_msg(容量 error_msg_len)。服务器会将该消息写入其错误日志;失败的 create 或 insert 会使语句失败,错误为 ERROR 3219 (HY000): InnoDB: Custom type operation failed. See server error log for details.
mark_delete 和 purge 是不同的,因为 InnoDB MVCC 要求已删除的行在 purge 运行之前对旧的快照保持可读。
每个列的上下文和 Arena
C++ SDK 在调用create 或 load 之前,默认构造 MyCtx——在进入您的函数时,ctx->user() 已经填充。MyCtx 必须是默认可构造的;C++ SDK 使用不带参数的 T() 调用。
直接使用 ctx->user() 来初始化状态。不要调用 ctx->arena().construct<MyCtx>()——这将分配第二个、未使用的实例,并且 ctx->user() 不指向它。
load 遵循相同的模式——ctx->user() 预先填充,并且 storage_ref 携带由 ctx->set_ref() 在 create 中存储的打包值:
ctx->arena() 来分配辅助对象,这些对象太大或太动态,无法直接嵌入到 MyCtx 中。C++ SDK 在 drop 返回后,无论 drop 是否成功,都会自动销毁 arena 并调用 ~MyCtx()。
InnoDB 访问实用程序
包含<villagesql/preview/storage_api.h> 以获取 InnoDB 原语。所有页面的读取和写入都必须在微事务中进行:
create 时保留——有关完整的设置模式,请参见上面“每个列的上下文”中的 create 和 load 示例。在 DML 操作期间,从根页面获取段引用以分配新页面:
mtr_ref 传递给写入调用,以便 InnoDB 记录更改:
页面访问器会拒绝位于标头或尾部区域内的偏移量:发布构建版本会跳过该读取或写入,而未定义
NDEBUG 的构建版本会触发 assert 失败。InnoDB 使用这些字节范围用于其自身的簿记和校验和。