DABroker for C++ - 目次

HITACHI Inspire The Next

DABroker for C⁺⁺

手引・文法書

3020-6-032-80

目　　次

変更内容

はじめに

1.　DABroker for C++の概要

1.1　DABroker for C++の役割・位置付け

1.1.1　DABroker for C++の役割・位置付け

1.1.2　アクセスできるDBMS

1.3　提供C++クラス

1.3.1　データベースアクセスクラス

1.3.2　エラー処理クラス

1.4　データベースアクセスの基礎知識

1.4.1　ResultSet

1.4.2　データベースへの接続と切断

1.4.3　同期・非同期処理

1.4.4　トランザクションと排他制御

1.4.5　繰り返し列

1.5　簡易版クラスのデータベースアクセス

1.5.1　提供クラスとオブジェクト

1.5.2　データベースとの接続と切断

1.5.3　レコードの検索

1.5.4　検索レコードの参照

1.5.5　レコードの更新

1.5.6　レコードの削除

1.5.7　レコードの追加

1.5.8　繰り返し列へのアクセス

1.5.9　テーブルの定義と削除

1.5.10　DBRResultSet仮想関数の利用

1.6　詳細版クラスのデータベースアクセス

1.6.1　提供クラスとオブジェクト

1.6.2　データベースとの接続と切断

1.6.3　レコードの検索

1.6.4　検索レコードの参照

1.6.5　レコードの更新

1.6.6　レコードの削除

1.6.7　レコードの追加

1.6.8　繰り返し列へのアクセス

1.6.9　テーブルの定義と削除

1.6.10　テーブル定義情報の参照

1.6.11　ストアドプロシジャの利用

2.　データベースアクセス

2.1　データベースへの接続と切断

2.1.1　データベースへの接続

2.1.2　データベースとの切断

2.2　同期・非同期処理

2.2.1　同期・非同期処理を選択するメソッド

2.2.2　非同期処理の完了確認

2.2.3　非同期処理実行中にエラーとなるメソッド

2.3　トランザクションと排他制御

2.3.1　一つのDBMSを対象にトランザクション制御を行う方法

2.3.2　複数のDBMSを対象にトランザクション制御を行う方法（TPBrokerのOTS機能を使用する場合）

2.3.3　複数のDBMSを対象にトランザクション制御を行う方法（OpenTP1を使用する場合）

2.3.4　排他制御

2.4　エラー処理

2.4.1　基本的なアプリケーションのエラー処理

2.5　簡易版クラスのデータベースアクセス

2.5.1　レコードの検索

2.5.2　検索レコードの参照

2.5.3　レコードの更新

2.5.4　レコードの削除

2.5.5　レコードの追加

2.5.6　DBRResultSet仮想関数の利用

2.6　詳細版クラスのデータベースアクセス

2.6.1　レコードの検索

2.6.2　検索レコードの参照

2.6.3　レコードの更新

2.6.4　レコードの削除

2.6.5　レコードの追加

2.6.6　ストアドプロシジャの利用

2.7　繰り返し列へのアクセス

2.7.1　検索条件としての要素の利用

2.7.2　繰り返し列の参照

2.7.3　ResultSetを利用した要素の更新

2.7.4　パラメタを利用した要素の一括更新

2.7.5　SQL文を利用した要素の更新

2.8　XDM/SDへのアクセス

2.8.1　XDM/SD接続機能とは

2.8.2　排他制御

2.8.3　データベースアクセス時の制限

2.8.4　注意事項

3.　アプリケーションの作成

3.1　ヘッダーファイル

3.2　ビルド方法

3.2.1　HP-UXの場合のビルド方法

3.2.2　AIXの場合のビルド方法

3.2.3　Red Hat Linuxの場合のビルド方法

3.2.4　Windowsの場合のビルド方法（Visual C++ 5.0，Visual C++ 6.0の場合）

3.2.5　Windowsの場合のビルド方法（Visual C++ .NET 2003，Visual Studioの場合）

3.3　アプリケーション作成上の留意点

3.3.1　オブジェクトの生成と削除

3.3.2　データベースアクセスリソース数の制限

3.3.3　検索性能の向上策

3.3.4　BLOB型データの取得方法についての制限

3.3.5　検索中のCommit,Rollbackについて

3.3.6　signal使用時の注意

3.3.7　Visual C++ 6.0以降使用時の注意

3.3.8　暗黙のsetlocale関数の実行

3.3.9　?パラメタに文字列を指定する場合の注意

3.3.10　データベースへの接続処理の複数スレッド同時実行

4.　簡易版関数詳細

4.1　文法の説明順序

メソッド名

4.2　簡易版クラスの概要

4.3　DBRDatabaseクラスの詳細

DBRDatabaseコンストラクタ

Closeメソッド

Commitメソッド

Connectメソッド

ExecuteDirectメソッド

GetArrayDataFactoryメソッド

GetErrorStatusメソッド

InWaitForDataSourceメソッド

