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>