Difference between revisions of "PrF UG files database backend"

From Protege Wiki
Jump to: navigation, search
 
(3 intermediate revisions by one other user not shown)
Line 2: Line 2:
 
== {{#var:Pr}} Database Format ==
 
== {{#var:Pr}} Database Format ==
  
{{PrF_UG_TOC_files}}<div id='prf_ug'>
+
<noinclude>{{PrF_UG_TOC_files}}<div id='prf_ug'></noinclude>
  
 
You can save the ontology-related information for a {{#var:PrF}} project
 
You can save the ontology-related information for a {{#var:PrF}} project
as a single table in a [[PrF_UG_|JDBC database]].
+
as a single table in a [{{#var:P_D}}/design/jdbc_backend.html JDBC database].
 
Note that this is a "flat" table that does not use any special database constructs
 
Note that this is a "flat" table that does not use any special database constructs
 
to represent the information.
 
to represent the information.
Line 32: Line 32:
 
       If you are using Microsoft Access,
 
       If you are using Microsoft Access,
 
       you don't need to acquire a JDBC driver;
 
       you don't need to acquire a JDBC driver;
       it's already bundled into the JDK.
+
       it's already bundled into the JDK. (not recommended option due to slow performance)
 
       </p>
 
       </p>
 
    
 
    
Line 66: Line 66:
 
     </p>
 
     </p>
 
     <div>[[Image:PrF_UG_projects_create_from_database.png|frame|none|
 
     <div>[[Image:PrF_UG_projects_create_from_database.png|frame|none|
           Create New Project dialog box]]</div>
+
           Create New Project dialog box, "Protege Database" selected]]</div>
  
 
   <li><p>
 
   <li><p>
Line 76: Line 76:
 
     </p>
 
     </p>
 
     <div>[[Image:PrF_UG_files_create_from_existing_checkbox.png|frame|none|
 
     <div>[[Image:PrF_UG_files_create_from_existing_checkbox.png|frame|none|
           Create from Existing Sources checkbox]]</div>
+
           Create from Existing Sources checkbox (checked)]]</div>
  
 
   <li><p>
 
   <li><p>
Line 145: Line 145:
 
     </p>
 
     </p>
 
     <div>[[Image:PrF_UG_files_database_convert.png|frame|none|
 
     <div>[[Image:PrF_UG_files_database_convert.png|frame|none|
           Select Format dialog box]]</div>
+
           Select Format dialog, "Protege Database" selected]]</div>
  
 
   <li><p>
 
   <li><p>
Line 154: Line 154:
  
  
</div>
+
<noinclude></div></noinclude>

Latest revision as of 17:45, March 5, 2009

Database Format


Protege-Frames User's Guide
Project Types
Understanding Project Types
Protege Files
Protege DB Format
Experimental XML Format
Protege-OWL
RDF(S) Support in Protege
Using the RDF Backend
Exporting a Project to CLIPS
Exporting a Project to HTML
Glossary, Editing Help

You can save the ontology-related information for a Protege-Frames project as a single table in a JDBC database. Note that this is a "flat" table that does not use any special database constructs to represent the information. Information specific to the Protege-Frames user interface is stored in a separate Protege project (.pprj) file. See Understanding Project Types for more information about these files.

Requirements

Before you create a Protege Database project, you will need to do the following:

  • Make sure you have a database program installed on your system.

  • Make sure you have a JDBC driver that is compatible with your database and the version of the Java VM that you are using.

    • If you are using Microsoft Access, you don't need to acquire a JDBC driver; it's already bundled into the JDK. (not recommended option due to slow performance)

    • Otherwise, acquire a driver and rename it to "driver.jar" (or "driver1.jar" or "driver2.jar", if you have several). Add this driver to the Protege installation directory (not the plugins directory).

You can store multiple projects in the same database by giving their tables different names.

Note: When a project is saved in a JDBC database, backend changes to the database (for example, changes to slots, classes, and instances) are committed as soon as they are made. However, changes to the User Interface (stored in the .pprj file) are not committed until you save the project, for example by clicking Save.

Creating or Importing a Database Project

  1. Select New Project from the File menu. The Create New Project dialog box will open.

    Create New Project dialog box, "Protege Database" selected
  2. To import a project from existing files, select Create from Existing Sources. To create a new, empty Protege-Frames project, leave this blank (the default).

    Create from Existing Sources checkbox (checked)
  3. Select Protege Database as the project type.

  4. Click Next.

  5. A Protege Database dialog box will be displayed.

    Protege Database dialog box
  6. Enter the class name of your JDBC driver in the JDBC Driver line of the dialog box. The class name can be found in the documentation provided with your particular driver. (For Microsoft Access, use: sun.jdbc.odbc.JdbcOdbcDriver)

  7. Enter the URL for your database in the JDBC URL line.

    Note: For Microsoft Access, navigate to the "ODBC Data Source Administrator" dialog via the Control Panel and add a User DSN for your Access database. If you're unfamiliar with how to find this dialog or how to add a User DSN, please refer to Microsoft Windows Help. Your URL will look like: jdbc:odbc:<User DSN name>

  8. Enter the name for the database table where you will be storing the information. If you are importing a file, enter the name of the table that contains the information you wish to import. This field is required.

  9. If your database requires a username and/or password, enter these in the appropriate lines of the dialog box.

  10. Click Finish.

To save your project and give it a name, select Save from the File menu. See Saving a Project for more information.

Converting a Protege-Frames Project to a Database

  1. Select File | Convert Project to Format...

  2. Select Protege Database in the Select Format dialog box.

    Select Format dialog, "Protege Database" selected
  3. In the Protege Database dialog box, fill out the required information, as described above.