QUERY BY FORMULA

4D v16.3

QUERY BY FORMULA


QUERY BY FORMULA ( aTable {; queryFormula} )

引数	型	説明
aTable	テーブル	レコードセレクションを求めるテーブル
queryFormula	ブール	検索フォーミュラ

説明

QUERY BY FORMULAはaTableからレコードを検索します。QUERY BY FORMULAは、カレントプロセスのaTableのカレントセレクションを変更し、セレクションの先頭のレコ－ドをカレントレコ－ドにします。

QUERY BY FORMULAとQUERY SELECTION BY FORMULAは、全く同じように機能しますが、QUERY BY FORMULAがテーブルのすべてのレコードを検索対象とするのに対して、QUERY SELECTION BY FORMULAコマンドはカレントセレクションのレコードのみを検索対象とします。

両方のコマンドは、テーブルまたはセレクションの各レコードに対してqueryFormulaを適用します。queryFormulaはTRUEかFALSEのいずれかの状態に評価されるブール式です。queryFormulaでTRUEに評価されたレコードを新しいセレクションに追加します。

queryFormulaは、フィールドと値とを比較するだけの単純なものから、計算、またはリレート先テーブルの情報を評価するような複雑なものまで処理します。queryFormulaには4Dの関数 (コマンド) や開発者が作成した関数 (メソッド) や式 (フォーミュラ) を使用することができます。文字フィールドやテキストフィールドに対して作業を実行する場合は、queryFormulaにワイルドカード (@) を使用することもできます。詳しい情報はQUERYコマンドの例を参照してください。

queryFormulaが省略されると、4Dはフォーミュラでクエリダイアログボックスを表示します(ユーザーは[+]ボタン上をAlt+クリックすることでフォーミュラに新しい行を追加することができます)。

検索が完了すると、新しいセレクションの最初のレコードがディスクからロードされカレントレコードになります。

これらのコマンドは最適化され、特にインデックスを利用します。クエリのタイプが許す場合、これらのコマンドはQUERYコマンドと同じのクエリを実行します。例えば

QUERY BY FORMULA([mytable]; [mytable]myfield=value)

は可能であればインデックスを使用し、

QUERY([mytable]; [mytable]myfield=value)

と同じに実行されます。4Dは最適化可能な部分を先に検索し、他の残りのクエリと合算することで、部分的に最適化できないクエリも最適化します。例えば、

QUERY BY FORMULA([mytable];Length(myfield)=value)

は最適化されません。他方、

QUERY BY FORMULA([mytable];Length(myfield)=value1 | myfield=value2)

は部分的に最適化されます。

これらのコマンドは、異なるテーブルのフィールドを比較する場合デフォルトでSQLのような"JOIN"を行います。これはつまりテーブル間に自動リレーションが必要ない事を意味します。たとえば、以下のようなステートメントを実行する事が可能です(例題3を参照)

QUERY BY FORMULA([Table_A];([Table_A]field_X = [Table_B]field_Y) & ([Table_B]field_Y = "abc"))

フォーミュラの前半([Table_A]field_X = [Table_B]field_Y) は二つのフィールド間でのJOINを確立し、後半の([Table_B]field_Y = "abc") は検索条件を定義します(少なくとも一つの条件が設定される必要があります)。

テーブル間のリレーションが存在しても、それらはルールとしては使用されません。しかし以下のケースでは、これらのコマンドは自動リレーションを使用します:

フォーミュラが { フィールド ; 比較演算子; 値} の形式の要素に分解できない場合
同じテーブルの2つのフィールドが比較されている場合

注: 互換性のためJOINメカニズムを無効にできます。これはデータベース環境設定でグローバルに (変換されたデータベースのみ)、またはSET DATABASE PARAMETERコマンドコマンドを使用してプロセスごとに行うことができます。

4D Server: このコマンドはサーバ上で実行され、実行が最適化されるようになりました。queryFormula内で直接変数が呼ばれているとき、クライアントマシンの変数値を使用してクエリを計算します。例えばQUERY BY FORMULA([mytable];[mytable]myfield=myvariable)というステートメントはサーバ上で実行されますが、myvariable変数の内容はクライアントマシンのものが使用されます。

互換性に関する注意: 4D Server v11までは、このコマンドはクライアントマシン上で実行されていました。後方互換性のために、この振る舞いは変換されたデータベースでは維持されています。しかしながら、互換性プロパティ、あるいはSET DATABASE PARAMETER コマンドのセレクターを使用することで、変換されたデータベースでもサーバー側での実行が有効化されます。

 $currentVal:=Get database parameter(QUERY BY FORMULA Joins)

 SET DATABASE PARAMETER(QUERY BY FORMULA Joins;2) `Activate SQL joins

  `Query all the lines of "ACME" client invoices even though the tables are not related

 QUERY BY FORMULA([invoice_line];([invoice_line]invoice_id=[invoice]id&[invoice]client="ACME"))

 SET DATABASE PARAMETER(QUERY BY FORMULA Joins;$currentVal) `We re-establish the current settings

参照

QUERY
QUERY BY SQL
QUERY SELECTION
QUERY SELECTION BY FORMULA

4D v16.3

QUERY BY FORMULA

QUERY BY FORMULA

説明

例題 1

例題 2

例題 3