LCConnection の Select メソッド

このメソッドは､現在の METADATA プロパティおよびその他のプロパティから結果セットを作成します。

定義位置

LCConnection

構文

count = lcConnection.Select (keyFieldlist, recordIndex, destFieldlist)

パラメータ

パラメータ	説明
keyFieldlist	LCFieldlist。選択キー。KeyFieldlist 内のフィールドのうち､LCFIELDF_KEY フラグが設定されているフィールドが選択キーとして使用されます。キーフィールドの値が一致するレコードのみがコネクション先から選択されます。不等式キーを使用するには､LCFIELDF_KEY_XXX (GT -- より大、LT -- より小、NE -- 等しくない) フラグを追加します。結果セットを制限するのに、キーフィールドをいくつでも指定できます。キーを指定しない場合､または「Nothing」を指定した場合､すべてのレコードが結果セットに選択されます。
recordIndex	Long、1 以上。キーフィールド値を含むレコードを選択する､キーフィールドリスト内の、インデックスで指定されたレコード位置。
destFieldlist	LCFieldlist。選択された結果セットのメタデータを格納するフィールドリスト。結果セット内のフィールドがこのフィールドリストに追加されます。結果セットのメタデータが必要ない場合は「Nothing」を使用します。

戻り値

値	説明
count	Long。結果セットのレコード数。 Connector によってレコード数の判断がつかない場合は、定数 LCCOUNT_UNKNOWN が返されます。

使用法

LCConnection の Select メソッドを使用するときには、次のことを考慮してください。

Select を呼び出すことによって destFieldlist にフィールドが追加されます。その場合、destFieldlist に既にあるフィールドは、名前がメタデータ内のフィールド名と重複していても、削除されたり再割り当てされたりしません。このため、一般には destFieldlist にフィールドが含まれていない状態で Select 呼び出しを発行する必要があります。
複数の Select 呼び出しで再使用できるように destFieldlist 内の既存のフィールドをすべて削除するには、古いフィールドリストを破棄し、次の方法で新しいフィールドリストを作成します。

Set destFieldlist = New LCFieldList(args)

取得するレコード内のフィールドを別のフィールドリスト内のフィールドにマッピングする必要があるなどの理由で、この方法が適切でない場合は、別の方法もあります。メタデータに含まれているフィールドが分かっている場合は、Select ステートメントで返されたフィールドリストへとデータを取り出す代わりに、destFieldlist 引数に Nothing キーワードを指定し、事前に手動で作成したフィールドリストを使用してデータを取り込むとよいでしょう。
キーフィールドリストを指定するとフィールドリスト内の選択条件は「AND」で連結され、すべての条件に一致するレコードのみが選択されます。キーリスト内の LCFIELDF_KEY フラグが設定されているフィールドのみが、選択基準として使用されます。
コネクションの CONDITION プロパティを設定すると、設定した検索条件がキーリストの条件に「AND」で追加され､返されるレコードがさらに制限されます。
LCConnection では、複数の条件を論理演算子「OR」で連結する方法は直接サポートされません。ただし、バックエンドシステムの照会言語を使用して独自に照会を作成できます。LCConnection.Execute を使用して独自の照会を実行するか､または Select メソッドで LCConnection.Condition プロパティを使用します。サポートされる構文については、各 Connector のドキュメントを参照してください。
Select を実行する前に WRITEBACK プロパティを設定し､結果セットに対してライトバックオペレーションを実行可能とするかどうかを指定します。この設定によって結果セットに返されるレコードの内容が変わることはありません。生成される結果セットへのオペレーションを続ける上で､ライトバックによる Update または Remove を実行できるかどうかが決まります。
GT、LT および NE といった不等式キーフラグを使用する場合は､フラグを指定しない場合のデフォルトは等式となる点に注意してください。不等式フラグでは､次の組み合わせが有効です。
- 等しい LCFIELDF_KEY
- 以上 LCFIELDF_KEY + LCFIELDF_KEY_GT
- 以下 LCFIELDF_KEY + LCFIELDF_KEY_LT
- 等しくない LCFIELDF_KEY + LCFIELDF_KEY_NE
- より大きい LCFIELDF_KEY + LCFIELDF_KEY_GT + LCFIELDF_KEY_NE
- より小さい LCFIELDF_KEY + LCFIELDF_KEY_LT + LCFIELDF_KEY_NE
- 文字列パターンのマッチング LCFIELDF_KEY + LCFIELDF_KEY_LIKE
「LIKE」比較演算子でのパターンマッチングのルールは、Connector によって異なります。詳しくは、使用しているデータベースのドキュメントを参照してください。

例

Option Public
Uselsx "*lsxlc"

