方法:CLR データベースオブジェクトを使用する

[アーティクル]
06/02/2023

Transact-SQL プログラミング言語の他にも、.NET Framework 言語を使用して、データの取得と更新を行うデータベースオブジェクトを作成できます。マネージドコードで記述したデータベースオブジェクトは、SQL Server 共通言語ランタイム (CLR: Common Language Run) データベースオブジェクトと呼ばれます。 SQL Server でホストされる CLR データベースオブジェクトを使用する利点と、Transact-SQL と CLR の間での選択方法については、CLR 統合の利点に関する記事と、「マネージドコードを使用したデータベースオブジェクトの作成の利点」を参照してください。

SQL Server Data Tools で CLR データベースオブジェクトを作成するには、データベースプロジェクトを作成し、これに CLR データベースオブジェクトを追加します。以前のバージョンの Visual Studio とは異なり、CLR プロジェクトを別に作成したうえで、データベースプロジェクトからこのプロジェクトへの参照を追加する必要がありません。データベースプロジェクトをビルドして公開すると、自動的にプロジェクト内の CLR オブジェクトも同時に公開されます。このように公開された CLR オブジェクトは、他のデータベースオブジェクトと同じように呼び出して実行できます。

CLR および CLR ビルドのプロパティページには、CLR オブジェクトをプロジェクトで使用するための設定が多数含まれています。具体的には、CLR プロパティページには CLR アセンブリに対するアクセス許可を設定するためのアクセス許可レベル設定が含まれています。また、プロジェクトに追加された CLR データベースオブジェクトの DDL を生成するかどうかを制御する "DDL を生成する" 設定も含まれています。 CLR ビルドのプロパティページには、プロジェクト内の CLR コードのコンパイルを構成するために設定できるコンパイラオプションがすべて含まれています。これらのプロパティページにアクセスするには、ソリューションエクスプローラーでプロジェクトを右クリックして、 [プロパティ] をクリックします。

CLR データベースオブジェクトのデバッグを有効にするには、SQL Server オブジェクトエクスプローラーを開きます。デバッグする CLR データベースの成果物を含むサーバーを右クリックし、 [SQL または CLR のデバッグの許可] をクリックします。メッセージボックスに、警告が表示されます。"デバッグ中は、サーバー上のすべてのマネージスレッドが停止されます。このサーバーで SQL/CLR デバッグを有効にしますか?" という警告がメッセージボックスに表示されます。 CLR データベースオブジェクトをデバッグすると、実行の中断によりサーバー上のすべてのスレッドが停止され、その他のユーザーに影響します。このため、CLR データベースオブジェクト用アプリケーションのデバッグは運用サーバーでは行わないようにしてください。また、デバッグを開始すると、SQL Server オブジェクトエクスプローラー の設定を変更できないことにも注意してください。 SQL Server オブジェクトエクスプローラー で行われた変更が反映されるのは、次回デバッグセッションを開始するときです。

CLR データベースオブジェクトをビルドするための要件について詳しくは、「共通言語ランタイム (CLR) 統合によるデータベースオブジェクトの構築」の関連トピックをご覧ください。

警告

以下に示す手順では、「プロジェクト指向のオフラインデータベース開発」セクションのこれまでの手順で作成したエンティティを使用します。

プロジェクトに CLR データベースオブジェクトを追加するには

