JOIN コマンド

2 つの Analytics テーブルのフィールドを連結して 1 つの新しい Analytics テーブルにします。

メモ

曖昧一致を使用して、テーブルを結合するには、FUZZYJOIN コマンドを参照してください。

構文

JOIN PKEY 主テーブルのキー フィールド|PKEY ALL} {FIELDS 主テーブルのフィールド|FIELDS ALL} {SKEY 副テーブルのキーフィールド |SKEY ALL} <WITH 副テーブルのフィールド|WITH ALL> {キーワードなし|MANY|UNMATCHED|PRIMARY|SECONDARY|PRIMARY SECONDARY} <IF テスト> TO テーブル名 <LOCAL> <OPEN> <WHILE テスト> <{FIRST 範囲|NEXT 範囲> <APPEND> <PRESORT> <SECSORT> <ISOLOCALE ロケールコード>

パラメーター

名前

説明

PKEY 主テーブルのキーフィールド | PKEY ALL

主テーブルのキーフィールド（複数可）または式。

主テーブルのキーフィールド指定されたフィールドを使用します
ALL テーブルのすべてのフィールドを使用します。

FIELDS 主フィールド | FIELDS ALL

結合先の出力テーブルに含める、主テーブル内のフィールドまたは式。

主フィールド指定した 1 つまたは複数のフィールドが含まれます。
ALL テーブルのすべてのフィールドを含めます

メモ

結合テーブルに含める場合は、主キーフィールドを明示的に指定する必要があります。ALL を指定すると含まれます。

SKEY 副テーブルのキーフィールド | SKEY ALL

副テーブルのキーフィールド（複数可）または式。

副テーブルのキーフィールド use the specified field or fields
ALL テーブルのすべてのフィールドを使用します。

WITH 副フィールド | WITH ALL

省略可能

結合先の出力テーブルに含める、副テーブル内のフィールドまたは式。

副フィールド指定した 1 つまたは複数のフィールドが含まれます。
ALL テーブルのすべてのフィールドを含めます

メモ

結合テーブルに含める場合は、副キーフィールドを明示的に指定する必要があります。ALL を指定すると含まれます。

結合タイプ "UNMATCHED" を使用する場合には、"WITH" は指定できません。

実行する結合の種類。

キーワードなし（結合タイプのどのキーワードも指定しない）

結合された出力テーブルの内容：

［結合］ダイアログボックスの対応するオプション

すべての一致した主レコードおよび最初に一致した副レコード

一致した主レコードおよび副レコード

(一致する 1 件目の副レコード)

MANY

結合された出力テーブルの内容：

［結合］ダイアログボックスの対応するオプション

すべての一致した主レコードおよびすべての一致した副レコード
主および副テーブル間の各一致に 1 つのレコード

一致した主レコードおよび副レコード

(重複する副レコードのすべての一致)

UNMATCHED

結合された出力テーブルの内容：	［結合］ダイアログボックスの対応するオプション
不一致の主レコード	不一致の主レコード

PRIMARY

結合された出力テーブルの内容：	［結合］ダイアログボックスの対応するオプション
すべての主レコード（一致と不一致の両方）、最初に一致した服レコード	すべての主レコードと、キーに一致する副レコード

メモ

キーワード、BOTH は、PRIMARY を指定することと同じです。

SECONDARY

結合された出力テーブルの内容：	［結合］ダイアログボックスの対応するオプション
すべての副レコード（一致と不一致）およびすべての一致する主レコード重複する副一致の最初のインスタンスのみが主レコードに結合されます。	すべての副レコードと、キーに一致する主レコード

PRIMARY SECONDARY

結合された出力テーブルの内容：	［結合］ダイアログボックスの対応するオプション
すべての主および副レコード（一致と不一致）重複する副一致の最初のインスタンスのみが主レコードに結合されます。	すべての主レコードおよび副レコード

IF テスト

省略可能

各レコードを処理するために真である必要がある条件式。コマンドは、その条件を満たすレコードに対してのみ実行されます。

メモ

IF パラメーターは、任意の範囲パラメーター（WHILE、FIRST、NEXT）が適用された後に、テーブルに残るレコードに対してのみ評価されます。

メモ

ほとんどの結合タイプで、IF 条件が主テーブルにのみ適用されます。

例外は多対多結合で、IF 条件が副テーブルも参照できます。

TO テーブル名

コマンドの結果を送信する場所：

テーブル名は、結果の保存先となる Analytics テーブルのことです。
テーブル名には、ファイル拡張子 .FIL を付けた文字列を引用符で囲んで指定する必要があります。例：TO "Output.FIL"
デフォルトでは、テーブルデータファイル（.fil）は、Analytics プロジェクトが入っているフォルダーに保存されます。
既存の異なるフォルダーにデータファイルを保存するには、絶対または相対ファイルパスを指定します。
- TO "C:\Output.FIL"
- TO "Results\Output.FIL"
メモ
テーブル名は 64 文字の英数字（.FIL 拡張子を含まない）に制限されています。名前にはアンダースコア文字（_）を使用できますが、他の特殊文字やスペースは使用できません。名前の先頭を数字にすることはできません。

LOCAL

省略可能

Analytics プロジェクトと同じ場所に出力ファイルを保存します。

メモ

Analytics テーブルである出力ファイルを含むサーバーテーブルに対してコマンドを実行するときにのみ適用されます。

OPEN

省略可能

コマンドを実行した後、コマンドによって作成されたテーブルを開きます。コマンドが出力テーブルを作成する場合にのみ有効です。

WHILE テスト

省略可能

各レコードを処理するために真である必要がある条件式。条件が false と評価するか、テーブルの最後に達したら、コマンドは実行を中止します。

メモ

WHILE を FIRST または NEXT とともに使用する場合は、1 つの制限に達するとすぐに、レコードの処理が停止します。

FIRST 範囲 | NEXT 範囲

省略可能

処理するレコード数：

FIRST 指定されたレコード数に達するまで、最初のレコードから処理を開始します
NEXT 指定されたレコード数に達するまで、現在選択されているレコードから処理を開始します

範囲は処理するレコード数を指定します。

FIRST と NEXT を省略すると、すべてのレコードがデフォルトで処理されます。

APPEND

省略可能

コマンドの出力を既存ファイルに上書きしないで、そのファイルの末尾に追加します。

メモ

コマンドの出力と既存のファイルの構造が同一であるようにする必要があります。

同じフィールド
同じフィールド順序
一致するフィールドが同じ長さ
一致するフィールドが同じデータ型

出力は、既存ファイルとの間でファイル構造が違っている場合でも、Analytics によって既存ファイルに追加されます。出力と既存のファイルの構造が一致しない場合は、データが混在、不足、不正確になります。

PRESORT

省略可能

コマンドを実行する前に主キーフィールドで主テーブルを並べ替えます。

メモ

GROUP コマンドの内部では PRESORT を使用することができません。

並べ替えの代わりのインデックス

主テーブルは、並べ替える代わりにインデックスを付けることができます。大きなテーブルでは並べ替えよりインデックス作成を行った方が、テーブルの結合に必要な時間を短くすることができます。

また、インデックス付きの共通のキーフィールドを使用して 2 つのテーブルを結合する場合は、PRESORT と SECSORT を省略します。

SECSORT

省略可能

コマンドを実行する前に副テーブルのキーフィールドで副テーブルを並べ替えます。

メモ

SECSORT は GROUP コマンド内では使用できません。

並べ替えの代わりのインデックス

副テーブルは、並べ替える代わりにインデックスを付けることができます。大きなテーブルでは並べ替えよりインデックス作成を行った方が、テーブルの結合に必要な時間を短くすることができます。

また、インデックス付きの共通のキーフィールドを使用して 2 つのテーブルを結合する場合は、PRESORT と SECSORT を省略します。

ISOLOCALE ロケールコード

省略可能

メモ

Analytics の Unicode 版にのみ適用されます。

システムロケールは「言語-国」の形式で入力します。たとえば、カナダフランス語はコード「fr_ca」を入力します。

次のコードを使用します。

言語 ISO 639 標準言語コード
国 ISO 3166 標準国コード
国コードを指定しない場合は、言語のデフォルト国が使用されます。

ISOLOCALE を使用しない場合は、デフォルトシステムロケールが使用されます。

例

業者である可能性がある従業員を検索するための方法として、2 つのテーブルを結合する

次の例は、共通キーフィールドとして住所（Address および Vendor_Street フィールド）を使用し、Empmast および Vendor テーブルを結合します。

JOIN コマンドは、新しいテーブルと、一致する主および副レコードを作成します。これにより、同じ住所の従業員と業者のリストが作成されます。

OPEN Empmast PRIMARY
OPEN Vendor SECONDARY
JOIN PKEY Address FIELDS Empno First Last Address SKEY Vendor_Street WITH Vendor_No Vendor_Name Vendor_Street TO "Employee_Vendor_Match" OPEN PRESORT SECSORT

このバージョンの JOIN コマンドは、主テーブルと副テーブルのすべてのフィールドを結合された出力テーブルに含めます。

OPEN Empmast PRIMARY
OPEN Vendor SECONDARY
JOIN PKEY Address FIELDS ALL SKEY Vendor_Street WITH ALL TO "Employee_Vendor_Match" OPEN PRESORT SECSORT

一致する顧客がない売掛金レコードを検出する方法として、2 つのテーブルを結合します。

次の例では、Ar テーブルと Customer テーブルを、顧客番号（CustNo）を共通のキーフィールドとして用いて結合します。

JOIN コマンドは、結合タイプ UNMATCHED を使用して、主テーブルの不一致レコードを含む新しいテーブルを作成しています。その結果、どの Customer レコードとも関連付けられていない Ar レコードの一覧が生成されます。

OPEN Ar PRIMARY
OPEN Customer SECONDARY
JOIN PKEY CustNo FIELDS CustNo Due Amount SKEY CustNo UNMATCHED TO "CustomerNotFound.fil" OPEN PRESORT SECSORT

備考

メモ

このコマンドの動作の詳細については、Analytics のヘルプを参照してください。

[ トップに戻る ]

ACL のスクリプト作成ガイド 14.1