ストアド プロシージャ - SQL Server Native Client での呼び出し
適用対象:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
重要
SQL Server Native Client (SNAC と略されることがよくあります) は、SQL Server 2022 (16.x) と SQL Server Management Studio 19 (SSMS) から削除されました。 SQL Server Native Client OLE DB プロバイダー (SQLNCLI または SQLNCLI11) とレガシ Microsoft OLE DB Provider for SQL Server (SQLOLEDB) はどちらも、新しい開発には推奨されません。 今後は、新しい Microsoft OLE DB Driver (MSOLEDBSQL) for SQL Server に切り替えてください。
ストアド プロシージャは、0 個以上のパラメーターを受け取ることができます。 また、値を返すこともできます。 SQL SERVER NATIVE CLIENT OLE DB プロバイダーを使用する場合、ストアド プロシージャへのパラメーターは次の方法で渡すことができます。
データ値をハードコーディングする。
パラメーター マーカー (?) を使用してパラメーターを指定し、プログラム変数をパラメーター マーカーにバインドしてから、データ値をプログラム変数に格納する。
Note
OLE DB で名前付きパラメーターを使用して SQL Server ストアド プロシージャを呼び出す場合は、パラメーター名の先頭に '@' 文字を付ける必要があります。 これは、SQL Server 固有の制限です。 SQL SERVER NATIVE CLIENT OLE DB プロバイダーでは、MDAC よりも厳密にこの制限が適用されます。
パラメーターをサポートするには、コマンド オブジェクトで ICommandWithParameters インターフェイスを公開します。 パラメーターを使用するには、コンシューマーは、まず、ICommandWithParameters::SetParameterInfo メソッドを呼び出して、プロバイダーにパラメーターを示します (または、必要に応じて、GetParameterInfo メソッドを呼び出す呼び出し元ステートメントを準備します)。 次に、バッファーの構造を指定するアクセサーを作成し、このバッファーにパラメーター値を格納します。 最後に、アクセサーのハンドルとバッファーへのポインターを Execute に渡します。 その後 Execute を呼び出す場合、コンシューマーはバッファーに新しいパラメーター値を格納し、アクセサー ハンドルとバッファー ポインターを指定して Execute を呼び出します。
パラメーターを使用する一時ストアド プロシージャを呼び出すコマンドは、まず、ICommandWithParameters::SetParameterInfo を呼び出してパラメーター情報を定義しないと、適切に準備されません。 これは、一時ストアド プロシージャの内部名がクライアントで使用される外部名とは異なるので、SQLOLEDB がシステム テーブルをクエリして、一時ストアド プロシージャのパラメーター情報を判断できないためです。
次に、パラメーターのバインド プロセスの手順を示します。
DBPARAMBINDINFO 構造体の配列にパラメーター情報を格納します。パラメーター情報には、パラメーター名、パラメーターのデータ型を表すプロバイダー固有の名前、標準のデータ型名などが含まれます。 配列内の構造体 1 つが、1 つのパラメーターを表します。 その後、この配列は SetParameterInfo メソッドに渡されます。
ICommandWithParameters::SetParameterInfo メソッドを呼び出して、パラメーターをプロバイダーに示します。 SetParameterInfo では、各パラメーターのネイティブ データ型を指定します。 SetParameterInfo 引数は次のとおりです。
型情報を設定するパラメーターの数
型情報を設定するパラメーターの序数の配列
DBPARAMBINDINFO 構造体の配列
IAccessor::CreateAccessor コマンドを使用して、パラメーター アクセサーを作成します。 このアクセサーにより、バッファーの構造を指定し、パラメーター値をバッファーに格納します。 CreateAccessor コマンドでは、バインドのセットからアクセサーを作成します。 このバインドは、コンシューマーが DBBINDING 構造体の配列を使用して記述します。 各バインドでは、1 つのパラメーターをコンシューマーのバッファーに関連付けます。バインドには、次のような情報が含まれます。
バインドが適用されるパラメーターの序数
バインドの対象 (データ値、データ値の長さと状態)
これらの各情報に関するバッファー内のオフセット
コンシューマーのバッファー内にあるデータ値の長さと型
アクセサーは、アクセサーのハンドルにより識別されます。このハンドルは HACCESSOR 型です。 このハンドルは、CreateAccessor メソッドから返されます。 コンシューマーはアクセサーを使い終わるたびに、ReleaseAccessor メソッドを呼び出して、アクセサーが保持しているメモリを解放する必要があります。
コンシューマーが ICommand::Execute などのメソッドを呼び出す場合、アクセサーへのハンドルとバッファー自体へのポインターを渡します。 プロバイダーはこのアクセサーを使用して、バッファー内にあるデータを送信する方法を決定します。
DBPARAMS 構造体にデータを格納します。 入力パラメーター値の取得と出力パラメーター値の書き込みに使われるコンシューマーの変数が、実行時に DBPARAMS 構造体の ICommand::Execute に渡されます。 DBPARAMS 構造体には、次の 3 つの要素が含まれます。
アクセサー ハンドルで指定されているバインドに従ってプロバイダーが入力パラメーター データを取得し、出力パラメーター データを返すための、バッファーへのポインター
バッファー内のパラメーター セットの数
手順 3. で作成したアクセサー ハンドル
ICommand::Execute を使用してコマンドを実行します。
ストアド プロシージャを呼び出す方法
SQL Serverでストアド プロシージャを実行する場合、SQL Server Native Client OLE DB プロバイダーは次をサポートします。
ODBC CALL エスケープ シーケンス。
リモート プロシージャ コール (RPC) エスケープ シーケンス
Transact-SQL EXECUTE ステートメント。
ODBC CALL エスケープ シーケンス
パラメーター情報を把握している場合は、ICommandWithParameters::SetParameterInfo メソッドを呼び出して、パラメーターをプロバイダーに示します。 それ以外の場合は、ストアド プロシージャの呼び出しに ODBC CALL 構文を使用すると、プロバイダーはヘルパー関数を呼び出してストアド プロシージャのパラメーター情報を取得します。
パラメーター情報 (パラメーターのメタデータ) を把握していない場合は、ODBC CALL 構文の使用をお勧めします。
ODBC CALL エスケープ シーケンスを使用してプロシージャを呼び出す場合の一般的な構文は、次のとおりです。
{[?=]callprocedure_name[([parameter][,[parameter]]...)]}
次に例を示します。
{call SalesByCategory('Produce', '1995')}
RPC エスケープ シーケンス
RPC エスケープ シーケンスは、ストアド プロシージャを呼び出す ODBC CALL 構文と似ています。 プロシージャを複数回呼び出す場合は、ストアド プロシージャを呼び出す 3 つの方法のうち、RPC エスケープ シーケンスのパフォーマンスが最も優れています。
RPC エスケープ シーケンスを使用してストアド プロシージャを実行する場合、プロバイダーはパラメーター情報の決定にヘルパー関数を呼び出しません (ODBC CALL 構文では、ヘルパー関数が呼び出されます)。 RPC 構文は ODBC CALL 構文よりも簡単です。そのためコマンドが高速に解析され、パフォーマンスが向上します。 この場合は、ICommandWithParameters::SetParameterInfo を実行してパラメーター情報を提供する必要があります。
RPC エスケープ シーケンスを使用する場合は、戻り値が必要です。 ストアド プロシージャが値を返さない場合、サーバーが既定で 0 を返します。 また、ストアド プロシージャのSQL Server カーソルを開くことはできません。 ストアド プロシージャは暗黙的に準備され、ICommandPrepare::Prepare の呼び出しは失敗します。 RPC 呼び出しを準備できないため、列のメタデータをクエリすることはできません。IColumnsInfo::GetColumnInfo と IColumnsRowset::GetColumnsRowset によって DB_E_NOTPREPARED が返されます。
パラメーターのメタデータを把握できている場合は、ストアド プロシージャの実行方法として RPC エスケープ シーケンスの使用をお勧めします。
次に、ストアド プロシージャを呼び出す RPC エスケープ シーケンスの例を示します。
{rpc SalesByCategory}
RPC エスケープ シーケンスを示すサンプル アプリケーションについては、ストアド プロシージャの実行 (RPC 構文を使用) とリターン コードおよび出力パラメーターの処理 (OLE DB) に関するページを参照してください。
Transact-SQL EXECUTE ステートメント
ストアド プロシージャを呼び出す方法としては、EXECUTE ステートメントよりも、ODBC CALL エスケープ シーケンスや RPC エスケープ シーケンスをお勧めします。 SQL Server Native Client OLE DB プロバイダーは、SQL Serverの RPC メカニズムを使用してコマンド処理を最適化します。 この RPC プロトコルでは、サーバー側で実行されるパラメーター処理やステートメントの解析作業の多くを排除することで、パフォーマンスを向上しています。
Transact-SQL EXECUTE ステートメントの例を次に示します。
EXECUTE SalesByCategory 'Produce', '1995'
参照
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示