EXTRACT-Befehl

Konzept-Informationen

Extrahiert Daten aus einer Analytics-Tabelle und gibt sie in eine neue Analytics-Tabelle aus oder fügt sie an eine bestehende Analytics-Tabelle an. Es können entweder komplette Datensätze oder einzelne Felder extrahiert werden.

Syntax

EXTRACT {RECORD|FIELDS Feldname <AS Neuer_Feldname> <...n>|FIELDS ALL} <Name_der_verbundenen_Tabelle.ALL <...n>> <EXCLUDE Feldname <...n>> TO Tabellenname <LOCAL> <IF Test> <WHILE Test> <FIRST Bereich|NEXT Bereich> <EOF> <APPEND> <OPEN>

Parameter

Name	Beschreibung
RECORD \| FIELDS Feldname \| FIELDS ALL	Die in die Ausgabe einzuschließenden Felder: RECORD Den gesamten Datensatz in der Quelldatendatei verwenden: alle Felder der Tabelle und undefinierte Teile des Datensatzes Felder werden in derselben Reihenfolge verwendet, in der sie im Tabellenlayout angezeigt werden. Erhält Kalkulationsfelder aufrecht. FIELDS Feldname Die angegebenen Felder verwenden Felder werden in derselben Reihenfolge verwendet, in der Sie sie auflisten. Wenn Sie ein Feld aus einer verbundenen Tabelle verwenden möchten, geben Sie Name_der_verbundenen_Tabelle.Feldname an. Wandelt Kalkulationsfelder in der Zieltabelle in physische Felder des jeweiligen Datentyps um – ASCII oder Unicode (je nach Analytics-Edition), ACL (der systemeigene numerische Datentyp), Datumzeit oder logisch. Füllt die physischen Felder mit den tatsächlich berechneten Werten. FIELDS ALL Alle Felder der Tabelle verwenden Felder werden in derselben Reihenfolge verwendet, in der sie im Tabellenlayout angezeigt werden. Wandelt Kalkulationsfelder in der Zieltabelle in physische Felder des jeweiligen Datentyps um – ASCII oder Unicode (je nach Analytics-Edition), ACL (der systemeigene numerische Datentyp), Datumzeit oder logisch. Füllt die physischen Felder mit den tatsächlich berechneten Werten.
AS Neuer_Feldname Optional	Nur beim Extrahieren mit FIELDS Feldname gültig. Der neue physische Name und der Anzeigename (alternative Spaltentitel) für das Feld in der Ausgabetabelle. Alle Sonder- oder Leerzeichen, die Sie angeben, werden im Anzeigenamen beibehalten und im physischen Feldnamen im Tabellenlayout automatisch in Unterstriche (_) umgewandelt. Geben Sie Neuer_Feldname als eine in Anführungszeichen gesetzte Zeichenfolge an. Verwenden Sie zwischen den Wörtern ein Semikolon (;), wenn Sie die Zeilen in dem Anzeigenamen umbrechen möchten. Hinweis AS funktioniert nur für das Extrahieren in eine neue Tabelle. Wenn Sie an eine bestehende Tabelle anfügen, haben die physischen Feldnamen und Anzeigenamen in der bestehenden Tabelle Vorrang.
Name_der_verbundenen_Tabelle.ALL Optional	Verwenden Sie alle Felder in der angegebenen verbundenen Tabelle.
EXCLUDE Feldname Optional	Nur beim Extrahieren mit FIELDS ALL oder Name_der_verbundenen_Tabelle.ALL gültig. Die Felder, die von dem Befehl ausgeschlossen werden sollen. Durch EXCLUDE können Sie eine Feinanpassung des Schlüsselworts ALL vornehmen, indem Sie die angegebenen Felder ausschließen. EXCLUDE muss unmittelbar auf FIELDS ALL folgen, oder auf das letzte Vorkommen des Schlüsselworts ALL, wenn Sie Felder aus einer oder mehreren verbundenen Tabellen einschließen. Beispiel: FIELDS ALL EXCLUDE Feld_1 Feld_2 FIELDS ALL Name_der_verbundenen_Tabelle.ALL EXCLUDE Feld_1 Feld_2
TO Tabellenname	Der Ort, an den die Ergebnisse des Befehls gesendet werden sollen: Tabellenname Speichert die Ergebnisse in einer Analytics-Tabelle. Geben Sie Tabellenname als in Anführungszeichen gesetzte Zeichenfolge mit der Dateierweiterung „.FIL“ an. Beispiel: TO "Ausgabe.FIL" Standardmäßig wird die Tabellendatendatei (.FIL) im Ordner mit dem Analytics-Projekt gespeichert. Verwenden Sie entweder einen absoluten oder relativen Dateipfad, um die Datendatei in einen anderen bestehenden Ordner zu speichern: TO "C:\Ausgabe.FIL" TO "Ergebnisse\Ausgabe.FIL" Hinweis Tabellennamen sind auf 64 alphanumerische Zeichen beschränkt, was die .FIL-Dateierweiterung nicht einbezieht. Der Name kann einen Unterstrich beinhalten ( _ ), aber keine anderen Sonderzeichen oder Leerzeichen. Er kann nicht mit einer Ziffer beginnen.
LOCAL Optional	Speichert die Ausgabedatei am selben Speicherort wie das Analytics-Projekt. Hinweis Nur anwendbar, wenn der Befehl für eine Servertabelle ausgeführt wird und die Ausgabedatei eine Analytics-Tabelle ist. Der LOCAL-Parameter muss unmittelbar auf den TO-Parameter folgen.
IF Test Optional	Ein bedingter Ausdruck, der wahr sein muss, damit ein Datensatz verarbeitet wird. Der Befehl wird nur für Datensätze ausgeführt, welche die Bedingung erfüllen. Hinweis Der IF-Parameter wird nur für Datensätze ausgewertet, die nach Anwendung von Bereichsparametern (WHILE, FIRST, NEXT) in einer Tabelle übrig sind.
WHILE Test Optional	Ein bedingter Ausdruck, der wahr sein muss, damit ein Datensatz verarbeitet wird. Der Befehl wird ausgeführt, bis die Bedingung falsch ist oder das Tabellenende erreicht wurde. Hinweis Wenn Sie WHILE zusammen mit FIRST oder NEXT verwenden, endet die Datensatzverarbeitung, sobald eine Grenze erreicht wird.
FIRST Bereich \| NEXT Bereich Optional	Die Anzahl der zu verarbeitenden Datensätze: FIRST Verarbeitung beim ersten Datensatz beginnen, bis die angegebene Datensatzanzahl erreicht wird NEXT Verarbeitung beim aktuell ausgewählten Datensatz beginnen, bis die angegebene Datensatzanzahl erreicht wird Verwenden Sie Bereich, um die Anzahl der zu verarbeitenden Datensätze anzugeben. Wenn Sie FIRST und NEXT nicht angeben, werden standardmäßig alle Datensätze verarbeitet.
EOF Optional	Führen Sie den Befehl noch einmal aus, nachdem das Ende der Datei erreicht wurde. Dies stellt sicher, dass der letzte Datensatz in der Tabelle verarbeitet wird, wenn ein GROUP-Befehl verwendet wird. Verwenden Sie EOF nur, wenn alle Felder Kalkulationsfelder sind, die auf frühere Datensätze verweisen.
APPEND Optional	Hängt die Befehlsausgabe an das Ende einer vorhandenen Datei an, statt die Datei zu überschreiben. Hinweis Vergewissern Sie sich, dass die Struktur der Befehlsausgabe und der bestehenden Datei identisch sind: dieselben Felder dieselbe Feldanordnung abzugleichende Felder mit derselben Länge abzugleichende Felder mit demselben Datentyp Analytics hängt eine Ausgabe an eine bestehende Datei beliebiger Struktur an. Falls die Struktur der Ausgabe und der bestehenden Datei nicht übereinstimmen, kann die Datenintegrität verletzt sein, es können Daten fehlen oder falsch sein.
OPEN Optional	Öffnet die durch den Befehl erstellte Tabelle, nachdem der Befehl ausgeführt wird. Nur gültig, wenn der Befehl eine Ausgabetabelle erstellt.

