QUERY

version 11 (Modified)

QUERY ({aTable}{; queryArgument{; *}})

QUERY は、aTableに対してqueryArgumentに指定した条件に一致するレコードを検索し、検索結果をセレクションとして返します。QUERYは、カレントプロセスのaTableのカレントセレクションを変更し、セレクションの先頭のレコ−ドをカレントレコ−ドにします。

aTable引数を省略した場合、コマンドはデフォルトテーブルに対して適用されます。デフォルトテーブルが設定されていない場合には、エラーが発生します。

queryArgumentまたは * を指定しない場合、QUERYはaTable 用のクエリエディタを表示します (複数クエリの最後の行である場合を除く、例題 2参照):

クエリエディタについての詳細は4D Design Referenceマニュアルを参照してください。

ユーザはクエリを作成し、クエリボタンをクリックするか、絞り込みクエリボタンをクリックして検索を実行します。検索が中断されずに実行された場合、システム変数OKには1が代入されます。ユーザが「キャンセル」をクリックするか、QUERYコマンドが中断されて実際には検索が行われなかった場合には、システム変数OKに0が代入されます。

1. 以下の例は、[Products]テーブルに対するクエリエディタを表示します:

   QUERY([Products])

2. 以下の例は、デフォルトテーブル (設定されている場合) に対するクエリエディタを表示します:

   QUERY

queryArgument引数を指定すると、標準のクエリエディタは表示されず、クエリはプログラムから定義されます。単一クエリの場合 (1つのフィールドだけを検索)、queryArgumentをもとにQUERYコマンドを1回コールします。複合検索の場合 (複数フィールドに対する検索、または複合条件による検索)、queryArgumentを用いて必要な回数だけQUERYコマンドをコールします。そして、最後のQUERYコマンドのコール以外のQUERYコマンドに対してオプション引数 * を指定します。* を含まない最後のコールの後、実際の検索処理が実行されます。引数queryArgumentについては、この節で更に詳しく説明します。

3. 以下の例は、[People]テーブルの名前が“a”で始まる人のレコードを検索します:

   QUERY([People];[People]Last name="a@")

4. 以下の例は、[People]テーブルの名字フィールドが“a”または“b”で始まる人のレコードを検索します:

   QUERY([People];[People]Name="a@";*) ` *は追加の検索条件があることを示します
   QUERY([People]; |;[People]Name="b@") ` 最後のクエリには*を置きません

Note: @ 文字の解釈は環境設定で変更できます。詳細は比較演算子の節を参照してください。

queryArgument 引数には以下のシンタックスを指定できます:

・論理演算子はQUERY呼び出しを結合するために使用します。使用できる論理演算子はクエリエディタで使用できるものと同じです:

論理演算子はオプションで、複合検索の最初のQUERYコマンドおよびQUERYコマンドが1つしかない場合には使用されません。複合検索クエリで論理演算子を省略した場合、デフォルトでAND (&) が使用されます。

・fieldは検索対象となるフィールドです。aTableが1テーブルへの自動リレートまたはマニュアルリレートを持つ場合、fieldはリレート先の1テーブルのフィールドも使用可能です。

・比較演算子はフィールドと値とを比較するために使用します。比較演算子を次に示します:

Note: 比較演算子を記号ではなく文字式でも指定できます。この場合、クエリ文字列の項目を区切るためにセミコロンを使用しなければなりません。この方法を使用すれば、例えばカスタムクエリのユーザインタフェースを作成することができます。例題 20を参照してください。

・値はフィールドと比較するためのデータです。値は、評価結果がフィールドと同じデータタイプである式です。値は検索の初めに一度だけ評価されます。各レコードに対して評価されるわけではありません。文字列中に特定の文字列を含んでいるかどうかを検索する場合 (包含検索) には、値にワイルドカード記号 (@) を使用して、"@Smith@"のように検索する文字列を分離させることができます。この場合の検索は、コンパクトなデータストレージであるインデックスの利点を部分的にしか利用できない点に注意してください。

キーワードによる検索は文字やテキスト型のフィールドに対してのみ可能です。このタイプのクエリに関する詳細は、比較演算子の節を参照してください。

複合条件検索を実行するための規則を次に示します:

