Datenquellen verbinden

Syntax: Reale Felder verbinden

Die folgende JOIN-Syntax setzt voraus, dass die Felder, die verwendet werden, um die Dateien zu verbinden, reale Felder sind, die in der Masterdatei festgelegt wurden. Dies kann ein einfacher Join sein, der auf einem Feld in jeder zu verbindenden Datei basiert, oder, bei Datenquellen, die dieses Verhalten unterstützen, ein Mehrfachfeld-Join. Die folgende Syntax beschreibt den einfachen Join und den Mehrfachfeld-Join:

JOIN [LEFT_OUTER|INNER] hfld1 [AND hfld2 ...] IN hostfile [TAG tag1]
     TO [UNIQUE|MULTIPLE]
     crfield [AND crfld2 ...] IN crfile [TAG tag2] [AS joinname]
END

Hierbei gilt:

JOIN hfld1

Ist der Name eines Feldes in der Hostdatei, das Werte enthält, welche mit einem Feld in der Querverweisdatei gemeinsam verwendet werden. Dieses Feld wird Hostfeld genannt.

AND hfld2...

Kann ein zusätzliches Feld in der Hostdatei sein, mit den unten vermerkten Vorbehalten. Die Phrase, die mit AND beginnt, ist erforderlich, wenn mehrere Felder angegeben werden.

Wenn Sie zwei FOCUS-Datenquellen verbinden, können Sie bis zu vier alphanumerische Felder in der Hostdatei angeben, die bei Verkettung Werte enthalten, welche mit der Querverweisdatei gemeinsam verwendet werden. Sie können in der Querverweisdatei nicht mehr als ein Feld angeben, falls das Suffix der Datei FOC ist. Nehmen wir z. B. an, dass die Querverweisdatei ein Telefonnummernfeld mit einem Vorwahl-Präfixaustausch-Format enthält. Die Hostdatei besitzt ein Vorwahlfeld, ein Präfixfeld und ein Austauschfeld. Sie können angeben, dass diese drei Felder mit dem Telefonnummernfeld in der Querverweisdatei verbunden werden. Der JOIN-Befehl behandelt diese drei Felder als ein Feld. Andere Datenquellen haben diese Beschränkung für die Querverweisdatei nicht.
Bei Datenadaptern, die Mehrfachfeld- und verkettete Joins unterstützen, können Sie bis zu 16 Felder angeben. Spezifische Informationen über unterstützte Join-Features finden Sie in Ihrer Datenadapter-Dokumentation. Beachten Sie, dass FOCUS-Datenquellen diese Joins nicht unterstützen.

INNER

Gibt einen inneren Join an. Wenn Sie im JOIN-Befehl nicht den Typ des Joins spezifizieren, dann bestimmt die Einstellung des ALL-Parameters den Typ des Joins, der ausgeführt werden soll.

LEFT_OUTER

Spezifiziert einen linken äußeren Join. Wenn Sie im JOIN-Befehl nicht den Typ des Joins spezifizieren, dann bestimmt die Einstellung des ALL-Parameters den Typ des Joins, der ausgeführt werden soll.

Beachten Sie, dass in einem linken äußeren Join Host-Datensätze mit einer fehlenden querverwiesenen Instanz in der Reportausgabe enthalten sind. Um zu steuern, wie Tests mit fehlenden querverwiesenen Segmentinstanzen verarbeitet werden, verwenden Sie den Befehl SET SHORTPATH, der beschrieben ist unter Eine fehlende Segmentinstanz verarbeiten.

IN hostfile

Ist der Name der Hostdatei.

TAG tag1

Ist der Tag-Name mit bis zu acht Zeichen (normalerweise der Name der Masterdatei), der als eindeutiger Kennzeichner für Felder und Aliase in der Hostdatei verwendet wird.

Der Tag-Name für die Hostdatei muss in allen JOIN-Befehlen einer Join-Struktur derselbe sein.

TO [UNIQUE|MULTIPLE] crfld1

Ist der Name eines Feldes in der Querverweisdatei, das Werte enthält, die mit denen von hfld1 (oder von verketteten Hostfeldern) übereinstimmen. Dieses Feld wird Querverweisfeld genannt.

Hinweis: Unique gibt nur eine Instanz zurück, und falls es keine übereinstimmende Instanz in der querverwiesenen Datei gibt, stellt es Defaultwerte zur Verfügung (Leerstellen für alphanumerische Felder und Null für numerische Felder).

Verwenden Sie den Parameter MULTIPLE, wenn crfld1 mehrere Instanzen mit einem Wert in hfld1 gemein hat. Beachten Sie, dass ALL ein Synonym für MULITPLE ist und dass das Auslassen dieses Parameters ein Synonym für UNIQUE ist. Weitere Informationen finden Sie unter Eindeutige und nicht eindeutige verbundene Strukturen.

AND crfld2...

Ist der Name eines Feldes in der Querverweisdatei, das Werte mit hfld2 gemein hat.

Hinweis: crfld2 kann qualifiziert sein. Dieses Feld ist nur für Datenadapter verfügbar, die Mehrfachfeld-Joins unterstützen.

IN crfile

Ist der Name der Querverweisdatei.

TAG tag2

