0 / 0

Verwaltung von Umgebungsvariablen in DataStage

Letzte Aktualisierung: 10. Juli 2025
Umgebungsvariablen in DataStage verwalten

Sie können Umgebungsvariablen für IBM® DataStage® auf verschiedene Arten verwalten.

In DataStage können Sie Umgebungsvariablen auf drei verschiedene Arten verwalten: auf Projektebene, auf Flow-Ebene und über die dsjob-Befehlszeilen-Schnittstelle (CLI).

Projektebene

Führen Sie die folgenden Schritte aus, um Umgebungsvariablen auf Projektebene einzurichten:
  1. Öffnen Sie ein Projekt und klicken Sie dann auf die Registerkarte Verwalten .
  2. Klicken Sie auf Umgebungen > Vorlagen > Neue Vorlage + oder bearbeiten Sie eine vorhandene Vorlage, indem Sie sie öffnen, auf Neue Umgebungsvariable + klicken und ein Schlüssel/Wert-Paar hinzufügen.
  3. Geben Sie die Umgebungsdetails und die Konfiguration an.
  4. Geben Sie im Feld Umgebungsvariablen Laufzeitumgebungsvariablen unter Verwendung eines Name/Wert-Paars an.
    Zum Beispiel:
    CC_MSG_LEVEL=1
APT_CONFIG_FILE=/ds-storage/2nodes.apt
  5. Klicken Sie auf Erstellen.
  6. Klicken Sie in einem DataStage -Flow auf das Symbol Einstellungen in der Symbolleiste und anschließend auf der Seite Einstellungen auf Ausführen .
  7. Wählen Sie die Umgebung aus, die Sie erstellt haben, und klicken Sie anschließend auf Speichern.

DataStage -Ablaufebene

