Npgsql User Manual Npgsql用戶使用手冊-簡體中文版 100%由原官方文檔翻譯。
<@ Assembly name="System. Data"2> <s@ Assembly name="Npgsql"8> 你可以從這里獲得更多的細節 FAQ Mono Page about ASP. NET 建立連接 使用名為“joe”密碼為“ secret”的用戶,建立一個到IP地址為127.0.0.1,端∏為5432的服務器上的“ joedata”的數據庫的連接,可以使 用以下的連接字符串來打開 NpgsqlConnection。 using system; using system. Data using Pgsql public class NpgsqlUserManual public static void Main(String[] args) NpgsqlCo nection Con Npgsq-Connection ("Server=127.0.0. 1i Port=5432; User Id=joe; Password=secret; Database=joedata: )i con Cpen() co'n Close() 連接字符串里的參數 建立連接的時候, Npgsql Connection可以接受一些用以改變其行為的參數,下面就是現在你可以使用的參數列表:(溟自 NpgsqlConnection 的源代碼) 連接 PostgreSQL數據厙時,可以獲取或者設置這些字符串。合法的值有: Server PostgresQL服務器的IP地或名字 Por 用以連接的端口 Protocol 使用的協議版本,可以用 Integer類型的2或者3代替 automatic Database 數據庫名字,如果沒有指定,默認為與用戶名相同 User id 用尸名 Integrated Security 設置為 Windows集成安全性,默認為fase Password 純文本的身份驗證密碼 SSL True或者 False,控制是否使用一個安全的連接(SSL連接),默認為 false Poolin True或者 False,控制是否使用連孌池,默認為True Minpoolsize 連接淝的最小值,指定了連接池的最小值,可以讓 Npgsqlo。 nnection預冗分酎指定數量的連接。默認值為1 Maxpoolsize 迕接池的最大值,如果迄接氿內的連接的數量大亍這個值,那么堵塞的連接將被處置掉。默認值為:20 Encoding 已廢弁。總是返回“ Unicode”字符串,即使設置它也會被忽略 Timeout 等待連接的事件,單位為秒。默認值為:15 Commandtimeout 等待命令完成執行的時間,超時將拋出異常。單位為秒。默認值為:20 Sslmode 連接控制的方式,可以是以下值中的一個 Prefer 如果有可能使用SSL連接,那么就采用SSL連接。(首選) Require 如果不能建立SSL連接,將拋出異常。(必須) AllOw 如果還不支持,那么就使用非SSL連接。(允許 Disable 使用非SSL連接(不允許) 默認值是“ Disable” Connectional fetime 連接池中不再使用的連接關閉的等待時間。單位:秒,默認值為:15 SyncNotification 指定的話 Npgsq將使用同步消息機制 SearchPath 改變 public的和特定的模式的搜索路徑 Pre⊥ oad reade 如果設置為為“‘true”〔默認值為“ false”)的活,數據讀取器寢在 Executerεder全部返回前被加載。這將尋致性能損失(特別是在大量的記 錄集時,可能導致不可容忍的性能損失〕,它保留下來是為了和之前版本的 Pgsql保持兼容。根據ADO.N氏T文檔,當 I DataReader打開用于 獲取數據的 IDbConnection時,它的狀態被設置為“busy”,不能用于其他任何操作(有一些明確的異常( Exception類)專門針對此規則) Npgsa強制執行這個規則,所以當 Npgsa| Datareader打開后,其他的基于這個用于獲取數據的 IDbConnection上的其它操作都將導致 InvalidOperationEⅹ ception( Pgsql放松了這個規則,如果 Npgsq| DataReader已經讀到結果集的結尾但是還沒有破關閉, Pgsql允午你使 用這個連接。因為這時,它不再從迕接上使用什么資源。) 但是左以前, Npgsq允許用戶完全忽賂這個規則。這完全是一個內置的執行問題的副作用,嚴格來說,它從來沒有被支捋過(因為它總是違背 AD◎.NET的規范),而且這一點偷懶可能會讓你發現以前運行良好的代碼突然掛掉了。如果你確定無論如何都要使用它,可以將它作為修復代碼 前的權益之計,基于下兩個原因: 性能,尤其是可伸縮性,不適用這個選項仲縮性將更好 Use Extended Types 這個選項可決定 Data Adaptors到底是使用NET的 System Data Time類型還是使用類似 NpgsqlTimestamp這樣比 System Data Time類 型具有更多功能和使用范圍的 Npgsq的日期和事件類型。選項設置為“ Either”允許使用 Pgsql和 System類型,但是如果設置為“true” DataAdaptors將考慮為字段仗用使用定的 Npgsq類型,反之,如果設置為“ false”將使用 Systen. Data time 這個選項是實驗性的,有可能因為沖突在新版本中簡化或刪掉 默認值為“ false Compatibility 這個版本的目的是為了應付不斷曾加新的連接字符串選項而帶來的破壞性的變更,它的值可以設置為版本號的形式(像這樣a.b[.cC[C]).變化 可能會破壞現有的代碼,所以,在可能的情況下,盡量復制以前版本的行為。第一個這么做的版本是2.0.2.1,所以在2.0.2中,這個值不會有新 的行為。 版本行為 如果指定字段名找不到,則Ge0 rinal返回-1 0.2 etOrdinal區分假名的寬度 版本行為 口果指定字段名找不到,則 Getordinal將拋出 IndexOutOfRange Exception異常 0.2.1 GetOrdinal不區分假名寬度 使用 Npgsql Command向表格增加一個行 前面的示例其實一點有用的事情也沒有做,僅僅是連接效據庫,然后斷開。如果有錯誤的話,將拋出一個 Npgsq| Exception異常。現在假設你有 一個名為“ table1”的表,該表恪捐有“ fielda”和“ field”兩個字段,類型都是int.如果你想向該表格屮插入(1,1)元組,可以使用以下插入 語句。 using system; using system. Datai using Npgsq public static class NpgsqlUserManual public static void Main(String[ args) NpgsqlConnection Npgsq-Connection("server=127.0.0.liport=5432 User Id=joe; Password=secreti Database=joedata; coIn. Cpe1(): NpgsqlCommand command= new NpgsqlCommand(insert into tablel values(1, 1)", conn); Int32 rows. ffected trv rowsaffected= command. ExecuteNonQuery()i Console. WriteLine("It was added o lines in table tablel" rowsaffected) finally n Close ExecuteNonQuery()是插入和更新查詢的理想方法,囚為它返回一個指小受最后一次操作影響的行數的整數。 使用 NpgsqlCommand. EXecute Scalar()方法獲取單一的返回值 有些情況下,你只想從函數取回會一個單獨的值( scalar)這是你可以使用 Command對象的 Executescalar()方法。 usIng System. Dat. using Pgsql public static class Npgsq-UserManual { public static voi NpgsqIConnection co-n ne Npgsg-Connection("server=127.0.0. liport=5432; User Id=joe; Password=secreti Database=joedata: co-n Cpe(): Npgsql Comma nd command new NpgsqlCommand("select. version(),conn)i string serverversion; try serverversion=(String)command. ExecuteScalar()i Console. WriteLine('EostgresQ- server version: [0], serverversicn)i finally y conn Close(i 你也可以使用 Executescalar執行返回記錄集的查詢,比如“ select count(*) from table1”。但是,當調用返回一條或更多記錄的函數時 只有第一行的第一列能這回(目 Dataset. Tables[0].Rows[o][0])。一股來說,何一個返回單一值的香詢都應該使 Command ExecuteScalar 使用 Npgsqlcommand ExecuteReader()方法和 Npgsql DataReader獲得完整的結果集 有很多方式可以獲得 Pgsql返回的記錄集。當你想通過一個sQL語句作為命令的文本和使用高效內存數據讀取器訪問結果的時候,請使用 Npgsglcommand對象的 EXecuteReader()方法。 using system; using system. Data using Pgsql oublic static class NpgsqlUserManual public static void Main(String[] args) Npgsql Connection Npgsq Connection ("Server=127.0.0. 1 i Port=5432: User Id=joei Password=secreti Database=joedata; )i co-n. cpe NpgsqlCommand command new Npg sqlCommand("select x from tablea, conn)i NpgsglDataReader dr= command. ExecuteReader()i while(dr Read() Tor ( dr. Field i++) insole Write("[0)t", dr[il tinally conn Close()i 記住,你可以在一個 Command對象的 CommandText屬性中使用一連串的 select語句來檢索多余一個的記錄集,就像這樣:“ select*from ta blea select k from tableb 在查詢中使用參數 參數可以讓你在運行時動態的向SQL查詢中插入多個值,一般而言,參數綁定是你在客戶端代碼中產生動態SQL語句的最好方法。而其他的方法, 如基本的串聯宇符串的方沄,是不太可靠的,它可能會招致注入攻擊。通過在參數名稱前附加“:”前綴的方式同你的SQL查詢字符串中增加參 數。下面的示例使用一個名為“vaue1”的參數(就像這樣“:vaue1”) using system stem. Dat using Pgsql public static class NpgsqlUserManual public static void Main (String[] args) using(NpgsqlConnection conn Npgsq-Connection ("Server=127,0.0. li Port=5432: User Id=joe: Password=secret Database=joedata: ") conn Cpen()i /聲明查詢語句中使用的參數 using(Npgsq l Commandcommand= rew Npgsgl Command('select s from tablea where colurmr1=: va luel", conn)) Now add the parameter to the parameter collection of the command specifying its type ∥/垗在按照參數的類型將參教添加到參數集合中。 command. Pa rameters. Add(new Pgsql Parameter("valuel", Pgsql DbType Integer)) /7 Now, add a value to it and later execute the command as usual /現在,設置參數的值,并在稍后執行查詢。 command Parameters[ ol Value 4 using(NpgsqlDataReader dr command ExecuteReader()) while(dr Read( i=0: i dr. Fieldcount i++ Console. Write("(0\t", dr[i]); Console. Writeine(i 你也可以使用 Pgsql Parameter和 Npgsql Parameter collection對象向服務器發送一個參數化的查詢 這段代碼假設已存在一個名為“ tablea”的表,且它至少有一個名為“ column1”類型為int4的字段 使用預備語句 預備語句可以優化你經常使用的查詢的性能, Prepare()基本上就是“緩存”的查詢計劃,這樣就可以在以后的調用使用它。(記住:這個特性只 能在73以后的版本中使冂,如果你在一個不支持它的服務器中使用它, Npgsq將悄悄的忽略它)在執行查詢之前簡單的調用 NpgsqlCommand 的 Prepare(方法就可以了。 using system. Datai ng Rpgs public static class NpgsalUserManual public static void Main(String args) using(pgsglConnection conn new Npgsg-Connection ("server=127.0.0. li port=5432; User Id=joe: Password=secreti Database=joedata: ) conn Cpen()i //在查詢語句中言明參數 using(NpgsqlCommand command=new NpgsalCommand("select from ablea where column1=: colannl", conn)) //現在,把參數添加到合令的參數集合中,并指定其類型 command Parameters. Add(new NpgsqlParameter ("columnl", Npg sqlDbType. Irtecer) //現在,預各這個命令 //現在,給參數添加一個值,并在梢后像普通方式一樣執行這個命令 command Parameters[o.value 4 using(NpgsqlDataReader dr= command. ExecuteReader()) while(dr Read ()i for (1=0: i< dr. Fieldcount; i++ Console. Write("(o\t", dr[i])i onsale. Writeine(i 這段代碼假定已存在一個名為“ tablea”的表,且它至少有個一個名為“ column1”類型為int4的字段。 函數調用 要調用函數,需要將 Npgsqlcommand對象的 CommandType屬性設置為 CommandType StoredProcedure,并將你要調用的函數名作為 杳詢字符串(在 CommandTex屬性設置杳詢字符申) 譯者注:因為 Npgsq中標識符是區分大小寫的,所以,如果你的函數名中有大小寫,需要將函數名用雙引號括起來,比如: command. Commandtext="" getTableName\",這樣實際上發送給服務器的函數名字外就有雙引號了。 using System. using system. Datai using pgsql //這個示例使用一個名為〃 funct()〃的函數,它的定義如下 / create function funct() returns inte as / select count(x) from tablea; t language Note that the return type of select count (* changed from int4 to inc8 in 7.3+ versions. To use this function /7 in a 7. 2 server, change the return type from int8 to int 4 //注意:在7.3以前的阪本中, select ccu(*)將int4類型轉換為int8類型,如果要在7.2版本中使用,需要將int8轉化為int4類型 public static class NpgsqlUserManual public static void Main(String[] args) NpgsqlConnection Npgsq-Connection("server=127.0.0. liPort=5432i User Id=joe; Password=secret; Database=joedata: )i con. Cpen(): NpgsqlCommanc command new NpgsqlCommand("funct", conn) corman. CommandType= CommandType StoredProcedure Object result command Executescalar()i Console. Writeline(result) fia1⊥ onn. Close(i 向 PostgreSQL増加參數很像我們前面的小例。不過,當我們指定 CommandText字符串的時侯,可以省略參數的名字,只使用函數名字就可以 using system using System. Datai using Npgsali / This example uses a function called funcc with the =ollowing definitio //create function funcc(int. 4) returns int8 as / select count(x) from tablea where field int4 = $li //1 anguage'sq1'’; public static class NpgsqlUserManual public static void Main(String[] args) NpgsqlConnection conn Ipgsq-Connection ("Server=127 1, port=5232: User Id-joei Password-secreti Database-joedatai")i co n Cpe (i tr NpgsqlCommand command= new NpgsglCommand("funcc", conn)i conman. CommandType CommandType storedProcedurei command. aranecers Add (new Npgscl Parameter() command ?=.0]. Npgsql DbType- NpgsqlDbType Integer command. aranmesers0] Value 4; object result= command. F. xecutescalar( Console. Writeline(result)i