稀疏列支持 (ODBC)

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)

重要

SQL Server Native Client （SNAC） 未随附：

• SQL Server 2022 （16.x） 及更高版本
• SQL Server Management Studio 19 及更高版本

不建议在新应用程序开发工作中使用 SQL Server Native Client（SQLNCLI 或 SQLNCLI11）和旧版 Microsoft OLE DB Provider for SQL Server (SQLOLEDB)。

对于新项目，请使用以下驱动程序之一：

• Microsoft ODBC Driver for SQL Server
• 适用于 SQL Server 的 Microsoft OLE DB 驱动程序 (MSOLEDBSQL)

对于作为 SQL Server 数据库引擎组件（版本 2012 到 2019）随附的 SQLNCLI，请参阅此支持生命周期特例。

本主题介绍对稀疏列的 SQL Server Native Client ODBC 支持。 有关演示对稀疏列的 ODBC 支持的示例，请参阅 在具有稀疏列的表上调用 SQLColumns。 有关稀疏列的详细信息，请参阅 SQL Server Native Client 中的稀疏列支持。

语句元数据

应用程序参数描述符 (APD) 字段和 SQL_SOPT_SS_NAME_SCOPE 语句属性接受新增的值 SQL_SS_NAME_SCOPE_EXTENDED 和 SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET。 这些值指定 SQLColumns 返回的结果集中包含哪些列。 有关SQL_SOPT_SS_NAME_SCOPE的详细信息，请参阅 SQLSetStmtAttr。

新的实现行描述符（IRD），一个名为SQL_CA_SS_IS_COLUMN_SET的只读 SQLSMALLINT 字段，可用于确定列是否为 XML column_set 值。 SQL_CA_SS_IS_COLUMN_SET 接受值 SQL_TRUE 和 SQL_FALSE。

目录元数据

已将两个 SQL Server 特定列（SS_IS_SPARSE和SS_IS_COLUMN_SET）添加到 SQLColumns 的结果集中。

对稀疏列的 ODBC 函数支持

已更新以下 ODBC 函数以支持 SQL Server Native Client 中的稀疏列：

• SQLColAttribute

• SQLColumns

• SQLGetDescField

• SQLSetDescField

• SQLSetStmtAttr

另请参阅

SQL Server Native Client (ODBC)