0 / 0

Gestione delle variabili d'ambiente in DataStage

Ultimo aggiornamento: 10 lug 2025
Gestione delle variabili di ambiente in DataStage

È possibile gestire le variabili di ambiente per IBM® DataStage® in diversi modi.

In DataStage, è possibile gestire le variabili d'ambiente in tre modi diversi: a livello di progetto, a livello di flusso e utilizzando l'interfaccia a riga di comando (CLI) di dsjob.

Livello progetto

Per impostare le variabili di ambiente dal livello del progetto, completare la seguente procedura:
  1. Aprire un progetto, quindi fare clic sulla scheda Gestisci .
  2. Fare clic su Ambienti > Modelli > Nuovo modello + oppure modificare un modello esistente aprendolo, facendo clic su Nuova variabile di ambiente + e aggiungendo una coppia chiave - valore.
  3. Specificare i dettagli dell'ambiente e la configurazione.
  4. Nel campo Variabili di ambiente , specificare le variabili di ambiente di runtime utilizzando una coppia nome=valore.
    Ad esempio:
    CC_MSG_LEVEL=1
APT_CONFIG_FILE=/ds-storage/2nodes.apt
  5. Fare clic su Crea.
  6. Da un flusso di DataStage , fare clic sull'icona Impostazioni nella barra degli strumenti, quindi fare clic su Esegui nella pagina Impostazioni .
  7. Selezionare l'ambiente creato, quindi fare clic su Salva.

Livello flusso DataStage

Per selezionare le variabili di ambiente dal livello del flusso, completare la seguente procedura:
  1. Aprire un flusso DataStage .
  2. Fare clic sull'icona Aggiungi parametri ({#}) sulla barra degli strumenti.
  3. Selezionare una o più variabili di ambiente dall'elenco di variabili di ambiente disponibili.
  4. Fare clic su Aggiungi, quindi fare clic su Torna all'area di disegno.

interfaccia riga di comando (CLI, command-line interface)

Puoi passare le variabili di ambiente dalla CLI. Vedi il seguente esempio:
cpdctl dsjob run --job "TestSimpleJavaWriteJSON.DataStage job" --project Project2021 --wait 300 --param FILE_NAME=/ds-storage/output/MySales5k.json --env "\$CC_MSG_LEVEL"="1"

Per ulteriori informazioni, consultare Strumenti della riga comandiDataStage.

Sovrascrivi regole

Le seguenti regole di sovrascrittura si applicano alle variabili di ambiente:
  • Le variabili di ambiente della CLI dsjob sovrascrivono le DataStage variabili di ambiente a livello del flusso.
  • DataStage Le variabili di ambiente a livello di flusso sovrascrivono le variabili di ambiente a livello di ambiente di runtime.

Variabili d'ambiente definite per impostazione predefinita

Il seguente elenco contiene le variabili d'ambiente definite per impostazione predefinita.

APT_OLD_BOUNDED_LENGTH
  • Cloud Pak for Data impostazione: APT_OLD_BOUNDED_LENGHT = vero
  • Cloud Pak for Data comportamento: il modo in cui PX gestisce internamente le stringhe di lunghezza limitata e i campi grezzi è stato modificato, passando dal trattamento dei campi a lunghezza variabile a quello a lunghezza fissa. Ciò è stato fatto per migliorare le prestazioni di elaborazione dei record. È impostato su true per leggere i dati scritti nel vecchio formato a lunghezza variabile.
  • Impostazione di comportamento predefinita tradizionale (11.7): APT_OLD_BOUNDED_LENGTH = false
  • Comportamento con impostazione Tradizionale (11.7): I set di dati scritti nel vecchio formato a lunghezza variabile non possono essere letti.
APT_THREAD_SAFE_FAST_ALLOC
  • Cloud Pak for Data impostazione: APT_THREAD_SAFE_FAST_ALLOC = threadsafe
  • Cloud Pak for Data comportamento: La stringa di valore specifica la modalità di threading per gli allocatori veloci, usati per allocare oggetti di uso comune come le stringhe: 'threadsafe'. Le istanze degli allocatori veloci saranno mantenute all'interno della memoria specifica del thread.
  • Impostazione di comportamento predefinita tradizionale (11.7): APT_ THREAD_SAFE_FAST_ALLOC = legacy (o) false
  • Comportamento con impostazione tradizionale (11.7): Le istanze dell'allocatore veloce sono condivise tra i thread.
APT_DONT_ALLOW_DOUBLE_TSORT_COMBINE
  • Cloud Pak for Data impostazione: APT_DONT_ALLOW_DOUBLE_TSORT_COMBINE = vero
  • Cloud Pak for Data comportamento: Per impostazione predefinita, il controllore dell'operatore combinato unisce il maggior numero possibile di operatori tsort. È definito a true in modo che l'operatore combinato non unisca più di un operatore tsort se l'operatore combinato è seguito da uno stadio di join a valle. Questo viene aggiunto per evitare scenari di sospensione che coinvolgono le fasi di tsort-join.
  • Impostazione predefinita del comportamento tradizionale (11.7): APT_ DONT_ALLOW_DOUBLE_TSORT_COMBINE = false
  • Comportamento con impostazione Tradizionale (11.7): Il controllore operatore combinato combina il maggior numero possibile di operatori tsort.
