3.x RC1 compatibility
[phpeclipse.git] / archive / net.sourceforge.phpeclipse.quantum.sql / doc / getting_started_connections.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>Creating a QuantumDB Bookmark</title>
7   <link rel="stylesheet" href="book.css" charset="ISO-8859-1" type="text/css"></head>
8 </head>
9 <body>
10 <h1>Creating a QuantumDB Bookmark</h1>
11 <p>Author: jparrai<br>
12 Date: 28-03-2003<br>
13 <p>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.</p>
17  
18 <img src="images/newbookmark_menu.gif" />
19
20 <p>Once this menu item is selected, you will see the "New Bookmark" wizard:</p>
21
22 <img src="images/newbookmark_wizard.gif" />
23
24 <p>The data that the form asks of you is:
25 <ul>
26   <li><b>Bookmark name:</b> Is your private name of the bookmark you 
27     are creating. It will appear in the view after is created. For example <span
28  style="font-weight: bold;">Test</span>.</li>
29   <li><b>Username:</b> The username for accessing the database. For 
30     example <span style="font-weight: bold;">SCOTT</span> for the classical Oracle 
31     examples.</li>
32   <li><b>Password:</b> The password for that username. For example 
33     "TIGER" for the "SCOTT" user.</li>
34   <li><b>Prompt for Password:</b> Check this box if you want to be prompted for a password
35     every time you try to connect to the database.</li>
36   <li><b>Schema</b>: (optional): The schema of the user. We can leave 
37     it blank.</li>
38   <li><b>Connect</b>: Connect string, the format is (for Oracle) <font
39  face="Geneva, Arial, Helvetica, sans-serif" size="2"><span
40  style="font-weight: bold;">jdbc:[database]:[type]:@[host]:[port]:[database]</span>, 
41     for example, for an Oracle database called DEV based on the same computer 
42     you could put <span style="font-weight: bold;">jdbc:oracle:thin:@localhost:1521:DEV</span>.</font></li>
43   <li><b>Driver</b>: The driver name, it should be in the documentation 
44     of the JDBC driver. For Oracle, is usually <span
45  style="font-weight: bold;">oracle.jdbc.OracleDriver</span> or <span
46  style="font-weight: bold;">oracle.jdbc.driver.OracleDriver </span> (Oracle before 
47     version 9)</li>
48   <li><b>Type</b>: The type of the database. It will be used by Quantum 
49     to adapt the SQL queries to the particular incompatibilites of each. The generic 
50     should work for most of the features, so if you don't find your database on 
51     the drop-down, use the <span
52  style="font-weight: bold;">Generic SQL</span>.<br>
53   </li>
54   <li><b>Driver Filename</b>: You can select the <span
55  style="font-weight: bold;">.jar</span> or <span
56  style="font-weight: bold;">.zip</span> file where the driver is located. For 
57     example in Oracle is usually at <span
58  style="font-weight: bold;">C:\Oracle\jdbc\lib\classes12.jar</span>, being C:\Oracle 
59     the installation directory of oracle.</li>
60 </ul>
61 <p>Other examples (only as orientation, your particular data may be
62 different)<br>
63 <p>
64 For <span style="font-weight: bold;">MySql</span> (in Windows):</p>
65 <pre>Connect: <span style="font-weight: bold;">jdbc:mysql://localhost/test</span><br>Driver: <span
66  style="font-weight: bold;">com.mysql.jdbc.Driver</span><br>Driver Filename: <span
67  style="font-weight: bold;">C:\mysql\jdbc\mysql-connector-java-2.0.4-bin.jar</span><br>
68 </pre>
69  <p>For <span
70  style="font-weight: bold;">PostgreSql</span> (in Linux):</p>
71 <pre>
72  <br>Connect: <span
73  style="font-weight: bold;">jdbc:postgresql://localhost/emsdevel</span><br>Driver: <span
74  style="font-weight: bold;">org.postgresql.Driver</span><br>driver filename: <span
75  style="font-weight: bold;">/opt/postgresql/share/java/postgresql.jar</span></pre>
76 </body>
77 </html>