C++使用MySQL XdevAPI插入数据报错：未找到元数据

问题根源 #

直接使用mysqlx::abi2::Row（内部ABI兼容层类）创建的对象没有关联目标表的列元数据，XdevAPI无法识别该Row对应的字段信息，因此插入时会抛出std::out_of_range异常，提示“no meta-data found”。即使手动指定列名，由于Row本身未绑定元数据，依然无法匹配。

可行解决方案 #

方案1：使用公共API的mysqlx::Row绑定表元数据

通过表的列元数据初始化Row，让Row关联目标表的字段信息：

// 获取目标表的列元数据集合
auto table_columns = t.getColumns();

// 用列元数据初始化Row，此时Row已携带表的元信息
mysqlx::Row row(table_columns);

// 注意：Row的索引从0开始，对应表的列顺序
row.set(0, 0);
row.set(1, "cng");
row.set(2, "CNG");

// 执行插入操作
t.insert().values(row).execute();

方案2：动态指定列名+动态值列表（最适合编译时未知列的场景）

不需要依赖Row对象，直接动态构建列名列表和值列表，匹配后执行插入：

// 动态生成列名列表（可从配置、业务逻辑等来源获取）
std::vector<std::string> target_columns = {"id", "code", "name"};
// 动态生成对应的值列表（数量需与列名列表一致）
std::vector<mysqlx::Value> target_values = {0, "cng", "CNG"};

// 构建插入语句，传入动态列名
auto insert_operation = t.insert(target_columns.begin(), target_columns.end());
// 传入动态值并执行插入
insert_operation.values(target_values.begin(), target_values.end()).execute();

方案3：批量插入多行（基于方案1扩展）

如果需要批量插入，只需为每行都绑定表元数据：

auto table_columns = t.getColumns();

std::vector<mysqlx::Row> rows;
// 构建第一行
mysqlx::Row row1(table_columns);
row1.set(0, 0);
row1.set(1, "cng");
row1.set(2, "CNG");
rows.push_back(row1);

// 构建第二行
mysqlx::Row row2(table_columns);
row2.set(0, 1);
row2.set(1, "petrol");
row2.set(2, "Petrol");
rows.push_back(row2);

// 批量插入
t.insert().rows(rows.begin(), rows.end()).execute();

注意事项 #

• 避免直接使用mysqlx::abi2::Row：该命名空间属于XdevAPI的内部实现层，版本更新时可能存在兼容性问题，优先使用公共API中的mysqlx::Row。
• 索引一致性：Row的字段索引从0开始，需与表的列顺序或指定的列名顺序严格对应。

内容的提问来源于stack exchange，提问作者devcore96