IsClosedメソッド

Rollbackメソッド

WaitForDataSourceメソッド

4.4　DBRResultSetクラスの詳細

DBRResultSetコンストラクタ

Absoluteメソッド

Bottomメソッド

Closeメソッド

Deleteメソッド

Editメソッド

Executeメソッド

GetArraySizeメソッド

GetCurrentメソッド

GetCurrentOfResultSetメソッド

GetErrorStatusメソッド

GetFieldメソッド

GetFieldCountメソッド

GetFieldCTypeメソッド

GetFieldDBTypeメソッド

GetFieldNameメソッド

GetFieldPrecisionメソッド

GetFieldScaleメソッド

GetFieldTypeメソッド

GetMaxRowsメソッド

GetParamメソッド

GetParamCountメソッド

GetRowCountメソッド

InExecuteメソッド

IsEOFメソッド

IsFieldNullメソッド

IsParamNullメソッド

Nextメソッド

OnBeforeRefreshメソッド

OnEndRecordメソッド

OnMoveRecordメソッド

Openメソッド

PageNextメソッド

Previousメソッド

Refreshメソッド

Relativeメソッド

SetFieldメソッド

SetFieldNullメソッド

SetMaxRowsメソッド

SetParamメソッド

SetParamNullメソッド

SetParamTypeメソッド

Topメソッド

Updateメソッド

WaitForDataSourceメソッド

5.　詳細版関数詳細

5.1　文法の説明順序

プロパティ名，又はメソッド名

5.2　詳細版で利用できるクラスの概要

5.3　DBDriverManagerクラスの詳細

Driverメソッド

InitializeMessageメソッド

RemoveDriverメソッド

RemoveTransactionメソッド

Transactionメソッド

5.4　DBDriverクラスの詳細

Connectメソッド

GetDriverTypeメソッド

GetErrorStatusメソッド

Parentメソッド

Removeメソッド

RemoveConnectionメソッド

5.5　DBConnectionクラスの詳細

Closeメソッド

Connectメソッド

CreateCallableStatementメソッド

CreatePreparedStatementメソッド

CreateStatementメソッド

EraseTransactionメソッド

ExecuteDirectメソッド

GetArrayDataFactoryメソッド

GetErrorStatusメソッド

GetMetaDataメソッド

GetNameメソッド

InWaitForDataSourceメソッド

IsClosedメソッド

Parentメソッド

RegisterTransactionsメソッド

Removeメソッド

RemoveCallableStatementメソッド

RemovePreparedStatementメソッド

RemoveStatementメソッド

Transactionメソッド

WaitForDataSourceメソッド

5.6　DBStatementクラスの詳細

Executeメソッド

GetErrorStatusメソッド

GetFieldCountメソッド

GetMaxFieldSizeメソッド

GetMaxRowsメソッド

GetNameメソッド

GetResultSetメソッド

GetResultSetMetaDataメソッド

GetUpdateRowsメソッド

InExecuteメソッド

Parentメソッド

Removeメソッド

RemoveResultSetメソッド

SetMaxFieldSizeメソッド

SetMaxRowsメソッド

SetResultSetTypeメソッド

WaitForDataSourceメソッド

5.7　DBResultSetクラスの詳細

Absoluteメソッド

Bottomメソッド

Deleteメソッド

Editメソッド

FindColumnメソッド

GetCurrentメソッド

GetCurrentOfResultSetメソッド

GetErrorStatusメソッド

GetFieldメソッド

GetMetaDataメソッド

GetRowCountメソッド

InExecuteメソッド

IsEOFメソッド

IsNullメソッド

Nextメソッド

PageNextメソッド

Parentメソッド

Previousメソッド

Refreshメソッド

Relativeメソッド

Removeメソッド

SetFieldメソッド

SetNullメソッド

Topメソッド

Updateメソッド

WaitForDataSourceメソッド

5.8　DBResultSetMetaDataクラスの詳細

GetArraySizeメソッド

GetColumnCountメソッド

GetColumnCTypeメソッド

GetColumnDBTypeメソッド

GetColumnNameメソッド

GetColumnPrecisionメソッド

GetColumnScaleメソッド

GetColumnTypeメソッド

Parentメソッド

5.9　DBPreparedStatementクラスの詳細

Executeメソッド

ExecuteUpdateメソッド

GetErrorStatusメソッド

GetFieldCountメソッド

GetMaxFieldSizeメソッド

GetMaxRowsメソッド

GetNameメソッド

GetParamメソッド

GetParamCountメソッド

GetResultSetメソッド

GetResultSetMetaDataメソッド

GetUpdateRowsメソッド

InExecuteメソッド

IsNullメソッド

Parentメソッド

Removeメソッド

RemoveResultSetメソッド

SetInsertRowsメソッド

SetMaxFieldSizeメソッド

SetMaxRowsメソッド

SetNullメソッド

SetParamメソッド

SetParamTypeメソッド

SetResultSetTypeメソッド

WaitForDataSourceメソッド