Beispiele

Alle Datensätze einer Tabelle in eine neue Tabelle extrahieren

Sie erstellen ein exaktes Duplikat der Tabelle Kundenforderung, indem alle Datensätze in eine neue Analytics-Tabelle extrahiert werden. Kalkulationsfelder bleiben als Kalkulationsfelder erhalten:

OPEN Kundenforderung
EXTRACT RECORD TO "Kundenforderung_2"

Alle Felder einer Tabelle in eine neue Tabelle extrahieren

Sie extrahieren alle definierten Felder der Tabelle Kundenforderung in eine neue Analytics-Tabelle. Kalkulationsfelder werden in physische Felder konvertiert, die mit den tatsächlich berechneten Werten aufgefüllt wurden:

OPEN Kundenforderung
EXTRACT FIELDS ALL TO "Kundenforderung_2"

Alle Datensätze in eine Tabelle extrahieren und an eine vorhandene Tabelle anhängen

Sie extrahieren alle Datensätze in die Tabelle Kundenforderung und hängen sie als Gruppe an das Ende der Tabelle Kundenstamm an:

OPEN Kundenforderung
EXTRACT RECORD TO "Kundenstamm" APPEND

Alle Datensätze in eine Tabelle extrahieren und an eine vorhandene Tabelle in einem anderen Ordner anhängen

