DEFINE TABLE DB-Befehl

Definiert eine Analytics-Servertabelle durch das Verbinden mit einer Datenbanktabelle in AX-Konnector. Sie können sich mit einer Microsoft-SQL-Server-, Oracle- oder DB2-Datenbank verbinden.

Syntax

DEFINE TABLE DB {SOURCE Datenbankprofil <PASSWORD Zahl> <PASSWORD Zahl> | SERVER Serverprofil <PASSWORD Zahl>} <FORMAT Formatname> SCHEMA Schema <TITLED ACL_Tabellenname> <PRIMARY|SECONDARY> DBTABLE DB_Tabellenname FIELDS {Feldnamen|ALL} <...n> <WHERE Bedingung> <ORDER Feldnamen>

Parameter

SOURCE Datenbankprofil

Das Analytics-Datenbankprofil, das für den Zugriff auf das Datenbankmodul verwendet werden soll.

Datenbankprofile enthalten erforderliche Informationen zum Herstellen einer Verbindung mit der Datenbank-Engine, darunter:

  • eine Referenz auf das zugehörige Serverprofil
  • den Datenbanktyp
  • den Datenbanknamen
  • Benutzerkontoinformationen

Hinweis

DEFINE TABLE DB unterstützt nur Verbindungen mit den folgenden Datenbanken: Microsoft SQL Server, Oracle oder DB2.

PASSWORD Zahl

Optional

Die zu verwendende Kennwortdefinition.

Sie verwenden nicht PASSWORD Zahl, um ein tatsächliches Kennwort abzurufen oder festzulegen. Die Kennwortdefinition bezieht sich auf ein vorher angegebenes oder ein mit dem PASSWORD-, dem SET-PASSWORD-Befehl oder dem PASSWORD-Analysetag festgelegtes Kennwort.

Zahl bezieht sich auf die Zahl der Kennwortdefinition. Wenn beispielsweise zuvor zwei Kennwörter in einem Skript angegeben bzw. festgelegt wurden oder falls eine Analyse geplant wurde, wird mit PASSWORD 2 angegeben, dass das zweite Kennwort verwendet wird.

Weitere Informationen über die Angabe oder das Festlegen von Kennwörtern finden Sie unter:

Das Kennwort wird nur benötigt, wenn im Datenbankprofil keine Kennwörter gespeichert sind. Verwenden Sie PASSWORD zweimal nach dem Schlüsselwort SOURCE. Das erste Kennwort dient zum Server-Login, das zweite zum Datenbank-Login.

SERVER Serverprofil

Nicht mehr verwendet.

Vor der Version 10.0 von Analytics wurde dies zur Verbindung mit ACL Server Edition für z/OS verwendet. Seit Analytics Version 10.0 ist ACL Server Edition für z/OS nicht mehr enthalten.

FORMAT Formatname

Optional

Der Name einer Analytics-Tabelle oder einer Tabellenlayout-Datei (.layout) mit einem zu verwendenden Tabellenlayout.

SCHEMA Schema

Das Schema, mit dem eine Verbindung hergestellt werden soll. Der Schemaname muss in Anführungszeichen eingeschlossen werden.

TITLED ACL_Tabellenname

Optional

Der Name der zu erstellenden Analytics-Tabelle.

ACL_Tabellenname muss eine in Anführungszeichen gesetzte Zeichenfolge sein. Wenn Sie TITLED nicht angeben, verwendet Analytics den Datenbanktabellennamen. Wenn Sie auf mehrere Tabellen gleichzeitig zugreifen, verwendet Analytics den Namen der ersten Tabelle.

PRIMARY | SECONDARY

Optional

Verwenden Sie die Tabelle in Befehlen, die mehrere Dateien betreffen, als Primär- oder Sekundärtabelle. Wird keiner der beiden Optionen angegeben, wird der Standardwert PRIMARY verwendet.

DBTABLE Datenbanktabelle

