适用于 SQL Server 的 OLE DB 驱动程序的 FILESTREAM 支持

  • 项目

适用于：SQL Server - 仅限 Windows

下载 OLE DB 驱动程序

从 SQL Server 2008 (10.0.x) 开始，OLE DB Driver for SQL Server 支持增强的 FILESTREAM 功能。 有关示例，请参阅 文件流 和 OLE DB。

FILESTREAM 允许通过 SQL Server 或通过直接访问 Windows 文件系统来存储和访问大型二进制值。 大型二进制值是大于 2 GB 的值。 若要详细了解增强的 FILESTREAM 支持，请参阅 FILESTREAM (SQL Server)。

默认情况下，在打开数据库连接时，将 @@TEXTSIZE 设置为 -1（无限制）。

还可以使用 Windows 文件系统 API 访问和更新 FILESTREAM 列。

有关详细信息，请参阅使用 OpenSqlFilestream 访问 FILESTREAM 数据。

查询 FILESTREAM 列

OLE DB 中的架构行集不会报告某个列是否为 FILESTREAM 列。 OLE DB 中的 ITableDefinition 不能用于创建 FILESTREAM 列。

若要创建 FILESTREAM 列或检测哪些现有列是 FILESTREAM 列，可以使用 sys.columns 目录视图的 is_filestream 列。

下面的脚本就是一个示例。

-- Create a table with a FILESTREAM column.
CREATE TABLE Bob_01 (
    GuidCol1 UNIQUEIDENTIFIER ROWGUIDCOL NOT NULL UNIQUE DEFAULT NEWID(),
    IntCol2 INT,
    varbinaryCol3 VARBINARY(MAX) FILESTREAM
);

-- Find FILESTREAM columns.
SELECT name
FROM sys.columns
WHERE is_filestream = 1;

-- Determine whether a column is a FILESTREAM column.
SELECT is_filestream
FROM sys.columns
WHERE name = 'varbinaryCol3'
    AND object_id IN (
        SELECT object_id
        FROM sys.tables
        WHERE name = 'Bob_01'
    );

下级兼容性

如果你的客户端是使用 OLE DB Driver for SQL Server 编译的，并且应用程序连接到 SQL Server（SQL Server 2012 (11.x) 或更高版本），那么 varbinary(max) 行为将与 SQL Server 2005 (9.x) 中的 SQL Server Native Client 引入的行为兼容。 就是说，返回数据的最大大小将限制为不超过 2 GB。 对于超过 2 GB 的结果值，将发生截断，并将返回“字符串数据，右截断”警告。

如果将数据类型兼容性设置为 80，则客户端行为将与下级客户端行为一致。

如果客户端使用 SQLOLEDB，或使用在 SQL Server 2005 (9.x) 之前发布的其他访问接口，则 varbinary(max) 将映射到映像。

注释

  • 为了发送和接收大于 2 GB 的 varbinary(max) 值，应用程序在参数和结果绑定中使用 DBTYPE_IUNKNOWN。 对于参数，提供程序必须为 ISequentialStream 和返回 ISequentialStream 的结果调用 IUnknown::QueryInterface。

  • 对于 OLE DB，对与 ISequentialStream 值相关的检查会放宽。 当 DBBINDING 结构中的 wType 是 DBTYPE_IUNKNOWN 时，可以通过省略 dwPart 中的 DBPART_LENGTH 或将数据长度（数据缓冲区中的偏移 obLength）设置为 ~0 来禁用长度检查。 在此情况下，提供程序不检查值的长度，并且会请求和返回可通过流提供的所有数据。 这一更改适用于所有大型对象 (LOB) 类型和 XML，但只在连接到 SQL Server 2005 (9.x)（或更高版本）服务器时才适用。 这会为开发人员提供更高的灵活性，同时为现有应用程序和下级服务器维护一致性和向下兼容性。 此更改会影响传输数据的所有接口，主要是 IRowset::GetData、ICommand::Execute，以及 IRowsetFastLoad::InsertRow。

相关内容