X-Git-Url: http://wien.tomnetworks.com/gitweb/?a=blobdiff_plain;f=doc%2Fpostgresql;h=6e5bb4f24837d0bf512b7b01111e117f6a64e29e;hb=9d93ddc5daf9a96e7fcd5d9ef7fac0ddba68feb9;hp=2bd0b74d09f63e81793b9e5b9447fee0edcb7bc1;hpb=c40860f8f6073bf2e89beb08857b7e5b1cfb39bc;p=mono.git

diff --git a/doc/postgresql b/doc/postgresql
index 2bd0b74d09f..6e5bb4f2483 100644
--- a/doc/postgresql
+++ b/doc/postgresql
@@ -1,98 +1,208 @@
-* PostgreSQL Data Provider
+* PostgreSQL and Mono
+
+  When it comes to Mono and PostgreSQL, there are many ways
+  you can handle your data.   You have many Mono Data Providers which can be used
+  to access data from a application written for Mono.  
+  Then there is the future goal of having the ability to host Mono within PostgreSQL to
+  have the applications run on the server which makes things much faster.
+  
+* Hosting Mono in PostgreSQL
+
+  There is a project to <a href="http://gborg.postgresql.org/project/plmono/projdisplay.php">host Mono within PostgreSQL</a>.
+
+  plMono is a PostgreSQL language using the embedded Mono runtime. It provides support for writing functions in C#, or any other language that supports .NET.
+
+* Data Providers
+
+ There are many ADO.NET data providers for <a href="http://www.postgresql.org/">PostgreSQL</a>:
+ 
+ There are two providers created specifically for PostgreSQL included with Mono:
 
 <ul>
-	<li>Exists in namespace Mono.Data.PostgreSql and assembly Mono.Data.PostgreSql</li>
+
+	<li><a href="http://gborg.postgresql.org/project/npgsql/projdisplay.php">Npgsql</a>
+		<ul>
+			<li>included with Mono</li>
+			
+			<li>a .NET Managed Data Provider for PostgreSQL</li>
+			
+			<li>Written in 100% C#</li>
+			
+			<li>does not require a client library</li>
+			
+			<li>works on Mono and Microsoft .NET</li>
+			
+			<li>created by Francisco Figueiredo jr. and has many developers working on it
+			
+			<li>works in the SQL# (command-line and GTK# GUI versions)</li>
+			
+			<li>in namespace Npgsql and assembly Npgsql and is found in mcs
+			at mcs/class/Npgsql</li>
+		</ul>
+	</li>
 	
-	<li>Is a Mono Data Provider for the <a href="http://www.postgresql.org/">PostgreSQL</a>
-	client/server database management system.</li>
+	<li>Mono.Data.PostgreSQL (deprecated)
+		<ul>
+			<li>included with Mono</li>
+		
+			<li>Deprecated in favor of Npgsql</li>
+			
+			<li>Exists in namespace Mono.Data.PostgreSql and assembly Mono.Data.PostgreSql</li>
 	
-	<li>Written in C# and has C# bindings to the PostgreSQL C Client library pq.dll on Windows
-	and libpq.so on Linux.</li>
+			<li>Is a Mono Data Provider for the <a href="http://www.postgresql.org/">PostgreSQL</a>
+				client/server database management system.</li>
 	
-	<li>Alternative to the PostgreSQL provider in Mono:
-		<ul>
-			<li><a href="http://gborg.postgresql.org/project/npgsql/projdisplay.php">Npgsql</a>
-			is a Managed PostgreSQL provider written in 100% C#, does not require a client library,
-			and works on Microsoft .NET and Mono.
-			</li>
+			<li>Written in C# and has C# bindings to the PostgreSQL C Client library pq.dll on Windows
+				and libpq.so on Linux.</li>
 		</ul>
 	</li>
 	
-	<li>See Testing for both Mono's Mono.Data.PostgreSqlClient and Npgsql.</li>
+	<li><a href="http://sourceforge.net/projects/mysqlnet/">ByteFX.Data</a> has a provider for PostgreSQL too, but I do not know how well it works with Mono.</li>
+	
+	<li>There is another .NET data provider for PostgreSQL named <a href="http://sourceforge.net/projects/pgsqlclient/">PgSqlClient</a>, but I do not know if it works with Mono.</li>
+	
+	<li>If none of the above providers meet your needs.  There is the ODBC and OLEDB providers included with Mono.</li>
+			
+	<li>Bugs with Mono or the data provider should be reported 
+	in Mono's Bugzilla <a href="http://bugzilla.ximian.com/">here</a>.  If you
+	do not have Bugzilla user account, it is free 
+	and easy to 
+	create one <a href="http://bugzilla.ximian.com/createaccount.cgi">here</a>.</li>
+
+
 </ul>
 
