Online Documentation for SQL Manager for Oracle

Advanced connection settings

You need the installed Oracle client on the client computer where SQL Manager for Oracle will be used. The version of the Oracle client should be compatible with the version of Oracle server you need to connect.


You need to add the connection settings of Oracle server databases to your TNS names file (tnsnames.ora file). This is a configuration file which contains databases description.


If you use Database Client the tnsnames.ora file is located in the %HOME_name\NETWORK\ADMIN directory.


If you use Instant Client for oracle, you should create tnsnames.ora file manually. since it does not exist. File should be created in the same directory where Oracle instant client is installed (e.g. C:\OracleInstantClient\). This file can be created using any text editor (create a simple text file and then change its name and extension).


Only for Instant Client: After the tnsnames.ora file is created and database description is added, create TNS_ADMIN environment variable. For this please do the following:

  1. Right-click 'My computer'.
  2. Select 'Properties' menu item.
  3. Proceed to the 'Advanced' tab and press 'Environment Variables' button.
  4. Press 'New...' button in the 'System variables' section.
  5. Set 'Variable name:' TNS_ADMIN, 'Variable value:' C:\OracleInstantClien\tnsnames.ora
  6. Press 'OK' button to save the variable.


Find PATH variable in the same dialog, double-click it and add path to the Oracle Instant client libraries (they are located in the directory where client is installed, i.e. C:\OracleInstantClient\). Remember that the paths entries should be separated with semicolons ( ; ).


SQL Manager for Oracle connects to the server (with the help of Oracle client) via TCP/IP protocol. Here is an example of TCP/IP connection specified in TNS names file:


DB_Alias =



(ADDRESS = (PROTOCOL = TCP)(HOST = Host_name)(PORT = 1521))




(SERVICE_NAME = Database_Name)




PROTOCOL is the keyword that identifies the specific protocol adapter used. For this protocol, the value is TCP. The value can be entered in either uppercase or lowercase.

HOST is the host name or IP address.

PORT is the TCP/IP port number.

SERVICE_NAME the name of service on server; the database instance name may differ from the actual database name, but generally the names match.

DB_Alias any name of the connection


When the client is installed, you can register a database in SQL Manager for Oracle. To open the wizard, select the Database | Register Database... main menu item, or use the Register Database btnRegisterDB button on the main toolbar. You can also use the Shift+Alt+R shortcut for the same purpose.


At the firs step select Oracle client HOME in Home name dropdown list. Proceed to the step Setting registration options and select database from the Database name dropdown list. The databases names are taken from the tnsnames.ora file.


Note: If you have a 64-bit version of OS, you might probably have a 64-bit Oracle client. Since SQL Manager for Oracle is a 32-bit program, it cannot work a 64-bit client. In this case you need to install a 32-bit Oracle client.