ステートメント パラメーターの使用

  • [アーティクル]

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

パラメーターは、ODBC アプリケーションで次の操作を可能にする SQL ステートメント内の変数です。

  • テーブルの列に効果的に値を提供する。

  • クエリ条件を作成する際のユーザーとの対話を強化する。

  • テキスト、ntext、およびイメージ データとSQL Server固有の C データ型を管理します。

たとえば、Parts テーブルには、PartID、Description、Price という名前の列があります。 パラメーターを使用しないで部品を追加するには、次のような SQL ステートメントを構築する必要があります。

INSERT INTO Parts (PartID, Description, Price) VALUES (2100, 'Drive shaft', 50.00)

既知の値のセットを含む行を 1 行挿入する場合はこのステートメントでもかまいませんが、アプリケーションで複数の行を挿入する必要がある場合には不適切です。 ODBC は、SQL ステートメント内の任意のデータ値をパラメーター マーカーで置き換えることで、この問題に対処します。 パラメーター マーカーは疑問符 (?) で表されます。 次の例では、3 つのデータ値をパラメーター マーカーに置き換えています。

INSERT INTO Parts (PartID, Description, Price) VALUES (?, ?, ?)

これらのパラメーター マーカーは、その後アプリケーション変数にバインドされます。 新しい行を挿入する場合は、アプリケーションでこれらの変数に値を設定し、ステートメントを実行するだけです。 ドライバーで、変数から現在値が取得され、データ ソースに送信されます。 ステートメントを複数回実行する場合は、そのステートメントを準備することで、アプリケーションの処理をより効率的にできます。

各パラメーター マーカーは、左側のパラメーターから右側のパラメーターに順番に割り当てられる序数で参照されます。 SQL ステートメントの左端のパラメーター マーカーの序数が 1、次のパラメーター マーカーの序数が 2 というように割り当てられます。

このセクションの内容

参照

クエリの実行 (ODBC)