+ Below, see separate Testing sections for Npgsql and Mono.Data.PostgreSqlClient.
+
 ** Current Status
 
 <ul>
+	<li>Npgsql
+		<ul>
+			<li>Builds and Runs on both Microsoft .NET and Mono.</li>
+			<li>Works using SQL# (command-line and GTK# versions)</li>
+			<li>You can send insert, update, delete queries 
+				through NpgsqlCommand.ExecuteNonQuery() method.</li>
+			<li>You can send queries like, select count(*) from table, select version()
+				with NpgsqlCommand.ExecuteScalar() method.</li>
+			<li>There is logging support. (Thanks Dave Page)
+				To use it, place code like that in your program:</li>
+
+<pre>      
+      // Enable logging.
+	  NpgsqlEventLog.Level = LogLevel.Debug;            // LogLevel.
+	  NpgsqlEventLog.LogName = "NpgsqlTests.LogFile";   // LogFile.
+</pre>
+    
+			<li>You can use Npgsql with Mono (Thanks Kristis Makris). It is not working perfectly.</li>
+			<li>There is a winforms test suite (Thanks Dave Page).</li>
+			<li>Clearer code in NpgsqlConnection removing *magic* numbers and constants. (Thanks Kristis Makris)</li>
+			<li>Better support of ODBC-like ConnectionString in NpgsqlConnection (Thanks Dave Page)</li>
+			<li>Thanks Ulrich Sprick for all discussion and ideas.</li>
+
+		</ul>
+	</li>
+	<li>Mono.Data.PostgreSQL status
+	<ul>
+	
+	<li>Deprecated in favor of Npgsql</li>
+	
 	<li>We are able to do simple CREATE TABLE, DROP TABLE, UPDATE, INSERT, and
-	DELETE SQL commands using the ExecuteNonQuery method in PgSqlCommand.  
+	DELETE SQL commands using the ExecuteNonQuery method in PgSqlCommand.</li>
 	
 	<li>We can execute multiple queries and do a NextResult() in PgSqlDataReader()
-	to get the next result set.  
+	to get the next result set.</li>
 	
 	<li>We are also able to do simple aggregate functions, 
 	ie, count(), sum(), min(), and max() 
-	in a simple SELECT SQL query using the ExecuteScalar() now.  
+	in a simple SELECT SQL query using the ExecuteScalar() now.</li>
 	
 	<li>We are also able to retrieve data with a simple SELECT SQL query 
 	using ExecuteReader() which returns a PgSqlDataReader.  We are able to
 	use GetSchemaTable() to get the meta data about the table columns.  
-	We are able	to Read() to get each row from the result set.  
+	We are able	to Read() to get each row from the result set.</li>
 	
 	<li>We are able to get 
 	String data (char, character, text, varchar), Int16 (smallint),
 	Int32 (integer), Int64 (bigint), DateTime (time, date, timestamp),
 	Boolean (boolean), Single (float), and Double (double).
 	More data types will come later.  Note, the types that do work still 
-	need thorough testing.
+	need thorough testing.</li>
 	
 	<li>Rows that are returned which contain columns that are NULL are handled now. 
 	The PgSqlDataReader method IsDBNull() needs to be called to determine 
-	if a field IS NULL before trying to read data from that field.
+	if a field IS NULL before trying to read data from that field.</li>
 	
 	<li>Calling PostgreSQL stored procedures works.  It does not work perfectly.  
 	It may not
 	even work to specification - yet.  If you want to test it yourself, look at
 	TestSqlDataReader.cs or PostgresTest.cs in
-	mcs/class/System.Data/Test.  
+	mcs/class/System.Data/Test.</li>
 	
 	<li>Below, I have some sample code you can
 	use to call a PostgreSQL stored procedure named "version".  This stored
 	procedure returns a string containing the PostgreSQL server version.  Notice
-	the CommandType is StoredProcedure and the method ExecuteScalar() is called.
+	the CommandType is StoredProcedure and the method ExecuteScalar() is called.</li>
 	
 	<li>ExecuteScalar() is a lightweight method in class PgSqlCommand that only returns
-	one row and one column as one object - even if there is more than row or column.
+	one row and one column as one object - even if there is more than row or column.</li>
 			
 	<li>We have the beginnings of Parameters support PostgreSQL.  Only
 	Input Parameters are currently supported.  Output, Input/Output,
-	and Return parameters still need to be done.
-	
-	<li>A lot of functionality in System.Data is missing, but the 
-	infrastructure is starting to come together.
+	and Return parameters still need to be done.</li>
 	
 	<li>A lot of Exceptions need to be thrown for various exceptions.  However,
 	PgSqlException, PgSqlErrorCollection, and PgSqlError have been partially
-	implemented.
+	implemented.</li>
 	
 	<li>Tim Coleman and Rodrigo Moya got the beginnings of the
 	PgSqlDataAdapter/DataSet/DataTable/DataRow to work.  Currently, 
 	the PgSqlDataAdapter can Fill() relational data into a DataTable in a DataSet.
