initial quantum version
[phpeclipse.git] / archive / net.sourceforge.phpeclipse.quantum.sql / doc / connect.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4   <meta http-equiv="content-type"
5  content="text/html; charset=ISO-8859-1">
6   <title>Making a Quantumdb connexion (bookmark)</title>
7 </head>
8 <body>
9 Author: jparrai<br>
10 Date: 28-03-2003<br>
11 Subject: Making a Quantumdb connexion<br>
12 <br>
13 To connect to a database (create a bookmark in quantum) you use the <span
14  style="font-weight: bold;">New Bookmark</span> menu item that appears
15 when right-clicking on the blank space in the <span
16  style="font-weight: bold;">Database Bookmarks</span> view.<br>
17 <br>
18 The data that the form asks of you is:<br>
19 <br>
20 <ul>
21   <li><big><b>Bookmark name:</b></big> Is your private name of the bookmark you 
22     are creating. It will appear in the view after is created. For example <span
23  style="font-weight: bold;">Test</span>.</li>
24   <li><big><b>Username:</b></big> The username for accessing the database. For 
25     example <span style="font-weight: bold;">SCOTT</span> for the classical Oracle 
26     examples.</li>
27   <li><big><b>Password:</b></big> The password for that username. For example 
28     <span
29  style="font-weight: bold;">TIGER</span> for the SCOTT user. If you leave the 
30     password blank, it'll ask you for it when connection is attempted.This behaviour 
31     can be customized.</li>
32   <li><big><b>Schema</b>: (optional):</big> The schema of the user. We can leave 
33     it blank.</li>
34   <li><big><b>Connect</b>:</big> Connect string, the format is (for Oracle) <font
35  face="Geneva, Arial, Helvetica, sans-serif" size="2"><span
36  style="font-weight: bold;">jdbc:[database]:[type]:@[host]:[port]:[database]</span>, 
37     for example, for an Oracle database called DEV based on the same computer 
38     you could put <span style="font-weight: bold;">jdbc:oracle:thin:@localhost:1521:DEV</span>.</font></li>
39   <li><big><b>Driver</b>:</big> The driver name, it should be in the documentation 
40     of the JDBC driver. For Oracle, is usually <span
41  style="font-weight: bold;">oracle.jdbc.OracleDriver</span> or <span
42  style="font-weight: bold;">oracle.jdbc.driver.OracleDriver </span> (Oracle before 
43     version 9)</li>
44   <li><big><b>Type</b>:</big> The type of the database. It will be used by Quantum 
45     to adapt the SQL queries to the particular incompatibilites of each. The generic 
46     should work for most of the features, so if you don't find your database on 
47     the drop-down, use the <span
48  style="font-weight: bold;">Generic SQL</span>.<br>
49   </li>
50   <li><big><b>Driver Filename</b>:</big> You can select the <span
51  style="font-weight: bold;">.jar</span> or <span
52  style="font-weight: bold;">.zip</span> file where the driver is located. For 
53     example in Oracle is usually at <span
54  style="font-weight: bold;">C:\Oracle\jdbc\lib\classes12.jar</span>, being C:\Oracle 
55     the installation directory of oracle.</li>
56 </ul>
57 <br>
58 Other examples (only as orientation, your particular data may be
59 different)<br>
60 <br>
61 For <span style="font-weight: bold;">MySql</span> (in Windows):<br>
62 <pre>Connect: <span style="font-weight: bold;">jdbc:mysql://localhost/test</span><br>Driver: <span
63  style="font-weight: bold;">com.mysql.jdbc.Driver</span><br>Driver Filename: <span
64  style="font-weight: bold;">C:\mysql\jdbc\mysql-connector-java-2.0.4-bin.jar</span><br><br>For <span
65  style="font-weight: bold;">PostgreSql</span> (in Linux):<br><br>Connect: <span
66  style="font-weight: bold;">jdbc:postgresql://localhost/emsdevel</span><br>Driver: <span
67  style="font-weight: bold;">org.postgresql.Driver</span><br>driver filename: <span
68  style="font-weight: bold;">/opt/postgresql/share/java/postgresql.jar</span><br><br><br></pre>
69 <br>
70 </body>
71 </html>