対話型の ODBC テスト ツールである isql を使用するれば、DSN に対しデータベースへの接続をテストしたり、データベースに接続できていれば SQL ステートメントを実行したりすることができます。このツールの 32 ビット版は、Zen Enterprise Server 32 ビット、Zen Client 32 ビット、また Zen Enterprise Server 64 ビットのインストールで一緒にインストールされます。このツールの 64 ビット版は isql64 という名前です。これは Enterprise Server 64 ビットおよび Client 64 ビットのインストールで一緒にインストールされます。

2 つのユーティリティの違いは、接続できる DSN のタイプです。デフォルトで、dsnadd は 32 ビットおよび 64 ビットのどちらのアプリケーションにもアクセスできます（DSN はドライバー記述 "Pervasive ODBC Interface" を指定します）。isql または isql64 ではそのような DSN の接続をテストできます。Linux、macOS、および Raspbian 用の Zen ODBC ドライバー記述を参照してください。

使用が推奨されないレガシー スタイルの DSN がアクセスできるのは 32 ビット アプリケーションのみです。このため、そのような DSN の接続テストが可能なのは isql のみです。Linux、macOS、Raspbian 向けの ODBC および DSN サポートに関する FAQを参照してください。

たとえば、Zen に含まれる Demodata サンプル データベースに接続するには、isql demodata または isql64 demodata というように、DSN を第 1 パラメーターとして指定し isql（または isql64）を実行します（Demodata 用の DSN にはドライバー記述に "Pervasive ODBC Interface" を指定するので、どちらのバージョンのツールもその DSN 接続をテストすることができます）。

このツールを使用すると、データベースを対話型で処理できる状態になります。この状態で、データベースにクエリ（SELECT * FROM Department など）を実行することができます。

isql を使用してデータベースのセキュリティを有効にするには、まず Master ユーザーとしてデータベースに接続します。次に SQL の SET SECURITY ステートメントを使用して Master ユーザーのパスワードを設定します。たとえば、次のように指定します。

『SQL Engine Reference』の SET SECURITY を参照してください。

セキュリティが設定されているデータベースに接続するには、isql の 2 番目と 3 番目のパラメーターとして、それぞれユーザー名とパスワードを渡します。たとえば、demodata にパスワード vforge を使用し Master ユーザーとして接続するには、isql64 demodata Master vforge または isql demodata Master vforge と入力します。

上記の要素は次のような意味があります。

DSN は接続するデータベースのデータ ソース名です。必ず指定する必要があります。

UID は、Zen SQL データベース エンジンに接続するユーザー名です。セキュリティで保護されたデータベースに対して使用します。セキュリティで保護されているデータベースの場合のみ必要です。

PWD は UID のパスワードです。UID が使用されている場合のみ必要です。

options は以下に示す 1 つまたは複数のオプションです。

対話モードにした場合は、以下のコマンドを使用することができます。

デフォルトで、isql および isql64 は対話モードの場合にプロンプト情報を表示します（Connected!、sql-statement、help [tablename] および quit など）。ファイルへの出力をリダイレクトおよびパイプするため、プロンプト情報を表示させたくない場合もあります。-b オプションを使用すれば、プロンプト情報は出力されません。

isql および isql64 は入出力のリダイレクションとパイプをサポートします。さらに、両ユーティリティは複数の SQL ステートメントを含むファイルを処理することができます。各ステートメントの終わりには、キャリッジ リターン/ライン フィードを指定する必要があります。ファイルの最終行は空白行にしてください。例を参照してください。

次の例では、64 ビット クライアント上で実行する 64 ビット ODBC アプリケーションからアクセスされる、セキュリティで保護されていない acctspay というデータベースに接続します。

isql64 acctspay

データベースと同様に acctspay という DSN が指定されています。この DSN では ODBC ドライバー記述 "Pervasive ODBC Interface" を指定しています。

次の例は、セキュリティで保護された payrol というデータベースに対し、パスワード j77b99 を使用し Master ユーザーとして接続します。

isql payrollsecdb Master j77b99

payrollsecdb という DSN が指定されています。この DSN では、使用が推奨されないレガシー スタイルの ODBC ドライバー記述 "Pervasive ODBC Engine Interface" を指定しています。また、isql の他の用途としては、ODBC ドライバー記述 "Pervasive ODBC Interface" が指定されているかどうか DSN をテストすることもできます。

次の例は、複数の SQL ステートメントを処理する方法を示します。Demodata サンプル データベースに対して、以下の 2 つのクエリを実行します。

select count(*) from billing
select count(*) from person

この 2 つの行で 1 つのファイル（説明上、名前は two-queries.sql とします）が作成されます。ファイルの最終行として空白行追加します。

次のコマンドを実行します。

cat two-queries.sql | isql demodata -b

結果は次のようになります。

-b オプションを使用した場合は、プロンプト情報が出力されないので注意してください。-b オプションを使用していなければ、結果は次のようになります。