ステートメント パラメーターの使用
適用対象: SQL Server Azure SQL データベース Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
パラメーターは、ODBC アプリケーションで次のことが可能な SQL ステートメントの変数です。
テーブルの列に効果的に値を提供する。
クエリ条件を作成する際のユーザーとの対話を強化する。
text、ntext、および image データ型と 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 などです。