Download e importação de um fluxo DataStage e suas dependências

Você pode fazer o download dos fluxos DataStage® e importá-los em outro projeto, juntamente com quaisquer dependências que o fluxo tenha.

Você pode baixar o fluxo individual ou múltiplo DataStage e suas dependências na forma de um arquivo ZIP, em seguida importar o arquivo para outro projeto. Dependências de fluxos incluem itens como conexões, subfluxos ou conjuntos de parâmetros.

Você também pode usar ferramentas de linha de comandos ou a API DataStage para realizar esta tarefa. Para obter mais informações sobre o uso das ferramentas da linha de comandos, consulte DataStage ferramentas de linha de comandos.

Nota: fluxos transferidos por download podem incluir ativos de conexão que possuem credenciais ou outras informações confidenciais. É possível executar o comando a seguir para mudar o comportamento de exportação para que todas as exportações futuras removam as credenciais por padrão

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

Baixando e importando um fluxo individual DataStage e suas dependências

Para fazer o download de um fluxo individual DataStage e suas dependências:
  1. Em um DataStage fluxo, clique no ícone Download Ícone de download na barra de ferramentas.
  2. Faça o download e salve o arquivo em seu computador. O arquivo transferido por download pode incluir ativos de conexão que possuem credenciais ou outras informações sensíveis.
  3. Em um projeto diferente, vá até a aba Ativos , em seguida, clique em Novo ativo. A Nova página de ativos é aberta.
  4. Localize e clique no ladrilho DataStage . A página Criar uma DataStage flow abre.
  5. Clique em Arquivo local, clique em Procurar, em seguida, selecione o arquivo ZIP do seu computador. Você também pode arrastar o arquivo do seu computador para a página. Em seguida, clique em Criar.
  6. Selecione uma das ações a seguir no menu suspenso para conflitos de ativos:
    Ignorar
    Esta ação é o padrão. Se houver um ativo ou dependência com o mesmo nome, o ativo do arquivo ZIP não será importado. O relatório de importação indica se alguma coisa foi ignorada.
    Renomear
    São anexadas informações adicionais ao nome do ativo ou da dependência importados para que ele seja diferente daquele que já existe.
    Substituir
    O ativo ou a dependência do arquivo ZIP sobrescreve quaisquer ativos ou dependências existentes com o mesmo nome.
  7. Selecione o arquivo ZIP, em seguida, clique em Criar.

Você também pode fazer o download de um fluxo individual usando o método mostrado em Baixando e importando vários fluxos de DataStage e suas dependências e selecionando um fluxo único para download.

Baixando e importando vários fluxos DataStage e suas dependências

Para fazer o download de vários fluxos DataStage e suas dependências:
  1. Na guia Assets do seu projeto, sob Tipos de ativos, clique em DataStage fluxos.
  2. Selecione os fluxos que você deseja fazer download na lista.
  3. Clique em Download. Uma caixa de diálogo é aberta perguntando se você removeu credenciais dos ativos. Clique em Cancelar download para parar ou Continuar o download para prosseguir.
  4. Faça o download e salve o arquivo em seu computador. O arquivo transferido por download pode incluir ativos de conexão que possuem credenciais ou outras informações sensíveis.
  5. Em um projeto diferente, vá até a aba Ativos , em seguida, clique em Novo ativo. A Nova página de ativos é aberta.
  6. Localize e clique no ladrilho DataStage . A página Criar uma DataStage flow abre.
  7. Clique em Arquivo local, clique em Procurar, em seguida, selecione o arquivo ZIP do seu computador. Você também pode arrastar o arquivo do seu computador para a página. Em seguida, clique em Criar.
  8. Selecione uma das ações a seguir no menu suspenso para conflitos de ativos:
    Ignorar
    Esta ação é o padrão. Se houver um ativo ou dependência com o mesmo nome, o ativo do arquivo ZIP não será importado. O relatório de importação indica se alguma coisa foi ignorada.
    Renomear
    O nome do ativo ou da dependência importada é acrescido de informações adicionais para tornar o nome diferente do existente.
    Substituir
    O ativo ou a dependência do arquivo ZIP sobrescreve quaisquer ativos ou dependências existentes com o mesmo nome.
  9. Selecione o arquivo ZIP, em seguida, clique em Criar.

