跳转到主要内容
本页中的功能处于预览阶段:其 API 并不稳定,声明这些功能的扩展程序需要 vsql_allow_preview_extensions = ON 才能安装。有关如何启用预览层和注册功能,请参阅预览功能。 列存储允许扩展直接向 InnoDB 注册自定义的磁盘布局,用于其自定义类型之一,而不是将该类型的数据通过行的 VARBINARY 负载进行路由。当您的类型需要一种 VARBINARY 无法表达的磁盘布局时,请使用它——例如,必须存储在专用页中的打包浮点数组。这是一个功能特性:它启用了新的存储布局,而不是用于现有布局的调整旋钮。
列存储是一个预览版 ABI——正在积极开发中,并且可能在不同版本之间发生变化。它目前仅涵盖行级持久性;自定义存储的列只接受自定义索引,普通索引会被拒绝,错误为 ERROR 3219 (HY000): InnoDB: Indexing for types with column storage is supported only with custom index.

声明功能

两个预览功能协同工作:
  • 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 使用这些字节范围用于其自身的簿记和校验和。