Die Datenbanktabelle, auf die Sie zugreifen möchten. Datenbanktabelle muss eine in Anführungszeichen gesetzte Zeichenfolge sein.

FIELDS Feldnamen | ALL

Die in die Ausgabe einzuschließenden Felder:

  • FIELDS Feldnamen die angegebenen Felder verwenden

    Feldnamen muss eine in Anführungszeichen gesetzte Zeichenfolge sein.

  • ALL alle Felder der Tabelle auswählen

So verwenden Sie Felder aus mehr als einer Tabelle:

  1. Geben Sie den ersten Tabellennamen gefolgt von den Feldern dieser Tabelle ein.
  2. Geben Sie den nächsten Tabellennamen gefolgt von den Feldern dieser Tabelle ein.
  3. Für jede zusätzliche Tabelle wiederholen Sie den Schritt b).
DBTABLE "DSN1310" FIELDS "Feld_A Feld_B Feld_C"
DBTABLE "DSN2516" FIELDS "Feld_L Feld_M Feld_N"

Hinweis

Mithilfe von AX-Konnektor können Sie auf beliebig viele verbundene Tabellen zugreifen, es wird jedoch empfohlen, eine Anzahl von fünf nicht zu überschreiten. Beim Zugriff auf mehrere Tabellen erhöht sich die Verarbeitungszeit.

WHERE Bedingung

Optional

Eine SQL-WHERE-Klausel, die Daten auf diejenigen Datensätze begrenzt, welche die angegebene Bedingung erfüllen.

Sie müssen gültige SQL-Syntax als Zeichenfolge in Anführungszeichen eingeben.

Wenn Sie Tabellen zusammenführen, wird in Analytics die Bedingung für die Zusammenführung in der WHERE-Klausel angezeigt:

"Tabelle_1.Vorname = Tabelle_2.Vorname"
ORDER Feldnamen

Optional

Die Felder, welche die Datenbank-Engine zur Sortierung der Datensätze verwendet. Feldnamen muss eine in Anführungszeichen gesetzte Zeichenfolge sein.

Die Ausführung des Befehls dauert länger, wenn Datensätze sortiert werden. Verwenden Sie ORDER nur dann, wenn die Sortierung wichtig ist.

Beispiele

Beispiel

Sie möchten über AX-Konnektor auf Daten einer Microsoft-SQL-Server-Datenbank zugreifen. Dafür verwenden Sie den Befehl DEFINE TABLE DB. Sie schließen den SOURCE-Parameter ein, um eine Verbindung mit AX-Konnektor über ein Datenbankprofil herzustellen:

DEFINE TABLE DB SOURCE "SQLServer_Prüfung" SCHEMA "Personal" TITLED "Lohnbuch" DBTABLE "HR.Mitarbeiter" FIELDS "Mitarbeiternr" DBTABLE "HR.ZahlungsverlaufMitarbeiter" FIELDS "Zahlungshäufigkeit" WHERE "HR.Mitarbeiter.Mitarbeiternr=HR.ZahlungsverlaufMitarbeiter.Mitarbeiternr"

Bemerkungen

Funktionsweise

Die Analytics-Servertabelle wird als Abfrage definiert, die ein Datenbankprofil verwendet, um eine Verbindung mit einer Datenbanktabelle herzustellen.

Den Zeitbestandteil von Datumzeit-Werten unterdrücken

Stellen Sie dem Befehl DEFINE TABLE DB den Befehl SET SUPPRESSTIME voraus, um den Zeitteil von Datumzeit-Werten zu unterdrücken.

SET SUPPRESSTIME ON ist für Analytics-Skripts vor der Version 10.0 konzipiert, die davon ausgehen, dass die Zeitkomponente von Datumzeit-Werten entfernt wird. Wenn der Befehl SET SUPPRESSTIME ON diesen Skripts nicht hinzugefügt wird, können diese in der Datumzeit-aktivierten Version von Analytics nicht ausgeführt werden.

Weitere Informationen finden Sie im Abschnitt „SET SUPPRESSTIME“ von SET-Befehl.