1. 程式人生 > >.net 呼叫Oracle儲存過程

.net 呼叫Oracle儲存過程

在.NET中呼叫Oracle9i儲存過程經驗總結(1) 

在.NET中呼叫Oracle9i儲存過程可以用多個數據提供者,比如OralceClient,OleDb。本文將用OralceClient為例。.NET語言用C#。

一、呼叫一個帶輸入、輸出引數的儲存過程

首先,在Oralce中建立儲存過程如下:

create or replace procedure GetRecords(name_out out varchar2,age_in in varchar2) 
as
begin
select NAMEinto name_out from test where AGE = age_in;
end;

然後,在C#專案中作如下呼叫:

string connectionString = "DataSource=YXZHANG;User ID=YXZHANG;Password=YXZHANG";
     string queryString = "getrecords";
    OracleConnection cn = newOracleConnection(connectionString);
    OracleCommand cmd = newOracleCommand(queryString,cn);
    cmd.CommandType = CommandType.StoredProcedure;
    cmd.Parameters.Add("name_out",OracleType.VarChar,20);
    cmd.Parameters["name_out"].Direction = ParameterDirection.Output;
    cmd.Parameters.Add("age_in",21);
    
     try
     {
        cn.Open();
        cmd.ExecuteNonQuery();
        Console.WriteLine("Nameis:{0}",cmd.Parameters["name_out"].Value.ToString());
        cn.Close();
     }
     catch( OracleException ex )
     {
        Console.WriteLine("Exception occurred!");
        Console.WriteLine("The exception messageis:{0}",ex.Message.ToString());
     }
     finally
     {
        Console.WriteLine("------------------End-------------------");
     }

小結:

以上是很平常的呼叫方法,但是我在做這個示例程式的時候,卻不是那麼一帆風順。這裡要指出OracleClient的一個不盡如人意之處,就是對於引數名稱,必須和儲存過程定義中的引數同名,否則就會報錯。比如將程式碼中的“name_out”改為別的名稱的話,就會報異常。但我試著用OleDb代替OralceClient,卻沒有這個問題。不知道在新版本的資料提供程式中會否改進這一點?

二、呼叫不返回資料的儲存過程

首先,在Oralce中建立儲存過程如下:

create or replace procedure insertRecord(UserID in varchar2,
UserName in varchar2,
                                        UserAge in varchar2) is
    begin
     insert into test values(UserID, UserName, UserAge);
    end;

然後,在C#專案中作如下呼叫:

string connectionString= "Data Source=YXZHANG;User ID=YXZHANG;Password=YXZHANG";
string queryString ="insertRecord";
OracleConnection cn = newOracleConnection(connectionString);
OracleCommand cmd = newOracleCommand(queryString,cn);
cmd.CommandType = CommandType.StoredProcedure;
     cmd.Parameters.Add("UserID","007");
    cmd.Parameters.Add("UserName","Dell");
    cmd.Parameters.Add("UserAge","40");     
     try
     {
        cn.Open();
        cmd.ExecuteNonQuery();
        Console.WriteLine("Record inserted!");
        cn.Close();
     }
     catch( OracleException ex )
     {
        Console.WriteLine("Exception occurred!");
        Console.WriteLine("The exception messageis:{0}",ex.Message.ToString());
     }
     finally
     {
        Console.WriteLine("------------------End-------------------");
     }

小結:

       不返回資料的儲存過程一般有Delete, Insert, Update等。雖然它們的SQL語句不同,但是呼叫方面都是一樣的。只要傳入正確的引數,一般不會出什麼問題。不過還是要注意,在使用OralceClient作為資料提供者的時候,引數名稱一定要和儲存過程定義中的一致!至於引數新增的順序倒是無所謂的,因為有引數名稱作為區別。

在.NET中呼叫Oracle9i儲存過程經驗總結(2) 

三、IDENTITY 和 SEQUENCE

