如何在Rust中为SurrealDB的SELECT语句传递多字段？

我需要将固定字段的SurrealDB查询：

let sql = "SELECT name, skills FROM user:1";

改为通过变量指定查询字段的形式：

let sql = "SELECT $fields FROM $th";

目前已经掌握$th（指定目标对象）的实现方式，但不清楚$fields（多字段列表）该如何正确传递。我曾尝试直接将字段数组作为变量传入，但这种写法无法生效：

let sql = "SELECT $fields FROM $th";

let fields = ["name", "skills"];

let vars: BTreeMap<String, Value> = [
    ("fields".into(), fields.into()),
    ("th".into(), thing(&id)?.into())
].into();

临时方案（寻求更优实现） #

我目前用字符串替换的方式临时解决，但这种写法不够优雅，且存在SQL注入风险：

let sql = "SELECT $fields FROM $th";

let join_vec;
let fields_vec: Option<Vec<&str>> = fields.into();
let mut fields = fields_vec.into_iter();

match fields.next() {
    Some(f) => join_vec = f.join(", "),
    None => join_vec = "*".to_string(),
}
        
let replace_with: String = "SELECT ".to_owned() + &join_vec;
let sql = &*sql.replace("SELECT $fields", &replace_with);

更优解决方案 #

方法1：使用SurrealQL的* ONLY语法（推荐） #

SurrealDB支持* ONLY语法来通过参数化变量传递字段列表，这是官方支持的安全方式，无需手动拼接SQL：

let sql = "SELECT * ONLY $fields FROM $th";

let fields = ["name", "skills"];

let vars: BTreeMap<String, Value> = [
    ("fields".into(), Value::from(fields)),
    ("th".into(), thing(&id)?.into())
].into();

这里的$fields会被解析为字段列表，而非普通数据值，完美适配需求。

方法2：使用官方查询构建器 #

如果使用SurrealDB的Rust客户端，可以直接用官方提供的查询构建器动态生成查询语句，完全避免手动拼接SQL的问题：

use surrealdb::sql::Thing;
use surrealdb::statement::Select;

// 构建查询
let target = thing(&id)?;
let fields = ["name", "skills"];
let select_stmt = Select::new()
    .fields(fields)
    .from(target);

// 执行查询
let result = db.query(select_stmt).await?;

为什么直接传数组变量无效？ #

参数化查询中的变量仅用于传递数据值，不能替换SQL的语法元素（比如字段名、表名这类标识符）。直接将字段数组传入$fields会被SurrealDB当成普通数据处理，而非查询字段，因此无法生效。

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