適用対象:
SQL ServerAzure SQL データベースAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
SQL Server text、 ntext、および image データ (long data とも呼ばれます) は、データ値が大きすぎて char、 varchar、 binary、または varbinary 列に収まらない可能性がある文字またはバイナリ文字列のデータ型です。 SQL Server text データ型は ODBC SQL_LONGVARCHAR データ型にマップされます。 ntext はSQL_WLONGVARCHARにマップされ、 image はSQL_LONGVARBINARYにマップされます。 長いドキュメントや大きなビットマップなど、データ アイテムの中には大きすぎて適切にメモリに読み込むことができないものもあります。 SQL Server からシーケンシャル 部分で長いデータを取得するには、SQL Server Native Client ODBC ドライバーを使用して、アプリケーションで SQLGetData を呼び出します。 シーケンシャル部分で長いデータを送信するために、アプリケーションは SQLPutData を呼び出すことができます。 実行時にデータ送信に使われるパラメーターを、実行時データ パラメーターと呼びます。
アプリケーションでは、 SQLPutData または SQLGetData を使用して任意の種類のデータ (長いデータだけでなく) を実際に書き込んだり取得したりすることができますが、 character および binary データのみを一部で送受信できます。 ただし、データが 1 つのバッファーに収まるほど小さい場合、一般に、 SQLPutData または SQLGetData を使用する理由はありません。 バッファーをパラメーターまたは列にバインドする方がはるかに簡単です。