APT_SCRATCH_RESERVE_MB
  • Cloud Pak for Data impostazione: APT_SCRATCH_RESERVE_MB = 10
  • Cloud Pak for Data comportamento: Operatori come sort o buffer utilizzano il disco scratch. Se nel disco di scratch è disponibile un minimo di spazio libero, il disco di scratch viene utilizzato per la creazione dei file di scratch. Se lo spazio libero è inferiore al minimo di MB, viene utilizzato il disco scratch successivo che soddisfa i criteri di spazio libero minimo. Viene applicato quando in APT_CONFIG_FILE sono definiti più dischi di scratch.
  • Impostazione di comportamento predefinita tradizionale (11.7): APT_SCRATCH_RESERVE_MB = false
  • Comportamento con impostazione tradizionale (11.7): Viene utilizzato uno spazio di riserva predefinito di 2GB.
APT_DISABLE_JOBMON_SCHEMA_STRINGA
  • Cloud Pak for Data impostazione: APT_DISABLE_JOBMON_SCHEMA_STRING = vero
  • Cloud Pak for Data comportamento: Disabilita l'invio di informazioni sullo schema nei messaggi di linkstats al monitor dei lavori.
  • Impostazione di comportamento predefinita tradizionale (11.7): APT_DISABLE_JOBMON_SCHEMA_STRING = false
  • Comportamento con impostazione Tradizionale (11.7): invia informazioni sullo schema in linkstats. Attualmente Cloud Pak for Data non elabora le stringhe dello schema da linkstats. Le informazioni sullo schema possono essere disabilitate.
APT_DS_COMPRESSIONE
  • Cloud Pak for Data impostazione: APT_DS_COMPRESSION = true
  • Cloud Pak for Data comportamento: La variabile abilita la compressione per i set di dati.
  • Impostazione di comportamento predefinita tradizionale (11.7): APT_DS_COMPRESSION = false
  • Comportamento con impostazione Tradizionale (11.7): I set di dati non sono compressi.
APT_IMPORT_FORCE_QUOTE_DELIM
  • Cloud Pak for Data impostazione: APT_IMPORT_FORCE_QUOTE_DELIM = vero
  • Cloud Pak for Data comportamento: Per impostazione predefinita, l'importazione di campi quotati cerca un carattere di apertura e di chiusura delle virgolette. Se i dati del campo contengono un carattere di virgolette, questo carattere viene erroneamente considerato come il carattere di chiusura delle virgolette. L'impostazione di questa variabile d'ambiente fa sì che l'importazione riconosca solo un carattere di virgolette di chiusura seguito dal carattere delimitatore del campo. Questa modifica consente al campo di contenere caratteri di citazione incorporati e di essere importato correttamente.
  • Impostazione di comportamento predefinita tradizionale (11.7): APT_IMPORT_FORCE_QUOTE_DELIM = false
  • Comportamento con l'impostazione Tradizionale (11.7): L'importazione di campi con caratteri di citazione incorporati non importa il record. Per impostazione predefinita, viene lanciato un avviso e i record vengono rifiutati.
APT_TSORT_SCRATCH_COMPRESSION
  • Cloud Pak for Data impostazione: APT_TSORT_SCRATCH_COMPRESSION = true
  • Cloud Pak for Data comportamento: i file scratch di Tsort vengono scritti sul disco in modalità compressa per risparmiare spazio.
  • Impostazione di comportamento predefinita tradizionale (11.7): APT_TSORT_SCRATCH_COMPRESSION = false
  • Comportamento con l'impostazione Tradizionale (11.7): I file scratch di Tsort vengono scritti su disco senza compressione.
APT_DOWNGRADE_MESSAGES
  • Cloud Pak for Data impostazione: APT_DOWNGRADED_MESSAGES = "Raccolto JAVA_TOOL_OPTIONS:"
  • Cloud Pak for Data comportamento: Converte la gravità dei messaggi di errore o di avviso di orchestrazione in uscita in Informational per i messaggi con stringa "Picked up JAVA_TOOL_OPTIONS:".
  • Impostazione di comportamento predefinita tradizionale (11.7): APT_DOWNGRADED_MESSAGES = false
  • Comportamento con l'impostazione Tradizionale (11.7): Nessun messaggio viene declassato. Tuttavia, l'utente può sovrascriverlo con nuovi valori. Il formato di questa variabile è un elenco di messaggi di errore o di avvertimento completi o parziali che devono cambiare la loro gravità in informazioni senza la parte del timestamp. Ogni messaggio è separato da una stringa unica - #?#.
  • Esempio: APT_DOWNGRADED_MESSAGES = READ non è supportato nello stato standby#?#IPv6 non è attualmente supportato.
APT_IMPEXP_INFER_EOL_RECORD_DELIM
  • Cloud Pak for Data impostazione: APT_IMPEXP_INFER_EOL_RECORD_DELIM = true
  • Cloud Pak for Data comportamento: il livello di importazione dei file sequenziali cerca i delimitatori di record EOL di Windows quando sono impostati i delimitatori di record EOL di Unix e consente di importare correttamente il file.
  • Impostazione di comportamento predefinita tradizionale (11.7): APT_IMPEXP_INFER_EOL_RECORD_DELIM = false
  • Comportamento con l'impostazione Tradizionale (11.7): il livello di importazione dei file sequenziali cerca solo il delimitatore di record EOL impostato nelle proprietà di importazione.