Sql Server中,定義一個列為遞增列很容易,但我在Oracle中卻怎麼也找不到設定的方法。不過查了點資料後知道Oracle中有個叫Sequence的物件,產生一個唯一的序列號,類似於Sql Server中的IDENTITY。於是,我做了如下實驗:

首先,在Oracle中建立了一個名為TEST_SEQ的Sequence物件,SQL語句如下:

create sequence TEST_SEQ
minvalue 100
maxvalue 999
start with 102
increment by 1
nocache;

語法應該是比較易懂的,最小最大值分別用minvalue,maxvalue表示,初始值是102(這個數字是動態變化的,我建立的時候設的是100,後因插入了2條資料後就自動增加了2),increment當然就是步長了。在PL/SQL中可以用test_seq.nextval訪問下一個序列號,用test_seq.currval訪問當前的序列號。

    定義完了Sequence,接下來就是建立一個儲存過程InsertRecordWithSequence:

--這次我修改了test表的定義,和前面的示例不同。其中,UserID是PK。

create or replace procedureInsertRecordWithSequence(UserID   out number,
                                                        UserName in varchar2,
                                                        UserAge  in number)
is
begin
        insert into test(id, name,age)         --插入一條記錄,PK值從Sequece獲取
        values(test_seq.nextval, UserName,UserAge);
/*返回PK值。注意Dual表的用法*/
select test_seq.currval intoUserIDfrom dual;   
end InsertRecordWithSequence;

接下來,就是在C#中進行呼叫了:

string connectionString= "Data Source=YXZHANG;User ID=YXZHANG;Password=YXZHANG";
     string queryString ="InsertRecordWithSequence";
    OracleConnection cn = newOracleConnection(connectionString);
    OracleCommand cmd = new OracleCommand(queryString,cn);
    cmd.CommandType = CommandType.StoredProcedure;
    cmd.Parameters.Add("UserID",OracleType.Number);
    cmd.Parameters["UserID"].Direction = ParameterDirection.Output;
     cmd.Parameters.Add("UserName","Jack");
    cmd.Parameters.Add("UserAge",40); 
     try
     {
         cn.Open();
         int rowAffected =cmd.ExecuteNonQuery();
         Console.WriteLine("{0}行已插入。",rowAffected);
         Console.WriteLine("插入行的ID為:{0}",cmd.Parameters["UserID"].Value.ToString());
        cn.Close();
     }
     catch( OracleException ex )
     {
        Console.WriteLine("Exception occurred!");
        Console.WriteLine("The exception messageis:{0}",ex.Message.ToString());
     }
     finally
     {
        Console.WriteLine("------------------End-------------------");
     } 

小結:

    使用Sequece物件可以很容易地建立唯一序列,在儲存過程中的呼叫也十分方便,只要sequence_name.nextval以及sequence.currval就能得到下一個以及當前的序列值。倒是Dual表值得注意。

在.NET中呼叫Oracle儲存過程經驗總結(3)  

四、使用DataReader讀取返回的結果集

為了讓儲存過程返回結果集,必須定義一個遊標變數作為輸出引數。這和Sql Server中有著很大的不同!並且還要用到Oracle中“包”(Package)的概念,似乎有點繁瑣,但熟悉後也會覺得很方便。

關於“包”的概念,有很多內容可以參考,在此就不贅述了。首先,我建立了一個名為TestPackage的包,包頭是這麼定義的: 

 create or replace package TestPackage is
    typemycursor is ref cursor; --定義遊標變數
     procedureGetRecords(ret_cursor out mycursor);-- 定義過程,用遊標變數作為返回引數
endTestPackage; 

包體是這麼定義的:

create orreplace package body TestPackage is
/*過程體*/
         procedure GetRecords(ret_cursor outmycursor) as
         begin
             open ret_cursor for select*from test;
         end GetRecords;
endTestPackage;

    已經萬事具備了,讓我們前臺呼叫試試:

