Migração de empregos DataStage

É possível migrar tarefas do DataStage criando e importam arquivos ISX que contêm as informações da tarefa. Conclua outras tarefas pós-migração, quando aplicável

Procedimento

Conclua as tarefas a seguir para migrar DataStage®. Depois de importar o arquivo ISX, outras tarefas podem ser aplicadas, dependendo das conexões, estágios e outros componentes de suas tarefas migrados..
  1. Criar e importar o arquivo ISX
  2. Migrar conexões
  3. Migrar estágios
  4. Revise os conjuntos de parâmetros e valores PROJDEF
  5. Atualizar scripts que usam a interface da linha de comando dsjob
  6. Migrar tarefas de sequência
  7. Regravar o código de rotina para sub-rotinas antes da tarefa e após a tarefa

Criar e importar o arquivo ISX

Crie um arquivo ISX de exportação usando um dos métodos listados na tabela a seguir:

Opção Instruções
ISTool Use o ISTool para criar um arquivo ISX e exportar o arquivo. Para obter instruções, consulte Comando de exportação para ativos InfoSphere DataStage e QualityStage e Como usar o ISTool para EXPORTAÇÃO IMPORTAÇÃO de componentes do Information Server.
MettleCI Use a ferramenta MettleCI S2PX para converter projetos de trabalhos de servidor em projetos de trabalhos paralelos equivalentes e, em seguida, exportar um arquivo ISX dos ativos resultantes. Para obter mais informações, consulte os documentos do site MettleCI.
Cliente da GUI do InfoSphere Information Server Manager Use o cliente da GUI do Information Server Manager para exportar o arquivo ISX. Para obter instruções detalhadas, consulte Exportando ativos
Nota: Certifique-se de que a exportação do arquivo ISX inclua dependências, como conjuntos de parâmetros e definições de tabelas. Se o suporte de pasta estiver ativado, as estruturas de pastas serão recriadas na importação
Observação: é recomendável aumentar a escala dos seus serviços, como DataStage, Orchestration Pipelines e IBM Cloud® Object Storage para o tamanho de instância Grande antes de importar o seu arquivo.ISX. Após a migração, menos recursos são necessários e é possível escalar para baixo. Se você estiver tendo problemas, mesmo com um tamanho de instância Grande , poderá ser necessário customizar sua configuração Para obter mais informações, consulte troubleshooting.html #reference_mwl_byg_wpb__largeisx.
Conclua as etapas a seguir para importar o arquivo ISX:
  1. Abra um projeto existente ou crie um novo.
  2. Na guia Assets (Ativos ) do projeto, clique em New asset (Novo ativo) > Graphical builders (Construtores gráficos ) > DataStage.
  3. Clique na guia Arquivo local , em seguida, faça o upload do arquivo ISX de seu computador local. Em seguida, clique em Criar.
    Nota: O arquivo ISX deve existir em sua área de trabalho ou unidade de rede. Não arraste o arquivo como um anexo de outro aplicativo.

O relatório de importação de ativos contém informações de status e mensagens de erros que podem ser usadas para solucionar problemas de importação de ISX. Para obter informações sobre como visualizar e usar o relatório para solucionar problemas, consulte Relatório de importação de ativos ( DataStage ).

Migrar conexões

Se seus trabalhos migrados contiverem conexões, consulte Migração de conexões em DataStage para obter informações.

Migrar estágios

Tabela 1. Estágios e suas considerações de migração.
Estágios Considerações
Procedimento armazenado Os procedimentos armazenados são migrados para o conector da plataforma correspondente

Todos os procedimentos armazenados nos conectores do tipo Db2® são migrados para o conector padrão do Db2 , incluindo procedimentos armazenados para conectores como Db2 for i e Db2 for z/OS® Substitua manualmente o conector Db2 pelo tipo de conector correto e copie a chamada do procedimento armazenado.

Se os parâmetros de entrada e de saída não puderem ser detectados em um procedimento armazenado, ele será deixado como está e deverá ser atualizado após a migração para corresponder à nova sintaxe. Para obter mais informações, consulte Uso de procedimentos armazenados em DataStage.

Revise os conjuntos de parâmetros e valores PROJDEF

Revise seus conjuntos de parâmetros e verifique se seus valores padrão estão corretos após a migração..

PROJDEF conjuntos de parâmetros são criados e atualizados pela migração. Se você migrar uma tarefa com um conjunto de parâmetros PROJDEF , revise o conjunto de parâmetros PROJDE e especifique valores padrão para ele. Em seguida, dentro de fluxos e execuções de tarefas, qualquer valor de parâmetro $PROJDEF usa o valor do conjunto de parâmetros PROJDEF .

Se os valores dos parâmetros PROJDEF tiverem sido definidos no arquivo DSParams, use o comando cpdctl dsjob create-dsparams para transferir esses valores para o ambiente de tempo de execução do seu projeto. Para obter mais informações, consulte DSParams.

Atualizar scripts que usam a interface da linha de comando dsjob

Se você tiver scripts que usam dsjob para executar tarefas, atualize a chamada de script para dsjob concluindo as etapas a seguir:
  1. Faça download do cpdctl: https://github.com/IBM/cpdctl/releases/
  2. Crie um script shell de origem (source.sh) para configurar o cpdctl. Crie um arquivo de texto key.txt para a sua chave de criptografia Consulte o exemplo a seguir:
    #!/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

    Mude quaisquer referências a dsjob para cpdctl dsjob. Pode ser necessário ajustar as opções de linha de comandos para ajustar o estilo de linha de comandos do DataStage Consulte DataStage ferramentas de linha de comando.

Tarefas de sequência de migração

É possível importar um arquivo ISX para migrar uma tarefa de sequência para um fluxo de pipeline. Regrave expressões em CEL e selecione novamente valores manualmente para alguns nós de pipeline. Consulte os tópicos a seguir para obter mais considerações: Executar fluxos em sequência com Orchestration Pipelines e Migrar e construir fluxos de pipeline para DataStage. Consulte Migração de rotinas BASIC em DataStage para obter informações sobre como reescrever rotinas BASIC como scripts.

Importante: Antes de migrar tarefas de sequência, remova todas as referências a DSJS.VALOK (status “Apenas validar ”) dos gatilhos das tarefas e de qualquer atividade de tarefa em fase de preparação configurada com a opção “Apenas validar ”.

Regravar o código de rotina para sub-rotinas antes e após a tarefa

Ao migrar sub-rotinas antes da tarefa e após a tarefa, o código de rotina é armazenado em um script .sh em /ds-storage/projects/<projectName>/scripts/DSU.<RoutineName>.sh. Reescreva o código da rotina da mesma forma que uma rotina BASIC, seguindo as etapas descritas em “Migração de rotinas BASIC” em DataStage para recuperar os argumentos de saída, mas inclua uma instrução exit para a sub-rotina antes/depois do trabalho. Consulte o exemplo a seguir:
# TODO: Update the following json string and print it as the last line of the standard output.

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