Ist ein Tag-Name mit bis zu acht Zeichen (normalerweise der Name der Masterdatei), der als eindeutiger Kennzeichner für Felder und Aliase in Querverweisdateien verwendet wird. In einer rekursiven Join-Struktur werden allen Feldnamen und Aliasen die ersten vier Zeichen des Join-Namens vorangestellt, wenn kein Tag-Name angegeben wurde. Weitere Informationen zu diesem Thema finden Sie unter Verwendungshinweise für rekursive verbundene Strukturen.

Der Tag-Name für die Hostdatei muss in allen JOIN-Befehlen einer Join-Struktur derselbe sein.

AS joinname

Ist ein optionaler Name mit bis zu acht Zeichen, den Sie einer Join-Struktur zuweisen können. Sie müssen einer Join-Struktur einen eindeutigen Namen zuweisen, wenn:

Sie sicherstellen möchten, dass ein nachfolgender Join-Befehl ihn nicht überschreibt.
Sie ihn später selektiv löschen möchten.
Die Struktur rekursiv ist. Siehe Rekursive verbundene Strukturen.

Hinweis: Wenn Sie der Join-Struktur keinen Namen mit der AS-Phrase zuweisen, wird angenommen, dass der Name leer ist. Ein Join ohne Namen überschreibt einen vorhandenen Join ohne Namen.

END

Ist erforderlich, wenn der JOIN-Befehl länger als eine Zeile ist. Es beendet den Befehl. Er muss sich auf einer eigenen Zeile befinden.

Nach oben

Beispiel: Eine einfache eindeutige verbundene Struktur erstellen

Unterhalb sehen Sie ein Beispiel eines einfachen eindeutigen Joins:

JOIN JOBCODE IN EMPLOYEE TO JOBCODE IN JOBFILE AS JJOIN

Nach oben

Beispiel: Einen inneren Join erstellen

Die folgende Prozedur erstellt drei FOCUS-Datenquellen:

EMPINFO, die die Felder EMP_ID, LAST_NAME, FIRST_NAME und CURR_JOBCODE des Segments EMPINFO der Datenquelle EMPLOYEE enthält.
JOBINFO, die die Felder JOBCODE und JOB_DESC der Datenquelle JOBFILE enthält.
EDINFO, die die Felder EMP_ID, COURSE_CODE und COURSE_NAME der Datenquelle EDUCFILE enthält.

Die Prozedur fügt dann EMPINFO einen Angestellten mit dem Namen Fred Newman hinzu, für den es in den Datenquellen JOBINFO oder EDINFO keine übereinstimmenden Datensätze gibt.

TABLE FILE EMPLOYEE
SUM LAST_NAME FIRST_NAME CURR_JOBCODE
BY EMP_ID
ON TABLE HOLD AS EMPINFO FORMAT FOCUS INDEX EMP_ID CURR_JOBCODE
END
-RUN
 
TABLE FILE JOBFILE
SUM JOB_DESC
BY JOBCODE
ON TABLE HOLD AS JOBINFO FORMAT FOCUS INDEX JOBCODE
END
-RUN
 
TABLE FILE EDUCFILE
SUM COURSE_CODE COURSE_NAME
BY EMP_ID
ON TABLE HOLD AS EDINFO FORMAT FOCUS INDEX EMP_ID
END
-RUN
 
MODIFY FILE EMPINFO
FREEFORM EMP_ID LAST_NAME FIRST_NAME CURR_JOBCODE
MATCH EMP_ID
ON NOMATCH INCLUDE
ON MATCH REJECT
DATA
111111111, NEWMAN, FRED, C07,$
END

Die folgende Anfrage druckt die Inhalte von EMPINFO. Beachten Sie, dass Fred Newman der Datenquelle hinzugefügt wurde:

TABLE FILE EMPINFO
PRINT *
END

Die Ausgabe ist:

EMP_ID     LAST_NAME        FIRST_NAME  CURR_JOBCODE
------     ---------        ----------  ------------
071382660  STEVENS          ALFRED      A07
112847612  SMITH            MARY        B14
117593129  JONES            DIANE       B03
119265415  SMITH            RICHARD     A01
119329144  BANNING          JOHN        A17
123764317  IRVING           JOAN        A15
126724188  ROMANS           ANTHONY     B04
219984371  MCCOY            JOHN        B02
326179357  BLACKWOOD        ROSEMARIE   B04
451123478  MCKNIGHT         ROGER       B02
543729165  GREENSPAN        MARY        A07
818692173  CROSS            BARBARA     A17
111111111  NEWMAN           FRED        C07

Der folgende JOIN-Befehl erstellt einen inneren Join zwischen der Datenquelle EMPINFO und der Datenquelle JOBINFO.

JOIN CLEAR *
JOIN INNER CURR_JOBCODE IN EMPINFO TO MULTIPLE JOBCODE IN JOBINFO AS J0

Beachten Sie, dass der JOIN-Befehl einen Mehrfach-Join angibt. In einem eindeutigen Join wird das Querverweissegment nie als fehlend betrachtet und alle Datensätze der Hostdatei werden in der Reportausgabe angezeigt. Defaultwerte (Leerstelle für alphanumerische Felder und Null für numerische Felder) werden angezeigt, falls keine tatsächlichen Daten vorhanden sind.

