この章では、Pervasive PSQL v11 SP3 ODBC インターフェイスの制限とサポートについて説明します。

ODBC API、SQL 文法、およびスカラー関数の詳細については、『Microsoft ODBC Programmer's Reference』を参照してください。

Pervasive PSQL のリレーショナル インターフェイスでは、メタデータでバージョン 1（V1）とバージョン 2（V2）という 2 つのバージョンをサポートします。

メタデータのバージョンはデータベース プロパティの 1 つで、データベースの作成時に指定します。デフォルトは "メタデータ バージョン 1" です。"メタデータ バージョン 2" にする場合は、データベースを作成する際に指定する必要があります。

メタデータのバージョンは、そのデータベース内のすべてのデータ辞書ファイル（DDF）に適用されます。単独のデータベースで、メタデータ バージョン 1 を使用する DDF とメタデータ バージョン 2 を使用する DDF を一緒に使用することはできません。2 つのバージョンの DDF はそれぞれ情報をやり取りすることができません。

ただし、データベース エンジンで複数のデータベースへ同時にアクセスすれば、そのデータベースごとにメタデータ バージョン 1 またはメタデータ バージョン 2 を使用することができます。

Pervasive PSQL v10 より前の Pervasive PSQL バージョンで作成されたデータベースはすべてメタデータ バージョン 1 を使用します。Pervasive PSQL v10 以降を使って作成されたデータベースは、データベースの設定に応じてどちらかのメタデータ バージョンを使用しています。

メタデータ バージョン 2 では、多くの識別子名に最大 128 バイトの名前を付けることができます。詳細については、Pervasive PSQL 機能の制限/条件を参照してください。またメタデータ バージョン 2 では、ビューおよびストアド プロシージャに対する権限が認められます。ビューおよびストアド プロシージャに対する権限を参照してください。

メタデータ バージョン 2 のデータ辞書ファイル（DDF）には、バージョン 1 用とは異なる名前が付けられます。多くの場合、バージョン 2 の DDF には追加フィールドや既存フィールドへの変更が含まれています。システム テーブルを参照してください。

Pervasive PSQL には pvmdconv という、メタデータ バージョン 1 からメタデータ バージョン 2 へ変換するための変換ユーティリティが付属しています。『Pervasive PSQL User's Guide』の pvmdconv を参照してください。

次の表は、リレーショナル インターフェイスの機能に適用される制限または条件を示します。

Pervasive PSQL データベースには、40 億のオブジェクトをさまざまに組み合わせて含むことができます。オブジェクトはデータ辞書ファイルに保存されます。

開発者リファレンス『Pervasive PSQL Programmer's Guide』の名前付け規則も参照してください。

完全修飾されたオブジェクト名は、ドット表記でデータベース名とオブジェクトを結合します。たとえば、mydbase というデータベースに myview というビューがある場合、完全修飾オブジェクト名は mydbase.myview となります。

完全修飾オブジェクト名はデータベース内で一意である必要があります。たとえば、データベース "mydbase" に "acctpay" というテーブルとユーザー定義関数（またはその他のオブジェクト）"acctpay" があるとします。この場合、Pervasive PSQL は完全修飾名の "maydbase.acctpay" がどのオブジェクトを参照するのか識別できません。

DSN への接続に使用される接続文字列には、ドライバーの定義済みキーワードをいくつでも含むことができます。これらのキーワードを使用することにより、ドライバーはデータ ソースへ接続するのに十分な情報を得ることができます。ドライバーは、データ ソースとの接続に必要なキーワードを定義します。

Pervasive PSQL の接続文字列およびキーワードの完全な説明については、ODBC 接続文字列を参照してください。

リレーショナル インターフェイスは、コア、レベル 1、およびレベル 2 のインターフェイス サポート レベルに対する ODBC v3.51 仕様をサポートしています。

SQL_BEST_ROWID

リレーショナル インターフェイスでは、テーブル内の行を識別する最適な列セットとして固有のインデックスが使用されます。

IDENTITY 列のあるテーブルに新しい列を挿入した場合、リレーショナル インターフェイスは IDENTITY 列に割り当てられた値を返しません。IDENTITY 列の値は @@IDENTITY 変数を使用することによって判断できます。@@IDENTITY を参照してください。

SQL_ROWVER

上記の SQL_BEST_ROWID を参照してください。

SQL_ATTR_LOGIN_TIMEOUT

サポートされていません

