大网数据广告活动
数据库与应用安全

SELECT - FOR 子句 (Transact-SQL)

· 52CE 我爱测

- 允许在查看浏览模式游标中的查询结果时通过指定 FOR BROWSE 来更新。

适用对象:yesSQL Server(从 2008 版开始)yesAzure SQL 数据库noAzure SQL 数据仓库no并行数据仓库

使用 FOR 子句指定查询结果的以下查询结果之一。

  • 允许在查看浏览模式游标中的查询结果时通过指定 FOR BROWSE 来更新。

  • 通过指定 FOR XML,将查询结果格式化为 XML。

  • 通过指定 FOR JSON,将查询结果格式化为 JSON 。

主题链接图标 TRANSACT-SQL 语法约定

语法

  
[ FOR { BROWSE | <XML> | <JSON>} ]  
  
<XML> ::=  
XML   
{   
    { RAW [ ( 'ElementName' ) ] | AUTO }   
    [   
        <CommonDirectivesForXML>   
        [ , { XMLDATA | XMLSCHEMA [ ( 'TargetNameSpaceURI' ) ] } ]   
        [ , ELEMENTS [ XSINIL | ABSENT ]   
    ]  
  | EXPLICIT   
    [   
        <CommonDirectivesForXML>   
        [ , XMLDATA ]   
    ]  
  | PATH [ ( 'ElementName' ) ]   
    [  
        <CommonDirectivesForXML>   
        [ , ELEMENTS [ XSINIL | ABSENT ] ]  
    ]  
}   
  
<CommonDirectivesForXML> ::=   
[ , BINARY BASE64 ]  
[ , TYPE ]  
[ , ROOT [ ( 'RootName' ) ] ]  
  
<JSON> ::=  
JSON   
{   
    { AUTO | PATH }   
    [   
        [ , ROOT [ ( 'RootName' ) ] ]  
        [ , INCLUDE_NULL_VALUES ]  
        [ , WITHOUT_ARRAY_WRAPPER ]  
    ]  
  
}  

FOR BROWSE

BROWSE
指定可以在查看 DB-Library 浏览模式游标中的数据时进行更新。 如果表包括 timestamp 列,并且表有唯一索引,而且在发送到 SQL Server 实例的 SELECT 语句中 FOR BROWSE 选项位于末尾,则可以在应用程序中浏览该表。

Note:
不能在包括 FOR BROWSE 选项的 SELECT 语句中使用 <lock_hint> HOLDLOCK。

FOR BROWSE 不能出现在由 UNION 运算符所联接的 SELECT 语句中。

Note:
如果表的唯一索引键列可为空,并且表在外部联接的内侧,则浏览模式不支持索引。

使用浏览模式可以扫描 SQL Server 表中的行并逐行更新表中的数据。 若要以浏览模式访问应用程序中的 SQL Server 表,必须使用下列两个选项之一:

  • 用于访问 SQL Server 表的数据的 SELECT 语句必须以 FOR BROWSE 关键字结尾。 启用 FOR BROWSE 选项以使用浏览模式时,将创建时态表。

  • 必须运行以下 Transact-SQL 语句,以使用 NO_BROWSETABLE 选项打开浏览模式:

    SET NO_BROWSETABLE ON  
    

    启用 NO_BROWSETABLE 选项时,所有 SELECT 语句的行为就像在这些语句后追加了 FOR BROWSE 选项一样。 但是,NO_BROWSETABLE 选项不会创建 FOR BROWSE 选项通常用于向应用程序发送结果的时态表。

当使用涉及外部联接语句的 SELECT 查询尝试以浏览模式访问 SQL Server 表中的数据,并且当对外部联接语句内侧已存在的表定义唯一索引时,浏览模式不支持此唯一索引。 仅当所有唯一索引键列可接受 Null 值时,浏览模式才支持唯一索引。 如果满足下列条件,浏览模式不支持唯一索引:

  • 尝试使用包含外部联接语句的 SELECT 查询在浏览模式中访问 SQL Server 表的数据。

  • 对外部联接语句内侧已存在的表定义唯一索引。

若要在浏览模式下重现此行为,请按下列步骤操作:

  1. 在 SQL Server Management Studio 中,创建一个名为 SampleDB 的数据库。

  2. 在 SampleDB 数据库中,创建均包含名为 c1 的列的 tleft 表和 tright 表。 对 tleft 表中的 c1 列定义唯一索引,并将此列设置为接受 Null 值。 为此,请在相应的查询窗口中运行下列 Transact-SQL 语句:

    CREATE TABLE tleft(c1 INT NULL UNIQUE) ;  
    GO   
    CREATE TABLE tright(c1 INT NULL) ;  
    GO  
    
  3. 在 tleft 表和 tright 表中插入多个值。 请确保在 tleft 表中插入一个 Null 值。 为此,请在查询窗口中运行下列 Transact-SQL 语句:

    INSERT INTO tleft VALUES(2) ;  
    INSERT INTO tleft VALUES(NULL) ;  
    INSERT INTO tright VALUES(1) ;  
    INSERT INTO tright VALUES(3) ;  
    INSERT INTO tright VALUES(NULL) ;  
    GO  
    
  4. 开启 NO_BROWSETABLE 选项。 为此,请在查询窗口中运行下列 Transact-SQL 语句:

    SET NO_BROWSETABLE ON ;  
    GO  
    
  5. 通过在 SELECT 查询中使用外部联接语句来访问 tleft 表和 tright 表中的数据。 请确保 tleft 表位于外部联接语句的内侧。 为此,请在查询窗口中运行下列 Transact-SQL 语句:

    SELECT tleft.c1   
    FROM tleft   
    RIGHT JOIN tright   
    ON tleft.c1 = tright.c1   
    WHERE tright.c1 <> 2 ;  
    
    

    请注意“结果”窗格中的以下输出:

    c1

    ----

    NULL

    NULL

在运行 SELECT 查询以便以浏览模式访问表之后,对于 tleft 表中的 c1 列,SELECT 查询的结果集包含两个 Null 值,这是因为在右外部联接语句中定义了该列。 因此,您无法在结果集中区分源自该表的 Null 值和右外部联接语句引入的 Null 值。 如果必须忽略结果集的 Null 值,则可能收到错误结果。

Note:
如果唯一索引中包含的列不接受 Null 值,则结果集中的所有 Null 值都是由右外部联接语句引入的。

FOR XML

XML
指定以 XML 文档返回查询的结果。 必须指定下列 XML 模式之一:RAW、AUTO、EXPLICIT。 有关 XML 数据和 SQL Server 的详细信息,请参阅 FOR XML (SQL Server)。

RAW [ ('ElementName') ]
获得查询结果并将结果集内的每一行转换为以一般标识符 <row /> 作为元素标记的 XML 元素。 (可选)可以为该行元素指定名称。 产生的 XML 输出将指定的 ElementName 用作每行生成的行元素。 有关详细信息,请参阅 将 RAW 模式与 FOR XML 一起使用。

AUTO
以简单的嵌套 XML 树返回查询结果。 FROM 子句中每个在 SELECT 子句中至少列出一次的表都被表示为一个 XML 元素。 SELECT 子句中列出的列映射到适当的元素属性。 有关详细信息,请参阅 将 AUTO 模式与 FOR XML 一起使用。

EXPLICIT
指定显式定义产生的 XML 树的形状。 使用该模式要求必须以一种特定的方式编写查询,即显式指定与想要的嵌套有关的其他信息。 有关详细信息,请参阅 将 EXPLICIT 模式与 FOR XML 一起使用。

XMLDATA
返回内联 XDR 架构,但不将根元素添加到结果中。 如果指定了 XMLDATA,则 XDR 架构将被追加到文档末尾。

Important:
XMLDATA 指令已弃用。 如果是 RAW 和 AUTO 模式,请使用 XSD 生成。 在 EXPLICIT 模式下,没有 XMLDATA 指令的替代项。 此功能处于维护模式并且可能会在 Microsoft SQL Server 将来的版本中被删除。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。

XMLSCHEMA [ ('TargetNameSpaceURI') ]
返回内联 XSD 架构。 如果指定该指令(用于返回架构中指定的命名空间),则可以选择指定目标命名空间 URI。 有关详细信息,请参阅 生成内联 XSD 架构。

ELEMENTS
指定列作为子元素返回。 否则,列将映射到 XML 属性。 只在 RAW、AUTO 和 PATH 模式中支持该选项。 有关详细信息,请参阅 将 RAW 模式与 FOR XML 一起使用。

XSINIL
指定为 NULL 列值创建其 xsi:nil 属性设置为 True 的元素。 该选项只能与 ELEMENTS 指令一起指定。 有关详细信息,请参阅使用 XSINIL 参数生成 NULL 值对应的元素。

ABSENT
指示对于空列值,将不在 XML 结果中添加对应的 XML 元素。 该选项只能与 ELEMENTS 一起指定。

PATH [ ('ElementName') ]
为结果集中的每一行生成 <row> 元素包装器。 可以根据需要为 <row> 元素包装器指定元素名称。 如果提供了空字符串(例如 FOR XML PATH ('')),则不生成包装器元素。 使用 PATH 可能为使用 EXPLICIT 指令所编写的查询提供更简单的代替方案。 有关详细信息,请参阅 将 PATH 模式与 FOR XML 一起使用。

BINARY BASE64
指定查询返回二进制 base64 编码格式的二进制数据。 使用 RAW 和 EXPLICIT 模式检索二进制数据时,必须指定该选项。 这是 AUTO 模式中的默认值。

TYPE
指定查询以 xml 类型返回结果。 有关详细信息,请参阅 TYPE Directive in FOR XML Queries。

ROOT [ ('RootName') ]
指定将一个顶级元素添加到结果 XML 中。 可以选择指定要生成的根元素名称。 如果不指定可选的根名称,则添加默认的 <root> 元素。

有关详细信息,请参阅 FOR XML (SQL Server)。

FOR XML 示例

以下示例指定具有 FOR XML AUTO 和 TYPE 选项的 XMLSCHEMA。 由于有 TYPE 选项,因此结果集将作为 xml 类型返回到客户端。 XMLSCHEMA 选项指定在所返回的 XML 数据中包括内联 XSD 架构,而 ELEMENTS 选项指定 XML 结果是以元素为中心的。

USE AdventureWorks2012;  
GO  
SELECT p.BusinessEntityID, FirstName, LastName, PhoneNumber AS Phone  
FROM Person.Person AS p  
JOIN Person.PersonPhone AS pph ON p.BusinessEntityID  = pph.BusinessEntityID  
WHERE LastName LIKE 'G%'  
ORDER BY LastName, FirstName   
FOR XML AUTO, TYPE, XMLSCHEMA, ELEMENTS XSINIL;  

对于 JSON

JSON
指定 FOR JSON,返回已格式化为 JSON 文本的查询结果。 还必须指定以下 JSON 模式之一:AUTO 或 PATH。 有关 FOR JSON 子句的详细信息,请参阅借助 FOR JSON 将查询结果格式化为 JSON (SQL Server)。

AUTO
根据 SELECT 语句的结构
通过指定 FOR JSON AUTO 自动格式化 JSON 输出。 有关详细信息和示例,请参阅在 AUTO 模式下自动格式化 JSON 输出 (SQL Server)。

PATH
通过指定
FOR JSON PATH 获取对 JSON 输出格式的完全控制。 借助PATH 模式,你可以创建包装器对象,并嵌套复杂属性。 有关详细信息和示例,请参阅在 PATH 模式下设置嵌套的 JSON 输出格式 (SQL Server)。

INCLUDE_NULL_VALUES
通过使用 FOR JSON 子句指定 INCLUDE_NULL_VALUES 选项,在 JSON 输出中包括 NULL 值。 如果没有指定此选项,输出不会在查询结果中包括 NULL 值的 JSON 属性。 有关详细信息和示例,请参阅使用 INCLUDE_NULL_VALUES 选项将 NULL 值包含在 JSON 输出中 (SQL Server)。

ROOT [ ('RootName') ]
通过使用 FOR JSON 子句指定 ROOT 选项,将一个顶层元素添加到 JSON 输出中。 如果没有指定 ROOT 选项,则 JSON 输出不会包括根元素。 有关详细信息和示例,请参阅使用 ROOT 选项将根节点添加到 JSON 输出中 (SQL Server)。

WITHOUT_ARRAY_WRAPPER
通过使用 FOR JSON 子句指定 WITHOUT_ARRAY_WRAPPER 选项,删除默认括住 JSON 输出的方括号。 如果不指定此选项,JSON 输出将括在方括号中。 使用 WITHOUT_ARRAY_WRAPPER 选项可以生成单个 JSON 对象作为输出。 有关详细信息,请参阅 使用 WITHOUT_ARRAY_WRAPPER 选项从 JSON 输出中删除方括号 (SQL Server)。

有关详细信息,请参阅借助 FOR JSON 将查询结果格式化为 JSON (SQL Server)。

另请参阅

SELECT (Transact-SQL)

历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 douglaslMS)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / SQL Server 中文文档历史快照
适用范围
历史中文快照 2018-11-30;详见原文产品版本;文档日期 08/09/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。