Die folgende Anfrage zeigt Felder der verbundenen Struktur an:

TABLE FILE EMPINFO
PRINT LAST_NAME FIRST_NAME JOB_DESC
END

Fred Newman wird in der Reportausgabe weggelassen, da es für seinen Jobcode in der Datenquelle JOBINFO keine Übereinstimmung gibt:

LAST_NAME  FIRST_NAME  JOB_DESC
---------  ----------  --------
STEVENS    ALFRED      SECRETARY
SMITH      MARY        FILE QUALITY
JONES      DIANE       PROGRAMMER ANALYST
SMITH      RICHARD     PRODUCTION CLERK
BANNING    JOHN        DEPARTMENT MANAGER
IRVING     JOAN        ASSIST.MANAGER
ROMANS     ANTHONY     SYSTEMS ANALYST
MCCOY      JOHN        PROGRAMMER
BLACKWOOD  ROSEMARIE   SYSTEMS ANALYST
MCKNIGHT   ROGER       PROGRAMMER
GREENSPAN  MARY        SECRETARY
CROSS      BARBARA     DEPARTMENT MANAGER

Nach oben

Beispiel: Einen linken äußeren Join erstellen

Der folgende JOIN-Befehl erstellt einen linken äußeren Join zwischen der Datenquelle EMPINFO und der Datenquelle EDINFO:

JOIN CLEAR *
JOIN LEFT_OUTER EMP_ID IN EMPINFO TO MULTIPLE EMP_ID IN EDINFO AS J1

Die folgende Anfrage zeigt Felder der verbundenen Struktur an:

TABLE FILE EMPINFO
PRINT LAST_NAME FIRST_NAME COURSE_NAME
END

Alle Angestelltendatensätze werden in der Reportausgabe angezeigt. Die Datensätze für Angestellte, für die es in der EDINFO-Datenquelle keine Übereinstimmung gibt, zeigen das Zeichen für fehlende Daten (.) in der COURSE_NAME-Spalte an. Wenn der Join eindeutig wäre, würden anstelle des Zeichens für fehlende Daten Leerstellen angezeigt werden.

LAST_NAME  FIRST_NAME  COURSE_NAME
---------  ----------  -----------
STEVENS    ALFRED      FILE DESCRPT & MAINT
SMITH      MARY        BASIC REPORT PREP FOR PROG
JONES      DIANE       FOCUS INTERNALS
SMITH      RICHARD     BASIC RPT NON-DP MGRS
BANNING    JOHN        .
IRVING     JOAN        .
ROMANS     ANTHONY     .
MCCOY      JOHN        .
BLACKWOOD  ROSEMARIE   DECISION SUPPORT WORKSHOP
MCKNIGHT   ROGER       FILE DESCRPT & MAINT
GREENSPAN  MARY        .
CROSS      BARBARA     HOST LANGUAGE INTERFACE
NEWMAN     FRED        .

Nach oben

Beispiel: Zwei innere Joins mit einer Mehrpfadstruktur erstellen

Die folgenden JOIN-Befehle erstellen einen inneren Join zwischen den Datenquellen EMPINFO und JOBINFO und einen inneren Join zwischen den Datenquellen EMPINFO und EDINFO:

JOIN CLEAR *
JOIN INNER CURR_JOBCODE IN EMPINFO TO MULTIPLE JOBCODE IN JOBINFO AS J0
JOIN INNER EMP_ID IN EMPINFO TO MULTIPLE EMP_ID IN EDINFO AS J1

Die Struktur, die von den zwei Joins erstellt wird, besitzt zwei unabhängige Pfade:

         SEG01
 01      S1
**************
*EMP_ID      **I
*CURR_JOBCODE**I
*LAST_NAME   **
*FIRST_NAME  **
*            **
***************
 **************
       I
       +-----------------+
       I                 I
       I SEG01           I SEG01
 02    I KM        03    I KM
..............    ..............
:EMP_ID      ::K  :JOBCODE     ::K
:COURSE_CODE ::   :JOB_DESC    ::
:COURSE_NAME ::   :            ::
:            ::   :            ::
:            ::   :            ::
:............::   :............::
 .............:    .............:
 JOINED  EDINFO    JOINED  JOBINFO

Die folgende Anfrage zeigt Felder der verbundenen Struktur an:

SET MULTIPATH=SIMPLE
TABLE FILE EMPINFO
PRINT LAST_NAME FIRST_NAME IN 12 COURSE_NAME JOB_DESC
END

Mit MULITPATH=SIMPLE erstellen die unabhängigen Pfade unabhängige Joins. Alle Angestelltendatensätze, die von einem der Joins akzeptiert werden, werden in der Reportausgabe angezeigt. Nur Fred Newman (für den in keiner der Querverweisdateien ein übereinstimmender Datensatz vorhanden ist) wird weggelassen:

