MySQL 8：通过 DDL 创建 Collections

Question

我希望能够通过简单的 SQL DDL 语句而不是使用 X 协议客户端来创建 MySQL 文档存储 Collections。

有什么办法吗？

编辑：我会尝试澄清这个问题。

Collections 是使用 JSON 数据类型和函数的表。 这很清楚。 我想知道如何在不使用 X-Protocol 调用的情况下创建一个集合，并确保将上述集合作为一个实际的集合。

从 MySQL 工作台来看，收集表有一个带有表达式的 _id blob PK、一个文档 JSON 列和一些我目前不记得的其他元素（可能是索引等）。

我无法通过 Workbench 告诉我们需要什么额外的模式/元数据信息才能将表视为文档存储集合，或者仅存在 _id 和 doc 列是否足够。

我希望这能解决问题。

Answer 1

所有“x-api”指令都直接映射到 sql 语法。 例如，当您运行db.createCollection('my_collection')时， MySQL 只会执行

CREATE TABLE `my_collection` (
  `doc` json DEFAULT NULL,
  `_id` varbinary(32) GENERATED ALWAYS AS
     (json_unquote(json_extract(`doc`,_utf8mb4'$._id'))) STORED NOT NULL,
  `_json_schema` json GENERATED ALWAYS AS (_utf8mb4'{"type":"object"}') VIRTUAL,
  PRIMARY KEY (`_id`),
  CONSTRAINT `$val_strict` CHECK (json_schema_valid(`_json_schema`,`doc`))
      NOT ENFORCED
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci

如果您遵循该格式，您可以自己运行相应的 sql 语句。 doc和_id （及其类型和给定表达式）是必需的， _json_schema是可选的，检查也是（并且仅在 MySQL 8.0.17 之后添加）。 从 MySQL 8 开始，不允许使用其他列，除了生成的列在doc上使用JSON_EXTRACT并且应该在索引中使用，请参见下文（尽管它们实际上不必在索引中使用）。

任何看起来像这样的表 - doc和_id具有正确的类型/表达式，除了可选的_json_schema和生成的JSON_EXTRACT(doc, -columns - 之外没有其他列 - 将使用getCollections()找到。

要添加索引，对应的语法为

my_collection.createIndex("age", {fields: [{field: "$.age", type: "int"}]})

将会

ALTER TABLE `test`.`my_collection` ADD COLUMN `$ix_i_somename` int
      GENERATED ALWAYS AS (JSON_EXTRACT(doc, '$.age')) VIRTUAL, 
   ADD INDEX `age` (`$ix_i_somename`)

明显地，

db.dropCollection('my_collection')

简单地转化为

DROP TABLE `my_collection`

类似地，文档上的所有 CRUD 操作都有相应的 sql DML 语法（当您通过 x-api 使用它们时将实际执行）。