| Oracle® Database Extensions for .NET開発者ガイド ODAC 12.2c リリース1 (12.2.0.1) for Microsoft Windows E88314-01 |
|
 前 |
 次 |
| Oracle® Database Extensions for .NET開発者ガイド ODAC 12.2c リリース1 (12.2.0.1) for Microsoft Windows E88314-01 |
|
|
前 |
次 |
これらの項では、.NETストアド・ファンクションの開発およびデプロイ方法を説明します。
関連項目:
これらのコンポーネントの詳細は、Oracle Developer Tools for Visual Studioヘルプを参照してください
このデモでは、Oracle Developer Tools for Visual Studioのみを使用しますが、一部のプロセスは他のOracleツールを使用して実行できます。また、このデモではOracle Developer Tools for Visual Studioの次のコンポーネントを参照します。
Oracleエクスプローラ
Oracle Project
Oracle Deployment Wizard for .NET
このデモでは、GetDeptNoという.NETストアド・ファンクションを開発し、PL/SQLラッパーGETDEPTNOとともにデプロイします。GetDeptNoファンクションは、従業員番号(EMPNO)を受け入れて問合せを実行し、従業員の部門番号(DEPTNO)を戻します。
このデモは、Visual Studioを開き、ファンクションを作成してアセンブリに組み込むことから始まります。
CLRLibrary1を指定し、場所を指定します。クラスCLRLibrary1.Class1が表示されます。このクラスには、ストアド・プロシージャ用のテンプレートが含まれています。
ビルド・メニューからOracle Deployment Wizard for .NETを起動できます。
次に、「次へ」をクリックします。
ドロップダウン・リストから接続を選択して「次へ」をクリックするか、接続していない場合は「新規接続」をクリックします。
SYSBA接続を選択または追加する必要があります。
「接続の詳細」タブで、ドロップダウン・リストからデータ・ソース名を選択します。「Windowsの統合認証の使用」オプションまたは「特定のユーザー名およびパスワードを使用」オプションを選択し、該当する情報を入力できます。必要な場合は、「パスワードの保存」を選択します。「ロール」には使用可能な唯一のオプションであるSYSDBAが表示されます。接続をテストする場合は、「接続のテスト」をクリックします。「OK」をクリックします。
デプロイ・ウィザードを初めて実行するときには、「アセンブリをコピーしてストアド・プロシージャを生成」を選択します。後でファンクションまたはストアド・プロシージャを変更する場合は、デプロイ・ウィザードを再実行して、これらの操作の1つのみを実行するように選択できます。「次へ」をクリックします。
アセンブリを指定するには、ドロップダウン・リストからプロジェクトを選択するか、「ファイル」を選択して「参照」をクリックし、該当のプロジェクトにナビゲートします。
選択したアセンブリに使用するライブラリ・データベース・オブジェクトの名前を指定するには、デフォルトを受け入れるか、ドロップダウン・リストから名前を選択するか、または新しい名前を入力します。
このデモでは、デフォルトのプロジェクトとライブラリ名を受け入れて「次へ」をクリックします。
データベースにコピーする依存アセンブリを指定するには、リストから選択します。このリストには、依存アセンブリの候補がすべて表示されます。この場合、表示されるアセンブリはデータベースにコピー済であるため、コピーする必要はありません。アセンブリをデフォルトのbin\clr以外のディレクトリにデプロイするには、コピー先パスを変更します。コピー先には、bin\clrディレクトリまたは既存のサブディレクトリの1つを指定する必要があります。
このデモでは、依存アセンブリを選択せず、コピー先パスを変更しないでください。
必要な場合は、「データベースにファイルがすでに存在する場合は上書き」を選択します。
次に、「次へ」をクリックします。
メソッドおよびセキュリティ詳細の指定ウィンドウが表示されます。
デプロイ対象となるプロジェクト全体を選択するか、展開して特定のファンクションをデプロイするように選択できます。このプロジェクトにはファンクションが1つしかないため、項目を1つ選択するとプロジェクト全体が選択されます。複数のファンクションまたはプロシージャがある場合は、デプロイする項目を個別に選択できます。
デプロイ対象として他のスキーマを選択する場合は、このウィンドウで選択できます。必要なスキーマがリストに表示されない場合は、別のフィルタを適用する必要があります。このプロセスの詳細は、Oracle Developer Tools for Visual Studioヘルプを参照してください。
ドロップダウン・リストを使用してセキュリティ・レベルを設定できます。設定可能なレベルは次のとおりです。
「パラメータ・タイプ・マッピング...」を選択した場合は、パラメータ・タイプ・マッピング・ウィンドウが表示され、ドロップダウン・リストを使用してデータ型を変更できます。
このデモでは、.NETデータ型System.Int32からOracleのBINARY_INTEGER型へのデフォルト・マッピングを受け入れます。
「OK」をクリックしてメソッドおよびセキュリティ詳細の指定ウィンドウに戻ります。
関連項目:
データ型マッピングの表は、「データ型変換」を参照してください
Oracle Deployment Wizard for .NETのサマリー・ウィンドウが表示され、指定した内容がすべて表示されます。このウィンドウで「戻る」を選択すると任意の値を変更できます。
このデモを完了するには、次を行います。
この時点で、GetDeptNo()ファンクションがOracleデータベースにデプロイされ、PL/SQLラッパー・ファンクションをコールしてテストする準備が完了したことになります。
このデモでは、ファンクションをコールするためにデフォルト・ユーザーscottとして接続する必要があります。
ファンクションを次のツールからコールしてテストします。
Oracle Developer Tools for Visual Studioでファンクションを検索してコールする手順は、次のとおりです。
ドキュメント・ウィンドウに出力値10が表示されます。これは、従業員番号7934が部門10に属していることを示します。
次のコード例に、.NETファンクションのPL/SQLラッパーの起動方法を示します。
using System;
using System.Data;
using Oracle.DataAccess.Client;
namespace ODPNETClientApp
{
public class Class1
{
public static void Main()
{
int empno = 7934;
int deptno = 0;
try
{
// Open a connection to the database
OracleConnection con = new OracleConnection(
"User Id=scott; Password=tiger; Data Source=inst1");
con.Open();
// Create and execute the command
OracleCommand cmd = con.CreateCommand();
cmd.CommandType = CommandType.StoredProcedure;
cmd.CommandText = "GETDEPTNO";
// Set parameters
OracleParameter retParam = cmd.Parameters.Add(":DEPTNO",
OracleDbType.Int32, System.Data.ParameterDirection.ReturnValue);
cmd.Parameters.Add(":EMPNO", OracleDbType.Int32, empno,
System.Data.ParameterDirection.Input);
cmd.ExecuteNonQuery();
deptno = (int)retParam.Value;
Console.WriteLine("\nEmployee# {0} working in department# {1}\n",
empno, deptno);
cmd.Dispose();
con.Close();
}
catch (Exception e)
{
Console.WriteLine(e.Message);
}
}
} // Class1
} // ODPNETClientApp namespace