-	See the test mcs/class/System.Data/Test/TestSqlDataAdapter.cs to see it in action.
+	See the test mcs/class/System.Data/Test/TestSqlDataAdapter.cs to see it in action.</li>
+	
+	<li>Works in the SQL# command-line version
+			and the GTK# version on Linux.  It only works in SQL# command-line version
+			on Windows.</li>
+			
+	</ul>
+	</li>
+			
 </ul>
 
 ** Action Plan
+	<ul>
+		<li>More testing and fixing bugs</li>
+		
+		<li>Better error handling</li>
+		
+		<li>More Data Types to use</li>
+		
+		<li>Any features for Npgsql should be implemented in Npgsql's main cvs repository at
+		gborg.postgresql.org.  Most bugs should be fixed in gborg.postgresql.org's cvs.
+		Only bugs neccessary for building and running of Npgsql	on Mono can be done in Mono cvs, 
+		but once applied they should be sent to Npgsql's mailing list
+		at gborg.postgresql.org for inclusion into cvs there.  Whenever there is 
+		a release of Npgsql (determined by Francisco Figueiredo jr. or a release
+		of Mono (determined by Miguel de Icaza), then the Npgsql source 
+		in gborg.postgresql.org's cvs will be used to update the Npgsql source in
+		Mono's cvs. 
+		</li>
+		
+		<li>Mono.Data.PostgreSqlClient even though deprecated can still 
+		accept bug fixes. This is because other areas, such as, ASP.NET examples
+		may still use this provider.</li>
+		
+		<li>Add any missing functionality to Npgsql. If this funtionality works on
+		.NET but not on Mono, implement the missing features or fix the bugs in Mono</li>
 
-	<p>More testing and fixing bugs...
-
-	<p>Eventually replace the PostgreSQL data provider in Mono
-	with <a href="http://gborg.postgresql.org/project/npgsql/projdisplay.php">Npgsql</a>.
-	Npgsql is a .Net Data Provider for PostgreSQL which implements 
-	the <a href="http://developer.postgresql.org/docs/postgres/protocol.html">PostgreSQL Frontend/Backend Protocol</a>.
-	Npgsql is implemented in 100% C#.  This provider was created by Francisco Figueiredo jr.
-	and has many programmers developing the provider.
+		<li>Npgsql has replaced Mono.Data.PostgreSqlClient as the provider of
+		choice to use.  However, Mono.Data.PostgreSqlClient will remain in a
+		deprecated state until nobody uses it anymore - then it can be removed</li>
+		
+		<li>Implement more of PostgreSQL 7.3 features in Npgsql</li>
+	</ul>
 
-** Testing Mono's Mono.Data.PostgreSqlClient
+** Testing Mono.Data.PostgreSqlClient
 
 	<ul>
 		* <p>In order to test Mono.Data.PostgreSqlClient, you will need to have
@@ -352,6 +462,7 @@ mono PostgresTest.exe
           "Password=fun2db;";
        IDbConnection dbcon;
        dbcon = new PgConnection(connectionString);
+       dbcon.Open();
        IDbCommand dbcmd = dbcon.CreateCommand();
        // requires a table to be created named employee
        // with columns firstname and lastname
@@ -362,11 +473,11 @@ mono PostgresTest.exe
        string sql = 
            "SELECT firstname, lastname" + 
            "FROM employee";
-       dbcmd.ConnectionString = sql;
+       dbcmd.CommandText = sql;
        IDataReader reader = dbcmd.ExecuteReader();
        while(reader.Read()) {
-            string FirstName = reader["firstname"];
-            string LastName = reader["lastname"];
+            string FirstName = (string) reader["firstname"];
+            string LastName = (string) reader["lastname"];
             Console.WriteLine("Name: " + 
                 FirstName + " " + LastName);
        }
@@ -434,6 +545,7 @@ mono TestExample.exe
           "User ID=postgres;" +
           "Password=fun2db;";
        IDbConnection dbcon;
+       dbcon.Open();
        dbcon = new NpgsqlConnection(connectionString);
        IDbCommand dbcmd = dbcon.CreateCommand();
        // requires a table to be created named employee
@@ -445,11 +557,11 @@ mono TestExample.exe
        string sql = 
            "SELECT firstname, lastname " +
            "FROM employee";
-       dbcmd.ConnectionString = sql;
+       dbcmd.CommandText = sql;
        IDataReader reader = dbcmd.ExecuteReader();
        while(reader.Read()) {
-            string FirstName = reader["firstname"];
-            string LastName = reader["lastname"];
+            string FirstName = (string) reader["firstname"];
+            string LastName = (string) reader["lastname"];
             Console.WriteLine("Name: " + 
                  FirstName + " " + LastName);
        }