COBSQL エラーメッセージ

埋め込み SQL 文

付録 C: DataDirect ODBC ドライバ

C.1 UNIX 環境

サポートされる UNIX プラットフォームについては、Micro Focus にお問い合わせください。

C.1.1 システム情報ファイル (.odbc.ini)

UNIX 環境には、ODBC データベースアドミニストレータがありません。データソースを設定するには、 システム情報ファイル、プレーンテキストファイル (通常はユーザの $HOME ディレクトリにあり、一般的に .odbc.ini と呼ばれる) を編集する必要があります。 このファイルは、任意のテキストエディタを使って、各ドライバの『データソースの設定および接続』に説明されているデータソースを定義した状態で保存されます。 サンプルファイル .odbc.ini は、ドライバのインストールディレクトリにあります。

データベースドライバの UNIX サポートにより、システム管理者が管理できる集中化されたシステム情報ファイルを使用できます。集中化されたファイルの完全修飾パス名を示すように環境変数 ODBCINI を設定することによって、 そのファイルを使用できます。

環境変数、ODBCINI を次のように設定します。

C シェル

setenv ODBCINI /opt/odbc/system_odbc.ini

Bourne シェルおよび Korn シェル

ODBCINI=/opt/odbc/system_odbc.ini;export ODBCINI

システム情報ファイルの場所の検索順序は次のとおりです。

1. ODBCINI のチェック

2. .odbc.ini の $HOME のチェック

InstallDir キーワードを含むシステム情報ファイルには、[ODBC] セクションを入れる必要があります。 このキーワードの値は、/lib および /messages ディレクトリを含むディレクトリのパスにしなければなりません。 たとえば、デフォルトのインストールディレクトリを選択する場合、[ODBC] 節に次の行を入れる必要があります。

InstallDir=/opt/odbc

C.1.1.1 システム情報ファイルの例 (Solaris)

次の例で、xx はドライバ番号を表します。

[ODBC Data Sources]
   Oracle7=Sample Oracle dsn
   dBase=Sample dBASE dsn
   Sybase=Sample Sybase dsn
   Informix=Sample Infofrmix dsn
   OpenIngres=Sample OpenIngres dsn
   DB2=Sample DB2 dsn
   Text=Sample Text file dsn 

[dBase]
   Driver=/opt/odbc/lib/ivdbfxx.so
   Description=dBase
   Database=/opt/odbc/demo 

[Sybase]
   Driver=/opt/odbc/lib/ivsybxx.so
   Description=Sybase
   Database=odbc
   ServerName=SYBASE
   LogonID=odbc01
   Password=odbc01
   OptimizePrepare=2
   SelectMethod=1 

[Oracle7]
   Driver=/opt/odbc/lib/ivor7xx.so
   Description=Oracle7
   ServerName=oraclehost
   LogonID=odbc01
   Password=odbc01

[Informix]
   Driver=/opt/odbc/lib/ivinfxx.so
   Description=Informix7
   Database=odbc
   HostName=informixhost
   LogonID=odbc01
   Password=odbc01  
 
[DB2]
   Driver=/opt/odbc/lib/ivdb2xx.so
   Description=DB2
   Database=ODBC 

[OpenIngres]
   Driver=/opt/odbc/lib/ivoingxx.so
   ServerName=ingreshost
   Database=odbc
   LogonID=odbc01
   Password=odbc01 

[Text]
   Driver=/opt/odbc/lib/ivtxtxx.so
   Description=Text driver
   Database=/opt/odbc/demo 

[ODBC]
   Trace=0
   TraceFile=odbctrace.out
   TraceDll=/opt/odbc/lib/odbctrac.so
   InstallDir=/opt/odbc 

C.1.2 環境変数

Connect ODBC ドライバでは、環境変数を設定する必要があります。

C.1.2.1 環境変数 (必須)

ODBC ホームディレクトリにある適切なシェルスクリプトを実行することによって、ほとんどの変数を設定できます。

ODBC 対応アプリケーションを使用する前に次のコマンドを実行して、使用している環境を初期化します。

C シェル (および関連シェル)

% source odbc.csh

Bourne シェル (および関連シェル)

$ . odbc.sh

これらのスクリプトを実行すると、適切なライブラリ検索パスの環境変数 (Solaris の場合には LD_LIBRARY_PATH、 HP/UX の場合には SHLIB_PATH、AIX の場合には LIBPATH) が設定されます。

ライブラリ検索パスの環境変数は、実行時に ODBC コアコンポーネントおよび ODBC ドライバを配置できるように設定する必要があります。

C.1.2.2 環境変数 (オプション)

多くの Connect ODBC ドライバには、そのドライバで使用されるデータベースのクライアントコンポーネントに応じて環境変数を設定する必要があります。 各ドライバの要件に関する詳細情報については、各ドライバに関する『システム環境』を参照してください。

ODBCINI は、すべての Connect ODBC ドライバを認識する省略可能な環境変数です。 ODBCINI を使用してデフォルトファイル以外のシステム情報ファイルを配置します。ODBCINI の詳細については、 『システム情報ファイル (.odbc.ini)』を参照してください。

C.1.3 2 バイト文字セットの使用

Connect ODBC ドライバでは、2 バイト文字セットを使用できます。別の文字セットを明示的に示す場合以外は通常、デフォルトのロケール、C によって定義される文字セットを使用します。 デフォルトのロケール、C は、ISO 8859-1 が有効な文字に限定された 7 ビット ASCII 文字セットに対応します。ロケールを別の文字セットに設定するには、次の手順に従ってください。

1. 2 バイト文字セットを使用するアプリケーションの開始直後に次の行を追加します。

   setlocale (LC_ALL, "");
   

   この行は、標準 UNIX 関数です。X/Open 準拠の文字処理関数で使用される標準 UNIX 関数として、環境変数 LANG によって示される文字セットが選択されます。この行を追加しない場合、または LANG を設定しない、あるいは NULL に設定する場合に、デフォルトのロケール、C が使用されます。

2. LANG 環境変数に適切な文字セットを設定します。 UNIX コマンド、locale -a を使用して、システムでサポートされているすべての文字セットを表示できます。

詳細については、locale および setlocale の MAN ページを参照してください。

C.1.3.1 ivtestlib ツール

UNIX 環境では、設定問題 (環境変数が正確に設定されていない、DBMS クライアントコンポーネントが足りないなど) の診断に役立つ ivtestlib ツールが提供されます。 このコマンドを実行すると、特定の ODBC ドライバのロード、およびロードが失敗した場合の有効なすべてのエラー情報の印刷が行われます。

たとえば、HP-UX では、/opt/odbc にドライバをインストールする場合には、次のコマンドを使用します。

ivtestlib /opt/odbc/lib/ivinfxx.sl

INFORMIX ドライバがロードされます (xx は、ドライバの番号を表します)。 ドライバをロードできない場合には、ivtestlib により原因を示すエラーメッセージが返されます。

注: Solaris および AIX では、ivtestlib に対してドライバの完全パスを指定する必要はありません。 ただし、HP-UX 版の ivtestlib には完全パスが必要です。

C.1.4 文字コード変換

Micro Focus により、変換ライブラリのコーディング用のフレームワークをサポートする、文字コード変換機能のサンプルが提供されています。