Führen Sie die folgenden Schritte aus, um Umgebungsvariablen auf Ablaufebene auszuwählen:
  1. Öffnen Sie einen DataStage -Ablauf.
  2. Klicken Sie in der Symbolleiste auf das Symbol "Parameter hinzufügen" ({#}).
  3. Wählen Sie mindestens eine Umgebungsvariable aus der Liste der verfügbaren Umgebungsvariablen aus.
  4. Klicken Sie auf Hinzufügenund anschließend auf Zum Erstellungsbereich zurückkehren.

Befehlszeilenschnittstelle (CLI)

Sie können Umgebungsvariablen über die Befehlszeilenschnittstelle übergeben. Beispiel:
cpdctl dsjob run --job "TestSimpleJavaWriteJSON.DataStage job" --project Project2021 --wait 300 --param FILE_NAME=/ds-storage/output/MySales5k.json --env "\$CC_MSG_LEVEL"="1"

Weitere Informationen finden Sie unter DataStage -Befehlszeilentools.

Überschreibungsregeln

Die folgenden Überschreibungsregeln gelten für die Umgebungsvariablen:
  • dsjob CLI-Umgebungsvariablen überschreiben DataStage -Umgebungsvariablen auf Ablaufebene.
  • DataStage -Umgebungsvariablen auf Ablaufebene überschreiben Umgebungsvariablen auf Laufzeitumgebungsebene.

Umgebungsvariablen, die standardmäßig definiert sind

Die folgende Liste enthält Umgebungsvariablen, die standardmäßig definiert sind.

APT_OLD_BOUNDED_LENGTH
  • Cloud Pak for Data Einstellung: APT_OLD_BOUNDED_LENGHT = true
  • Cloud Pak for Data Verhalten: Die Art und Weise, wie PX intern mit Strings begrenzter Länge und Rohfeldern umgeht, wurde von der Behandlung der Felder als variable Länge auf feste Länge geändert. Dies wurde getan, um die Leistung der Datensatzverarbeitung zu verbessern. Sie wird auf true gesetzt, um in den alten Datensätzen mit variablem Längenformat geschriebene Daten zu lesen.
  • Traditionelle (11.7) Standardverhaltenseinstellung: APT_OLD_BOUNDED_LENGTH = false
  • Verhalten bei traditioneller (11.7) Einstellung: Datensätze, die im alten variablen Längenformat geschrieben wurden, können nicht gelesen werden.
APT_THREAD_SAFE_FAST_ALLOC
  • Cloud Pak for Data Einstellung: APT_THREAD_SAFE_FAST_ALLOC = threadsafe
  • Cloud Pak for Data behavior: Der Wert string gibt den Threading-Modus für schnelle Allokatoren an, die für die Zuweisung häufig verwendeter Objekte wie Strings verwendet werden: 'threadsafe'. Instanzen von Schnellzuweisern werden im thread-spezifischen Speicher gehalten.
  • Traditionelle (11.7) Standardverhaltenseinstellung: APT_ THREAD_SAFE_FAST_ALLOC = legacy (oder) false
  • Verhalten bei traditioneller (11.7) Einstellung: Fast-Allocator-Instanzen werden zwischen Threads geteilt.
APT_DONT_ALLOW_DOUBLE_TSORT_COMBINE
  • Cloud Pak for Data Einstellung: APT_DONT_ALLOW_DOUBLE_TSORT_COMBINE = true
  • Cloud Pak for Data Verhalten: Standardmäßig führt der kombinierte Operator-Controller so viele tsort-Operatoren wie möglich zusammen. Sie ist auf "true" definiert, damit der kombinierte Operator nicht mehr als einen tsort-Operator zusammenführt, wenn dem kombinierten Operator in der nachgelagerten Stufe ein join folgt. Dies wird hinzugefügt, um hängende Szenarien zu vermeiden, die tsort-join Phasen beinhalten.
  • Traditionelle (11.7) Standardverhaltenseinstellung: APT_ DONT_ALLOW_DOUBLE_TSORT_COMBINE = false
  • Verhalten bei traditioneller (11.7) Einstellung: Kombinierter Operator-Controller kombiniert so viele tsort-Operatoren wie möglich.
APT_SCRATCH_RESERVE_MB
  • Cloud Pak for Data Einstellung: APT_SCRATCH_RESERVE_MB = 10
  • Cloud Pak for Data Verhalten: Operatoren wie Sortieren oder Puffern verwenden die Scratch-Disk. Wenn auf der Scratch-Disk ein Minimum an freiem Speicherplatz vorhanden ist, wird die Scratch-Disk zum Erstellen von Scratch-Dateien verwendet. Wenn der freie Speicherplatz weniger als die Mindestgröße beträgt, wird die nächste Scratch-Disk verwendet, die die Kriterien für den Mindestfreiraum erfüllt. Sie wird angewendet, wenn mehrere Scratch-Disks in APT_CONFIG_FILE definiert sind.
  • Traditionelle (11.7) Standardverhaltenseinstellung: APT_SCRATCH_RESERVE_MB = false
  • Verhalten bei traditioneller (11.7) Einstellung: Der Standard-Scratch-Speicherplatz von 2GB wird verwendet.
APT_DISABLE_JOBMON_SCHEMA_STRING
  • Cloud Pak for Data Einstellung: APT_DISABLE_JOBMON_SCHEMA_STRING = true
  • Cloud Pak for Data Verhalten: Deaktiviert das Senden von Schemainformationen in Linkstats-Nachrichten an den Jobmonitor.
  • Traditionelle (11.7) Standardverhaltenseinstellung: APT_DISABLE_JOBMON_SCHEMA_STRING = false
  • Verhalten bei traditioneller (11.7) Einstellung: Sendet Schemainformationen in Linkstats. Derzeit verarbeitet Cloud Pak for Data keinen Schema-String aus Linkstats. Schemainformationen können deaktiviert werden.
APT_DS_COMPRESSION
  • Cloud Pak for Data Einstellung: APT_DS_COMPRESSION = true
  • Cloud Pak for Data Verhalten: Die Variable aktiviert die Komprimierung für Datensätze.
  • Traditionelle (11.7) Standardverhaltenseinstellung: APT_DS_COMPRESSION = false
  • Verhalten bei traditioneller (11.7) Einstellung: Die Datensätze werden nicht komprimiert.
APT_IMPORT_FORCE_QUOTE_DELIM
  • Cloud Pak for Data Einstellung: APT_IMPORT_FORCE_QUOTE_DELIM = true
  • Cloud Pak for Data Verhalten: Standardmäßig sucht der Import für Felder mit Anführungszeichen nach einem öffnenden und schließenden Anführungszeichen. Wenn die Felddaten zufällig das Anführungszeichen enthalten, wird dieses Zeichen fälschlicherweise als das schließende Anführungszeichen angenommen. Wenn Sie diese Umgebungsvariable setzen, erkennt import nur ein schließendes Anführungszeichen, auf das das Feldbegrenzungszeichen folgt. Durch diese Änderung kann das Feld eingebettete Anführungszeichen enthalten und korrekt importiert werden.
  • Traditionelle (11.7) Standardverhaltenseinstellung: APT_IMPORT_FORCE_QUOTE_DELIM = false
  • Verhalten bei der Einstellung Traditionell (11.7): Beim Import von Feldern mit eingebetteten Anführungszeichen wird der Datensatz nicht importiert. Standardmäßig wird eine Warnung ausgegeben und die Datensätze werden abgelehnt.
APT_TSORT_SCRATCH_COMPRESSION
  • Cloud Pak for Data Einstellung: APT_TSORT_SCRATCH_COMPRESSION = true
  • Cloud Pak for Data Verhalten: Tsort Scratch-Dateien werden im komprimierten Modus auf die Festplatte geschrieben, um Platz zu sparen.
  • Traditionelle (11.7) Standardverhaltenseinstellung: APT_TSORT_SCRATCH_COMPRESSION = false
  • Verhalten bei traditioneller (11.7) Einstellung: Tsort Scratch-Dateien werden ohne Komprimierung auf die Festplatte geschrieben.
APT_DOWNGRADED_MESSAGES
  • Cloud Pak for Data Einstellung: APT_DOWNGRADED_MESSAGES = "Picked up JAVA_TOOL_OPTIONS:"
  • Cloud Pak for Data Verhalten: Konvertiert den Schweregrad von ausgegebenen Orchestrate-Fehler- oder Warnmeldungen in Informational für Meldungen mit der Zeichenfolge "Picked up JAVA_TOOL_OPTIONS:".
  • Traditionelle (11.7) Standardverhaltenseinstellung: APT_DOWNGRADED_MESSAGES = false
  • Verhalten bei der Einstellung Traditionell (11.7): Es werden keine Meldungen zurückgestuft. Der Benutzer kann diese jedoch mit neuen Werten überschreiben. Das Format dieser Variablen ist eine Liste von vollständigen oder teilweisen Fehler- oder Warnmeldungen, die ihren Schweregrad ändern müssen, um ohne Zeitstempel zu informieren. Jede Nachricht wird durch eine eindeutige Zeichenfolge getrennt - #?#.
  • Beispiel: APT_DOWNGRADED_MESSAGES = READ is not supported in state standby#?#IPv6 is not currently supported.
APT_IMPEXP_INFER_EOL_RECORD_DELIM
  • Cloud Pak for Data Einstellung: APT_IMPEXP_INFER_EOL_RECORD_DELIM = true
  • Cloud Pak for Data Verhalten: Die sequentielle Datei-Importschicht sucht nach Windows EOL-Datensatzbegrenzern, wenn Unix EOL-Datensatzbegrenzer gesetzt sind, und ermöglicht den korrekten Import der Datei.
  • Traditionelle (11.7) Standardverhaltenseinstellung: APT_IMPEXP_INFER_EOL_RECORD_DELIM = false
  • Verhalten bei traditioneller (11.7) Einstellung: Die Importschicht für sequentielle Dateien sucht nur nach dem in den Importeigenschaften festgelegten EOL-Datensatzbegrenzer.