0 / 0

Téléchargement et importation d'un flux DataStage et de ses dépendances

Dernière mise à jour : 12 mars 2025
Téléchargement et importation d'un flux DataStage et de ses dépendances

Vous pouvez télécharger des flux DataStage® et les importer dans un autre projet, ainsi que les dépendances du flux.

Vous pouvez télécharger un ou plusieurs flux DataStage et leurs dépendances sous la forme d'un fichier ZIP, puis importer le fichier dans un autre projet. Les dépendances des flux incluent des éléments tels que des connexions, des flux secondaires ou des ensembles de paramètres.

Vous pouvez également utiliser les outils de ligne de commande ou l'API DataStage pour effectuer cette tâche. Pour plus d'informations sur l'utilisation des outils de ligne de commande, voir Outils de ligne de commandeDataStage.

Remarque: les flux téléchargés peuvent inclure des actifs de connexion qui possèdent des données d'identification ou d'autres informations sensibles. Vous pouvez exécuter la commande suivante pour modifier le comportement d'exportation afin que toutes les exportations futures suppriment les données d'identification par défaut.

oc -n ${PROJECT_CPD_INST_OPERANDS} patch datastage datastage --patch '{"spec":{"migration_export_remove_secrets":true}}' --type=merge

Téléchargement et importation d'un flux DataStage individuel et de ses dépendances

Pour télécharger un flux DataStage individuel et ses dépendances:
  1. Dans un flux DataStage, cliquez sur l'icône Téléchargement Icône de téléchargement de la barre d'outils.
  2. Téléchargez et enregistrez le fichier sur votre ordinateur. Le fichier téléchargé peut inclure des actifs de connexion qui possèdent des données d'identification ou d'autres informations sensibles.
  3. Dans un autre projet, accédez à l'onglet Actifs , puis cliquez sur Nouvel actif. La page Nouvel actif s'ouvre.
  4. Localisez et cliquez sur la vignette DataStage . La page Créer un flux DataStage s'ouvre.
  5. Cliquez sur Fichier local, cliquez sur Parcourir, puis sélectionnez le fichier ZIP sur votre ordinateur. Vous pouvez également faire glisser le fichier depuis votre ordinateur sur la page. Cliquez ensuite sur Créer.
  6. Sélectionnez l'une des actions suivantes dans le menu déroulant Conflits d'actifs:
    Ignorer
    Cette action est la valeur par défaut. S'il existe une ressource ou une dépendance portant le même nom, la ressource du fichier ZIP n'est pas importée. Le rapport d'importation indique si quelque chose a été ignoré.
    Renommer
    Le nom de l'actif ou de la dépendance importé est ajouté avec des informations supplémentaires pour que le nom soit différent de celui qui existe déjà.
    Remplacer
    L'actif ou la dépendance du fichier ZIP remplace tous les actifs ou dépendances existants portant le même nom.
  7. Sélectionnez le fichier ZIP, puis cliquez sur Créer.

Vous pouvez également télécharger un flux individuel à l'aide de la méthode présentée dans la rubrique Téléchargement et importation de plusieurs flux DataStage et de leurs dépendances et sélection d'un flux unique à télécharger.

Téléchargement et importation de plusieurs flux DataStage et de leurs dépendances

Pour télécharger plusieurs flux DataStage et leurs dépendances:
  1. Dans l'onglet Actifs de votre projet, sous Types d'actif, cliquez sur DataStage.
  2. Sélectionnez les flux à télécharger dans la liste.
  3. Cliquez sur Télécharger. Une boîte de dialogue s'ouvre pour vous demander si vous avez supprimé des données d'identification des actifs. Cliquez sur Annuler le téléchargement pour arrêter ou sur Continuer le téléchargement pour continuer.
  4. Téléchargez et enregistrez le fichier sur votre ordinateur. Le fichier téléchargé peut inclure des actifs de connexion qui possèdent des données d'identification ou d'autres informations sensibles.
  5. Dans un autre projet, accédez à l'onglet Actifs , puis cliquez sur Nouvel actif. La page Nouvel actif s'ouvre.
  6. Localisez et cliquez sur la vignette DataStage . La page Créer un flux DataStage s'ouvre.
  7. Cliquez sur Fichier local, cliquez sur Parcourir, puis sélectionnez le fichier ZIP sur votre ordinateur. Vous pouvez également faire glisser le fichier depuis votre ordinateur sur la page. Cliquez ensuite sur Créer.
  8. Sélectionnez l'une des actions suivantes dans le menu déroulant Conflits d'actifs:
    Ignorer
    Cette action est la valeur par défaut. S'il existe une ressource ou une dépendance portant le même nom, la ressource du fichier ZIP n'est pas importée. Le rapport d'importation indique si quelque chose a été ignoré.
    Renommer
    Le nom de la ressource ou de la dépendance importée est complété par des informations supplémentaires afin de le différencier du nom existant.
    Remplacer
    L'actif ou la dépendance du fichier ZIP remplace tous les actifs ou dépendances existants portant le même nom.
  9. Sélectionnez le fichier ZIP, puis cliquez sur Créer.

