T-SQL的XQuery方法nodes(), value(), query(), exist()怎么用

nodes()将XML节点路径转为行集但不直接取值，需配合APPLY及value()/query()等方法；value()提取单值且须指定SQL类型；query()返回XML片段；exist()判断节点存在性并返回1/0。

nodes() 用来把 XML 拆成行集，不是直接取值

nodes() 的作用是「把 XML 中匹配的节点路径转成虚拟表的一行」，它本身不返回数据，必须配合 APPLY 才能展开。常见错误是以为它能直接提取字符串或数字——其实它只产出 XML 类型的列（通常是 xml 类型的单节点），后续还得用 value() 或 query() 处理。

比如有变量 @x xml = 'applebanana'，想拆出每个 元素：

SELECT T.c.query('.') AS order_xml
FROM @x.nodes('/orders/order') AS T(c);

注意三点：

• /orders/order 是 XPath 表达式，区分大小写，且不能以空格开头
• T(c) 中的 c 是别名，代表每个匹配到的 节点（仍是 XML 类型）
• 如果路径没匹配到任何节点，nodes() 返回空结果集（不是 NULL 行）

value() 只能取原子值，且必须指定 SQL 类型

value() 从单个 XML 节点里提取标量值（如 INT、VARCHAR(50)），但它有两个硬性要求：一是 XPath 必须返回「恰好一个节点」，二是必须显式声明返回的 SQL 类型，否则报错 XQuery [value()]: 'value()' requires a singleton (or empty sequence)。

继续上面的例子，要取出每个订单的 id 属性和 文本内容：

SELECT 
  T.c.value('@id', 'INT') AS order_id,
  T.c.value('item[1]', 'VARCHAR(20)') AS item_name
FROM @x.nodes('/orders/order') AS T(c);

关键细节：

• @id 表示属性，item[1] 中的 [1] 是必须的——即使只有一个 ，XPath 也得限定为单例
• 类型写 'VARCHAR(20)' 而不是 varchar，字符串字面量必须加单引号
• 如果某行的 没有 @id，value() 返回 NULL，不会报错

query() 返回子 XML 片段，适合嵌套结构重用

query() 把匹配到的节点（或子树）原样返回为 XML 类型，不解析内容。它不要求单例，XPath 可以返回多个节点，比如提取所有 包裹在新根中：

SELECT T.c.query('item') AS items
FROM @x.nodes('/orders/order') AS T(c);

输出是两行，每行是类似 apple 的 XML 字符串。常用于：

• 把一组子节点打包传给另一个存储过程（接收 XML 参数）
• 生成中间 XML 结构供后续 nodes() 二次拆解
• 避免手动拼接字符串，保留命名空间和属性

注意：query('.') 返回当前节点自身（含标签），而 value('.', 'NVARCHAR(MAX)') 只取文本内容（不含标签）。

exist() 判断是否存在节点，返回 1/0 而非布尔

exist() 是唯一返回 BIT（即 1 或 0）的 XQuery 方法，常用于 WHERE 或 IF 条件。它不关心匹配多少个节点，只要至少一个就返回 1。

例如筛选含特定商品的订单：

SELECT *
FROM OrdersTable
WHERE XmlColumn.exist('/order/item[text()="apple"]') = 1;

易错点：

• 必须跟 = 1 或 = 0 比较，不能直接写 WHERE XmlColumn.exist(...) = TRUE（T-SQL 没布尔字面量）
• text() 在 XPath 中表示文本节点，"apple" 要加双引号（XPath 规则），不是 SQL 单引号
• 路径为空或无效时，exist() 返回 NULL，所以条件写成 = 1 更安全（NULL = 1 为 false）

四个方法真正难的不是语法，而是 XPath 表达式的上下文绑定：在 nodes() 后的 value() 里，. 指向的是当前节点，不是原始 XML 根；而 exist() 默认从根开始，除非先用 nodes() 定位过。这点一旦搞混，查半天也不知道为什么取不到值。