nodes()将XML节点路径转为行集但不直接取值，需配合APPLY及value()/query()等方法；value()提取单值且须指定SQL类型；query()返回XML片段；exist()判断节点存在性并返回1/0。
nodes() 用来把 XML 拆成行集，不是直接取值
nodes() 的作用是「把 XML 中匹配的节点路径转成虚拟表的一行」，它本身不返回数据，必须配合 APPLY 才能展开。常见错误是以为它能直接提取字符串或数字——其实它只产出 XML 类型的列（通常是 xml 类型的单节点），后续还得用 value() 或 query() 处理。
比如有变量 @x xml = '，想拆出每个
SELECT T.c.query('.') AS order_xml
FROM @x.nodes('/orders/order') AS T(c);
注意三点：
-
/orders/order是 XPath 表达式，区分大小写，且不能以空格开头 -
T(c)中的c是别名，代表每个匹配到的 - 如果路径没匹配到任何节点，
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]是必须的——即使只有一个 - 类型写
'VARCHAR(20)'而不是varchar，字符串字面量必须加单引号 - 如果某行的
@id，value()返回NULL，不会报错
query() 返回子 XML 片段，适合嵌套结构重用
query() 把匹配到的节点（或子树）原样返回为 XML 类型，不解析内容。它不要求单例，XPath 可以返回多个节点，比如提取所有
将 iPhone 的 Apple Health 数据同步到 OpenClaw。只需扫描一次二维码，无需手动配置。支持 Mac、Linux 和 VPS。
SELECT T.c.query('item') AS items
FROM @x.nodes('/orders/order') AS T(c);
输出是两行，每行是类似
- 把一组子节点打包传给另一个存储过程（接收
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() 定位过。这点一旦搞混，查半天也不知道为什么取不到值。