LAST_NAME  FIRST_NAME  COURSE_NAME                     JOB_DESC
---------  ----------  -----------                     --------
STEVENS    ALFRED      FILE DESCRPT & MAINT            SECRETARY
SMITH      MARY        BASIC REPORT PREP FOR PROG      FILE QUALITY
JONES      DIANE       FOCUS INTERNALS                 PROGRAMMER ANALYST
SMITH      RICHARD     BASIC RPT NON-DP MGRS           PRODUCTION CLERK
BANNING    JOHN        .                               DEPARTMENT MANAGER
IRVING     JOAN        .                               ASSIST.MANAGER
ROMANS     ANTHONY     .                               SYSTEMS ANALYST
MCCOY      JOHN        .                               PROGRAMMER
BLACKWOOD  ROSEMARIE   DECISION SUPPORT WORKSHOP       SYSTEMS ANALYST
MCKNIGHT   ROGER       FILE DESCRPT & MAINT            PROGRAMMER
GREENSPAN  MARY        .                               SECRETARY
CROSS      BARBARA     HOST LANGUAGE INTERFACE         DEPARTMENT MANAGER

Mit MULTIPATH=COMPOUND werden nur Angestellte mit übereinstimmenden Datensätzen in beiden Querverweisdateien in der Reportausgabe angezeigt:

LAST_NAME  FIRST_NAME  COURSE_NAME                     JOB_DESC
---------  ----------  -----------                     --------
STEVENS    ALFRED      FILE DESCRPT & MAINT            SECRETARY
SMITH      MARY        BASIC REPORT PREP FOR PROG      FILE QUALITY
JONES      DIANE       FOCUS INTERNALS                 PROGRAMMER ANALYST
SMITH      RICHARD     BASIC RPT NON-DP MGRS           PRODUCTION CLERK
BLACKWOOD  ROSEMARIE   DECISION SUPPORT WORKSHOP       SYSTEMS ANALYST
MCKNIGHT   ROGER       FILE DESCRPT & MAINT            PROGRAMMER
CROSS      BARBARA     HOST LANGUAGE INTERFACE         DEPARTMENT MANAGER

Referenz: Voraussetzungen für Querverweisfelder in einem Equijoin

Die Querverweisfelder, die in einem JOIN verwendet werden, müssen in spezifischen Datenquellen die folgenden Charakteristika besitzen:

In relationalen Datenquellen und in einer CA-DATACOM/DB-Datenquelle kann jedes Feld das Querverweisfeld sein.
In FOCUS- und XFOCUS-Datenquellen muss das Querverweisfeld indiziert sein. Indizierte Felder besitzen das Attribut FIELDTYPE=I oder INDEX=I oder auch INDEX=ON in der Masterdatei. Fügen Sie, wenn das Querverweisfeld dieses Attribut nicht besitzt, der Felddeklaration in der Masterdatei das Attribut hinzu und erstellen Sie die Datei mit der Option INDEX der Utility REBUILD erneut. Dies fügt Ihrer FOCUS- oder XFOCUS-Datenquelle einen Index hinzu.
Hinweis: Die indizierten Felder können extern sein. Im Handbuch Daten mit der WebFOCUS-Sprache beschreiben Weitere Informationen über indizierte Felder und das Tool Rebuild finden Sie unter .
In IMS-Datenquellen muss das querverwiesene Feld eine Schlüssel im Root-Segment sein. Es kann ein primärer oder sekundärer Index sein.
In Dateien mit Fixformat oder in sequenziellen kommabegrenzten Dateien kann jedes Feld ein Querverweisfeld sein. Es muss jedoch sowohl die Host- als auch die Querverweisdatei in aufsteigender Reihenfolge vom benannten Feld (Schlüsselfeld) abgerufen werden. Falls die Daten sich nicht in derselben Sortierreihenfolge befinden, werden Fehlermeldungen angezeigt. Ein n:n-Join wird nicht unterstützt. Eine kommabegrenzte Datei, die im Join als Querverweisdatei verwendet wird, darf aus nur einem Segment bestehen. Wenn der Join auf mehreren Feldern basiert, muss eine sequenzielle Datei mit Fixformat aus einem Segment bestehen. Wenn die sequentielle Querverweisdatei mit Fixformat nur ein Segment enthält, muss die Hostdatei über eine Segmentdeklaration verfügen.

Referenz: Beschränkungen für Gruppenfelder

Wenn Gruppenfelder in einer verbundenen Struktur verwendet werden, muss die Gruppe in der Hostdatei und die Gruppe in der Querverweisdatei dieselbe Anzahl Elemente besitzen:

