Page tree
Skip to end of metadata
Go to start of metadata


  • The objective of this wiki is to explain how to connect the DBVisualizer tool to your PI database.
  • This tool can then be used to run SQL statements against you PI ABAP / Java database schema.
  • For example you may need to run some SQL statements as explained in the following wiki: PI Adapter Engine Troubleshooting SQL Statements


This document shows the steps needed to:

  • Download the DBVisualizer tool.
  • Download and install relevant database driver to the DBvisualizer tool.
  • Connection the DBVisualizer tool to the PI database.
  • Run an example SQL statement using the DBVisualizer tool.

Download and install the DBVisualizer tool.

The tool can be downloaded from the DBVisualizer page.

Download and relevant database driver.

Once the DBVisualizer tool is downloaded and installed, you next need to determine which database your PI system is using. To check this log onto your PI system (ABAP stack) and check System -> Status.

You can then see which database your PI system is using. In this example its Oracle

The next item is to determine which JDK version your PI system is using. This can be determined using the following steps:

  1. Transaction SXMB_IFR - Start Integration Builder
  2. Administration

Now you know the database version and the JDK version, your ready to download the relevant driver from the database vendor. In this example the driver is downloaded from Oracle.

  • JDBC Drivers
  • Oracle Database 10g Release 2 (, (, (, (, ( drivers
  • Oracle Database 10g Release 2 ( JDBC Drivers
  • ojdbc14.jar (1,555,682 bytes) - classes for use with JDK 1.4 and 1.5

Install relevant database driver.

Start DBVisualzier tool using the shortcut on your desktop.

Once DBVisualzier is open, click on the create new database connection icon.

Enter in the name of the new connection.

Select the driver type (in this example Oracle) and load the driver you previously downloaded from the database vendor.

Enter in the PI database connection details.

The oracle listening port is found in the listener.ora file. for example:


(HOST = hostName)
(PORT = 1527) <<<< Here >>>>

The rest of the parameters (Database userid, Password,...) will be known by your Oracle database administrator.

Connect the DBVisualizer tool to the PI database and execute a sample SQL statement.

Related Content:

PI Adapter Engine Troubleshooting SQL Statements

Related Notes:

1 Comment

  1. Former Member


    This is a nice blog which will be very usefull for handling maintenance projects.

    I am trying to use this blog to connect to PI using DB visualiser....We are PI 7.3 Single Stack java.

    I tired using Host name and Port ofr connection parameters it is giving error.

    How to find server details for single stack PI? is it server of ABAP instance ? I tired that as well but still having problems.

    Can you please clarify on these values??


    Thanks much in advance.