レコードセット: データ列を動的に結びつける方法 (ODBC)

[アーティクル]
04/03/2023

このトピックの内容は、MFC ODBC クラスに該当します。

設計時に指定したテーブル列のバインドはレコードセットによって管理されますが、設計時に不明であった列を自分でバインドしたい場合があります。このトピックでは、次の内容について説明します。

どのようなときにレコードセットに列を動的にバインドするか。
実行時に列を動的にバインドする方法。

Note

このトピックの内容は、バルク行フェッチが実装されていない CRecordset の派生オブジェクトを対象にしています。バルク行フェッチを使っている場合、説明する手法は一般に推奨されません。バルク行フェッチの詳細については、「レコードセット: バルク行フェッチ (ODBC)」を参照してください。

列を動的にバインドする場合

Note

MFC ODBC コンシューマーウィザードは、Visual Studio 2019 以降では利用できません。引き続き、コンシューマーを手動で作成することはできます。

設計時には、MFC アプリケーションウィザードまたは MFC ODBC コンシューマーウィザード ([クラスの追加] から) により、データソースでわかっているテーブルと列に基づいて、レコードセットクラスが作成されます。データベースは、設計した時点から、後で実行時にアプリケーションでそれらのテーブルや列が使われるまでの間に、変更されている場合があります。自分や他のユーザーが、アプリケーションのレコードセットが依存しているテーブルやテーブルの列を、追加または削除する可能性があります。これはおそらくすべてのデータアクセスアプリケーションに対する問題ではないでしょうが、もし自分がその立場になったら、再設計や再コンパイル以外でデータベーススキーマの変更に対応するには、どうすればよいでしょうか。このトピックの目的は、その質問に答えることです。

このトピックでは、動的に列をバインドする可能性がある最も一般的なケースについて説明します。つまり、既知のデータベーススキーマに基づいてレコードセットを開始した後、実行時に追加の列を処理する必要がある場合です。さらに、追加の列は最も一般的な CString フィールドデータメンバーにマップしているものとしますが、他のデータ型の管理に役立つ推奨事項を提供します。

コードを少し追加することで、次のことができます。

実行時に、使用可能な列を特定します。
実行時に、追加の列をレコードセットに動的にバインドします。

レコードセットには、設計時にわかっていた列のデータメンバーも含まれています。また、ターゲットテーブルに新しい列が追加されているかどうかを動的に判別し、そうである場合はこれらの新しい列を (レコードセットのデータメンバーではなく) 動的に割り当てられた記憶域にバインドする、少量の追加コードも含まれます。

このトピックでは、削除されたテーブルや列など、他の動的なバインドの場合については説明しません。それらのケースについては、さらに直接的に ODBC API の呼び出しを使う必要があります。詳細については、「ODBC プログラマーズリファレンス」を参照してください。

列を動的にバインドする方法

列を動的にバインドするには、追加する列の名前がわかっている (または特定できる) 必要があります。また、追加するフィールドデータメンバー用の記憶域を割り当て、それらの名前と型を指定し、追加する列の数を指定する必要もあります。

次の説明では、2 つの異なるレコードセットを取り上げます。 1 つ目は、ターゲットテーブルからレコードを選択するメインレコードセットです。 2 つ目は、ターゲットテーブル内の列に関する情報を取得するために使われる特殊な列レコードセットです。

一般的なプロセス

最も一般的なレベルでは、次のような手順で行います。

メインレコードセットオブジェクトを構築します。

必要に応じて、開いている CDatabase オブジェクトへのポインターを渡すか、または何らかの方法で列レコードセットへの接続情報を提供できます。
列を動的に追加する手順を実行します。

後の「列の追加」で説明されているプロセスを参照してください。
メインレコードセットを開きます。

レコードセットでレコードが選択され、レコードフィールドエクスチェンジ (RFX) を使って静的な列 (レコードセットのフィールドデータメンバーにマップされるもの) と動的な列 (ユーザーが割り当てた追加記憶域にマップされるもの) の両方がバインドされます。

列の追加

追加された列を実行時に動的にバインドするには、次の手順が必要です。