In der ISAM-Datenquelle muss das Feld der vollständige Primärschlüssel sein, wenn Sie einen eindeutigen Join ausgeben oder eine anfängliche Teilmenge des Primärschlüssels, wenn Sie einen nicht eindeutigen Join ausgeben. In der Masterdatei wird der Primärschlüssel von einer Schlüssel-GROUP beschrieben. Die erste Teilmenge ist das erste Feld in dieser Gruppe.
In VSAM KSDS-Datenquellen muss das Feld der vollständige primäre oder der alternative Schlüssel sein, wenn Sie einen eindeutigen Join ausgeben, oder eine anfängliche Teilmenge des primären oder alternativen Schlüssels, wenn Sie einen nicht eindeutigen Join ausgeben. In der Masterdatei wird der Primärschlüssel von einer Schlüssel-GROUP beschrieben. Die erste Teilmenge ist das erste Feld in dieser Gruppe.
In der Datenquelle VSAM ESDS kann jedes Feld das Feld sein, solange die Datei mit diesem Feld bereits sortiert wurde.
In Model 204-Datenquellen muss das Feld ein Schlüsselfeld sein. In der Zugriffsdatei gibt es folgende Schlüsselfeldertypen: alphanumerisch (KEY), sortierte Zeichen (ORA), sortiert numerisch (ORN), numerischer Bereich (RNG), nicht sichtbar (IVK) und nicht sichtbarer Bereich (IVR).
In ADABAS-Datenquellen muss das Feld ein Deskriptorfeld, ein Superdeskriptor, der mit dem .SPR- oder .NOP-Feldnamensuffix definiert wurde, oder ein Subdeskriptor sein, der mit dem Feldnamensuffix .NOP definiert wurde. Die Feldbeschreibung in der Masterdatei muss das Attribut FIELDTYPE=I enthalten.
In der Zugriffsdatei muss das Querverweissegment ACCESS=ADBS und entweder CALLTYPE=FIND oder CALLTYPE=RL angeben. Wenn CALLTYPE=RL vorliegt, kann das Hostfeld mit dem übergeordneten Teil eines Deskriptors, Superdeskriptors oder Subdeskriptors verbunden werden, falls der übergeordnete Teil länger als das Hostfeld ist.
In CA-IDMS/DB-Datenquellen muss das Feld entweder ein indiziertes Feld in einem Netzwerkdatensatz sein, das durch das Attribut FIELDTYPE=I in der Masterdatei identifiziert wird, ein CA-IDMS/DB CALC-Feld in einem Netzwerkdatensatz, das durch die Phrase CLCFLD in der Zugriffsdatei identifiziert wird, oder ein beliebiges Feld in einem LRF- oder ASF-Datensatz.

Referenz: Verwendungshinweise für innere und äußere JOIN-Befehlssyntax

Die Befehle SET ALL und SET CARTESIAN werden von der Syntax ignoriert.
Der ALL. Parameter wird nicht unterstützt. Wenn der ALL.- Parameter verwendet wird, wird die folgende Meldung angezeigt:
```
(FOC32452) Use of ALL. with LEFT_OUTER/INNER not allowed
```
Wenn Sie Mehrfach-Joins definieren, kann die sich ergebende Struktur eine Einfachpfad- oder eine Mehrfachpfad-Datenquelle sein.
- Wenn die Einstellung MULTIPATH=SIMPLE aktiv ist und der Report auf mehreren Pfaden basiert, wird jeder der individuellen Joins separat erstellt, ohne dass auf die anderen Joins geachtet wird, und die übereinstimmenden Datensätze von jedem der separaten Pfade werden in der Reportausgabe angezeigt. Daher kann die Ausgabe Datensätze enthalten, die weggelassen worden wären, wenn nur einer der Joins aktiv gewesen wäre.
- Wenn die Einstellung MULTIPATH=COMPOUND in einem Mehrpfadreport aktiv ist oder wenn der Report nur Daten eines einfachen Pfades anzeigt, werden nur die Datensätze in der Reportausgabe angezeigt, die alle Joins erfüllen.

Einen Equijoin verwenden, um ein virtuelles Feld mit einem realen Feld zu verbinden

Vorgehensweise:

Join von einem virtuellen Feld zu einem realen Feld

Referenz:

Verwendungshinweise für virtuelle Felder mit verbundenen Datenquellen

Sie können auf DEFINE basierende JOIN-Syntax verwenden, um ein virtuelles Hostfeld zu erstellen, das Sie mit einem realen Querverweisfeld verbinden können. Die DEFINE-Formel, die das virtuelle Hostfeld erstellt, kann nur Felder der Hostdatei oder Konstanten enthalten. (Es kann sein, dass sie keine Felder in der Querverweisdatei enthält.) Sie können mehr als einen Join von einem virtuellen Feld erstellen.

Sie können das virtuelle Hostfeld in einem separaten DEFINE-Befehl oder in einer Masterdatei erstellen. Informationen zu Masterdateien finden Sie im Handbuch Daten mit der WebFOCUS-Sprache beschreiben .

Dieselbe Reportanfrage kann sowohl auf JOIN basierende virtuelle Felder als auch virtuelle Felder enthalten, die nicht mit dem Join in Beziehung stehen.

Beachten Sie, dass Sie, wenn Sie ein virtuelles Feld in einem DEFINE-Befehl erstellen, den DEFINE- nach dem JOIN-Befehl aber vor der TABLE-Anfrage ausstellen müssen, da ein JOIN-Befehl alle Felder löscht, die von DEFINE-Befehlen für die Hostdatei und die verbundene Struktur erstellt wurden. Virtuelle Felder, die in Masterdateien definiert wurden, werden nicht gelöscht.

Tipp: Wenn dem JOIN-Befehl ein DEFINE-Befehl vorausgeht, können Sie KEEPDEFINES ON so einstellen, dass virtuelle Felder während des Parsings eines nachfolgenden JOIN-Befehls erneuert werden. Weitere Informationen finden Sie unter Virtuelle Felder mit KEEPDEFINES ON beibehalten.

Nach oben