・最初のQUERYは論理演算子を含んではいけません。

・最初以外のQUERYは論理演算子から始めることができます。論理演算子を省略した場合、デフォルトでAND (&) が使用されます。

・最後のQUERY以外は引数 * を指定しなければいけません。

・複合検索を実行するためには、最後のQUERYで引数 * を指定してはいけません。代りに最後のQUERYで、テーブル以外に引数のないQUERYコマンドを実行することができます (クエリエディタは表示されず、前の行までに定義した複合検索が実行されます)。

Note: 作成したカレントクエリは各テーブル毎に管理されます。つまり各テーブルに1つの複合検索を同時に作成できます。aTable引数を指定するかDEFAULT TABLEコマンドを使用して、検索対象テーブルを明確に特定する必要があります。

検索の定義方法に関係なく、以下の処理が行われます:

・実際の検索処理に時間がかかる場合、4Dは自動的にサーモメータで進捗状況のメッセージを表示します。MESSAGES ONコマンドとMESSAGES OFFコマンドを使用して、メッセージを表示または非表示にすることができます。進捗サーモメータが表示された場合、ユーザは中止ボタンをクリックして検索を中断することができます。検索が正常に終了すると、システム変数OKには1がセットされ、それ以外の場合には0がセットされます。

・インデックスフィールドが指定された場合、検索処理は毎回最適化され (最初にインデックスフィールドが検索される)、検索は最小の時間で終了します。コマンドはかつ (&) を使用するクエリでは、複合インデックスを使用できます。

5. 以下の例は、Smithという名の人のレコードをすべて検索します:

   QUERY([People];[People]Last Name="Smith")

Note: Last Nameのフィールドにインデックスが設定されている場合、QUERYコマンドは高速な検索のために、自動的にインデックスを使用します。

Reminder: この検索では、“Smith”、“smith”、“SMITH”等のレコードを検索します。大文字と小文字を区別するには、文字コードを使用した検索を行ってください。

6. 以下の例はJohn Smithという名前の人のレコードをすべて検索します。Last Nameのフィールドにはインデックスが設定されていますが、First Nameのフィールドにはインデックスが設定されていません。

   QUERY ([People]; [People]Last Name = "smith"; *)   ` Find every person named Smith
   QUERY ([People]; &; [People]First Name = "john")   ` with John as first name

検索を実行すると、まず最初にインデックスを持ったLast Nameのフィールドを検索し、Smithという名前の人のレコードのみに検索対象を絞ります。次に、このレコードセレクションの中からFirst Nameのフィールドに対してシーケンシャルな検索を行います。

Note: このクエリはデータベースに

[People]Last Name+[People]First Name

7. 以下の例はSmithまたはJonesという名字の人のレコードをすべて検索します。名字 (Last Name) のフィールドにはインデックスが設定されています。

   QUERY ([People]; [People]Last Name="smith"; *)  ` Find every person named Smith…
   QUERY ([People]; | ; [People]Last Name="jones") ` ...or Jones

QUERYコマンドは両方の検索にLast Nameインデックスを使用します。2つの検索が実行され、その結果が内部セットに納められて、結合されます。

8. 以下の例は、会社名が設定されていないレコードをすべて検索します。これは空のフィールド(空の文字列)を検索することによって行います。

   QUERY ([People]; [People]Company="") ` Find every person with no company

9. 以下の例は、Smithという名字でNew Yorkに会社のある人のレコードをすべて検索します。2番目のQUERYコマンドは、他のテーブルのフィールドを使用しています。これは、[People]テーブルから[Company]テーブルへN対1リレートされているために可能になっています:

   QUERY ([People]; [People]Last Name = "smith"; *)  ` Find every person named Smith…  
   QUERY ([People]; & ; [Company]State = "NY")   ` ... who works for a company based in NY

10. 以下の例は、名前のイニシャルがAからMの人のレコードをすべて検索します:

   QUERY ([People]; [People]Name < "n")  ` Find every person from A to M

11. 以下の例は、郵便番号がが“94” (サンフランシスコ) または“90” (ロサンゼルス) の人のレコードをすべて検索します:

   QUERY ([People]; [People]ZIP Code = "94@"; *)   ` Find every person in the SF…
   QUERY ([People]; | ; [People]ZIP Code = "90@")   ` ...or Los Angeles areas

