在Power Query中为Oracle数据库使用Value.NativeQuery()参数的正确语法

问题背景 #

在Power Query中执行Oracle SQL时，常见的两种方式存在明显弊端：

1. 直接写死查询条件

=Oracle.Database("database_name", [Query="SELECT name FROM employees WHERE name = 'Mike'"])

2. 通过字符串拼接传入参数

=Oracle.Database("database_name", [Query="SELECT name FROM employees WHERE name = '" & Parameter & "'"])

这种方式的问题在于：在Oracle SQL Developer等外部工具中运行时，必须手动替换所有拼接的参数部分，长查询多参数时操作繁琐；仅在Power Query编辑器内可查看参数替换结果，纯M代码仍需手动修改。

尝试使用Value.NativeQuery实现参数化查询时，参考SQL Server的写法调整后仍报错：

=Value.NativeQuery(Source,"SELECT name FROM employees WHERE name = '&name'",{name="Mike"})

报错信息：Expression.Error: The name 'name' wasn't recognized. Make sure it's spelled correctly.
修改参数名后仍提示未识别。

正确的Oracle参数化查询语法 #

针对Oracle，使用Value.NativeQuery需遵循以下规则：

1. SQL语句中的占位符使用问号?，而非&或@
2. 参数通过有序列表传递，严格对应SQL中?出现的顺序，不能使用命名键值对

单参数示例 #

let
    Source = Oracle.Database("database_name"),
    // 定义参数值
    targetName = "Mike",
    // 执行参数化查询
    Result = Value.NativeQuery(
        Source,
        "SELECT name FROM employees WHERE name = ?",
        {targetName},
        [EnableFolding = true] // 可选，启用查询折叠提升性能
    )
in
    Result

多参数示例 #

当存在多个参数时，按SQL中占位符的顺序依次放入列表：

let
    Source = Oracle.Database("database_name"),
    paramName = "Mike",
    paramAge = 30,
    Result = Value.NativeQuery(
        Source,
        "SELECT name, age FROM employees WHERE name = ? AND age > ?",
        {paramName, paramAge},
        [EnableFolding = true]
    )
in
    Result

关键说明 #

• Oracle的ODBC驱动仅支持位置占位符?，因此参数必须严格匹配SQL中?的顺序
• 无需给占位符添加单引号，Value.NativeQuery会自动处理参数类型和转义，同时避免SQL注入风险
• 启用EnableFolding = true可让Power Query将查询逻辑下推至Oracle执行，大幅提升查询效率

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