文字コード変換を実行するシステム情報ファイルのデータソースに、TranslationSharedLibrary キーワードを追加する必要があります。 TranslationOption キーワードの追加は省略可能です。

詳細については、DataDirect Connect ODBC のマニュアルを参照してください。

C.2 Connect ODBC DB2 ドライバ

C.2.1 システム環境

クライアント側には、次のソフトウェアが必要です。

Solaris

• IBM DB2 クライアントアプリケーションイネーブラー (CAE) (Solaris 版) バージョン 2.12 以上
• IBM DB2 ソフトウェア開発者用ツールキット (DB2 SDK) (Solaris 版) バージョン 2.12 以上

HP-UX

• IBM DB2 クライアントアプリケーションイネーブラー (CAE) (HP-UX 版) バージョン 2.12 以上
• IBM DB2 ソフトウェア開発者用ツールキット (DB2 SDK) (HP-UX 版) バージョン 2.12 以上

AIX

• IBM DB2 クライアントアプリケーションイネーブラー (CAE) (AIX 版) バージョン 5.0 以上
• IBM DB2 ソフトウェア開発者用ツールキット (DB2 SDK) (AIX 版) バージョン 5.0 以上

サーバ側には、次のソフトウェアが必要です。

• すべての UNIX 版に対して、DB2 サーバをサーバ版 (ローカル版ではなく) としてインストールする必要があります。

C.2.2 DB2 バインドおよび権限

DB2 にアクセスするには、このセクションで説明されているプロセスに従って、 DataDirect バインドファイルをバインドし、権限を付与する必要があります。

シェルプロンプトで db2 と入力し、DB2 コマンド行プロセッサに入ります。

注: DB2 コマンドプロセッサのプロンプトは、db2=> です。

DB2 コマンド行プロセッサ内では、最初の手順として、次の構文を使用して DB2 データベースに接続します。

db2=> CONNECT TO <database_name> USER <userid> 
          USING <password>

C.2.2.1 バインド

次の手順では、DataDirect SQL ファイルを DB2 データベースにバインドします。 インストール内容に基づいて BIND コマンドで特定のオプションの使用を選択できます。 BIND オプションの詳細リストについては、DB2 マニュアルセット にある『Command Reference』マニュアルを参照してください。 DataDirect SQL ファイルをバインドするには、次のセクションで示すコマンドを入力してください。 DB2 コマンド行プロセッサを終了するには、動詞 quit を入力してください。

Solaris

db2=> BIND iscsso.BND blocking all grant public
db2=> BIND isrrso.BND blocking all grant public
db2=> BIND isurso.BND blocking all grant public
db2=> BIND iscswhso.BND blocking all grant public
db2=> BIND isrrwhso.BND blocking all grant public
db2=> BIND isurwhso.BND blocking all grant public

HP-UX

db2=> BIND iscshp.BND blocking all grant public
db2=> BIND isrrhp.BND blocking all grant public
db2=> BIND isurhp.BND blocking all grant public
db2=> BIND iscswhhp.BND blocking all grant public
db2=> BIND isrrwhhp.BND blocking all grant public
db2=> BIND isurwhhp.BND blocking all grant public

AIX

db2=> BIND iscsax.BND blocking all grant public
db2=> BIND isrrax.BND blocking all grant public
db2=> BIND isurax.BND blocking all grant public
db2=> BIND iscswhax.BND blocking all grant public
db2=> BIND isrrwhax.BND blocking all grant public
db2=> BIND isurwhax.BND blocking all grant public

C.2.3 データソースの設定および接続

データソースを設定するには、下記の表に示されているデータソース定義を使用する必要があります。 システム情報ファイルの設定に関する詳細については、『UNIX 環境』を参照してください。

アプリケーションから接続文字列を使ってデータソースに接続する場合には、 データソース名を指定する必要があります。データソースの指定により、システム情報ファイルでドライバにより使われるセクションが決定され、 そこに記述されているデフォルトの接続情報がドライバによって読み取られます。 また、システム情報ファイルに記録されているデフォルトの接続情報は、接続文字列で attribute=value 対で指定して上書きすることができます。 ただし、接続文字列で指定した情報は、システム情報ファイルに優先して使用されるだけで、 実際にシステム情報ファイルに書き込まれることはありません。

接続文字列では、フルネームまたは省略名で指定できます。 接続文字列の書式は次のとおりです。

DSN=data_source_name[;attribute=value[;attribute=value]...]

DB2 の接続文字列の例

DSN=DB22 TABLES;DB=PAYROLL;UID=JOHN;PWD=XYZZY;GRP=ACCTNG

次の表は、各種属性のフルネームと省略名、および属性の内容の一覧です。

この表にあるデフォルト値は、接続文字列やシステム情報ファイルのデータソース定義に値が指定されていない場合に使用される初期値です。データソースの設定時に属性の値を指定した場合は、その値がデフォルト値となります。

C.2.4 データ型

次の表は、DB2 データ型と標準 ODBC データ型との対応関係を示したものです。

注: Graphic、Vargraphic、および Long Vargraphic のデータ型はサポートされていません。

C.2.5 サポートする分離レベルとロックレベル

DB2 ドライバは、分離レベル 0 (コミット前に読み出し)、1 (コミット後に読み出し)、 2 (繰り返し読み出し) をサポートしています。また、レコードレベルのロックもサポートしています。 分離とロックの詳細については、『Connect ODBC リファレンス』の『付録 D ロックレベルと分離レベル 』 を参照してください。

C.2.6 ODBC 対応レベル

DB2 ドライバがサポートしている関数については、『Connect ODBC リファレンス』の『付録 C ODBC API 関数とスカラ関数』に説明されています。また、次の X/Open 関数もサポートされています。

• SQLProcedures
• SQLProcedureColumns

また、基本 SQL 文法がサポートされています。

C.2.7 接続形態と文の数

DB2 データベースシステムは、単一接続、および各接続ごとの複数の文の実行をサポートしています。

C.3 Connect ODBC dBASE ドライバ

C.3.1 システム環境

dBASE ドライバは、UNIX 環境で dBASE IV および V をサポートしています。

dBASE ドライバは、dBASE と互換性のあるファイルを使用して SQL 文を直接実行します。 よって、それらのファイルにアクセスするために dBASE 製品を使用する必要はありません。

dBASE ドライバのファイル名については、DataDirect 製品に添付されている README ファイル を参照してください。

C.3.2 UNIX プラットフォームでのインデックス属性の定義

dBASE のインデックスファイルには、データベースファイルにある各インデックスのインデックスタグが含まれています。 そのタグを固有の属性としてマーキングすることができます。つまり、ドライバはインデックスタグを定義する列に重複した値がないかを 確認します。ただし、dBASE 製品または FoxPro 製品には、固有の属性がサポートされていません。 固有の属性を設定および認識するには、DataDirect dBASE ドライバの拡張機能を使用します。 DataDirect dBASE ドライバに、インデックスタグが固有であることを通知する必要があります。これにより、そのドライバを使って作成された固有のインデックスに設定する必要はありません。 そのドライバを使って作成されていないファイルを使用する場合には、次に説明されているように固有のインデックスタグを定義する必要があります。

データベースおよびインデックスファイルが配置されたディレクトリでは、vi などの任意のプレーンテキストエディタ を使用して、QEDBF.INI を次のように定義または編集します。

