2010-04-06 Rodrigo Kumpera <rkumpera@novell.com>
[mono.git] / web / odbc
blob80143fcb7eb92bdda8e45dec4acab847a06bd097
1 * ODBC Data Provider
3 <ul>
5         <li>ADO.NET Data Provider for Data Sources 
6         that have <a href="http://www.microsoft.com/data/odbc/">ODBC</a> support.</li>
8         <li>Exists in namespace System.Data.Odbc and assembly System.Data</li>
9         
10         <li>Works on Windows and Linux. Should have no problems working on UNIX too.</li>
11         
12         <li>Works on Windows via the native Windows odbc32.dll</li>
13         
14         <li>Works on Linux via:
15         
16         <ul>
17                 <li><a href="http://www.unixodbc.org/">unixODBC</a> which has 
18                         commercial support 
19                         from <a href="http://www.easysoft.com/">Easysoft</a></li>
20                         
21                 <li><a href="http://www.iodbc.org/">iODBC</a> which has 
22                     commercial support 
23                     from <a href="http://oplweb.openlinksw.com:8080/download/">OpenLink Software</a></li>
24         </ul>
25         
26         <li>List of unixODBC <a href="http://www.unixodbc.org/drivers.html">drivers</a>
27         
28         <li>List of <a href="http://www.sqlsummit.com/odbcvend.htm">ODBC Vendors</a>
29         
30         <li>ODBC can connect to various databases which has an ODBC driver installed:
31         <ul> 
32                   <li><a href="http://www.mysql.com/">MySQL</a></li>
33                   <li><a href="http://www.postgresql.org/">PostgreSQL</a></li>
34                   <li><a href="http://www.oracle.com/">Oracle</a></li>
35                   <li><a href="http://www.borland.com/products/downloads/download_interbase.html">Interbase</a></li>
36                   <li><a href="http://www.sybase.com/downloads">Sybase</a> (
37                   via <a href="http://www.freetds.org/">FreeTDS</a> on UNIX)</li>
38                   <li><a href="http://www.microsoft.com/sql/default.asp">Microsoft SQL Server</a> (
39                   via <a href="http://www.freetds.org/">FreeTDS</a> on UNIX)</li>
40                   <li><a href="http://www-3.ibm.com/software/data/db2/">IBM DB2 Universal Database</a></li>
41                   <li><a href="http://www.microsoft.com/office/access">MS Access</a>
42                   (via <a href="http://mdbtools.sourceforge.net/">MDB Tools</a> on UNIX)</li>
43         </ul>
44                 
45         <li>ODBC Provider created by Brian Ritchie.</li>
46         
47         <li>Does not support trusted connections</li>
48         
49 </ul>
50         
51 ** Current Status
53 <ul>
54         <li>Can Connect on:
55         <ul>
56                 <li>Windows via native Windows odbc32.dll</a></li>
57                 <li>Linux via:
58                 <ul>
59                         <li>unixODBC's libodbc.so</li>
60                         <li>iODBC's libiodbc.so</li>
61                 </ul>
62                 </li>
63         </ul>
64         </li>
65         
66         <li>Various databases have been tested using their
67            ODBC drivers: MySQL, PostgreSQL, Oracle, IBM DB2, and Microsoft SQL Server</li>
68            
69         <li>Can execute non-query commands via ExecuteNonQuery of a OdbcCommand</li>
70         
71         <li>Can execute aggreates and retrieve a single row single column result via
72         ExecuteScalar of a OdbcCommand</li>
73         
74         <li>Can execute queries via ExecuteReader of a OdbcCommand and 
75         retrieve results using an OdbcDataReader</li>
76         
77         <li>Can get a DataTable containing schema info via GetSchemaTable() in a OdbcDataReader</li>
78         
79         <li>Can Fill a DataTable in a DataSet via an OdbcDataAdapter</li>
80         
81         <li>Works in SQL#, but Column names don't show up correctly.</li>
82         
83         <li>Bugs with Mono or the data provider should be reported 
84         in Mono's Bugzilla <a href="http://bugzilla.ximian.com/">here</a>.  If you
85         do not have Bugzilla user account, it is free 
86         and easy to 
87         create one <a href="http://bugzilla.ximian.com/createaccount.cgi">here</a>.</li>
89         
90 </ul>
91         
92 ** Action Plan
94 <ul>
95         
96         <li>Fixing bugs
97         
98         <li>Testing with other setups
99 </ul>
101 ** Testing ODBC provider with IBM DB2 Universal Database
103 <ul>
104         <li>You need a working mono and mcs</li>
105         
106         <li>For Unix, you will need unixODBC or iODBC installed</li>
107         
108         <li>Have acess to a <a href="http://www-306.ibm.com/software/data/db2/">IBM DB2 Universal Database</a> or
109         you can download from IBM</li>
110         
111         <li>Read these web pages about Unix, ODBC, and IBM DB2
113         <ul>
114                 <li><a href="http://www.unixodbc.com/doc/db2.html">unixODBC web page about IBM DB2</a></li>
115                 <li><a href="http://www-306.ibm.com/software/data/db2/udb/ad/v8/cli/t0010406.htm">IBM web page about unixODBC and DB2</a></li>
116         </ul>
117         </li>
118         
119         <li>The ODBC provider is similar to the <a href="http://www.go-mono.com/ibmdb2.html">IBM DB2</a> provider.</li>
120 </ul>
122 ** Testing ODBC provider with MySQL
124 <p>You can test Mono's ODBC provider System.Data.Odbc with the MySQL ODBC driver MyODBC
125         
126 <p><ul>
127         <li>Take a look at OdbcTest.cs in mcs/class/System.Data/Test</li>
129         <li>Here is a ConnectionString format if you have a DSN setup: 
130 <pre>
131 "DSN=dataSetName;UID=myuserid;PWD=mypassword"
132 </pre>
133         </li>
134         <li>Here is a ConnectionString format if you do not have a DSN (have not
135         gotten this to work though):
136 <pre>
137 "DRIVER={MySQL ODBC 3.51 Driver};" +\r
138 "SERVER=localhost;DATABASE=test;" +\r
139 "UID=myuserid;PASSWORD=mypassword;" +\r
140 "OPTION=3";\r
142 </pre>
143         </li>
144         <li>C# Example:
145 <pre>
146  using System;
147  using System.Data;
148  using System.Data.Odbc;
150  public class Test 
152     public static void Main(string[] args)
153     {
154                 // have an ODBC DSN setup named MYSQLDSN
155                 // that accesses a MySQL database via
156                 // MyODBC driver for ODBC with a
157                 // hostname of localhost and database test
158        string connectionString = 
159           "DSN=MYSQLDSN;" +
160           "UID=myuserid;" +
161           "PWD=mypassword";
162        IDbConnection dbcon;
163        dbcon.Open();
164        dbcon = new OdbcConnection(connectionString);
165        IDbCommand dbcmd = dbcon.CreateCommand();
166        // requires a table to be created named employee
167        // with columns firstname and lastname
168        // such as,
169        //        CREATE TABLE employee (
170        //           firstname varchar(32),
171        //           lastname varchar(32));
172        string sql = 
173            "SELECT firstname, lastname " +
174            "FROM employee";
175        dbcmd.CommandText = sql;
176        IDataReader reader = dbcmd.ExecuteReader();
177        while(reader.Read()) {
178             string FirstName = (string) reader["firstname"];
179             string LastName = (string) reader["lastname"];
180             Console.WriteLine("Name: " + 
181                 FirstName + " " + LastName);
182        }
183        // clean up
184        reader.Close();
185        reader = null;
186        dbcmd.Dispose();
187        dbcmd = null;
188        dbcon.Close();
189        dbcon = null;
190     }
192 </pre>
193         </li>
194         <li>Building C# Example:
195         <ul>
196                 <li>Save the example to a file, such as, TestExample.cs</li>
197                 <li>Build on Linux:
198 <pre>
199         mcs TestExample.cs -r System.Data.dll
200 </pre>
201                 </li>
202                 <li>Build on Windows via Cygwin:
203 <pre>
204         mono C:/cygwin/home/MyHome/mono/install/bin/mcs.exe \
205              TestExample.cs \
206              -lib:C:/cygwin/home/MyHome/mono/install/lib \
207              -r System.Data.dll
208 </pre>
209                 </li>
210         </ul>
211         </li>
212         <li>Running the Example:
213 <pre>
214 mono TestExample.exe
215 </pre>
216         </li>
217         
218 </ul>