0 / 0

Migrazione dei job DataStage

Ultimo aggiornamento: 12 mar 2025
Migrazione dei job DataStage

È possibile migrare i job DataStage creando e importando i file ISX che contengono le informazioni sul job. Completare altre attività di post - migrazione, se applicabile.

Procedura

Completare le attività riportate di seguito per migrare DataStage®. Dopo aver importato il file ISX, potrebbero essere applicate altre attività, in base alle connessioni, agli stage e ad altri componenti dei job migrati.
  1. Creare e importare il file ISX
  2. Migra connessioni
  3. Migra stage
  4. Esaminare le serie di parametri e i valori PROJDEF
  5. Aggiorna gli script che utilizzano l'interfaccia della riga comandi dsjob
  6. Migra job di sequenza
  7. Riscrivere il codice di routine per le sottoroutine pre - lavoro e post - lavoro

Crea e importa il file ISX

Creare un file ISX di esportazione utilizzando uno dei metodi elencati nella tabella seguente:

Opzione Istruzioni
ISTOOL Utilizzare ISTOOL per creare un file ISX ed esportare il file. Per istruzioni, consultare Export command for InfoSphere DataStage and QualityStage assets e How to use ISTOOL for EXPORT IMPORT Information Server Components.
MettleCI Utilizzare lo strumento MettleCI S2PX per convertire i progetti di lavoro del server in progetti di lavoro paralleli equivalenti, quindi esportare un file ISX delle risorse risultanti. Per ulteriori informazioni, consultare MettleCI docs.
Client GUI di InfoSphere Information Server Manager Utilizzare il client della GUI di Information Server Manager per esportare il file ISX. Per istruzioni dettagliate, vedere Esportazione di risorse
Nota: verificare che l'esportazione del file ISX includa eventuali dipendenze, come le serie di parametri e le definizioni di tabella. Se il supporto cartella è abilitato, le strutture cartella verranno ricreate durante l'importazione.
Nota: Si consiglia di scalare i servizi quali DataStage, Orchestration Pipelines e IBM Cloud® Object Storage alle dimensioni dell'istanza Large prima di importare il file .ISX. Dopo la migrazione, sono richieste meno risorse e puoi ridurre le dimensioni. Se si verificano problemi anche con una dimensione dell'istanza Grande , potrebbe essere necessario personalizzare la configurazione. Per ulteriori informazioni, vedere troubleshooting.html#reference_mwl_byg_wpb__largeisx.
Completare la seguente procedura per importare il file ISX:
  1. Aprire un progetto esistente o crearne uno nuovo.
  2. Dalla scheda Risorse del progetto, fare clic su Nuova risorsa > Generatori grafici > DataStage.
  3. Fare clic sulla scheda File locale , quindi caricare il file ISX dal computer locale. Quindi, fare clic su Crea.
    Nota: il file ISX deve essere presente sul desktop o sull'unità di rete. Non trascinare il file come allegato da un'altra applicazione.

Il report di importazione asset contiene informazioni sullo stato e messaggi di errore che è possibile utilizzare per risolvere i problemi relativi all'importazione ISX. Per informazioni su come visualizzare e utilizzare il rapporto per la risoluzione dei problemi, vedere Rapporto di importazione delle risorse ( DataStage ).

Migra connessioni

Se i lavori migrati contengono connessioni, vedere Migrazione delle connessioni in DataStage per informazioni.

Migra stage

Tabella 1. Le fasi e le loro considerazioni sulla migrazione.
Stage Considerazioni
Procedura memorizzata Le procedure memorizzate vengono migrate al connettore della piattaforma corrispondente.

Tutte le procedure memorizzate sui connettori di tipo Db2® vengono migrate al connettore Db2 standard, incluse le procedure memorizzate per connettori come Db2 for i e Db2 for z/OS®. Sostituire manualmente il connettore Db2 con il tipo di connettore corretto e copiare la chiamata della procedura memorizzata.