Syntax: Join von einem virtuellen Feld zu einem realen Feld

Der auf DEFINE basierende JOIN-Befehl ermöglicht es Ihnen, ein virtuelles Feld in der Hostdatei mit einem realen Feld in der Querverweisdatei zu verbinden. Die Syntax lautet:

JOIN [LEFT_OUTER|INNER] deffld WITH host_field ... 
     IN hostfile [TAG tag1]
     TO [UNIQUE|MULTIPLE] 
     cr_field IN crfile [TAG tag2] [AS joinname]
END

Hierbei gilt:

JOIN deffld

Ist der Name eines virtuellen Feldes für die Hostdatei (das Hostfeld). Das virtuelle Feld kann in der Masterdatei oder mit einem DEFINE-Befehl definiert werden. Weitere Informationen zu diesem Thema finden Sie unter Verwendungshinweise für virtuelle Felder mit verbundenen Datenquellen.

WITH host_field

Ist der Name eines beliebigen realen Feldes im Hostsegment, dem Sie das virtuelle Feld zuordnen möchten. Diese Zuordnung ist erforderlich, um das virtuelle Feld zu lokalisieren.

Die Phrase WITH wird benötigt, es sei denn der Parameter KEEPDEFINES ist auf ON gestellt und deffld wurde vor dem Ausstellen des JOIN-Befehls definiert.

Verwenden Sie, um zu bestimmen, welches Segment das virtuelle Feld enthält, die ? DEFINE-Abfrage, nachdem Sie den DEFINE-Befehl ausgegeben haben. Sie finden im Handbuch Reportanwendungen entwickeln Genaueres über Abfragebefehle finden Sie im Handbuch .

INNER

Gibt einen inneren Join an. Wenn Sie im JOIN-Befehl nicht den Typ des Joins spezifizieren, dann bestimmt die Einstellung des ALL-Parameters den Typ des Joins, der ausgeführt werden soll.

LEFT_OUTER

Spezifiziert einen linken äußeren Join. Wenn Sie im JOIN-Befehl nicht den Typ des Joins spezifizieren, dann bestimmt die Einstellung des ALL-Parameters den Typ des Joins, der ausgeführt werden soll.

IN hostfile

Ist der Name der Hostdatei.

TAG tag1

Ist der Tag-Name mit bis zu acht Zeichen (normalerweise der Name der Masterdatei), der als eindeutiger Kennzeichner für Felder und Aliase in Hostdateien verwendet wird.

Der Tag-Name für die Hostdatei muss in allen JOIN-Befehlen einer verbundenen Struktur gleich sein.

TO [UNIQUE|MULTIPLE] crfld1

Ist der Name eines realen Feldes in der Querverweisdatenquelle, dessen Werte mit denen des virtuellen Feldes übereinstimmen. Dies muss eine reales Feld sein, das in der Masterdatei festgelegt wurde.

Hinweis: Unique gibt nur eine Instanz zurück, und falls es keine übereinstimmende Instanz in der querverwiesenen Datei gibt, stellt es Defaultwerte zur Verfügung (Leerstellen für alphanumerische Felder und Null für numerische Felder).

Verwenden Sie den Parameter MULTIPLE, wenn crfld1 mehrere Instanzen mit einem Wert in hfld1 gemein hat. Beachten Sie, dass ALL ein Synonym für MULITPLE ist und dass das Auslassen dieses Parameters ein Synonym für UNIQUE ist. Weitere Informationen finden Sie unter Eindeutige und nicht eindeutige verbundene Strukturen.

IN crfile

Ist der Name der Querverweisdatei.

TAG tag2

Ist ein Tag-Name mit bis zu acht Zeichen (normalerweise der Name der Masterdatei), der als eindeutiger Kennzeichner für Felder und Aliase in Querverweisdateien verwendet wird. In einer rekursiven verbundenen Struktur werden allen Feldnamen und Aliasen die ersten vier Zeichen des Join-Namens vorangestellt, wenn kein Tag-Name angegeben wurde. Weitere Informationen zu diesem Thema finden Sie unter Verwendungshinweise für rekursive verbundene Strukturen.

Der Tag-Name für die Hostdatei muss in allen JOIN-Befehlen einer verbundenen Struktur gleich sein.

AS joinname

Ist ein optionaler Name mit bis zu acht Zeichen, den Sie der verbundenen Struktur zuweisen können. Sie müssen einer Join-Struktur einen eindeutigen Namen zuweisen, wenn:

Sie sicherstellen möchten, dass ein nachfolgender Join-Befehl ihn nicht überschreibt.
Sie ihn später selektiv löschen möchten.
Die Struktur ist rekursiv und Sie geben keine Tag-Namen an. Siehe Rekursive verbundene Strukturen.

Es wird, wenn Sie der verbundenen Struktur keinen Namen mit der AS-Phrase zuweisen möchten, angenommen, dass der Name leer ist. Ein Join ohne Namen überschreibt einen vorhandenen Join ohne Namen.

END

Ist erforderlich, wenn der JOIN-Befehl länger als eine Zeile ist. Es beendet den Befehl. Er muss sich auf einer eigenen Zeile befinden.

Nach oben