ソリューションエクスプローラーで TradeDev データベースプロジェクトを右クリックし、 [追加] をポイントして、 [新しい項目] をクリックします。
[C# SQL CLR] テンプレートをクリックし、 [SQL CLR ユーザー定義関数] をクリックします。既定の名前をそのままにして、[追加] を選択します。

クラス本体に次のコードを追加します。この関数では、米国の電話番号を検証します。有効な番号は、順に 3 桁の数字 (かっこで囲まれていてもよい)、3 桁の数字、および 4 桁の数字で構成されている必要があります。サポートされる形式は、(425) 555-0123、425-555-0123、425 555 0123、1-425-555-0123 などです。


[SqlFunction(IsDeterministic = true, IsPrecise = true)]  
public static SqlBoolean validatePhone(SqlString phone)  
{  
    string aNorthAmericanPhoneNumberPattern = @"^[01]?[- .]?(\([2-9]\d{2}\)|[2-9]\d{2})[- .]?\d{3}[- .]?\d{4}$";  
    if (!phone.IsNull)  
    {  
       Regex regex = new Regex(aNorthAmericanPhoneNumberPattern);  
       return regex.IsMatch(phone.Value);  
    }  
    return true;  
 }

Regex は赤色の下線付きになっています。 Regex を右クリックし、 [解決] をクリックして、using System.Text.RegularExpressions をクリックします。
Microsoft SQL Server 2012 のサーバーインスタンスに対して開発を行っている場合は、この手順をスキップできます。それ以外の場合、SQL Server 2005 および SQL Server 2008 では .NET Framework の Version 2.0、3.0、または 3.5 でビルドされたデータベースプロジェクトのみがサポートされます。 .NET ターゲットプラットフォームが正しく設定されているか確認するには、ソリューションエクスプローラーで TradeDev データベースプロジェクトを右クリックし、 [プロパティ] をクリックします。 SQLCLR プロパティページで、 [ターゲットプラットフォーム] を .NET Framework 3.5 以下に変更します。最終画面で [はい] を選択してプロジェクトを閉じ、再度開きます。
TradeDev プロジェクトを右クリックし、 [ビルド] をクリックしてプロジェクトをビルドします。
Suppliers.sql をダブルクリックして [デザイナーの表示] をクリックすることにより、テーブルデザイナーで Suppliers テーブルを開きます。
列グリッドで空の行を選択し、テーブルに新しい列を追加します。 [名前] に「phone」、 [データ型] に「nvarchar (128) 」と入力し、 [Null を許容] チェックボックスはオンのままにします。
コンテキストペインの [CHECK 制約] ノードを右クリックし、 [新しい CHECK 制約の追加] をクリックします。
スクリプトペインで、制約の既定の定義を次のように変更します。
```
CONSTRAINT [CK_Suppliers_CheckPhone] CHECK (dbo.validatePhone(phone)=1),  
```
これにより、新しい phone フィールドへの入力はすべて、前に追加した CLR UDF でチェックされるようになります。
F5 キーを押してプロジェクトをビルドし、ローカルデータベースに配置します。

CLR データベースオブジェクトを使用するには

SQL Server オブジェクトエクスプローラーで、プロジェクトを配置する先のローカルデータベースに移動します。
既定では、SQL Server の CLR 統合機能はオフになっています。 CLR データベースオブジェクトを使用するには、CLR 統合機能を有効にする必要があります。 CLR 統合を有効にするには、sp_configure ストアドプロシージャの "clr enabled" オプションを使用します。詳しくは、「clr 有効化オプションに関する記事」をご覧ください。

データベースを右クリックし、 [新しいクエリ] をクリックします。クエリペインに次のコードを貼り付け、 [クエリの実行] をクリックします。
```
sp_configure 'clr enabled', 1;  
GO  
RECONFIGURE;  
GO  
```
Suppliers テーブルを右クリックして、 [データの表示] をクリックします。
id に「5」、name に「Contoso」と入力し、Address フィールドを空のままにして、phone に「425 3122 1222」と入力します。 phone フィールドから Tab キーで移動すると、メッセージが表示され、定義済みの電話番号形式を使用して phone フィールドの入力をチェックする既存の CHECK 制約と、INSERT ステートメントとが競合していることを示します。
入力を「425 312 1222」に変更して Tab キーで移動します。今回は入力が受け入れられます。

参照

CLR 統合機能の利点
 マネージドコードを使用してデータベースオブジェクトを作成する利点
 共通言語ランタイム (CLR) 統合を使用したデータベースオブジェクトの構築

方法:CLR データベースオブジェクトを使用する

プロジェクトに CLR データベースオブジェクトを追加するには

CLR データベースオブジェクトを使用するには

参照

フィードバック

フィードバック

その他のリソース

方法:CLR データベース オブジェクトを使用する

プロジェクトに CLR データベース オブジェクトを追加するには

CLR データベース オブジェクトを使用するには

参照

フィードバック

フィードバック

その他のリソース

方法:CLR データベースオブジェクトを使用する

プロジェクトに CLR データベースオブジェクトを追加するには

CLR データベースオブジェクトを使用するには