Sub Initialize
  Dim src As New LCConnection ("db2") 
  Dim fldLst As New LCFieldList
  Dim count As Integer

  ' set the appropriate properties to connect to the data sources
  src.Database = "Gold"
  src.Userid = "JDoe"
  src.Password = "xyzzy"
  src.Metadata = "customer"

  ' connect to the two data sources
  src.Connect

  ' now connected, we can execute a selection statement
  count = src.Select (Nothing, 1, fldLst)
  Select Case count
  Case LCCOUNT_UNKNOWN
  Print "An overview number of records were located."
  Case 0
    Print "No data were located."
  Case Else
    Print "The table contains " & Cstr(count) & " records."
  End Select
End Sub

出力例

An overview number of records were located.

LCConnection for DB2 の Select メソッド

このメソッドは、DB2® 内の定義された METADATA オブジェクトから結果セットを作成します。

Select メソッドでは、以下のプロパティを使用して結果セットの内容とプロパティを制限します。

プロパティ	説明
METADATA	ターゲットレコードが含まれるコネクション先のメタデータを指定します。
WRITEBACK	サポートされる場合､ライトバックの結果セットを作成するかどうかを指定します。TRUE の場合､生成される結果セットでは LCXUpdate および LCXRemove のライトバックバージョンがサポートされます。ライトバックの結果セットを使用すると､一般的にソースのメタデータはロックされます。
FIELDNAMES	結果セットに含めるフィールドのリストを指定します。このテキストリストに指定したフィールドのみが､指定した順番で結果セットに追加されます。フィールドリスト内のフィールドは、このリストと同じ順番となります。実際のレコード値を並べ替えるには ORDERNAMES を使用します。何も指定しないと、すべてのメタデータフィールドが追加されます。複数のフィールドはテキストリストで指定するか､またはカンマかセミコロンで値を区切ったテキスト形式で指定します。
ORDERNAMES	フィールドのテキストリストを指定します。最初から最後まで、昇順に結果セットのデータが並べ替えられます。何も指定しないと結果セットは並べ替えられません。複数のフィールドはテキストリストで指定するか､またはカンマかセミコロンで値を区切ったテキスト形式で指定します。
CONDITION	作成される内部ステートメントに組み込む条件文節を指定します。各 Connector で定義されている構文で指定します。
STAMPFIELD	タイムスタンプ (範囲指定) として使用するフィールド名を指定します。この値を設定すると､BASESTAMP に指定された日時の最小値が Connector によってチェックされます。また、Connector ではデータプロバイダから現在の時間が取得され、その値が MAXSTAMP プロパティに設定されて、時間の上限値として使用されます。
BASESTAMP	STAMPFIELD を設定した場合､選択の対象とする基準日時を指定します。STAMPFILD の値が BASESTAMP の値より大きいレコードだけが選択されます。STAMPFIELD を設定していない場合は、このプロパティは無視してください。
MAXSTAMP	STAMPFIELD を設定した場合､データソースから現在の日時が取得され、このプロパティに設定されます。STAMPFILD の値がこの値以下のレコードだけが選択されます。STAMPFIELD を設定していない場合は、このプロパティは無視してください。
SCROLLABLE	サポートされる場合､生成される結果セットで順方向のスクロールだけでなく、逆方向のスクロールもサポートするかどうかを指定します。
RECORD_LIMIT	サポートされる場合､生成される結果セットのレコード数がこの値以下に制限されます。0 (デフォルト) を指定するとレコード数は制限されません。

キーフラグのルール

キーフィールドリスト内のキーは､条件となるキー値を表します。デフォルトの条件は等式ですが､フィールドフラグを使用すると他の条件を指定できます。

不等式のキーフラグである GT、LT および NE をチェックする場合､フラグのないデフォルトの状態は等式です。

不等式フラグでは､次の組み合わせが有効です。

等しい LCFIELDF_KEY
以上 LCFIELDF_KEY + LCFIELDF_KEY_GT
以下 LCFIELDF_KEY + LCFIELDF_KEY_LT
等しくない LCFIELDF_KEY + LCFIELDF_KEY_NE
より大きい LCFIELDF_KEY + LCFIELDF_KEY_GT + LCFIELDF_KEY_NE
より小さい LCFIELDF_KEY + LCFIELDF_KEY_LT + LCFIELDF_KEY_NE

また、LCFIELDF_KEY_LIKE フラグを LCFIELDF_KEY と組み合わせると、LIKE 比較演算を実行できます。LIKE 比較演算のサポートの有無およびその動作は､使用している Connector によって異なります。

注: LIKE キーフラグは､他の不等式キーフラグとは一緒に使用できません。