この章では、リレーショナル インターフェイスおよび ODBC について説明します。

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

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

SQLFreeStmt に SQL_CLOSE オプションを指定して呼び出すと、SQLState は変更されますが、hStmt が使用している開いたテーブルは閉じません。hStmt が現在使用しているテーブルを閉じるには、SQLFreeStmt に SQL_DROP オプションを指定して呼び出す必要があります。

次の例では、Emp と Dept のテーブルは開いたままになります。

その次に SQLPrepare が hStmt で呼び出されたとき、前のステートメントで使用したテーブルが閉じられます。たとえば、次の呼び出しを実行すると、Emp と Dept の両方のテーブルは Zen によって閉じられます。

その後、次の呼び出しによって Customer テーブルを閉じます。

ODBC v 2.5 仕様は、最小、コア、拡張の 3 つの SQL 文法レベルを提供します。レベルが高くなるほど、より完全なデータ定義の実装とデータ操作言語のサポートが提供されます。

リレーショナル インターフェイスでは、最小 SQL 文法に加え、多数のコアおよび拡張のステートメント文法を完全サポートしています。リレーショナル インターフェイスがサポートしている SQL 文法は、次の表に要約されています。ステートメント文法は、『SQL Engine Reference』に記載されています。

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

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

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

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

次の表は、Zen によってサポートされる ODBC のリレーショナル データ型に関する情報を示します。SRDE は、SQLGetData または SQLBindCol を呼び出すときに別のデータ型変換が指定されない限り、リレーショナル データ型を ODBC のデフォルトのデータ型に変換します。データ型の変換については、Microsoft の ODBC ドキュメントに記載されているデータ型を参照してください。

以下のデータ型に関する詳しい情報は、『SQL Engine Reference』の Zen トランザクショナルおよびリレーショナル データ型を参照してください。

Zen で無限を表すには、次の表のように、4 バイト（C 言語の float 型）または 8 バイト（C 言語の double 型）の形式で、16 進数または文字として表現できます。

START TRANSACTION ステートメントはストアド プロシージャ外ではサポートされません。これは、ODBC 標準が、すべてのステートメントはデフォルトでトランザクション内にあることを条件としているためです。ODBC 標準にはトランザクションを開始する API がありません。『SQL Engine Reference』の START TRANSACTION を参照してください。

ODBC は、各 SQL ステートメントを SQL 独自のトランザクション内に置くか、それともアプリケーションが各トランザクションの終了時を指定するかどうかを決定するアプリケーションを提供します。ODBC は、トランザクション内にないどのステートメントより前に、自動的にトランザクションを開きます。したがって、指定された接続の最初のステートメント、あるいは COMMIT または ROLLBACK 後の最初のステートメントにより、ODBC は自動的に新しいトランザクションを開始します。

ODBC 標準内では、SQLSetConnectOption を使って、各ステートメントを独自のトランザクション内に置くか、またはアプリケーションが複数のステートメントを 1 つのトランザクションにまとめるかどうかを指定します。

SQLSetConnectOption にオプション SQL_AUTOCOMMIT、値 SQL_AUTOCOMMIT_ON（これがデフォルトです）を指定して呼び出すと、各ステートメントは独自のトランザクション内に置かれます。このように使用すると、トランザクションはステートメントの実行を開始するときに開始され、ステートメントの実行の完了時点でエラーが発生していない場合は自動的にコミットされ、エラーが発生した場合はロール バックされるようになります。

SQLSetConnectOption にオプション SQL_AUTOCOMMIT、値 SQL_AUTOCOMMIT_OFF を指定して呼び出すと、アプリケーションがステートメントを 1 つのトランザクションにまとめることができます。このように使用すると、トランザクションは実行される最初のステートメントを開始するときに開始されます。その後、トランザクションをいつ、どのように終了するかは、アプリケーションが SQLTransact を呼び出すか、'COMMIT WORK' または 'ROLLBACK WORK' ステートメントを実行するかによって決まります。アプリケーションが 1 つのトランザクションを終了すると、次のステートメントの実行時に別のトランザクションが自動的に開始されます。