Você também pode fazer o download de um fluxo individual usando este método e selecionando um fluxo único para download.

Opções de conflito de ativo

Ao importar arquivos zip do DataStage que contêm conexões, diferentes ações de conflito de ativo são executadas com base no contexto:
Importando conexões com a opção Substituir / ignorar
  • Se a conexão importada tiver o mesmo nome e conteúdo que uma conexão existente, a ação será ignorada.
  • Se a conexão importada tiver o mesmo conteúdo que uma conexão existente com um nome diferente, a ação será ignorado
  • Se a conexão importada não tiver o mesmo nome ou conteúdo que qualquer conexão existente, a conexão será importando.
  • Se a conexão importada tiver o mesmo nome que uma conexão existente que contém conteúdos diferentes, a ação dependerá da opção de resolução de conflito selecionada Se a opção skip for selecionada, a ação será ignorado e os valores existentes não serão alterados Se a ação replace for selecionada, a conexão existente será atualizada..
Quando você importa DataStage fluxos que contêm conjuntos de parâmetros, diferentes ações de conflito de ativos são tomadas com base no contexto:
Importando conjuntos de parâmetros com a opção Substituir / ignorar
  • Se o conjunto de parâmetros importado tiver o mesmo nome que um conjunto de parâmetros existente, mas o tipo for diferente a ação será ignorada, e uma mensagem de aviso será mostrada
  • Se o conjunto de parâmetro importado contiver novos parâmetros ou conjuntos de valor, o conjunto de parâmetros será importado e anexado ao conjunto de parâmetro existente...
  • Se o conjunto de parâmetros importado contiver parâmetros do mesmo nome e tipo ou conjuntos de valores do mesmo nome, mas valores diferentes, a ação dependerá do valor de replace_mode.Se você configurar replace_mode=hard, os valores para os parâmetros e conjuntos de valores serão atualizados na importação. Se você configurar replace_mode=soft, a ação será ignorada e valores existentes não serão alterados.
  • Se o conjunto de parâmetro importado contiver um subconjunto dos parâmetros e conjuntos de valores em um conjunto de parâmetro existente, a importação não afetará os parâmetros e conjuntos de valores extras.

Exportação de ativos do DataStage por meio de uma interface de linha de comando (CLI)

Exportar ativos individuais
O "export-zip" pode ser usado para exportar fluxos ou pipelines individuais (e suas dependências) por padrão, por exemplo:
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
Exportar ativos individuais sem dependências e segredos
Você pode exportar um fluxo ou pipeline sem dependências usando a opção --no-dep. Você pode ignorar a exportação de segredos, como senhas, usando a opção --no-secrets.
cpdctl dsjob export-zip --project dsjob --name Test-DataStage-Flow --file-name test-export-project.zip --no-deps --no-secrets
Exportar vários ativos
É possível exportar vários fluxos e pipelines em um arquivo ZIP, por exemplo:
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

Ativos que podem ser exportados

Os seguintes ativos podem ser exportados no nível do projeto:
  • DataStage fluxo
  • DataStage subfluxo
  • Estágio Build
  • Estágio customizado
  • Operational Decision Manager
  • Especificação de correspondência para estágios de qualidade de dados
  • Regra de padronização para estágios de regra de dados
  • Biblioteca Java para o estágio de integração Java
  • Biblioteca de esquemas para o estágio XML
  • Biblioteca de funções para funções definidas pelo usuário
  • Esquema de arquivo plano complexo para conector de arquivo plano complexo
  • Definição de dados
  • Estágio Wrapped

Opções de importação avançadas

Migrar STPPX Teradata para o Teradata plugin
Para a importação de arquivos ISX, você pode migrar o plug-in STPPX Teradata para o estágio Stored Procedure para obter um melhor desempenho do fluxo.

O que fazer a seguir

Consulte Migração de trabalhos do DataStage para obter mais informações sobre outras alterações de configuração que talvez seja necessário fazer.