Referenz: Verwendungshinweise für virtuelle Felder mit verbundenen Datenquellen

Anfragen, die verbundene Datenquellen lesen, können virtuelle Felder enthalten, die folgendermaßen definiert werden können:

In der Masterdatei der Host-Datenquelle.
In einem DEFINE-Befehl, in der die Syntax
```
DEFINE FILE hostfile
```
die Host-Datenquelle in der verbundenen Struktur identifiziert.
Hinweis: Die Formel, die das Hostfeld für den Join definiert, kann nur Hostfelder und Konstanten verwenden.
Alle anderen virtuellen Felder können reale Felder der Hostdatei und der Querverweisdatei enthalten.
Tipp: Da die Ausgabe des JOIN-Befehls alle DEFINE-Befehle für die Hostdatei und die verbundene Struktur löscht, müssen Sie den Befehl DEFINE nach dem JOIN ausgeben oder KEEPDEFINES auf ON einstellen, um die virtuellen Felder beizubehalten. Weitere Informationen finden Sie unter Virtuelle Felder während des Join-Parsings beibehalten.

Nach oben

Beispiel: Ein virtuelles Hostfeld für eine verbundene Struktur erstellen

Nehmen wir an, dass eine Einzelhandelskette vier Geschäftsleiter auf Fortbildungskurse schickt. Jeder von ihnen leitet ein Geschäft in einer anderen Stadt und wird durch eine ID-Nummer identifiziert. Die Geschäfte und die Städte, in denen sich diese befinden, sind in der SALES-Datenquelle enthalten. Die Geschäftsführer-IDs, die Kurse und die Daten, an denen die Geschäftsleiter teilgenommen haben, befinden sich in der EDUCFILE-Datenquelle.

Die folgende Prozedur listet die Kurse auf, an denen die Geschäftsleiter teilgenomen haben, wobei sie durch die Städte identifiziert werden, in denen sie arbeiten. Beachten Sie die drei Elemente in der Prozedur:

Der JOIN-Befehl verbindet die Datenquelle SALES mit der Datenquelle EDUCFILE, und zwar basierend auf den Werten, die das ID_NUM-Feld (welches die Geschäftsleiter-IDs enthält) in SALES und das EMP_ID-Feld in EDUCFILE gemein haben. Beachten Sie, dass das Feld ID_NUM noch nicht vorhanden ist und durch den Befehl DEFINE erstellt wird.
Der DEFINE-Befehl erstellt das Feld ID_NUM und weist ihm die IDs der Geschäftsleiter zu, die in den vier Städten arbeiten.
Der Befehl TABLE erzeugt den Report.

Die Prozedur ist:

JOIN ID_NUM WITH CITY IN SALES TO ALL EMP_ID IN EDUCFILE AS SALEDUC

DEFINE FILE SALES
ID_NUM/A9 = DECODE CITY ('NEW YORK' 451123478 'NEWARK' 119265415
                         'STAMFORD' 818692173 'UNIONDALE' 112847612);
END

TABLE FILE SALES
PRINT DATE_ATTEND BY CITY BY COURSE_NAME
END

Die Ausgabe ist:

CITY                    COURSE_NAME                 DATE_ATTEND
----                    -----------                 -----------
NEW YORK                FILE DESCRPT & MAINT           81/11/15
NEWARK                  BASIC RPT NON-DP MGRS          82/08/24
STAMFORD                BASIC REPORT PREP DP MGRS      82/08/02
                        HOST LANGUAGE INTERFACE        82/10/21
UNIONDALE               BASIC REPORT PREP FOR PROG     81/11/16
                        FILE DESCRPT & MAINT           81/11/15

Datenformate gemeinsam verwendeter Felder

Die Felder, die die gemeinsam verwendeten·Werte in der Host- und Querverweisdatei enthalten, müssen generell dasselbe Datenformat haben.

Wenn Sie mehrere Hostdateifelder angeben, behandelt der Befehl JOIN die Felder als ein verkettetes Feld. Fügen Sie die Feldformatlängen hinzu, um die Länge des verketteten Feldes zu erhalten. Sie müssen die folgenden Regeln beachten:

Wenn das Hostfeld alphanumerisch ist, muss das Querverweisfeld auch alphanumerisch sein und dieselbe Länge haben.
Die Formate können unterschiedliche Bearbeitungsoptionen haben.