5.10　DBCallableStatementクラスの詳細

Executeメソッド

GetErrorStatusメソッド

GetMaxFieldSizeメソッド

GetMaxRowsメソッド

GetNameメソッド

GetOutputParamsメソッド

GetParamメソッド

GetParamCountメソッド

GetResultSetメソッド

InExecuteメソッド

IsCompletedメソッド

IsNullメソッド

Parentメソッド

Removeメソッド

RemoveResultSetメソッド

Resumeメソッド

SetMaxFieldSizeメソッド

SetMaxRowsメソッド

SetNullメソッド

SetParamメソッド

SetProcedureメソッド

SetResultSetTypeメソッド

WaitForDataSourceメソッド

5.11　DBDatabaseMetaDataクラスの詳細

GetColumnsメソッド

GetErrorStatusメソッド

GetPrimaryKeysメソッド

GetProceduresメソッド

GetProcedureColumnsメソッド

GetTablesメソッド

InExecuteメソッド

Parentメソッド

5.12　DBTransactionクラスの詳細

BeginTransメソッド

Commitメソッド

GetNameメソッド

InTransactメソッド

Parentメソッド

Removeメソッド

Rollbackメソッド

SetAutoCommitメソッド

5.13　classListTablesクラスの詳細

Countプロパティ

OwnerNameメソッド

Qualifierメソッド

Remarksメソッド

TableNameメソッド

Typeメソッド

5.14　classListColumnsクラスの詳細

Countプロパティ

ArraySizeメソッド

ColumnNameメソッド

CTypeメソッド

DBTypeメソッド

Nullableメソッド

Precisionメソッド

Remarksメソッド

Scaleメソッド

Typeメソッド

Uniquenessメソッド

5.15　classListProceduresクラスの詳細

Countプロパティ

Defineメソッド

OwnerNameメソッド

ProcedureNameメソッド

Qualifierメソッド

Remarksメソッド

5.16　classListProcedureColumnsクラスの詳細

Countプロパティ

ColumnNameメソッド

ColumnTypeメソッド

CTypeメソッド

DBTypeメソッド

Nullableメソッド

Precisionメソッド

Remarksメソッド

Scaleメソッド

Typeメソッド

5.17　classListPrimaryKeysクラスの詳細

Countプロパティ

ColumnNameメソッド

KeyNameメソッド

OwnerNameメソッド

Sequenceメソッド

TableNameメソッド

6.　共通関数詳細

6.1　DBSQLCAクラスの詳細

Countプロパティ

ErrorMessageプロパティ

e_SQLCODEプロパティ

e_SQLCOUNTプロパティ

e_SQLERRORプロパティ

e_SQLSTATEプロパティ

e_USERCODEプロパティ

e_USERERRORプロパティ

RetCodeプロパティ

Deleteメソッド

GetErrorMessageメソッド

GetRetCodeメソッド

GetSQLCODEメソッド

GetSQLCOUNTメソッド

GetSQLERRORメソッド

GetSQLSTATEメソッド

GetUSERCODEメソッド

GetUSERERRORメソッド

6.2　DBRArrayDataFactoryクラス

CreateArrayDataメソッド

6.3　DBRArrayDataクラス

Createメソッド

GetArrayCountメソッド

GetDataメソッド

GetDataTypeメソッド

GetPrecisionメソッド

GetScaleメソッド

SetDataメソッド

SetNullメソッド

6.4　DBRArrayDataPtrクラス

DBRArrayDataPtrコンストラクタ

~DBRArrayDataPtrデストラクタ

IsNullメソッド

6.5　DBRArrayDataConstPtrクラス

DBRArrayDataConstPtrコンストラクタ

~DBRArrayDataConstPtrデストラクタ

IsNullメソッド

7.　データ型

7.1　クラスライブラリで扱うデータ型と変換規則

7.1.1　クラスライブラリで使用するデータ型とC++のデータ型との関係

7.1.2　データ型のサイズと範囲

7.1.3　戻り値とDBMSでのデータ型の対応

7.1.4　C++とDBMSのデータ型の対応

7.1.5　データ型変換規則

7.1.6　DBMSのデータ型と識別子との対応

7.2　DBR_BINARY型を使用したVARCHARデータの取得方法

7.2.1　DBR_BINARY型の構造体とメンバに設定される値

8.　トラブルシューティング

8.1.1　トラブルシューティングについて

8.1.2　トレースログ採取のための設定

8.1.3　トレースファイルの見方

8.2　C++クラスライブラリのエラー情報

8.2.1　C++クラスライブラリで発生するエラー情報

8.2.2　DB_ERROR_DAB_ILLEGAL_VALUEでの詳細コード

付録A　セットアップ

付録A.1　DABroker for C++の組み込み(UNIXの場合)

付録A.2　DABroker for C++の組み込み(Windowsの場合)

付録B　用語解説

All Rights Reserved. Copyright (C) 1998, 2015, Hitachi, Ltd.