string connectionString= "Data Source=YXZHANG;User ID=YXZHANG;Password=YXZHANG";
     string queryString ="TestPackage.GetRecords";    //注意呼叫方法
    OracleConnection cn = newOracleConnection(connectionString);
    OracleCommand cmd = newOracleCommand(queryString,cn);
    cmd.CommandType = CommandType.StoredProcedure;
    cmd.Parameters.Add("ret_cursor",OracleType.Cursor);    //注意這裡的型別
     cmd.Parameters["ret_cursor"].Direction =ParameterDirection.Output;
    
     try
     {
        cn.Open();
        OracleDataReader dr = cmd.ExecuteReader();
        int i = 1;
        while( dr.Read() )
        {
             Console.WriteLine("Record {0}:",i++);
             Console.WriteLine("ID:{0}   Name:{1} Age:{2}",
dr.GetOracleNumber(0),
dr.GetOracleString(1),
dr.GetOracleNumber(2));
             Console.WriteLine();
        }
        dr.Close();        //用完DataReader物件要記得及時關閉
        cn.Close();        //DataReader物件未關閉之前,不能關閉連線
     }
     catch( OracleException ex )
     {
        Console.WriteLine("Exception occurred!");
        Console.WriteLine("The exception messageis:{0}",ex.Message.ToString());
     }
     finally
     {
        Console.WriteLine("------------------End-------------------");
     } 

請看結果:

Record 1:

ID:100  Name:Tony       Age:23

Record 2:

ID:101  Name:Jack       Age:40

------------------End-------------------

小結:

    包是Oracle特有的概念,Sql Server中找不到相匹配的東西。在我看來,包有點像VC++的類,包頭就是.h檔案,包體就是.cpp檔案。包頭只負責定義,包體則負責具體實現。如果包返回多個遊標,則DataReader會按照您向引數集合中新增它們的順序來訪問這些遊標,而不是按照它們在過程中出現的順序來訪問。可使用DataReader的NextResult()方法前進到下一個遊標。

在.NET中呼叫Oracle儲存過程經驗總結(4)  

五、用返回的結果集填充DataSet

ADO.NET捨棄了原來ADO中RecordSet的概念,而使用全新的DataSet來替代。DataSet可以提供更加強大的功能!有了前面的基礎,利用ADO.NET從Oralce返回DataSet也是非常簡單的。主要思想就是用DataAdapter接收返回的遊標,再用DataAdapter的Fill()方法填充資料集。在下面的例子中,我仍用了前一個例子中建好的TestPackage包。

下面是前臺呼叫主要程式碼:

string connectionString= "Data Source=YXZHANG;User ID=YXZHANG;Password=YXZHANG";
     string queryString = "TestPackage.GetRecords";
    OracleConnection cn = newOracleConnection(connectionString);
    OracleCommand cmd = newOracleCommand(queryString,cn);
    cmd.CommandType = CommandType.StoredProcedure;
    cmd.Parameters.Add("ret_cursor",OracleType.Cursor);
    cmd.Parameters["ret_cursor"].Direction = ParameterDirection.Output;
    
     try
     {
        cn.Open();
        OracleDataAdapter da = newOracleDataAdapter(cmd);
        DataSet ds = new DataSet();
        da.Fill(ds,"TestTable");
        cn.Close();
        for( int i =0;i <= ds.Tables["TestTable"].Rows.Count-1;i++ )
        {
             string id =ds.Tables["TestTable"].Rows[i]["ID"].ToString();
             string name =ds.Tables["TestTable"].Rows[i]["NAME"].ToString();
             string age =ds.Tables["TestTable"].Rows[i]["AGE"].ToString();
             Console.WriteLine("Record {0}:",i+1);
             Console.WriteLine("ID:{0}\tName:{1}\tAge:{2}\n",id,name,age);
        }
     }
     catch( OracleException ex )
     {
        Console.WriteLine("Exception occurred!");
        Console.WriteLine("The exception messageis:{0}",ex.Message.ToString());
     }
     finally
     {
        Console.WriteLine("------------------End-------------------");
     } 