次の表は、リレーショナル インターフェイスによりサポートされる ODBC API 関数、および ODBC サポート レベルの一覧を示します。

次のセクションには、ODBC API サポートの例外に関する詳細が記述されています。

SQLGetTypeInfo を使用すると、リレーショナル インターフェイスによって指定されたネイティブ データ型名（タイプ名）のリストが生成されます。たとえば、SQL_CHAR が CHARACTER に割り当てられます。CREATE TABLE ステートメントまたは ALTER TABLE ステートメント内の列のデータ型名、あるいはプロシージャのパラメーターや、プロシージャおよびトリガーで宣言された変数のデータ型名には、この関数から戻される名前を使用してください。

サポートされている ODBC データ型の一覧については、Pervasive PSQL データ型と対応する ODBC データ型を参照してください。

リレーショナル インターフェイスでは、テーブル内の行を一意に識別する最適な列セットとして固有のインデックスが使用されます。新しい行が挿入されたとき、リレーショナル インターフェイスは IDENTITY 列の値は返しません。IDENTITY 列の値は @@IDENTITY 変数を使用することによって判断できます。@@IDENTITY を参照してください。

アプリケーションで SQLGetData を呼び出して SQL_C_NUMERIC 構造体にデータを返した場合、ODBC 標準では、SQL_DESC_SCALE フィールドはゼロに設定され、SQL_DESC_PRECISION フィールドにはドライバー定義の精度が使用されます。

Pervasive PSQL は、メタデータに定義されている小数位およびドライバー定義の精度（桁数）の値を使用します。次の例を考えて見ましょう。この例では、小数位は 2 に設定されます。

SELECT ステートメントは 10.00 ではなく 10.34 を返します。

リレーショナル インターフェイスは、SQL_DRIVER_VER と SQL_DBMS_VER で同一の値を返します。このバージョン値は次の形式で返されます。

この値は、次の表で説明されているように 4 つの構成要素として解釈できます。

次の表では、SQLGetInfo で一般的に返されるその他の値についてまとめています。値は例としてのみ挙げてあります。

リレーショナル インターフェイスは ODBC v3.51 の属性サポートを提供していますが、次の例外があります。

次の表は、ODBC ステートメント属性サポートの例外を示します。

次の表は、ODBC 接続属性サポートの例外を示します。

リレーショナル インターフェイスは ODBC v3.51 の記述子フィールド サポートを提供していますが、次の例外があります。

次の表は、ODBC 記述子フィールド サポートの例外を示します。

一部の記述子フィールドは ODBC のさまざまな SQLSet および SQLGet 関数を介して設定できますが、これらの関数が 64 ビット値対応に変更されている一方、それ以外の関数はまだ 32 ビット値対応であることに注意してください。64 ビット ODBC ドライバーを使用している場合、このようなフィールドを設定および取得する際には、適切なサイズの変数を使用するようにしてください。詳細については、Microsoft の ODBC ドキュメントを参照してください。
特に http://msdn.microsoft.com/en-us/library/ms716287%28VS.85%29.aspx（英語）をご覧ください。

説明の要点は、SQL_ROWSET_SIZE は SQLGetStmtOption と SQLGetStmtAttr の両方でサポートされるということです。64 ビット ODBC ドライバーを使用し、SQLGetStmtOption または SQLGetStmtAttr を呼び出した場合、属性パラメーターが SQL_ROWSET_SIZE に設定されている場合には、*ValuePtr に 64 ビット値が返されます。

このセクションでは、以下の SQLSetStmtOption の各種オプションに対する Pervasive PSQL のサポートについて説明します。

次の表は、各オプションで有効な設定値を示します。

ODBC v 2.5 仕様は、最小、コア、拡張の 3 つの SQL 文法レベルを提供します。レベルが高くなるほど、より完全なデータ定義の実装とデータ操作言語のサポートが提供されます。リレーショナル インターフェイスでは、最小 SQL 文法に加え、多数のコアおよび拡張のステートメント文法を完全サポートしています。リレーショナル インターフェイスがサポートしている SQL 文法は、次の表に要約されています。

列名およびテーブル名に非 ODBC 標準文字が含まれる場合、列名とテーブル名はデリミター付き識別子として表記できます。識別子がキーワードである場合は、デリミターを付ける必要があります。

識別子のデリミター文字は二重引用符です。

ハイフンは ODBC 標準文字ではありません。

"Password" は SET PASSWORD ステートメントのキーワードです。