InterSystems IRIS with DBine

How to connect DBine to InterSystems IRIS and what you can do once it's connected. This page is written from what the InterSystems IRIS driver says about itself, so it matches the version of DBine you download.

Connect

  1. In DBine, open New connection.
  2. Pick InterSystems IRIS in the list of engines.
  3. Fill in the fields below, press Test connection and then Save.

Default port: 1972.

General

FieldDescription
Server requiredExample: localhost
PortExample: 1972
Namespace required
User
PasswordKept in the system keychain, never in DBine's files.
ODBC driverODBC driver name as shown in odbcinst.ini (“InterSystems ODBC35” or “InterSystems ODBC”; on Linux, libirisodbc.so). It comes with IRIS or can be downloaded separately from the InterSystems site (WRC) or its driver repository.
Default: InterSystems ODBC35
Read-onlyOn or off.

SSH tunnel. The connection can go through an SSH server, even through a chain of bastions, with a password, a private key or the SSH agent. The server's fingerprint is checked against known_hosts or confirmed the first time.

Advanced

FieldDescription
Additional attributesThey are appended to the end of the ODBC connection string and replace the ones with the same name (TLS, timeouts, character set, Kerberos or Windows integrated security…).
Example: Key=Value;OtherKey=Value
Script sendingHow a script is sent to the server. If the engine accepts several statements per request, “All text at once” keeps blocks such as BEGIN … END intact.
Options: One statement at a time (separated by ;), Blocks separated by GO, All the text at once
Default: One statement at a time (separated by ;)
ODBC libraryPath to the ODBC driver manager (libodbc.2.dylib, libodbc.so.2 or odbc32.dll), only if it isn't found in the usual paths.
A file on this computer.

What the explorer shows

The objects appear right under the connection:

Query editor

The editor uses SQL, with completion for the connection's objects. Statements and commands run against the database selected in the tab.

Ready-made templates for new objects:

Tools for InterSystems IRIS

Available

  • Graphical execution plans
  • Server monitor
  • Manual transactions (commit and rollback)
  • Index usage
  • Relations in the ER diagram
  • Visual designer for new objects
  • Compare and sync schemas
  • Native bulk load when migrating data
  • Users and permissions

Not available for InterSystems IRIS

  • Live query profiler
  • Sessions and running queries
  • End a session
  • Locks: who blocks whom
  • Cancel another session's query from the sessions list
  • Create databases
  • Drop databases
  • Database properties
  • Rename objects
  • Clone tables
  • Backups

Why a tool doesn't apply to an engine, and the details of each one, are in the engine support reference.

Generated from the InterSystems IRIS driver 0.1.11, which DBine downloads the first time you connect to InterSystems IRIS.

Download DBineAll engines