.NET 訪問 Oracle 資料庫相關
長期以來,我一直用的是 MS SQL Server / Access 資料庫,通過 .NET 訪問 MS 自家的東西幾乎沒碰到過什麼麻煩。最近專案中要用 Oracle 作為資料庫,學習研究了一些 .NET 訪問 Oracle 的東西,發現問題倒真的不少。
1。System.Data.OracleClient 和 System.Data.OleDb 名稱空間
雖然通過這兩個名稱空間的類都可以訪問 Oracle 資料庫,但和 SQL Server 類似的(System.Data.SqlClient 名稱空間的類效率要比 System.Data.OleDb 名稱空間中的類高一些),System.Data.Oracle
當然還有另一點就是從針對性上說,System.Data.OracleClient 要更好一些:
比如資料型別,System.Data.OleDb.OleDbType 列舉中所列的就沒有 System.Data.OracleClient.OracleType 列舉中的那些有針對性;另外,Oracle 的 Number 型別如果數字巨大,超出 .NET 資料類型範圍的情況中,就必須使用 System.Data.Oracle
好了,不再贅述這兩個的比較,下面主要討論 System.Data.OracleClient 名稱空間中的型別,即 ADO.NET for Oracle Data Provider (資料提供程式)。
2。資料庫連線:
無論是 System.Data.OleDb 還是 System.Data.OracleClient 訪問 Oracle 都需要在 .NET 執行的機器(ASP.NET 中就是 Web 伺服器)安裝 Oracle 客戶端元件。(這一點是和 MS 的兩種資料庫不同的,MS 的東西安裝 MDAC: Microsoft Data Access Component 2.6 以上版本後,就無須再安裝 SQL Server 客戶端或者 Office 軟體,就能訪問。)
System Requirements:
(1)如用 System.Data.OracleClient 訪問 Oracle,客戶端元件版本應在 Oracle 8i Client Release 3 (8.1.7)以上版本。MS 只確保訪問 Oracle 8.1.6、Oracle 8.1.7、Oracle 9i 伺服器時的情況。MDAC 2.6 以上。
(2)如用 System.Data.OleDb 訪問 Oracle,客戶端元件版本 7.3.3.4.0 以上或 8.1.7.4.1 以上。MDAC 2.6 以上。
如伺服器為 Oracle8i 以上,客戶端元件版本應為 8.0.4.1.1c。
在 .NET 執行的機器中,安裝 Oracle 客戶端,然後開啟 Net Manager (Oracle 9i) / Easy Config (Oracle 8i) 按你以前的經驗設定本地服務的對映(這裡的服務名將用於資料庫連線串)。
System.Data.OracleClient 中訪問 Oracle 資料庫的連線串是:
User ID=使用者名稱; Password=密碼; Data Source=服務名
(上述為一般的連線串,詳細的連線串專案可以在 System.Data.OracleClient.OracleConnection.ConnectionString 屬性的文件中找到。)
System.Data.OleDb 中的訪問 Oracle 資料庫的連線串是:
Provider=MSDAORA.1; User ID=使用者名稱; Password=密碼; Data Source=服務名
3。Oracle 中的資料型別:
Oracle 的資料型別和 SQL Server 相比,要“奇怪”一些:SQL Server 的大多資料型別很容易找到 .NET 中比較接近的型別,Oracle 中的型別就離 .NET 型別遠了許多,畢竟 Oracle 是和 Java 親近的資料庫。
- number: 數字型別,一般是 Number(M,N),M是有效數字,N是小數點後的位數(預設0),這個是按十進位制說的。
- nvarchar2: 可變長字元型(Unicode),這個比較像 SQL Server 的 nvarchar(但不知 Oracle 為什麼加了個“2”)。(去掉“n”為非 Unicode 的,下同。)
- nchar: 定長字元型(Unicode)。
- nclob: “寫作文”的欄位,儲存大量字元(Unicode)時用。
- date: 日期型別,比較接近 SQL Server 的 datetime。
Oracle 中欄位不能是 bit 或者 bool 之類的型別,一般是 number(1) 代替的。
和 SQL Server 一樣在 SQL 命令中,字元型別需要用單引號(')隔開,兩個單引號('')是單引號的字元轉義(比如: I'm fat. 寫入一個 SQL 命令是: UPDATE ... SET ...='I''m fat.' ...)。
比較特殊的是日期型別:比如要寫入 2004-7-20 15:20:07 這個時刻需要如下寫:
UPDATE ... SET ... = TIMESTAMP '2004-7-20 15:20:07' ...
注意這裡使用了 TIMESTAMP 關鍵字,並使用單引號隔開;另外請注意日期格式,上面的格式是可識別的,Oracle 識別的格式沒有 SQL Server 那般多。這是和 SQL Server 不同的地方。
順便提一句:Access 中的日期型別是用井號(#)隔開的,UPDATE ... SET ... = #2004-7-20 15:20:07# ...
4。訪問 Oracle 過程/函式(1)
SQL Server 作程式時經常使用儲存過程,Oracle 裡也可以使用過程,還可以使用函式。Oracle 的過程似乎是不能有返回值的,有返回值的就是函數了(這點有些像 BASIC,函式/過程區分的很細緻。SQL Server 儲存過程是可以有返回值的)。
.NET 訪問 Oracle 過程/函式的方法很類似於 SQL Server,例如:
OracleParameter[] parameters = {
new OracleParameter("ReturnValue", OracleType.Int32, 0, ParameterDirection.ReturnValue, true, 0, 0, "",
DataRowVersion.Default, Convert.DBNull )
new OracleParameter("引數1", OracleType.NVarChar, 10),
new OracleParameter("引數2", OracleType.DateTime),
new OracleParameter("引數3", OracleType.Number, 1)
};
parameters[1].Value = "test";
parameters[2].Value = DateTime.Now;
parameters[3].Value = 1; // 也可以是 new OracleNumber(1);
OracleConnection connection = new OracleConnection( ConnectionString );
OracleCommand command = new OracleCommand("函式/程名", connection);
command.CommandType = CommandType.StoredProcedure;
foreach(OracleParameter parameter in parameters)
command.Parameters.Add( parameter );
connection.Open();
command.ExecuteNonQuery();
int returnValue = parameters[0].Value; //接收函式返回值
connection.Close();
Parameter 的 DbType 設定請參見 System.Data.OracleClient.OracleType 列舉的文件,比如:Oracle 資料庫中 Number 型別的引數的值可以用 .NET decimal 或 System.Data.OracleClient.OracleNumber 型別指定; Integer 型別的引數的值可以用 .NET int 或 OracleNumber 型別指定。等等。
上面例子中已經看到函式返回值是用名為“ReturnValue”的引數指定的,該引數為 ParameterDirection.ReturnValue 的引數。
5。訪問 Oracle 過程/函式 (2)
不返回記錄集(沒有 SELECT 輸出)的過程/函式,呼叫起來和 SQL Server 較為類似。但如果想通過過程/函式返回記錄集,在 Oracle 中就比較麻煩一些了。
在 SQL Server 中,如下的儲存過程:
CREATE PROCEDURE GetCategoryBooks
(
@CategoryID int
)
AS
SELECT * FROM Books
WHERE CategoryID = @CategoryID
GO
在 Oracle 中,請按以下步驟操作:
(1)建立一個包,含有一個遊標型別:(一個數據庫中只需作一次)
CREATE OR REPLACE PACKAGE Test
AS
TYPE Test_CURSOR IS REF CURSOR;
END Test;
(2)過程:
CREATE OR REPLACE PROCEDURE GetCategoryBooks
(
p_CURSOR out Test.Test_CURSOR, -- 這裡是上面包中的型別,輸出引數
p_CatogoryID INTEGER
)
AS
BEGIN
OPEN p_CURSOR FOR
SELECT * FROM Books
WHERE CategoryID=p_CatogoryID;
END GetCategoryBooks;
(3).NET 程式中:
OracleParameters parameters = {
new OracleParameter("p_CURSOR", OracleType.CURSOR, 2000, ParameterDirection.Output, true, 0, 0, "",
DataRowVersion.Default, Convert.DBNull),
new OracleParameter("p_CatogoryID", OracleType.Int32)
};
parameters[1].Value = 22;
OracleConnection connection = new OracleConnection( ConnectionString );
OracleCommand command = new OracleCommand("GetCategoryBooks", connection);
command.CommandType = CommandType.StoredProcedure;
foreach(OracleParameter parameter in parameters)
command.Parameters.Add( parameter );
connection.Open();
OracleDataReader dr = command.ExecuteReader();
while(dr.Read())
{
// 你的具體操作。這個就不需要我教吧?
}
connection.Close();
另外有一點需要指出的是,如果使用 DataReader 取得了一個記錄集,那麼在 DataReader 關閉之前,程式無法訪問輸出引數和返回值的資料。
好了,先這些,總之 .NET 訪問 Oracle 還是有很多地方和 SQL Server 不同的,慢慢學習了。