Migration des travaux DataStage

Dernière mise à jour : 12 mars 2025

Vous pouvez migrer des travaux DataStage en créant et en important des fichiers ISX contenant les informations sur les travaux. Effectuez d'autres tâches de post-migration, le cas échéant.

Procédure

Effectuez les tâches suivantes pour migrer DataStage®. Une fois que vous avez importé le fichier ISX, d'autres tâches peuvent s'appliquer, en fonction des connexions, des étapes et des autres composants de vos travaux migrés.

Créer et importer le fichier ISX

Créez un fichier ISX d'exportation en utilisant l'une des méthodes répertoriées dans le tableau suivant :

Option	Instructions
ISTOOL	Utilisez ISTOOL pour créer un fichier ISX et exporter le fichier. Pour plus d'informations, voir Commande d'exportation des actifs InfoSphere DataStage et QualityStage et Comment utiliser ISTOOL pour les composants Information Server EXPORT IMPORT.
MettleCI	Utilisez l'outil MettleCI S2PX pour convertir les conceptions de projets serveur en conceptions de projets parallèles équivalentes, puis exporter un fichier ISX des ressources obtenues. Pour plus d'informations, consultez MettleCI docs.
Client d'interface graphique Manager InfoSphere Information Server	Utilisez le client d'interface graphique Manager Information Server pour exporter le fichier ISX. Pour des instructions détaillées, voir Exportation d'actifs

Remarque: assurez-vous que l'exportation de fichier ISX inclut les dépendances, telles que les ensembles de paramètres et les définitions de table. Si la prise en charge des dossiers est activée, les structures de dossiers seront recréées lors de l'importation.

Note : Il est recommandé de mettre à l'échelle vos services tels que DataStage, Orchestration Pipelines, et IBM Cloud® Object Storage à la taille d'instance Large avant d'importer votre fichier .ISX. Après la migration, moins de ressources sont requises et vous pouvez effectuer une mise à l'échelle vers le bas. Si vous rencontrez des problèmes même avec une taille d'instance grande , vous devrez peut-être personnaliser votre configuration. Pour plus d'informations, voir troubleshooting.html#reference_mwl_byg_wpb__largeisx.

Procédez comme suit pour importer le fichier ISX:

Supprimez un projet existant pour en créer un nouveau.
Dans l'onglet Actifs du projet, cliquez sur Nouvel actif > Constructeurs graphiques > DataStage.
Cliquez sur l'onglet Fichier local , puis téléchargez le fichier ISX à partir de votre ordinateur local. Cliquez ensuite sur Créer.
Remarque: Le fichier ISX doit exister sur votre unité de bureau ou réseau. Ne faites pas glisser le fichier en tant que pièce jointe à partir d'une autre application.

Le rapport d'importation d'actifs contient des informations de statut et des messages d'erreur que vous pouvez utiliser pour traiter les incidents liés à votre importation ISX. Pour plus d'informations sur la consultation et l'utilisation du rapport pour le dépannage, voir Rapport d'importation des actifs ( DataStage ).

Migrer les connexions

Si vos projets migrés contiennent des connexions, consultez la rubrique Migration des connexions dans DataStage pour plus d'informations.

Etapes de migration

Tableau 1. Etapes et considérations relatives à la migration.
Etapes	Remarques
Procédure mémorisée	Les procédures mémorisées sont migrées vers le connecteur de plateforme correspondant. Toutes les procédures stockées sur les connecteurs de type Db2® sont migrées vers le connecteur Db2 standard, y compris les procédures stockées pour les connecteurs tels que Db2 for i et Db2 for z/OS®. Remplacez manuellement le connecteur Db2 par le type de connecteur approprié et copiez l'appel de procédure mémorisée. Si les paramètres d'entrée et de sortie ne peuvent pas être détectés dans une procédure mémorisée, ils sont conservés tels quels et doivent être mis à jour après la migration pour correspondre à la nouvelle syntaxe. Pour plus d'informations, voir Utilisation des procédures stockées dans DataStage.

Passez en revue les ensembles de paramètres et les valeurs PROJDEF

Passez en revue vos ensembles de paramètres et vérifiez que leurs valeurs par défaut sont correctes après la migration.

Les ensembles de paramètres PROJDEF sont créés et mis à jour par la migration. Si vous migrez un travail avec un ensemble de paramètres PROJDEF , passez en revue l'ensemble de paramètres PROJDEF et indiquez des valeurs par défaut pour ce travail. Ensuite, dans les flux et les exécutions de travail, toute valeur de paramètre $PROJDEF utilise la valeur de l'ensemble de paramètres PROJDEF .

Si les valeurs des paramètres PROJDEF ont été définies dans le fichier DSParams, utilisez la commande cpdctl dsjob create-dsparams pour transférer ces valeurs dans l'environnement d'exécution de votre projet. Pour plus d'informations, voir DSParams.

Mettre à jour les scripts qui utilisent l'interface de ligne de commande dsjob

Si vous disposez de scripts qui utilisent dsjob pour exécuter des travaux, mettez à jour l'appel de script à dsjob en procédant comme suit:

Téléchargez cpdctl: https://github.com/IBM/cpdctl/releases/

Créez un script de shell source (source.sh) pour configurer cpdctl. Créez un fichier texte key.txt pour votre clé de chiffrement. Prenons cet exemple :

#!/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

Remplacez les références à dsjob par cpdctl dsjob. Vous devrez peut-être ajuster les options de ligne de commande en fonction du style de ligne de commande DataStage . Voir les outils en ligne de commande DataStage.

Migrer les travaux séquentiels

Vous pouvez importer un fichier ISX pour migrer un travail séquentiel vers un flux de pipeline. Réécrivez les expressions dans CEL et resélectionnez manuellement les valeurs de certains noeuds de pipeline. Voir les rubriques suivantes pour plus de considérations : Exécuter les flux en séquence avec Orchestration Pipelines et Migrer et construire des flux de pipeline pour DataStage. Voir Migrating BASIC routines dans DataStage pour plus d'informations sur la réécriture des routines BASIC en scripts.

Réécriture du code de routine pour les sous-routines avant-travail et après-travail

Lorsque vous migrez des sous-routines avant-travail et après-travail, le code de routine est stocké dans un script .sh sous /ds-storage/projects/<projectName>/scripts/DSU.<RoutineName>.sh. Réécrivez le code de la routine de la même manière qu'une routine BASIC, en suivant les étapes de la section Migrating BASIC routines in DataStage pour récupérer les arguments de sortie, mais en incluant une instruction exit pour la sous-routine avant/après le travail. Prenons cet exemple :

# TODO: Update the following json string and print it as the last line of the standard output.

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

La rubrique a-t-elle été utile ?

0/1000