12. キーワードによる検索: 以下の例題は[Products] テーブルのdescriptionフィールドに単語“easy”が含まれるレコードを検索します:

   QUERY([Products];[Products]description%"easy")
      ` Find products whose 説明 contains the keyword easy

13. 以下の例題は、リクエストダイアログに入力したインボイス参照と等しい請求書を検索します:

   vFind:=Request("Find invoice reference:")  ` Get an invoice reference from the user
   If (OK = 1) ` If the user pressed OK
      QUERY ([Invoice]; [Invoice]Ref = vFind)   ` Find the invoice reference that matches vFind
   End if

14. 以下の例は、1996年に作成された請求書のレコードをすべて検索します。これは、1995年12月31日よりあとで1997年1月1日より前のレコードをすべて検索します:

   QUERY ([Invoice]; [Invoice]In 日付 > !12/31/95!; *)   ` Find invoices after 12/31/95…
   QUERY ([Invoice]; &; [Invoice]In 日付 < !1/1/97!)   ` and before 1/1/97

15. 以下の例は、給与が$10,000以上で、$50,000未満の条件に当てはまる従業員のレコードをすべて検索します:

   QUERY ([Employee]; [Employee]Salary >= 10000; *)  ` Find employees who make between… 
   QUERY ([Employee]; & ; [Employee]Salary < 50000)  ` ...$10,000 and $50,000

16. 以下の例は、$20,000以上の給与を得ているマーケティング部に所属する従業員のレコードをすべて検索します。Salaryフィールドにはインデックスが設定されているため最初に検索されます。2番目のQUERYコマンドが、他のテーブルのフィールドを使用している点に注意してください。[Employee]テーブルから[Dept]テーブルへn対1の自動リレートが設定されているためにこのようなことが可能になっています:

   QUERY ([Employee]; [Employee]Salary > 20000; *)   ` Find employees with salaries over $20,000 and...
   QUERY ([Employee]; &;[Dept]Name = "marketing")   ` ...who are in the marketing department

17. N対1でリレートされた3つのテーブルがあります: [City] -> [Department] -> [Region]。以下のクエリは市の名前が"Saint"で始まるRegionを検索します:

   QUERY([Region]; [City]Name="Saint@")  ` Find all the regions with cities beginning with "Saint"

18. 以下はmyVar変数の値を使用して情報を検索します。

   QUERY ([Laws]; [Laws]Text = myVar)  ` Find all laws that match myVar

myVarの値により、クエリは様々な結果になります。例えば:

・myVarが"Copyright@"のとき、Copyrightで始まる文字列を検索します。

・myVarが"@Copyright@"のとき、Copyright文字列を含むレコードを検索します。

19. 以下の例題では、変数の値に基づき複合クエリを組み立てます。この方法で、有効な条件のみを検索に使用することができます:

   QUERY([Invoice];[Invoice]Paid=False;*)
   If($city#"") ` if a city name has been specified
      QUERY([Invoice];[Invoice]Delivery_city=$city;*)
   End if
   If($zipcode#"") ` If a zip code has been specified
      QUERY([Invoice];[Invoice]ZipCode=$zipcode;*)
   End if
   QUERY([Invoice])  ` Execution of query on the criteria 

20. この例題では比較演算子に文字式を使用する方法を示します。比較演算子はポップアップメニューでカスタムクエリダイアログボックスに置かれています:

   C_TEXT($oper)
   $oper:=_popup_operator{_popup_operator}  `$oper equals for example "#" or "="
   If(OK =1)
      QUERY(Invoice];[Invoice]Amount;$oper;$amount)
   End if

QUERY SELECTION, 演算子.

クエリが正しく実行されるとOKシステム変数は1に設定されます。

以下の場合OKは0に設定されます:

- クエリダイアログボックスでユーザがキャンセルをクリックする

- 'QUERY & LOCK'モード (SET QUERY AND LOCK コマンド参照) で、クエリ時にロックされたレコードが1つ以上見つかったとき。この場合LockedSetシステムセットは更新されます。