小結:

    程式呼叫後的結果和剛才用DataReader呼叫的結果一樣。這裡只說明怎樣利用ADO.NET呼叫Oracle儲存過程,以及怎樣填充至資料集中。至於怎樣操縱DataSet,不是本文的討論範圍。有興趣的讀者可以參考MSDN以及相關書籍。

 在.NET中呼叫Oracle儲存過程經驗總結(5) 

六、用DataAdapter更新資料庫

通常用DataAdapter取回DataSet,將會對DataSet進行一些修改,繼而更新資料庫(如果只是為了獲取資料,微軟推薦使用DataReader代替DataSet)。然而,通過儲存過程更新資料庫,並不是那麼簡單,不能簡單地通過DataAdapter的Update()方法進行更新。必須手動為DataAdapter新增InsertCommand, DeleteCommand,UpdateCommand,因為儲存過程對這些操作的細節是不知情的,必須人為給出。

為了達成這個目標,我完善了之前的TestPackage包,包頭如下: 

create or replace package TestPackage is
     typemycursor is ref cursor;
     procedureUpdateRecords(id_in in number,newNamein varchar2,newAgein number);
     procedureSelectRecords(ret_cursor out mycursor);
     procedureDeleteRecords(id_in in number);
     procedureInsertRecords(name_in in varchar2, age_inin number);
endTestPackage; 

包體如下:

create orreplace package body TestPackage is
    procedure UpdateRecords(id_in in number,newName in varchar2, newAge  in number) as
    begin
     update test set age = newAge, name= newNamewhere id = id_in;
    end UpdateRecords;

    procedure SelectRecords(ret_cursor outmycursor)as
    begin
       open ret_cursor for select* from test;
    end SelectRecords;

    procedure DeleteRecords(id_in in number)as
    begin
       delete from test whereid = id_in;
    end DeleteRecords;

    procedure InsertRecords(name_in in varchar2,age_inin number) as
    begin
       insert into test values(test_seq.nextval, name_in, age_in);
--test_seq是一個已建的Sequence物件,請參照前面的示例
endInsertRecords;
    end TestPackage; 

前臺呼叫程式碼如下,有點繁瑣,請耐心閱讀:

