isql

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

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

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

たとえば、Pervasive PSQL に含まれる 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 は、Pervasive SQL データベースエンジンに接続するユーザー名です。セキュリティで保護されたデータベースに対して使用します。セキュリティで保護されているデータベースの場合のみ必要です。

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

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

-b	バッチ処理用のプロンプトを表示させないようにします。注記を参照してください。
-c	最初の行の列名を表示します（-d と共に使用）。
-dx	x 文字で列を区切ります。
-llocnname	locname にロケールを設定します。
-mn	列の表示幅を n 文字（数）に制限します。
-v	エラーや警告の詳細な説明を表示します。
--version	使用中の unixODBC のバージョンを表示します。
-w	結果を HTML テーブルにラップします。
-x0xHH	HH で列を区切ります。x は 16 進数で示します。たとえば、0x09 はタブ文字です。

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

sql-statement	isql または isql64 によって接続されるデータベースに対して実行する有効な SQL ステートメント。
help [tablename]	列情報を表示します。この出力は dbo.fSQLColumns カタログ関数の出力と同じです。『SQL Engine Reference』の dbo.fSQLColumns を参照してください。 tablename を省略すると、出力はデータベースのすべてのテーブルを対象とします。これにはシステムテーブルも含まれます。
quit	対話モードを終了します。

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

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

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

DSN にも "acctspay" という名前が付けられ、ODBC ドライバー記述 "Pervasive ODBC Interface" を指定します。

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

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

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

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

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

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

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