Se i parametri di input e di output non possono essere rilevati in una procedura memorizzata, vengono lasciati così come sono e devono essere aggiornati dopo la migrazione per corrispondere alla nuova sintassi. Per ulteriori informazioni, vedere Utilizzo delle procedure memorizzate in DataStage.

Rivedere le serie di parametri e i valori PROJDEF

Esaminare le serie di parametri e verificare che i valori predefiniti siano corretti dopo la migrazione.

Le serie di parametri PROJDEF vengono create e aggiornate dalla migrazione. Se si esegue la migrazione di un lavoro con una serie di parametri PROJDEF , esaminare la serie di parametri PROJDEF e specificarne i valori predefiniti. Quindi, all'interno dei flussi e delle esecuzioni dei lavori, qualsiasi valore di parametro $PROJDEF utilizza il valore della serie di parametri PROJDEF .

Se i valori dei parametri PROJDEF sono stati definiti nel file DSParams, usare il comando cpdctl dsjob create-dsparams per trasferire tali valori nell'ambiente di runtime del progetto. Per ulteriori informazioni, vedere DSParams.

Aggiornare gli script che utilizzano l'interfaccia della riga comandi dsjob

Se si dispone di script che utilizzano dsjob per eseguire i lavori, aggiornare la chiamata di script a dsjob completando la seguente procedura:
  1. Scarica cpdctl: https://github.com/IBM/cpdctl/releases/
  2. Creare uno script della shell di origine (source.sh) per configurare cpdctl. Crea un file di testo key.txt per la tua chiave di crittografia. Vedi il seguente esempio:
    #!/bin/bash
export CPDCTL_ENCRYPTION_KEY_PATH=~/key.txt
export DSJOB_URL=https://example.com
export DSJOB_ZEN_URL=https://example.com
export CPDCTL_ENABLE_DSJOB=true
export CPDCTL_ENABLE_DATASTAGE=true
export DSJOB_USER=admin
export DSJOB_PWD=<Password>
cpdctl config user set dscpserver-user --username $DSJOB_USER --password $DSJOB_PWD
cpdctl config profile set dscpserver-profile --url $DSJOB_URL
cpdctl config context set dscpserver-context --user dscpserver-user --profile dscpserver-profile
cpdctl config context use dscpserver-context


cpdctl dsjob list-projects

    Modificare i riferimenti in dsjob in cpdctl dsjob. Potrebbe essere necessario modificare le opzioni della riga comandi per adattarle allo stile della riga comandi di DataStage . Vedere gli strumenti da riga di comando DataStage.

Migra job di sequenza

È possibile importare un file ISX per migrare un job di sequenza in un flusso di pipeline. Riscrivere le espressioni in CEL e riselezionare manualmente i valori per alcuni nodi pipeline. Per ulteriori considerazioni, consultare i seguenti argomenti: Eseguire i flussi in sequenza con Pipeline di orchestrazione e Migrazione e costruzione di flussi di pipeline per DataStage. Vedere Migrating BASIC routines in DataStage per informazioni sulla riscrittura delle routine BASIC come script.

Riscrivi il codice di routine per le sottoroutine pre - lavoro e post - lavoro

Quando si migrano le sottoroutine pre - job e post - job, il codice della routine viene memorizzato in uno script .sh in /ds-storage/projects/<projectName>/scripts/DSU.<RoutineName>.sh. Riscrivi il codice della routine allo stesso modo di una routine BASIC, seguendo i passaggi in Migrazione delle routine BASIC in DataStage, per recuperare gli argomenti di output, ma includi un'istruzione di uscita per la subroutine prima/dopo il lavoro. Vedi il seguente esempio:
# TODO: Update the following json string and print it as the last line of the standard output.

ErrorCode=0
echo "{\"ErrorCode\":\"$ErrorCode\"}"
exit $ErrorCode