スパース列のサポート (ODBC)

適用対象: SQL Server Azure SQL データベース Azure SQL Managed Instance Azure Synapse Analytics Analytics 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) は、新しいアプリケーション開発には推奨されません。

新しいプロジェクトの場合は、次のいずれかのドライバーを使用します。

SQL Server データベース エンジン (バージョン 2012 から 2019) のコンポーネントとして付属する SQLNCLI については、この「サポート ライフサイクルの例外」を参照してください。

このトピックでは、スパース列に対する SQL Server Native Client ODBC のサポートについて説明します。 スパース列の ODBC サポートを示すサンプルについては、「スパース列を含むテーブルで SQLColumns を呼び出す を参照してください。 スパース列の詳細については、「 Sparse Columns Support in 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を参照してください。

SQL_CA_SS_IS_COLUMN_SETと呼ばれる読み取り専用の SQLSMALLINT フィールドである新しい実装行記述子 (IRD) を使用して、列が XML column_set 値であるかどうかを判断できます。 SQL_CA_SS_IS_COLUMN_SET は、値 SQL_TRUE および SQL_FALSE を受け取ります。

カタログ メタデータ

SQLColumns の結果セットに、2 つの SQL Server 固有の列 (SS_IS_SPARSEとSS_IS_COLUMN_SET) が追加されました

ODBC 関数によるスパース列のサポート

SQL Server Native Client でスパース列をサポートするように、次の ODBC 関数が更新されました。

参照

SQL Server Native Client (ODBC)