Beachten Sie, dass Textfelder nicht verwendet werden können, um Datenquellen zu verbinden.
Wenn das Hostfeld ein numerisches Feld ist, muss das Hostfeldformat, das durch das Attribut USAGE oder FORMAT in der Masterdatei angegeben wurde, mit dem Formattyp (I, P, F oder D) des Querverweisfeld, das durch das Attribut USAGE oder FORMAT angegeben wurde, übereinstimmen. Genaueres finden Sie unter
Felder mit unterschiedlichen numerischen Datentypen verbinden.
Die Bearbeitungsoptionen können unterschiedlich sein. Die Länge kann auch unterschiedlich sein, was aber Folgendes bewirkt:
- Wenn das Format des Hostfeldes (das durch das Attribut USAGE angegeben wurde) gepackte Dezimalzahl (P) oder ganze Zahl (I) ist und länger ist als das Format des Querverweisfeldes (das für FOCUS-Datenquellen durch das Attribut USAGE und für andere Datenquellen durch das Attribut ACTUAL angegeben ist), wird nur die Länge des Formats des Querverweisfeldes verglichen, wobei nur die Ziffern ganz rechts des kürzeren Feldes verwendet werden. Wenn z. B. ein Feld mit einer gepackten Dezimalzahl mit fünf Stellen mit einem Feld mit einer gepackten Dezimalzahl mit drei Stellen verbunden wird, werden beim Abruf des Hostdatensatzes mit einer fünfstelligen Zahl auch alle Querverweisdatensätze abgerufen, die die letzten drei Stellen dieser Zahl besitzen.
- Es werden die linken acht Bytes aller Felder verglichen, wenn das Format des Hostfeldes Doppelpräzision (D) ist.
Das Querverweisfeld muss, wenn das Hostfeld ein Datumsfeld ist, ebenfalls ein Datumsfeld sein. Datums- und Datum-Zeit-Felder müssen dieselben Komponenten besitzen, aber nicht unbedingt in derselben Reihenfolge.
Die Host- und Querverweisfelder können als Gruppen in der Masterdatei beschrieben werden, falls sie dieselbe Anzahl Komponentenfelder besitzen. Die entsprechenden Komponentenfelder in jeder Gruppe (z. B. das erste Feld in der Hostgruppe und das erste Feld in der Querverweisgruppe) müssen die obigen Regeln befolgen. Weitere Informationen zu diesem Thema finden Sie unter Beschränkungen für Gruppenfelder.
Wenn das Hostfeld kein Gruppenfeld ist, kann das Querverweisfeld trotzdem eine Gruppe sein. Wenn das Hostfeld eine Gruppe ist, muss das Querverweisfeld auch eine Gruppe sein.

Felder mit unterschiedlichen numerischen Datentypen verbinden

Vorgehensweise:

Joins mit Datentypkonvertierung aktivieren

Sie können zwei oder mehrere Datenquellen verbinden, die unterschiedliche numerische Datentypen enthalten. Sie können z. B. ein Feld mit dem Format kurze gepackte Dezimalzahl mit einem Feld mit dem Format lange gepackte Dezimalzahl verbinden. Dies gilt auch für ein Feld mit dem Format ganze Zahl und ein Feld mit dem Format gepackte Dezimalzahl. Dies verschafft Ihnen enorme Flexibilität beim Erstellen von Reports aus verbundenen Datenquellen.

Der Querverweiswert wird, wenn Sie ein kürzeres Feld mit einem längeren Feld verbinden, auf die Länge des Hostfeldes verlängert, wobei zusätzliche Leerstellen (für Alphafelder) oder hexadezimale Nullen (für numerische Felder) hinzugefügt werden. Dieser neue Wert wird für das Suchen in der Querverweisdatei verwendet.
Wenn ein längeres Feld mit einem kürzeren Feld verbunden wird, wird der FROM-Wert abgeschnitten. Wenn ein Teil Ihres Wertes aufgrund der Länge von USAGE in der Querverweisdatei abgeschnitten wurde, befinden sich in der Querverweisdatei nur Datensätze, die mit dem abgeschnittenen Wert übereinstimmen.

Hinweis:

Damit Vergleiche von Feldern mit gepackten Dezimalzahlen richtig durchgeführt werden können, werden alle Zeichen für positive Werte in Hex C und alle Zeichen für negative Werte in Hex D umgewandelt.
Der JOINOPT-Parameter korrigiert auch Verzögerungswerte in einem eindeutigen Join. Informationen finden Sie unter Verzögerungswerte mit einem eindeutigen Join korrigieren.

Nach oben

Syntax: Joins mit Datentypkonvertierung aktivieren

Geben Sie, um Joins mit Datentypkonvertierung zu aktivieren, den folgenden Befehl aus

SET JOINOPT = [NEW|OLD]

Hierbei gilt:

NEW: Aktiviert Joins mit Datentypkonvertierung.
OLD: Deaktiviert Joins mit Datentypkonvertierung. Dieser Wert ist der Defaultwert.

Nach oben

Beispiel: Joins mit Datentypkonvertierung ausgeben

Da Sie ein Feld mit dem Format kurze gepackte Dezimalzahl mit einem Feld mit dem Format lange gepackte Dezimalzahl verbinden können, kann in der folgenden Masterdatei ein Join definiert werden:

FILE=PACKED,SUFFIX=FIX,$
  SEGNAME=ONE,SEGTYPE=S0
   FIELD=FIRST,,P8,P4,INDEX=I,$

FILE=PACKED2,SUFFIX=FIX,$
  SEGNAME=ONE,SEGTYPE=S0
   FIELD=PFIRST,,P31,P16,INDEX=I,$

Der JOIN-Befehl kann folgendermaßen aussehen:

JOIN FIRST IN PACKED TO ALL PFIRST IN PACKED2 AS J1

Das bevorzugte Zeichenformat X'C' für positive Werte und X'D' für negative Wert wird weiterhin benötigt, wenn Sie gepackte Felder verbinden. Alle anderen nicht bevorzugten Zeichen werden entweder in X'C' oder X'D' umgewandelt.