Sie extrahieren alle Datensätze in die Tabelle Kundenforderung und hängen sie als Gruppe an das Ende der Tabelle Kundenstamm an, die sich in einem anderen Ordner als dem Analytics-Projektordner befindet:Analytics

OPEN Kundenforderung
EXTRACT RECORD TO "C:\Benutzer\Kundendaten\Kundenstamm" APPEND

Eine Untermenge von Feldern einer Tabelle in eine neue Tabelle extrahieren

Wenn Sie eine Teilmenge der Felder einer Tabelle extrahieren, haben Sie zwei Möglichkeiten:

zu extrahierende einzelne Felder festlegen
FIELDS ALL festlegen und von Extrahierung auszuschließende Felder angeben

Tipp

Verwenden Sie die Methode, die am wenigsten arbeitsaufwendig ist.

Die folgenden Beispiele beziehen sich auf die Tabelle Kundenforderung mit sieben Feldern:

Referenznummer
Kundennummer
Kundenname
Transaktionstyp
Rechnungsdatum
Fälligkeitsdatum
Rechnungsbetrag

Zu extrahierende Felder festlegen

Sie extrahieren drei Felder der Tabelle Kundenforderung in eine neue Analytics-Tabelle:Analytics

OPEN Kundenforderung
EXTRACT FIELDS Name Fälligkeit Datum TO "Kundenforderung_Datum.fil"

FIELDS ALL festlegen und auszuschließende Felder angeben

Sie extrahieren alle Felder der Tabelle Kundenforderung in eine neue Analytics-Tabelle, außer das Feld „Referenznummer“:Analytics

OPEN Kundenforderung
EXTRACT FIELDS ALL EXCLUDE Referenznummer TO "Kundenforderungsdaten.fil"

Neue Namen für extrahierte Felder erstellen

Sie extrahieren drei Felder der Tabelle Kundenforderung und erstellen in der neuen Analytics-Tabelle neue physische Namen und Anzeigenamen für diese Felder:Analytics

OPEN Kundenforderung
EXTRACT FIELDS Name AS "Kunde;Name" Fällig AS "Fälligkeits-;datum" Datum AS "Rechnungs-;datum" TO "Kundenforderung_Datum.fil"

Durch die Semikolons (;) zwischen den Wörtern wird ein Zeilenumbruch in den Anzeigenamen erzeugt. In den physischen Feldnamen werden die Semikolons automatisch in Unterstriche (_) umgewandelt.

Felder auf Basis einer Bedingung extrahieren

Sie extrahieren drei Felder aus der Tabelle Kundenforderung in eine neue Analytics-Tabelle, falls das Datum des Felds Fälligkeit vor dem 1. Juli 2014 liegt:Analytics

OPEN Kundenforderung
EXTRACT FIELDS Name Fällig Datum IF Fällig < `20140701` TO "Überfällig.fil"

Bemerkungen

Weitere Informationen über die Funktionsweise dieses Befehls finden Sie unter Extrahieren von Daten oder Extrahieren und Anhängen von Daten.

EXTRACT gegenüber dem Kopieren einer Tabelle

EXTRACT erstellt eine neue Quelldatendatei (.fil) und ein neues Tabellenlayout.

Beim Kopieren einer Tabelle im Navigator (Bearbeiten > Kopieren) wird ein neues Tabellenlayout erstellt, das weiterhin der ursprünglichen Quelldatendatei zugeordnet ist. Es wird keine neue Datendatei erstellt.