通过

使用 sql:encode 请求 BLOB 数据的 URL 引用 (SQLXML 4.0)

适用于： SQL Server Azure SQL 数据库

在带批注的 XSD 架构中，当属性（或元素）映射到 Microsoft SQL Server 中的 BLOB 列时，数据以 XML 中的 Base 64 编码格式返回。

如果希望返回对数据（URI）的引用，稍后可以使用该引用以二进制格式检索 BLOB 数据，请指定 sql：encode 批注。 可以在简单类型的属性或元素上指定 sql：encode 。

指定 sql：encode 批注以指示应返回字段的 URL，而不是字段的值。 sql：encode 取决于主键以在 URL 中生成单一实例选择。 可以使用 sql：key-fields 批注指定主键。

可以为 sql：encode 批注分配“url”或“default”值。 值为“default”将返回 Base 64 编码格式的数据。

sql：encode 批注不能与 sql：use-cdata 一起使用，也不能用于 ID、IDREF、IDREFS、NMTOKEN 或 NMTOKENS 属性类型。 它也不能与 XSD 固定 属性一起使用。

注意

BLOB 类型的列不能用作键或外键的一部分。

示例

若要创建使用以下示例的工作示例，必须满足某些要求。 有关详细信息，请参阅 运行 SQLXML 示例的要求。

A. 指定 sql:encode 以获取对 BLOB 数据的 URL 引用

在此示例中，映射架构指定 LargePhoto 属性上的 sql：encode，以检索对特定产品照片的 URI 引用（而不是检索 Base 64 编码格式的二进制数据）。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
  
  <xsd:element name="ProductPhoto" sql:relation="Production.ProductPhoto"   
               sql:key-fields="ProductPhotoID" >  
   <xsd:complexType>  
      <xsd:attribute name="ProductPhotoID"  type="xsd:int"  />  
     <xsd:attribute name="LargePhoto" type="xsd:string" sql:encode="url" />  
    </xsd:complexType>  
  </xsd:element>  
</xsd:schema>
针对架构测试示例 XPath 查询

  1. 复制上面的架构代码，并将它粘贴到文本文件中。 将文件另存为 sqlEncode.xml。

  2. 复制以下模板，并将它粘贴到文本文件中。 在保存 sqlEncode.xml 的相同目录中将该文件另存为 sqlEncodeT.xml。

    <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
    <sql:xpath-query mapping-schema="sqlEncode.xml">  
        /ProductPhoto[@ProductPhotoID=100]  
    </sql:xpath-query>  
</ROOT>

    为映射架构 (sqlEncode.xml) 指定的目录路径是相对于模板保存目录的相对路径。 也可以指定绝对路径，例如：

    mapping-schema="C:\SqlXmlTest\sqlEncode.xml"

  3. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

结果如下：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
   <ProductPhoto ProductPhotoID="100"  
                 LargePhoto="dbobject/Production.ProductPhoto[@ProductPhotoID="100"]/@LargePhoto" />   
</ROOT>