方法 : CLR の SQL Server ストアド プロシージャを作成および実行する
更新 : 2007 年 11 月
SQL ストアド プロシージャを作成するには、[ストアド プロシージャ] 項目を SQL Server プロジェクトに追加します。SQL Server を実行しているコンピュータに正しく配置すると、マネージ コードで作成されたストアド プロシージャは、他のストアド プロシージャと同様に呼び出され、実行されます。
メモ : |
---|
既定では、Microsoft SQL Server では共通言語ランタイム (CLR: Common Language Runtime) 統合機能が無効になっており、SQL Server プロジェクト項目を使用するにはこれを有効にする必要があります。CLR 統合を有効にするには、sp_configure ストアド プロシージャの clr enabled オプションを使用します。詳細については、「CLR 統合の有効化」を参照してください。 |
メモ : |
---|
使用している設定またはエディションによっては、表示されるダイアログ ボックスやメニュー コマンドがヘルプに記載されている内容と異なる場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。 |
SQL Server のストアド プロシージャの作成
SQL Server のストアド プロシージャを作成するには
既存の SQL Server プロジェクトを開くか、または新しい SQL Server プロジェクトを作成します。詳細については、「方法 : SQL Server プロジェクトを作成する」を参照してください。
[プロジェクト] メニューの [新しい項目の追加] をクリックします。
[新しい項目の追加] ダイアログ ボックスの [ストアド プロシージャ] を選択します。
新しいストアド プロシージャに [ファイル名] を指定します。
ストアド プロシージャの実行時に実行するコードを追加します。下記の例を参照してください。
メモ : C++ の例は、/clr:safe コンパイラ オプションを使ってコンパイルする必要があります。
Visual Basic および Visual C# の場合は、ソリューション エクスプローラで TestScripts フォルダを開き、Test.sql ファイルをダブルクリックします。
Visual C++ の場合は、ソリューション エクスプローラで debug.sql ファイルを開きます。
ストアド プロシージャを実行するコードを Test.sql (Visual C++ の場合は debug.sql) ファイルに追加します。下記の 2 番目の例を参照してください。
F5 キーを押して、ストアド プロシージャをビルド、配置、およびデバッグします。デバッグせずに配置する方法については、「方法 : SQL Server のプロジェクト項目を SQL Server に配置する」を参照してください。
[出力] ウィンドウ内の結果を表示して、[出力元の表示: データベース出力] を選択します。
使用例
Adventure Works サンプル データベースの Currency テーブルにレコードを挿入するストアド プロシージャを作成するコード例を次に示します。このストアド プロシージャの作成後に、SQL Server に配置します。詳細については、「方法 : SQL Server のプロジェクト項目を SQL Server に配置する」を参照してください。
Imports System
Imports System.Data
Imports System.Data.SqlClient
Imports System.Data.SqlTypes
Imports Microsoft.SqlServer.Server
Partial Public Class StoredProcedures
<SqlProcedure()> _
Public Shared Sub InsertCurrency( _
ByVal currencyCode As SqlString, ByVal name As SqlString)
Using conn As New SqlConnection("context connection=true")
Dim InsertCurrencyCommand As New SqlCommand()
Dim currencyCodeParam As New SqlParameter("@CurrencyCode", SqlDbType.NVarChar)
Dim nameParam As New SqlParameter("@Name", SqlDbType.NVarChar)
currencyCodeParam.Value = currencyCode
nameParam.Value = name
InsertCurrencyCommand.Parameters.Add(currencyCodeParam)
InsertCurrencyCommand.Parameters.Add(nameParam)
InsertCurrencyCommand.CommandText = _
"INSERT Sales.Currency (CurrencyCode, Name, ModifiedDate)" & _
" VALUES(@CurrencyCode, @Name, GetDate())"
InsertCurrencyCommand.Connection = conn
conn.Open()
InsertCurrencyCommand.ExecuteNonQuery()
conn.Close()
End Using
End Sub
End Class
using System;
using System.Data;
using System.Data.SqlClient;
using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;
public partial class StoredProcedures
{
[SqlProcedure()]
public static void InsertCurrency_CS(
SqlString currencyCode, SqlString name)
{
using (SqlConnection conn = new SqlConnection("context connection=true"))
{
SqlCommand InsertCurrencyCommand = new SqlCommand();
SqlParameter currencyCodeParam = new SqlParameter("@CurrencyCode", SqlDbType.NVarChar);
SqlParameter nameParam = new SqlParameter("@Name", SqlDbType.NVarChar);
currencyCodeParam.Value = currencyCode;
nameParam.Value = name;
InsertCurrencyCommand.Parameters.Add(currencyCodeParam);
InsertCurrencyCommand.Parameters.Add(nameParam);
InsertCurrencyCommand.CommandText =
"INSERT Sales.Currency (CurrencyCode, Name, ModifiedDate)" +
" VALUES(@CurrencyCode, @Name, GetDate())";
InsertCurrencyCommand.Connection = conn;
conn.Open();
InsertCurrencyCommand.ExecuteNonQuery();
conn.Close();
}
}
}
#include "stdafx.h"
#using <System.dll>
#using <System.Data.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::Data;
using namespace System::Data::Sql;
using namespace System::Data::SqlClient;
using namespace System::Data::SqlTypes;
using namespace Microsoft::SqlServer::Server;
// In order to debug your Stored Procedure, add the following to your debug.sql file:
//
// EXEC InsertCurrency_CPP 'AAA', 'Currency Test'
// SELECT * FROM Sales.Currency WHERE CurrencyCode = 'AAA'
public ref class StoredProcedures
{
public:
[SqlProcedure]
static void InsertCurrency_CPP(SqlString currencyCode, SqlString name)
{
SqlConnection ^conn = gcnew SqlConnection("context connection=true");
SqlCommand ^insertCurrencyCommand = gcnew SqlCommand();
SqlParameter ^currencyCodeParam =
gcnew SqlParameter("@CurrencyCode", SqlDbType::NVarChar);
SqlParameter ^nameParam =
gcnew SqlParameter("@Name", SqlDbType::NVarChar);
insertCurrencyCommand->CommandText =
"insert Sales.Currency(CurrencyCode, Name, ModifiedDate)" +
" values(@CurrencyCode, @Name)";
insertCurrencyCommand->Connection = conn;
conn->Open();
insertCurrencyCommand->ExecuteNonQuery();
conn->Close();
}
};
ストアド プロシージャの実行とテストを行うコードを、プロジェクトの TestScripts フォルダにある Test.sql (Visual C++ の場合は debug.sql) ファイルに追加します。たとえば、ストアド プロシージャを配置した場合、EXEC <StoredProcedureName> を呼び出して、必要なパラメータをすべて渡すことで実行します。ストアド プロシージャから値がまったく返されない場合、データがストアド プロシージャの影響を受けたことを確認するために追加のコードを挿入します。
EXEC InsertCurrency 'AAA', 'Currency Test'
SELECT * from Sales.Currency where CurrencyCode = 'AAA'
参照
処理手順
方法 : CLR の SQL Server ストアド プロシージャを作成および実行する
方法 : CLR の SQL Server トリガを作成および実行する
方法 : CLR の SQL Server の集計を作成および実行する
方法 : CLR の SQL Server ユーザー定義関数を作成および実行する
方法 : CLR の SQL Server ユーザー定義型を作成および実行する
チュートリアル : マネージ コードでのストアド プロシージャの作成
方法 : SQL CLR のストアド プロシージャをデバッグする
概念
SQL Server の CLR 統合の概要 (ADO.NET)
マネージ コードを使用したデータベース オブジェクトの作成の利点
参照
SQL Server プロジェクトおよびデータベース オブジェクトの属性