Vous pouvez également télécharger un flux individuel en utilisant cette méthode et en sélectionnant un flux unique à télécharger.

Options de conflit d'actifs

Lorsque vous importez des fichiers DataStage qui contiennent des connexions, différentes actions de conflit d'actifs sont effectuées en fonction du contexte:
Importation de connexions avec l'option Remplacer / Ignorer
  • Si la connexion importée a le même nom et le même contenu qu'une connexion existante, l'action est ignorée.
  • Si la connexion importée a le même contenu qu'une connexion existante avec un nom différent, l'action est ignorée.
  • Si la connexion importée n'a pas le même nom ou le même contenu que les connexions existantes, la connexion est importée.
  • Si la connexion importée porte le même nom qu'une connexion existante qui contient un contenu différent, l'action dépend de l'option de résolution de conflit sélectionnée. Si l'option skip est sélectionnée, l'action est ignorée et les valeurs existantes ne sont pas modifiées. Si l'action replace est sélectionnée, la connexion existante est mise à jour.
Lorsque vous importez des flux DataStage qui contiennent des ensembles de paramètres, différentes actions de conflit d'actifs sont effectuées en fonction du contexte:
Importation d'ensembles de paramètres avec l'option Remplacer / Ignorer
  • Si l'ensemble de paramètres importé porte le même nom qu'un ensemble de paramètres existant, mais que le type est différent, l'action est ignorée et un message d'avertissement s'affiche.
  • Si l'ensemble de paramètres importé contient de nouveaux paramètres ou de nouveaux ensembles de valeurs, l'ensemble de paramètres est importé et ajouté à l'ensemble de paramètres existant.
  • Si l'ensemble de paramètres importé contient des paramètres de même nom et de même type ou des ensembles de valeurs de même nom, mais de valeurs différentes, l'action dépend de la valeur de replace_mode.Si vous définissez replace_mode=hard, les valeurs des paramètres et des ensembles de valeurs sont mises à jour lors de l'importation. Si vous définissez replace_mode=soft, l'action est ignorée et les valeurs existantes ne sont pas modifiées.
  • Si l'ensemble de paramètres importé contient un sous-ensemble de paramètres et d'ensembles de valeurs dans un ensemble de paramètres existant, l'importation n'affecte pas les paramètres et ensembles de valeurs supplémentaires.

Exportation des actifs DataStage via une interface de ligne de commande (CLI)

Exporter des actifs individuels
L'option "export-zip" peut être utilisée pour exporter des flux ou des pipelines individuels (et leurs dépendances) par défaut, par exemple :
cpdctl dsjob export-zip --project dsjob --name Test-DataStage-Flow --file-name test-export-project.zip

cpdctl dsjob export-zip --project dsjob --pipeline=testloop2 --file-name test-export-project.zip
Exportation d'actifs individuels sans dépendances ni secrets
Vous pouvez exporter un flux ou un pipeline sans dépendances en utilisant l'option --no-dep. Vous pouvez ne pas exporter les secrets tels que les mots de passe en utilisant l'option --no-secrets.
cpdctl dsjob export-zip --project dsjob --name Test-DataStage-Flow --file-name test-export-project.zip --no-deps --no-secrets
Exporter plusieurs actifs
Vous pouvez exporter plusieurs flux et pipelines dans un fichier ZIP, par exemple :
cpdctl dsjob export-zip --project dsjob --name={fsTarget,dsTarget}  --pipeline={testloop2,testPipe} --file-name test-export-project.zip
 cpdctl dsjob export-zip --project dsjob --name fsTarget --name dsTarget --pipeline testloop2 --pipeline testPipe --file-name test-export-project.zip

Que faire ensuite ?

Voir Migration des travaux DataStage pour plus d'informations sur les autres changements de configuration que vous pourriez avoir à effectuer.