string connectionString = "Data Source=YXZHANG;User ID=YXZHANG;Password=YXZHANG";
     string queryString ="TestPackage.SelectRecords";
    OracleConnection cn = newOracleConnection(connectionString);
    OracleCommand cmd = newOracleCommand(queryString,cn);
    cmd.CommandType = CommandType.StoredProcedure;
    cmd.Parameters.Add("ret_cursor",OracleType.Cursor);
     cmd.Parameters["ret_cursor"].Direction =ParameterDirection.Output;
    
     try
     {
         cn.Open();
         OracleDataAdapter da = newOracleDataAdapter(cmd);
         DataSet ds = new DataSet();
         da.Fill(ds,"TestTable");
         cn.Close();
         int count =ds.Tables["TestTable"].Rows.Count;
        
         /*列印原始記錄*/
         Console.WriteLine("Old Records is:");
         for( int i = 0;i <= count - 1;i++ )
        {
             string id =ds.Tables["TestTable"].Rows[i]["ID"].ToString();
             string name =ds.Tables["TestTable"].Rows[i]["NAME"].ToString();
             string age =ds.Tables["TestTable"].Rows[i]["AGE"].ToString();
 
             Console.WriteLine("Record {0}:",i+1);
             Console.WriteLine("ID:{0}\tName:{1}\tAge:{2}\n",id,name,age);
        }
        
        da.SelectCommand = cmd;    //為DataAdapter指定SelectCommand
 
        OracleCommand updateCmd = newOracleCommand("TestPackage.UpdateRecords",cn);
        updateCmd.CommandType = CommandType.StoredProcedure;
        updateCmd.Parameters.Add("id_in",OracleType.Number,3,"ID");
        updateCmd.Parameters.Add("newName",OracleType.VarChar,20,"NAME");
        updateCmd.Parameters.Add("newAge",OracleType.Number,3,"AGE");
        da.UpdateCommand = updateCmd;        //為DataAdapter指定UpdateCommand
 
        OracleCommand deleteCmd = newOracleCommand("TestPackage.DeleteRecords",cn);
        deleteCmd.CommandType = CommandType.StoredProcedure;
        deleteCmd.Parameters.Add("id_in",OracleType.Number,3,"ID");
        da.DeleteCommand = deleteCmd;        //為DataAdapter指定DeleteCommand
 
        OracleCommand insertCmd = newOracleCommand("TestPackage.InsertRecords",cn);
         insertCmd.CommandType = CommandType.StoredProcedure;
        insertCmd.Parameters.Add("name_in",OracleType.VarChar,20,"NAME");
        insertCmd.Parameters.Add("age_in",OracleType.Number,3,"AGE");
        da.InsertCommand = insertCmd;        //為DataAdapter指定InsertCommand
 
        DataTable newTable = ds.Tables["TestTable"];
        
        /*修改第一條記錄*/
        newTable.Rows[0]["AGE"] = 22;
        newTable.Rows[0]["NAME"] = "John";
        
        /*刪除一條記錄*/
        newTable.Rows[2].Delete();
 
        /*插入一條記錄*/
        DataRow newRow = newTable.NewRow();
        newRow["NAME"] = "Bob";
        newRow["AGE"] = 99;
        newTable.Rows.Add(newRow);
 
        cn.Open();
        da.Update(newTable);       //將更改更新到資料庫
        newTable.Clear();            //清空DataTable
        da.Fill(newTable);           //獲取更改後的資料
        cn.Close();
 
        /*列印新記錄*/
        Console.WriteLine("New Records is:");
        for( int i =0;i <= newTable.Rows.Count - 1;i++ )
        {
             string id =newTable.Rows[i]["ID"].ToString();
             string name =newTable.Rows[i]["NAME"].ToString();
             string age =newTable.Rows[i]["AGE"].ToString();
 
             Console.WriteLine("Record {0}:",i+1);
            Console.WriteLine("ID:{0}\tName:{1}\tAge:{2}\n",id,name,age);
        }
     }
     catch( OracleException ex )
     {
         Console.WriteLine("Exception occurred!");
         Console.WriteLine("The exception messageis:{0}",ex.Message.ToString());
     }
     finally
     {
        Console.WriteLine("------------------End-------------------");
} 

執行結果如下:

Old Records is:

Record 1:

ID:100  Name:Tony       Age:23

Record 2:

ID:101  Name:Jack       Age:34

Record 3:

ID:103  Name:newAdd     Age:100

New Records is:

Record 1:

ID:100  Name:John       Age:22

Record 2:

ID:101  Name:Jack       Age:34

Record 3:

ID:104  Name:Bob        Age:99

------------------End-------------------

小結:

使用Update()方法更新資料庫是非常有用的,但是隻侷限於單個表,對於表連線的情況,還是直接用OracleCommand的ExcuteNonQuery()方法去執行更新操作比較方便。

七、本文總結:

在.NET中利用ADO.NET呼叫Oralce9i中的儲存過程,函式,包等,可以提高效率,也能完成一些複雜的業務邏輯。然而呼叫Oracle儲存過程和Sql Server中有著很大不同,最需要明確的一個思想就是:在Oracle的過程中,所有返回值必須以輸出引數的形式出現。在Oracle中,要返回一個結果集,就必須把REF CURSOR作為返回引數,因此就要用到包。包類似於C++中的類,封裝了一些全域性變數、常量和函式,在函式中又可以有自己的私有變數。通過返回給應用程式的遊標,應用程式就可以用DataReader或者DataAdapter接收它,進而做一些處理。還還可以用DataAdapter的Update()方法更新資料庫,當然它需要你給出更新資料庫的一些操作(為其定義處理過程)。

由於筆者是邊學邊寫,以上示例不免有些不妥之處,請多多指教!