1. データベースファイルの名前 filename の場所に [filename] 節を作成します。 大文字/小文字を区別して入力し、ファイルの拡張子を付けます。

2. [filename] 節では、ファイルの固有インデックスの数 (NUMUNIQUE=) およびインデックスの仕様 (UNIQUE#=index_filename,index_tag) を指定します。 index_tag を決定するには、ODBC 関数 SQLStatistics を呼び出し、INDEX_NAME 結果の列を調べます。

   たとえば、accts.dbf 表に 2 つの固有インデックスを定義するには、 QEDBF.INI を次のように定義します。

   [accts.dbf]
   

   NUMUNIQUE=2
   UNIQUE0=accts.mdx,ACCT_NAME
   UNIQUE1=accts.mdx,ACCT_ID
   

C.3.3 データソースの設定および接続

データソースを設定するには、下記の表に示されているデータソース定義を使用する必要があります。 システム情報ファイルの設定に関する詳細については、『UNIX 環境』を参照してください。

アプリケーションから接続文字列を使ってデータソースに接続する場合には、 データソース名を指定する必要があります。データソースの指定により、システム情報ファイルでドライバにより使われるセクションが決定され、 そこに記述されているデフォルトの接続情報がドライバによって読み取られます。 また、システム情報ファイルに記録されているデフォルトの接続情報は、接続文字列で attribute=value のように指定して上書きすることができます。 ただし、接続文字列で指定した情報は、システム情報ファイルに優先して使用されるだけで、 実際にシステム情報ファイルに書き込まれることはありません。

接続文字列では、フルネームまたは省略名で指定できます。 接続文字列の書式は次のとおりです。

DSN=data_source_name[;attribute=value[;attribute=value]...]

dBASE の接続文字列の例

DSN=DBASE FILES;LCK=NONE;IS=0

次の表は、各種属性のフルネームと省略名、および属性の内容の一覧です。システム情報ファイルでは、属性のフルネームのみが使用されます。

この表にあるデフォルト値は、接続文字列やシステム情報ファイルのデータソース定義に値が指定されていない場合に使用される初期値です。データソースの設定時に属性の値を指定した場合は、その値がデフォルト値となります。

C.3.4 データ型

次の表は、dBASE データ型と標準 ODBC データ型との対応関係を示したものです。 dBASE データ型は、CREATE TABLE 文で使用できます。 CREATE TABLE 文の構文については、『Connect ODBC リファレンス』の『付録 A フラットファイルドライバと SQL 文』を参照してください。

注: ほとんどの製品では、NUMBER 列の精度およびスケールに従っていない数字を使って dBASE ファイルを作成することはできません。 たとえば、 これらの製品では、NUMBER(5,2) で宣言された列に 100000 を保存できますが、 dBASE ドライバにより、エラー 1244 "Unsupported decimal format." が表示されます。このエラーを対処するには、従っていない列に 1 を掛けると、 列が Float データ型に変換されます。次の例のようになります。

SELECT BADCOL * 1 FROM BADFILE

BADCOL * 1 で値が求められ、浮動値として返されます。

C.3.5 列名

SQL 文 (SELECT、INSERT など) の列名の長さは、最大 10 文字です。 列名には、アルファベット文字およびハイフン (-) を入れることができます。 最初の文字は、アルファベット文字 (a 〜 z) にする必要があります。

C.3.6 SELECT 文

SQL 文を使って列の指定とレコードの取り出しが可能です。 dBASE の SELECT 文では、Connect ODBC リファレンス』の『付録 A フラットファイルドライバと SQL 文』 で説明されているようにすべての SELECT 文の句がサポートされています。 このセクションでは、dBASE 固有 (Rowid) の情報について説明します。

C.3.6.1 Rowid 疑似列

各 dBASE レコードには、Rowid と名付けられた特殊な列が含まれています。 また、このフィールドには、データベースのレコード順序を示す固有の番号が含まれています。 たとえば、1 〜 50 の Rowid 値が付いた 50 個のレコードが表に含まれています (マーキングされたレコードが削除されていない場合)。 WHERE 句および SELECT 句で Rowid を使用できます。

Rowid は、とくにレコードの更新時に役立ちます。 他のフィールドと一緒にデータベースのレコードの Rowid を検索できます。次の例のようになります。

SELECT last_name, first_name, salary, rowid FROM 
emp

その後、更新するレコードの Rowid を使用して、正確なレコードを更新し、その他のレコードが更新されないようにすることができます。 次の例のようになります。

UPDATE emp set salary = 40000 FROM emp WHERE 
rowid=21

単一の行を素早く更新するには、Rowid の付いた WHERE 句を使用します。 ただし、Rowid 列を更新することはできません。

WHERE 句で Rowid 疑似列を使用する SELECT 文を実行すると、 完全一致のマッチを行う場合に限り、最大のパフォーマンスが発揮されます。 完全一致のマッチではなく、範囲スキャンを使用する場合、表全体のスキャンが実行されます。 次の例のようになります。

SELECT * FROM emp WHERE rowid=21    //fast search

SELECT * FROM emp WHERE rowid <=25  //full table 
scan

C.3.7 ALTER TABLE 文

dBASE ドライバは、ALTER TABLE 文をサポートしており、この文を使って表に列 (複数可) を追加することができます。 また、単一の列を削除することもできます。

ALTER TABLE 文の書式は次のとおりです。

ALTER TABLE table_name {ADD column_name data_type 
| ADD

(column_name data_type [, column_name data_type] 
... ) |
DROP [COLUMN] column_name}

ここで

たとえば、表 emp に 2 つの列を追加する場合は、次のようになります。

ALTER TABLE emp (ADD startdate date, dept char 
(10))

1 つの ALTER TABLE 文で列の追加と削除の両方を行うことはできません。 また、列の削除は、一度に 1 列に限られます。列の削除の記述例は次のとおりです。

ALTER TABLE emp DROP startdate

列にオブジェクト (インデックスやビューなど) が設定されている場合に、 その列に対して ALTER TABLE 文を使って削除すると、エラーが発生します。

C.3.8 CREATE INDEX 文

作成するインデックスのタイプは、システム情報ファイルまたは接続文字列で設定する CreateType 属性の値で決定されます。 次のインデックスを使用できます。

• dBASE (.MDX)
• FoxPro (.CDX)

インデックスの作成に使用する構文は次のとおりです。

CREATE [UNIQUE] INDEX index_name ON base_table_name 

(field_name [ASC | DESC] [,field_name [ASC | DESC]] ...) 

ここで

ASC を設定すると、昇順でインデックスが作成されます。DESC を設定すると、 降順でインデックスが作成されます。デフォルトでは、インデックスが昇順で作成されます。 1 つの CREATE INDEX 文で ASC と DESC 両方を指定することはできません。 たとえば、次の文は無効となります。

CREATE INDEX emp_i ON emp (last_name ASC, emp_id DESC)

次の表では、dBASEドライバでサポートされている各種インデックスファイルの属性を示しています。 サポートされている各タイプの項目の詳細は、次のとおりです。

• dBASE 形式の固有インデックスのサポートの有無

• 降順インデックス作成の有無

• キー列にサポートされている最大サイズ

• CREATE INDEX 文の列仕様にサポートされている最大サイズ

• 本番用/構造用のインデックスのサポートの有無

C.3.9 DROP INDEX 文

インデックスの削除に使用する構文は次のとおりです。

DROP INDEX table_name.index_name

ここで、table_name は、拡張子を除いた dBASE ファイルの名前です。

C.3.10 PACK 文

dBASE ファイルからレコードを削除しても、そのレコードは実際には除去されません。 その代わり、レコードは削除済みとしてマーキングされます。 また、メモフィールドを更新すると、ファイルのメモリが浪費されます。削除されたレコードを除去し、 メモフィールドの未使用メモリを解放するには、 PACK 文を使用する必要があります。次のような書式になります。

PACK filename

ここで、filename は、PACK 文を実行する dBASE ファイルの名前です。 拡張子、.DBF がない場合には、自動的に追加されるため、拡張子、.DBF を入力する必要はありません。 次の例のようになります。

PACK emp

他のユーザによって開かれているファイルに PACK 文を実行することはできません。 また、手動によるコミットモードで PACK 文を使用することもできません。

指定したファイルの場合、PACK 文を使って次の動作が実行されます。

• ファイルから削除されたすべてのレコードを除去します。

• ファイルと同じ名前の .CDX および .MDX ファイルから削除されたすべてのレコードの項目を除去します。

• メモ (.DBT または .FPT) ファイルの未使用メモリを圧縮します。

C.3.11 ロック

dBASE ドライバを使って、ネットワーク上で ｄBASE ファイルを共用するアプリケーションを構築および実行することができます。複数のユーザが共用データベースにアクセスしてアプリケーションを実行しているときはいつでも、変更しようとしているレコードをアプリケーションからロックします。 レコードをロックすると、他のユーザによるレコードのロック、更新、または削除が行われなくなります。

C.3.11.1 データベースのロックレベル

dBASE ドライバでは、3 つのロックレベル (NONE、RECORD、および FILE) がサポートされています。 接続文字列 (LCK=) でそれらのレベルを設定できます。

ロックしない場合は、パフォーマンスが最適となりますが、シングルユーザ環境に限定されます。

レコードまたはファイルをロックすると、 INSERT、UPDATE、DELETE、または SELECT...FOR UPDATE 文の実行時にデータベースの表がロックされます。 ユーザがトランザクションをコミットすると、ロックが解除されます。ロックを設定すると、他のユーザによるロックされたオブジェクトの変更が行われなくなりますが、リーダーはロックされません。

レコードをロックすると、文により影響を受けるレコードのみがロックされます。 また、表を変更する他のユーザとの同時性が提供されます。

ファイルをロックすると、表にあるすべてのレコードがロックされます。また、レコードの変更頻度がごく少ない場合、 おもに 1 人のユーザがレコードを変更する場合、または大量のレコードを変更する場合には、 オーバーヘッドが低下し、パフォーマンスが向上します。

C.3.11.2 ロック数の制限

ファイルに配置できるロック数は制限されています。 サーバから dBASE ファイルにアクセスしている場合、その制限はサーバに依存します (サーバのマニュアルを参照してください)。

C.3.11.3 トランザクションによるレコードロックの影響

UPDATE または DELETE 文を実行すると、その文により影響を受けるレコードがロックされます。 ドライバによりその変更内容がコミットされた後にロックが解除されます。 手動によるコミットモードを設定した場合、アプリケーションでトランザクションがコミットされるまで ロックが保持されます。自動コミットモードを設定した場合は、文が実行されるまでロックが保持されます。

SELECT...FOR UPDATE 文を実行すると、レコードがフェッチされる場合に限り、レコードがロックされます。 レコードを更新する場合は、その変更内容がコミットされるまでロックが保持されます。 それ以外の場合は、次のレコードがフェッチされると、ロックが解除されます。

C.3.12 サポートする分離レベルとロックレベル

dBASE ドライバは、分離レベル 1 をサポートしています。また、ファイルレベルおよびレコードレベルのロックもサポートしています。 分離とロックの詳細については、『Connect ODBC リファレンス』の『付録 D ロックレベルと分離レベル 』 を参照してください。

C.3.13 ODBC 対応レベル

dBASE ドライバがサポートしている関数については、『Connect ODBC リファレンス』の『付録 C ODBC API 関数とスカラ関数』に説明されています。また、SQLSetPos 関数もサポートされています。

さらに、SQLExtendedFetch および SQLFetchScroll でバックワードフェッチとランダムフェッチが使用できます。 また、基本 SQL 文法がサポートされています。

C.3.14 接続形態と文の数

dBASE ドライバは、複数接続、および各接続ごとの複数の文の実行をサポートしています。

C.4 Connect ODBC Informix ドライバ

C.4.1 システム環境

次のコマンドを使って、環境変数、INFORMIXDIR に、INFORMIX クライアントをインストールしたディレクトリを設定する必要があります。

C シェル

setenv INFORMIXDIR /databases/informix

Bourne シェルおよび Korn シェル

INFORMIXDIR=/databases/informix;export INFORMIXDIR

さらに、INFORMIXSERVER 変数には、INFORMIX サーバ の名前 ($INFORMIXDIR/ext/sqlhosts ファイルで定義されている名前) を設定する必要があります。 詳細については、『Informix Online Dynamic Server Administrator's Guide, Volume 2』または『Informix UNIX Installation Guide』を参照してください。

INFORMIX

UNIX 版 INFORMIX ドライバでは、INFORMIX-Connect または ESQL-C 7.23 が必要です。

INFORMIX 9

INFORMIX 9 ドライバを使って、リモートの INFORMIX 7.x または 9 データベースにアクセスするには、 Solaris および HP-UX 版 INFORMIX-Connect または ESQL-C 9.1.3 と AIX 版 INFORMIX-Connect 9.1.4 が必要です。

C.4.2 データソースの設定および接続

データソースを設定するには、下記の表に示されているデータソース定義を使用する必要があります。 システム情報ファイルの設定に関する詳細については、『UNIX 環境』を参照してください。

アプリケーションから接続文字列を使ってデータソースに接続する場合は、データソース名を指定する必要があります。データソースの指定により、システム情報中でドライバにより使われるセクションが決定され、そこに記述されているデフォルトの接続情報がドライバによって読み取られます。また、システム情報中に記録されているデフォルトの接続情報は、接続文字列で属性と値を対で指定して、上書きすることができます。ただし、接続文字列で指定した情報は、システム情報に優先して使用されるだけで、実際にシステム情報に書き込まれることはありません。

接続文字列では、属性をフルネームまたは省略名で指定します。接続文字列の書式は、次のとおりです。

DSN=data_source_name[;attribute=value[;attribute=value]...]

ここで、data_source_name はデータソース名、attribute は属性、value は属性の値です。また、DSN は、属性、DataSourceName の略号です。Informix の場合の接続文字列は、次の例のようになります。

DSN=INFORMIX TABLES;DB=PAYROLL

以下の表は、各種属性のフルネームと略号（かっこ内）、および属性の内容の一覧 です。システム情報ファイルでは、属性のフルネームのみが使用されます。

この表にあるデフォルトは、接続文字列やシステム情報ファイルのデータソース定義に値が指定されていない場合に使用される初期値です。データソースの設定時に属性の値を指定した場合は、その値がデフォルト値となります。

C.4.3 データ型

以下の表は、Informix ドライバで使われるデータ型と標準 ODBC データ型との対応関係を示したものです。

C.4.3.1 INFORMIX 9

INFORMIX データ型の他に、INFORMIX 9 では標準 ODBC データ型と次のように対応しています。

Informix 9 ドライバは、複合データ型（set、multiset、list、named/unnamed abstract 型など）をサポートしていません。データ中に複合データ型があると、不明なデータ型エラー (SQL State HY000) が返されます。

C.4.4 サポートする分離レベルとロックレベル

接続するデータベースシステムが Informix Online の場合は、分離レベルとして 0（コミット前に読み出し）、1（コミット後に読み出し）、3（直列化可能）をサポートしています。デフォルト値は 1 です。Informix Standard Engine（SE）は、レベル 0（コミット前に読み出し）のみをサポートしています。

また、Informix ドライバは、「カーソルスタビリティ」と呼ばれる分離レベル 1 をサポートしています。アプリケーションは、SQLSetConnectOption(1040,1) を呼び出して、この分離レベルを使用することができます。

Informix ドライバでは、データベースのトランザクションのログが無効になっている場合は、トランザクションは実行されません（ただし、ドライバは自動コミットモードで動作します）。

Informix ドライバは、ページ単位と行単位のロックをサポートしています。

分離とロックの詳細については、『Connect ODBC リファレンス』の『付録 D ロックレベルと分離レベル 』 を参照してください。

C.4.5 ODBC 対応レベル

INFORMIX ドライバがサポートしている関数については、『Connect ODBC リファレンス』の『付録 C ODBC API 関数とスカラ関数』に説明されています。 また、以下の X/Open 関数もサポートされています。

• SQLProcedures
• SQLColumnPrivileges
• SQLTablePrivileges
• SQLPrimaryKeys
• SQLForeignKeys
• SQLProcedureColumns

さらに、接続文字列の属性 EnableScrollableCursors を 1 に設定した場合は、SQLExtendedFetch または SQLFetchScroll でスクロールカーソルが使用できます。 また、コアレベルの SQL 文法がサポートされています。

C.4.6 接続形態と文の数

Informix ドライバは、Informix データベースへの複数接続、および各接続ごとの複数の文の実行をサポートしています。

C.5 Connect ODBC OpenIngres ドライバ

C.5.1 システム環境

次のセクションでは、OpenIngres と OpenIngres 2 の両方のシステム環境について説明します。

OpenIngres

クライアントワークステーションから OpenIngres データベースにアクセスするには、 クライアントノードに OpenIngres/Net Release 1.2 製品 (int.wnt/03 以上) をインストールしておく必要があります。

OpenIngres 2

クライアントワークステーションから OpenIngres 2 データベースにアクセスするには、 クライアントノードに CA OpenIngres Net バージョン 2.0 以上をインストールしておく必要があります。

OpenIngres および OpenIngres 2

リモートまたはホストの OpenIngres データベースは、INGRES 1.2 以上にする必要があります。

環境変数 II_SYSTEM に、INGRES クライアントをインストールしたディレクトリを設定する必要があります。

たとえば、/databases/ingres に INGRES 製品をインストールした場合は、次のようになります。

C シェル

setenv II_SYSTEM /databases

Bourne シェルまたは Korn シェル

II_SYSTEM=/databases;export II_SYSTEM

C.5.2 データソースの設定および接続

データソースを設定するには、下記の表に示されているデータソース定義を使用する必要があります。 システム情報ファイルの設定に関する詳細については、『UNIX 環境』を参照してください。

アプリケーションから接続文字列を使ってデータソースに接続する場合には、 データソース名を指定する必要があります。データソースの指定により、システム情報ファイルでドライバにより使われるセクションが決定され、 そこに記述されているデフォルトの接続情報がドライバによって読み取られます。 また、システム情報ファイルに記録されているデフォルトの接続情報は、接続文字列で attribute=value のように指定して上書きすることができます。 ただし、接続文字列で指定した情報は、システム情報ファイルに優先して使用されるだけで、 実際にシステム情報ファイルに書き込まれることはありません。

接続文字列では、フルネームまたは省略名で指定できます。 接続文字列の書式は次のとおりです。

DSN=data_source_name[;attribute=value[;attribute=value]...]

OpenIngres の接続文字列の例

DSN=INGRES TABLES;SRVR=QESERV;DB=PAYROLL;UID=JOHN

次の表は、各種属性のフルネームと省略名、および属性の内容の一覧です。 システム情報ファイルでは、属性のフルネームのみが使用されます。

この表にあるデフォルト値は、接続文字列やシステム情報ファイルのデータソース定義に値が指定されていない場合に使用される初期値です。データソースの設定時に属性の値を指定した場合は、その値がデフォルト値となります。

C.5.3 データ型

次の表は、OpenIngres データ型と標準 ODBC データ型との対応関係を示したものです。

注: OpenIngres の Date 値は、ODBC データ型の SQL_TYPE_TIMESTAMP には直接対応していません。 間隔データを Date 列に配置する場合、その値を読み込むときにエラーが発生します。

C.5.4 サポートする分離レベルとロックレベル

OpenIngres ドライバは、分離レベル 1 (コミット後に読み出し) をサポートしています。これがデフォルト値です。また、ページレベルのロックもサポートしています。 分離とロックの詳細については、『Connect ODBC リファレンス』の『付録 D ロックレベルと分離レベル 』 を参照してください。

C.5.5 ODBC 対応レベル

OpenIngres ドライバがサポートしている関数については、『Connect ODBC リファレンス』の『付録 C ODBC API 関数とスカラ関数』に説明されています。SQLGrammar=1 以外の場合には、SQLProcedures および SQLProcedureColumns 関数もサポートされています。

また、基本 SQL 文法がサポートされています。

C.5.6 接続形態と文の数

OpenIngres データベースシステムは、複数接続、および各接続ごとの複数の文の実行をサポートしています。

接続文字列の属性 RepeatedSelectsに 1 または 2 を設定した場合、ドライバが 1 つのアクティブな文と接続に限定されます。

C.6 Connect ODBC Oracle ドライバ

C.6.1 システム環境

UNIX 版 Oracle および Oracle8 クライアント情報は、次のとおりです。

Oracle および Oracle8

Oracle データソースを使用する前に、 使用する Oracle SQL*Net または Net8 ドライバを $ORACLE_HOME ソースツリーのワークステーション上にインストールしておく必要があります。 インストールプロセスで作成される環境変数、ORACLE_HOME は、 Oracle クライアントコンポーネントの場所を示します。

Oracle では、ランタイム Oracle コンポーネントは Oracle RDBMS と呼ばれます。 Oracle RDBMS 製品の場合に、Oracle ドライバは、$ORACLE_HOME/bin の実行可能ファイル、および $ORACLE_HOME/rdbms/lib のインターフェイスライブラリに依存します。

環境変数、ORACLE_HOME に、Oracle RDBMS、SQL*Net、または Net8 製品をインストールしたディレクトリを設定する必要があります。 次の例のようになります。

C シェル

setenv ORACLE_HOME /databases/oracle

Bourne シェルおよび Korn シェル

ORACLE_HOME=/databases/oracle;export ORACLE_HOME

Oracle7 SQL*Net 共有ライブラリドライバの構築

Oracle ドライバでは、AIX 上での Oracle7 SQL*Net ドライバ、Solaris および HP=UX 上での Oracle7.1 のみの構築にサイトリンクが必要です。このサイトリンクにより、使用している一意の Oracle7 SQL*Net 設定がファイルにバインドされます。 Oracle ドライバは、このファイルを使用してローカルおよびリモートの Oracle データベースにアクセスします。

Oracle7 SQL*Net 共有ライブラリを構築する前に Oracle をインストールし、 環境変数 ORACLE_HOME に、Oracle をインストールしたディレクトリを設定します。 Connect ODBC により、Oracle7 SQL*Net ドライバを構築する genclntsh スクリプトが提供されます。 このスクリプトは、scr/oracle ディレクトリにあります。

次のコマンドを使って、Oracle7 SQL*Net 共有ライブラリを構築します。

genclntsh

Solaris 用 Oracle Net8 共有ライブラリドライバの構築

Solaris 版 Oracle8.0.3 または 8.0.4 で使用する場合、Oracle8 ドライバでは、 一度だけサイトにリンクして、代わりの Oracle Net8 ドライバを構築する必要があります。 使用している固有の Oracle Net8 設定がファイルにバインドされます。 Oracle ドライバは、このファイルを使用してローカルおよびリモートの Oracle データベースにアクセスします。

Oracle8 ドライバには、共有ライブラリ libclntsh.so が必要です。 このライブラリは、Oracle スクリプトの genclntsh によって構築されます。 Oracle スクリプトの genclntsh は、シンボル slpmprodstab が定義されていない場合にはエラーの原因となります。 そのため、Oracle8 ユーザは、Connect ODBC スクリプトの genclntsh8 を使用して、代わりの libclntsh.so を構築する必要があります。 scr/oracle ディレクトリにあるこのスクリプトは、新しい libclntsh.so を ../../lib、つまり、使用する $ODBC_HOME/lib ディレクトリに配置します。$ORACLE_HOME/lib にある元の libclntsh.so は上書きされません。

Oracle Net8 共有ライブラリを構築する前に Oracle をインストールし、 環境変数 ORACLE_HOME に、Oracle をインストールしたディレクトリを設定します。

次のコマンドを使って、Oracle Net8 共有ライブラリを構築します。

genclntsh8

警告: Oracle8 ユーザの $ORACLE_HOME/lib ディレクトリには、元のライブラリである libclntsh.so があります。したがって、正しいライブラリを含む $ODBC_HOME/lib ディレクトリは、 LD_LIBRARY_PATH で $ORACLE_HOME/lib より前に指定する必要があります。このように指定されていないと、 元のライブラリがロードされ、未解決のシンボルエラーが発生します。

C.6.2 データソースの設定および接続

データソースを設定するには、下記の表に示されているデータソース定義を使用する必要があります。 システム情報ファイルの設定に関する詳細については、『UNIX 環境』を参照してください。

アプリケーションから接続文字列を使ってデータソースに接続する場合には、 データソース名を指定する必要があります。データソースの指定により、システム情報ファイルでドライバにより使われるセクションが決定され、そこに記述されているデフォルトの接続情報がドライバによって読み取られます。 また、システム情報ファイルに記録されているデフォルトの接続情報は、接続文字列で attribute=value のように指定して上書きすることができます。 ただし、接続文字列で指定した情報は、システム情報ファイルに優先して使用されるだけで、 実際にシステム情報ファイルに書き込まれることはありません。

接続文字列では、フルネームまたは省略名で指定できます。 接続文字列の書式は次のとおりです。

DSN=data_source_name[;attribute=value[;attribute=value]...]

Oracle 接続文字列の例

DSN=Accounting;SRVR=X:QESRVR;UID=JOHN;PWD=XYZZY

サーバ名にセミコロンが含まれている場合は、サーバ名を次のように二重引用符で囲みます。

DSN=Accounting;SRVR="X:QE;SRVR";UID=JOHN;PWD=XYZZY

次の表は、各種属性のフルネームと省略名、および属性の内容の一覧です。システム情報ファイルでは、属性のフルネームのみが使用されます。

この表にあるデフォルト値は、接続文字列やシステム情報ファイルのデータソース定義に値が指定されていない場合に使用される初期値です。データソースの設定時に属性の値を指定した場合は、その値がデフォルト値となります。

C.6.2.1 オペレーティングシステムパラメータによる接続

Oracle には、オペレーティングシステムのユーザ名とパスワードを使って Oracle に接続する機能があります。 Oracle に接続するには、ユーザ名にスラッシュ( / ) を付け、パスワードはブランクのままにします。 サーバ/クライアントの設定については、Oracle サーバのマニュアルを参照してください。

driver_prefix:computer_name[:sid]

database_name

TNSNAME

C.6.3 Oracle データ型

次の表は、Oracle データ型と標準 ODBC データ型との対応関係を示したものです。

Oracle8

Oracle データ型の他に、Oracle8 では標準 ODBC データ型と次のように対応しています。

Oracle8 ドライバは、Abstract データ型をサポートしていません。 取得したデータに Abstract データ型が含まれていると、不明なデータ型エラー (SQL State HY000) が返されます。 現行の Oracle8 クライアントの制約のため、非同期操作もサポートしていません。

C.6.4 結果を返すストアドプロシージャの使用

<結果を返すストアドプロシージャの使用> チェックボックスを選択すると、 ストアドプロシージャ/関数の結果セットが返されるようになります。 また、SQLGetInfo(SQL_MULT_RESULTS_SETS) は Y を返し、 SQLGetInfo(SQL_BATCH_SUPPORT) は SQL_BS_SELECT_PROC を返します。 このオプションが選択された状態で結果を返さないストアドプロシージャを実行すると、 パフォーマンスが低下します。

この機能を使用するには、ストアドプロシージャを特定の書式にする必要があります。 まず、パッケージを作成し、プロシージャで使用するすべてのカーソルを定義する必要があります。 その後、その新しいカーソルを使ってプロシージャを作成することができます。次に例を示します。

Create or replace package GEN_PACKAGE as CURSOR G1 is select 
CHARCOL from GTABLE2;
type GTABLE2CHARCOL is ref cursor return G1%rowtype;
end GEN_PACKAGE;

Create or replace procedure GEN_PROCEDURE1 (rset IN OUT 
GEN_PACKAGE.GTABLE2CHARCOL, icol INTEGER) as begin
open rset for select CHARCOL from GTABLE2 where INTEGERCOL 
<= icol order by INTEGERCOL; end;

詳細については、Oracle SQL のマニュアルを参照してください。

C.6.5 サポートする分離レベルとロックレベル

Oracle ドライバは、分離レベル 1 (コミット後に読み出し)、 3 (直列化可能、サーバのバージョンが Oracle 7.3 以上または 8.x の場合) をサポートしています。また、レコードレベルのロックもサポートしています。

分離とロックの詳細については、『Connect ODBC リファレンス』の『付録 D ロックレベルと分離レベル 』 を参照してください。

C.6.6 ODBC 対応レベル

Oracle がサポートしている関数については、『Connect ODBC リファレンス』の『付録 C ODBC API 関数とスカラ関数』に説明されています。また、EnableDescribeParam 属性が 1 に設定されている場合は、 SQLDescribeParam もサポートしています。さらに、EnableScrollableCursors 属性が 1 に設定されている場合には、SQLSetPos をサポートするとともに、 SQLFetchScroll および SQLExtendedFetch でスクロールカーソルが使用できます。

Oracle ドライバは、次の X/Open レベルの関数をサポートしています。

• SQLProcedures
• SQLProcedureColumns
• SQLPrimaryKeys
• SQLForeignKeys
• SQLTablePrivileges
• SQLColumnPrivileges

また、コアレベルの SQL 文法がサポートされています。

C.6.7 接続形態と文の数

Oracle ドライバは、複数接続、および各接続ごとの複数の文の実行をサポートしています。

C.7 Connect ODBC Sybase ドライバ

C.7.1 システム環境

System データソースを使用する前に、使用する Sybase Open Client Net-Libraries を $SYBASE ソースツリー上にインストールしておく必要があります。

次のコマンドを使って、環境変数、SYBASE に System クライアントをインストールしたディレクトリを設定する必要があります。

C シェル

setenv SYBASE /databases/sybase

Bourne シェルおよび Korn シェル

SYBASE=/databases/sybase;export SYBASE

System クライアント共有ライブラリを含むディレクトリを、環境変数、LD_LIBRARY_PATH (Solaris の場合)、 LIBPATH (AIX の場合)、および SHLIB_PATH (HP-UXの場合) に含める必要があります。

C シェル

setenv LD_LIBRARY_PATH /databases/sybase/
lib:$LD_LIBRARY_PATH

Bourne シェルおよび Korn シェル

LD_LIBRARY_PATH=/databases/sybase/
lib:$LD_LIBRARY_PATH;export LD_LIBRARY_PATH

非 DCE 環境では、ivsybxx Sybase ドライバを使用します。これにはライブラリ、libct が必要です。DCE 環境では、 ivsyb11xx Sybase ドライバを使用します。これには Sybase 11.1 クライアントライブラリ、libct_r が必要です。

C.7.2 データソースの設定および接続

データソースを設定するには、下記の表に示されているデータソース定義を使用する必要があります。 システム情報ファイルの設定に関する詳細については、『UNIX 環境』を参照してください。

アプリケーションから接続文字列を使ってデータソースに接続する場合は、データソース名を指定する必要があります。データソースの指定により、システム情報ファイル中でドライバにより使われるセクションが決定され、そこに記述されているデフォルトの接続情報がドライバによって読み取られます。また、システム情報中に記録されているデフォルトの接続情報は、接続文字列で属性と値を対で指定して、上書きすることができます。ただし、接続文字列で指定した情報は、システム情報ファイルに優先して使用されるだけで、実際にシステム情報ファイルに書き込まれることはありません。

接続文字列では、属性をフルネームまたは略号で入力します。接続文字列の書式は、次のとおりです。

DSN=data_source_name[;attribute=value[;attribute=value]...]

ここで、data_source_name はデータソース名、attribute は属性、value は属性の値です。また、DSN は、属性、DataSourceName の略号です。Sybase の場合の接続文字列は、次の例のようになります。

DSN=SYS10 TABLES;SRVR=QESRVR;DB=PAYROLL;UID=JOHN;PWD=XYZZY

以下の表は、各種属性のフルネームと略号（かっこ内）、および属性の内容の一覧 です。 システム情報ファイルでは、属性のフルネームのみが使用されます。

デフォルト値が示されている属性もあります。この値は初期値で、接続文字列中で属性の値が指定されていない場合は、この初期値が使われます。また、システム情報で属性の値が指定されていない場合にも使用されます。データソースの設定時に属性の値を指定した場合は、その値がデフォルト値となります。

sp_configure "maximum network packet size", 
5120

reconfigure

Restart Sybase Server

C.7.3 データ型

以下の表は、Sybase ドライバで使われるデータ型と標準 ODBC データ型との対応関係を示したものです。

C.7.4 サポートする分離レベルとロックレベル

サポートされる分離レベルは、レベル 0 サーバのバージョンが 11 以上の場合、レベル 1（コミット後に読み出し、デフォルト値）およびレベル 3（直列化可能）です。また、ページレベルのロックをサポートしています。分離とロックの詳細については、『Connect ODBC リファレンス』の『付録 D ロックレベルと分離レベル 』 を参照してください。

C.7.5 ODBC 対応レベル

Sybase ドライバがサポートしている関数については、『Connect ODBC リファレンス』の『付録 C ODBC API 関数とスカラ関数』に説明されています。また、次の関数もサポートされています。

• SQLColumnPrivileges
• SQLForeignKeys
• SQLPrimaryKeys
• SQLProcedureColumns
• SQLProcedures
• SQLTablePrivileges

また、基本 SQL 文法をサポートしています。

C.7.6 接続形態と文の数

Sybase ドライバでは、複数接続および、各接続ごとの複数の文の実行をサポートしています。また、SelectMethod 属性が 1 に設定されている場合は、Sybase データソースでは、手動コミットモードでアクティブとなる文が 1 つのみとなります。

C.8 Connect ODBC テキストドライバ

テキストドライバは、ASCII テキストファイルをサポートしています。これらのファイルには、バイナリ形式で保存されているデータが含まれないため、テキストエディタやワードプロセッサで直接、印刷および編集することができます。

テキストドライバのファイル名については、Micro Focus DataDirect 製品に付属の README ファイルを参照してください。

テキストドライバは、テキストファイルに対して直接 SQL 文を実行します。INSERT 文もサポートされており、ファイルの末尾にレコードが追加されます。また、状況によっては、UPDATE 文および DELETE 文も実行可能です。

C.8.1 テキストファイルのフォーマット

表 16-1.は、一般的なテキストファイルフォーマットの一覧です。

これらのフォーマットのうち、コンマ分割、タブ分割、および文字分割のテキストファイルは、まとめて文字区切りファイルと総称されます。これは、いずれも何らかの文字で値が区切られているためです。

C.8.2 UNIX プラットフォームでの表構造の定義

すべてのテキストファイルが同じ構造（フォーマット）を持っているわけではありません。このため、テキストドライバでは、既存のファイルの構造を定義するオプションが提供されています。ここで説明する表構造の定義は、必ず行わなければならないわけではありません（テキストドライバは、列の名前とデータ型の推測機能を使用して推測することができます）が、定義が非常に役に立つ場合もあります。

UNIX の場合は、テキストファイルの構造の定義は、QETXT.INI ファイルを作成して行います。QETXT.INI ファイルは、vi などの通常のテキストエディタで作成します。QETXT.INI ファイルの名前はすべて大文字でなければなりません。定義する表はすべて、このファイルにより指定されます。このファイルでテキストファイルを定義すると、システム情報ファイルおよび接続文字列で指定されている属性に優先して使用されます。

QETXT.INI ファイルによるテキストファイルの構造の定義は、次のようにして行います。

1. [Defined Tables] セクションを作成し、ここに定義する表を記述します。まず、テキストファイルの名前を指定し（テキストファイルの名前は、実際のファイルに応じて大文字または小文字を用います）、その後にそのテキストファイルに格納する表の名前を記述します（表は複数指定できます）。たとえば、次のようになります。

   emptxt.txt=EMP 
   

   表名は 32 字以内でなければなりません。また、同一のデータベース内の他の表と同じ名前を記述することはできません。この名前が、SQLTables により返されます。デフォルトでは、拡張子を除いた名前が返されます。

2. 記述した表（複数記述したときは、その全部）について、テキストファイルの名前（FILE=）、表の種類（TT=）、ファイルの最初の行の列名の有無（FLN=）および区切り文字の種類（DC=）を指定します。

   たとえば、テキストファイルの名前は、次のようにして指定します。

   FILE=emptxt.txt 
   

   表の種類を指定するには、各フィールドの区切り文字、Comma（コンマ区切り）、Tab（タブ区切り）、Character（文字区切り）、Fixed（固定長）、または Stream（ストリーム）を記述します。たとえば、次のように記述します。

   TT=COMMA 
   

   表の種類が Character（任意の文字）の場合は、実際の区切り文字を指定しなければなりません。たとえば、区切り文字がセミコロンの場合は、次のように記述します。

   DC=;
   

   さらに、最初の行に列名があるかどうかを 1（列名がある）または 0（列名がない）で示します。たとえば、次のようになります。

   FLN=0
   

3. 表の各フィールド（列）について定義を行います。この場合、最初の行を FIELD1 とし、フィールド（列）名、フィールドの種類、精度、スケール、長さ、オフセット（Fixed の場合）、日付 / 時間マスクの順で定義していきます。なお、日付マスクについては、『日付マスク』で説明されています。

   各要素の値は、コンマで区切ります。以下は、フィールドが 2 つの場合の記述例です。

   FIELD1=EMP_ID,VARCHAR,6,0,6,0,
   

   FIELD2=HIRE_DATE,DATE,10,0,10,0,m/d/yy
   

4. 定義が終わったら、ファイルを QETXT.INI として保存します。ドライバは、システム情報ファイルの属性、Database で指定されているディレクトリ、またはカレントのディレクトリでこのファイルを探します。

C.8.2.1 QETXT.INI の例

以下は、QETXT.INI ファイルの例です。ここでは、ファイル、emptext.txt の定義を行っています。emptext.txt はデータファイルで、サンプルとして付属しています。

[Defined Tables]

emptext.txt=EMP

[EMP]
FILE=emptext.txt
FLN=1
TT=Comma
Charset=ANSI
FIELD1=FIRST_NAME,VARCHAR,10,0,10,0,
FIELD2=LAST_NAME,VARCHAR,9,0,9,0,
FIELD3=EMP_ID,VARCHAR,6,0,6,0,
FIELD4=HIRE_DATE,DATE,10,0,10,0,m/d/yy
FIELD5=SALARY,NUMERIC,8,2,8,0,
FIELD6=DEPT,VARCHAR,4,0,4,0,
FIELD7=EXEMPT,VARCHAR,6,0,6,0,
FIELD8=INTERESTS,VARCHAR,136,0,136,0,

C.8.3 日付マスク

日付マスクを使用して、日付がテキストファイルに格納される場合の書式を指定することができます。値は、テキストファイルに挿入される際に、この日付マスクに従ってフォーマットされ、格納されます。また、テキストファイルから値が読み出されるときには、フォーマット済みの日付から通常の日付データへと変換されます。

以下の表は、日付マスクの指定に使用可能な記号と、その意味の一覧です。

以下の表は、日付、マスク、テキストファイルでの表現形式を示したものです。

C.8.4 データソースの設定および接続

データソースを設定するには、下記の表に示されているデータソース定義を使用する必要があります。 システム情報ファイルの設定に関する詳細については、『UNIX 環境』を参照してください。

アプリケーションから接続文字列を使ってデータソースに接続する場合は、データソース名を指定する必要があります。データソースの指定により、システム情報中でドライバにより使われるセクションが決定され、そこに記述されているデフォルトの接続情報がドライバによって読み取られます。また、システム情報ファイル中に記録されているデフォルトの接続情報は、接続文字列で属性と値を対で指定して、上書きすることができます。ただし、接続文字列で指定した情報は、システム情報に優先して使用されるだけで、実際にシステム情報ファイルに書き込まれることはありません。

接続文字列では、属性をフルネームまたは略号で入力します。接続文字列の書式は、次のとおりです。

DSN=data_source_name[;attribute=value[;attribute=value]...]

ここで、data_source_name はデータソース名、attribute は属性、value は属性の値です。また、DSN は、属性、DataSourceName の略号です。テキストファイルの場合の接続文字列は、次の例のようになります。

DSN=TEXT FILES;TT=CHARACTER;DC=&

以下の表は、各種属性のフルネームと略号（かっこ内）、および属性の内容の一覧です。システム情報ファイルでは、属性のフルネームのみが使用されます。

この表にあるデフォルト値は、接続文字列やシステム情報ファイルのデータソース定義に値が指定されていない場合に使用される初期値です。データソースの設定時に属性の値を指定した場合は、その値がデフォルト値となります。

注：この表の属性のうち、ScanRows 、TableType 、Delimiter 、FirstLineNames 、DecimalSymbol 、Charset は、新規に定義される表に対してのみ有効です。また、この 4 つの属性は、CREATE TABLE 文を使って表を新たに作成する場合にも有効となります。

C.8.5 データ型

以下の表は、テキストファイルのデータ型と標準 ODBC データ型との対応関係を示したものです。

C.8.6 SELECT 文

テキストドライバでは、SQL 文を使って列の指定とレコードの取り出しが可能です。ドライバでは、『Connect ODBC リファレンス』の『付録 A フラットファイルドライバと SQL 文』で説明されているようにすべての SELECT 文節がサポートされています。

C.8.7 ALTER TABLE 文

テキストドライバは、ALTER TABLE 文をサポートしており、この文を使って表に列（複数可）を追加することができます。また、単一の列を削除することもできます。

ALTER TABLE 文の書式は次のとおりです。

ALTER TABLE table_name

{ADD column_name data_type
| ADD (column_name data_type
[,column_name data_type] ...)
| DROP [COLUMN] column_name
}

ここで、table_name は、列の追加または削除を行う表の名前です。column_name は、追加する列の名前です。また、削除の場合は、ここに削除する列を指定します。data_type は、追加する列のデータ型です。

たとえば、表、emp に 2 つの列を追加する場合は、次のようになります。

ALTER TABLE emp (ADD startdate date, dept 
varchar(10))

1 つの ALTER TABLE 文で列の追加と削除の両方を行うことはできません。また、列の削除は、一度に 1 列に限られます。以下は、列の削除の記述例です。

ALTER TABLE emp DROP startdate

列にオブジェクト、たとえば、インデックスやビューなどが設定されている場合に、その列に対して ALTER TABLE 文で削除を行うとエラーが発生します。

C.8.8 ODBC 対応レベル

Text ドライバがサポートしている関数については、『Connect ODBC リファレンス』の『付録 C ODBC API 関数とスカラ関数』に説明されています。また、SQLSetPos 関数もサポートされています。

さらに、SQLExtendedFetch および SQLFetchScroll でのバックワードフェッチとランダムフェッチがサポートされており、基本 SQL 文法がサポートされています。

C.8.9 接続形態と文の数

テキストドライバは、複数接続および、各接続ごとの複数文の実行をサポートしています。

COBSQL エラーメッセージ

埋め込み SQL 文