実行時に、ターゲットテーブルにある列を特定します。その情報から、レコードセットクラスが設計された後でテーブルに追加された列の一覧を抽出します。

データソースでターゲットテーブルの列の情報 (列の名前やデータ型など) に関するクエリを行うように設計されている列レコードセットクラスを使うのがよい方法です。
新しいフィールドデータメンバー用の記憶域を提供します。メインレコードセットクラスには不明な列に対するフィールドデータメンバーがないため、名前、結果の値、および必要に応じてデータ型の情報 (列が異なるデータ型の場合) を格納する場所を提供する必要があります。

1 つの方法は、動的なリストを 1 つ以上作成することです。1 つ目のリストは新しい列の名前用、2 つ目は結果の値用、3 つ目はデータ型用 (必要な場合) です。これらのリスト (特に値リスト) で、バインドのための情報と必要な記憶域を提供します。次の図はリストの作成を示したものです。

動的に結び付ける列のリストを生成する方法
メインレコードセットの DoFieldExchange 関数で、追加する列ごとに RFX 関数の呼び出しを追加します。これらの RFX の呼び出しでは、レコードをフェッチし、追加の列を組み込み、レコードセットのデータメンバーまたは追加列用に動的に提供した記憶域に、列をバインドします。

1 つの方法としては、メインレコードセットの DoFieldExchange 関数にループを追加し、その中で、新しい列のリストをループ処理して、リスト内の各列に対して適切な RFX 関数を呼び出します。各 RFX の呼び出しでは、列名リストからの列名と、結果値リストの対応するメンバーの記憶域の場所を渡します。

列の一覧

処理する必要がある 4 つのリストを次の表に示します。

リスト	説明
Current-Table-Columns	(図のリスト 1) データソースのテーブルに現在存在する列のリスト。このリストは、レコードセットで現在バインドされている列のリストと一致する場合があります。
Bound-Recordset-Columns	(図のリスト 2) レコードセットでバインドされている列のリスト。 `DoFieldExchange` 関数にはこれらの列の RFX ステートメントが既にあります。
Columns-To-Bind-Dynamically	(図のリスト 3) テーブルにはあるがレコードセットにはない列のリスト。これらは動的にバインドする列です。
Dynamic-Column-Values	(図のリスト 4) 動的にバインドする列から取得された値のための記憶域が含まれるリスト。このリストの要素は、Columns-to-Bind-Dynamically の要素と一対一に対応します。

リストの作成

一般的な戦略を念頭に置いて、詳細に取りかかることができます。このトピックの残りの部分では、「列のリスト」で示したリストを作成する方法を示します。以下の手順について説明します。

レコードセットにない列の名前を特定します。
テーブルに新しく追加する列用の動的な記憶域を提供します。
新しい列の RFX 呼び出しを動的に追加します。

レコードセットに含まれていないテーブル列の決定

メインレコードセットで既にバインドされている列の一覧を含むリスト (Bound-Recordset-Columns、図のリスト 2) を作成します。次に、データソースのテーブルにはあるがメインレコードセットにはない列名を含むリスト (Columns-to-Bind-Dynamically、Current-Table-Columns と Bound-Recordset-Columns から派生) を作成します。

レコードセットにない列の名前を特定するには (Columns-to-Bind-Dynamically)

メインレコードセットで既にバインドされている列のリスト (Bound-Recordset-Columns) を作成します。

1 つの方法としては、設計時に Bound-Recordset-Columns を作成します。レコードセットの DoFieldExchange 関数内で RFX 関数の呼び出しを目で見て調べて、これらの名前を取得できます。次に、その名前で初期化された配列としてリストを設定します。

たとえば、図で示されている Bound-Recordset-Columns (リスト 2) には 3 つの要素があります。 Bound-Recordset-Columns には、Current-Table-Columns (リスト 1) で示されている Phone 列がありません。
Current-Table-Columns と Bound-Recordset-Columns を比較して、メインレコードセットでまだバインドされていない列のリスト (Columns-to-Bind-Dynamically) を作成します。

1 つの方法は、実行時のテーブルの列のリスト (Current-Table-Columns) とレコードセットで既にバインドされている列のリスト (Bound-Recordset-Columns) を、並列にループ処理することです。 Current-Table-Columns に含まれる列のうち、Bound-Recordset-Columns に含まれないものの名前を、Columns-to-Bind-Dynamically に設定します。

たとえば、図の Columns-to-Bind-Dynamically (リスト 3) に含まれる 1 つの要素 Phone 列は、Current-Table-Columns (リスト 1) では見つかりますが、Bound-Recordset-Columns (リスト 2) では見つかりません。
動的にバインドする列のリスト (Columns-to-Bind-Dynamically) に格納されている各列名に対応するデータ値を格納するために、Dynamic-Column-Values のリスト (図のリスト 4) を作成します。

このリストの要素は、新しいレコードセットフィールドデータメンバーの役割を果たします。それらは、動的な列がバインドされる記憶域の場所です。リストの説明については、「列のリスト」をご覧ください。

新しい列のストレージの提供

次に、動的にバインドする列に対する記憶域の場所を設定します。考え方としては、各列の値を格納するリスト要素を提供します。これらの記憶域の場所は、通常にバインドされた列が格納されるレコードセットメンバー変数と並列になっています。

新しい列の動的な記憶域を提供するには (Dynamic-Column-Values)

各列のデータの値を格納する Dynamic-Column-Values (Columns-to-Bind-Dynamically と並列) を作成します。

たとえば、図で示されている Dynamic-Column-Values (リスト 4) の 1 つの要素である CString オブジェクトには、現在のレコードの実際の電話番号が格納されます: "555-1212"。

最も一般的なケースでは、Dynamic-Column-Values には CString 型の要素が含まれます。さまざまなデータ型の列を扱っている場合は、さまざまな型の要素を含むことのできるリストが必要です。

上記の手順の結果は、2 つの主なリストです。つまり、列の名前が含まれる Columns-to-Bind-Dynamically と、現在のレコードに対する列の値が含まれる Dynamic-Column-Values です。

ヒント

新しい列がすべて同じデータ型ではない場合は、列リストの各対応要素の型を何らかの方法で定義している項目が含まれる追加の並列リストが必要な場合があります。 (必要に応じて、AFX_RFX_BOOL、AFX_RFX_BYTEなどの値を使用できます。これらの定数は AFXDB.H で定義されています。)列データ型の表現方法に基づいて、リストの種類を選択します。

RFX 呼び出しを追加して列をバインドする

最後に、DoFieldExchange 関数内に新しい列の RFX 呼び出しを配置することによって、動的なバインドが行われるようにします。

新しい列の RFX 呼び出しを動的に追加するには

メインレコードセットの DoFieldExchange メンバー関数で、新しい列のリスト (Columns-to-Bind-Dynamically) をループ処理するコードを追加します。各ループでは、Columns-to-Bind-Dynamically から列の名前を、Dynamic-Column-Values から列の結果の値を抽出します。これらの項目を、列のデータ型に適した RFX 関数の呼び出しに渡します。リストの説明については、「列のリスト」をご覧ください。

一般的なケースでは、RFX_Text 関数の呼び出しの中で、次のコード行のように、リストから CString オブジェクトを抽出します。ここで、Columns-to-Bind-Dynamically は m_listName という名前の CStringList であり、Dynamic-Column-Values は CStringList という名前の m_listValue です。

RFX_Text( pFX,
            m_listName.GetNext( posName ),
            m_listValue.GetNext( posValue ));

RFX 関数の詳細については、"クラスライブラリリファレンス" の「Macros and Globals」 (マクロとグローバル) を参照してください。

ヒント

新しい列が異なるデータ型の場合は、ループで switch ステートメントを使って、各型の適切な RFX 関数を呼び出します。

フレームワークで Open プロセスの間に DoFieldExchange を呼び出して列をレコードセットにバインドすると、静的列に対する RFX の呼び出しによってそれらの列がバインドされます。その後、ループで動的な列の RFX 関数を繰り返し呼び出します。

次の方法で共有