Migrando conexões no DataStage

Conclua as tarefas a seguir após migrar tarefas que contêm conexões.

Atualizar informações de conexão

A tabela a seguir fornece uma visão geral das ações que são necessárias após migrar tarefas que contêm conexões.
Tabela 1. Conexões e ações
Cenário Ações
As informações de conexão ou credenciais estão diretamente integradas dentro da tarefa.
  • O serviço de migração cria uma conexão com as credenciais É possível então criar um fluxo do DataStage® , compilar esse fluxo, criar uma tarefa do DataStage e a tarefa estará pronta para ser executada após a migração.
  • Com conexões de fluxo, quando você migra um trabalho do DataStage tradicional, se as propriedades incorporadas no trabalho forem diferentes das propriedades do objeto de conexão de dados, as propriedades de conexão incorporadas no DataStage tradicional serão adicionadas à definição do trabalho.
A conexão é parametrizada.

  • Se nenhuma credencial estiver no sistema de origem: para cada tipo exclusivo de banco de dados com uma referência de parâmetro que é referenciada no arquivo ISX de origem, DataStage cria uma nova conexão com os parâmetros. As propriedades são migrados como estão.

    Compatibilidade com recursos que não estão presentes no tradicional DataStage:

    Embora seja possível compilar e executar a tarefa, esses recursos adicionais não funcionarão: Conexão de teste, Navegador de ativos, Visualizar dados, importar um ativo de dados conectado. Além disso, não será possível usar a conexão com outros serviços ou ferramentas do projeto, tais como blocos de notas, Data Refineryou Watson Machine Learning Se você desejar usar os recursos adicionais ou usar a conexão em outras ferramentas, edite a conexão do projeto e altere os parâmetros para os valores reais
As propriedades não têm mapeamentos de um para um entre as propriedades tradicionais DataStage e DataStage em IBM Cloud Pak® for Data.

  • Parâmetros gerados automaticamente a partir de um fluxo migrado:

    Algumas propriedades não têm mapeamentos um para um. Essas propriedades são incluídas em conjuntos de parâmetros gerados automaticamente

    Para tratar esses parâmetros, conclua as etapas a seguir:
    1. Após a migração, abra cada conjunto de parâmetros, forneça valores padrão e, em seguida, compile.
    2. Aborde quaisquer problemas que surgiram durante a compilação e, em seguida, execute a tarefa que foi criada durante a migração para o fluxo do DataStage migrado correspondente
  • Se o recurso de conexão de fluxo estiver ativado, DataStage cria um trabalho que contém uma conexão de fluxo com os conjuntos de parâmetros. A maioria das propriedades de conexão que foram parametrizadas na tarefa tradicional do DataStage também será parametrizada no fluxo importado

    Para ativar as conexões de fluxo, consulte Ativar conexões de fluxo

Especificar informações de nome do host e número da porta

Em trabalhos na versão tradicional do DataStage, as informações de conexão de dados podem ser especificadas na forma de uma referência de parâmetro.

Quando você importa um desses trabalhos para a versão moderna do DataStage, as informações de conexão não são reconhecidas e o processo de importação gera avisos. Para abordar os avisos, especifique manualmente as informações nas configurações da tarefa DataStage . Em seguida, recompile a tarefa.

A tabela a seguir mostra as conexões que podem ter esse problema, os valores padrão dos parâmetros e quais campos no DataStage tradicional dos quais as informações de parâmetro são derivados....

Nota: alguns nomes de conexão tradicionais são mapeados para diversos nomes de conexões modernas e alguns nomes de conexões modernas são mapeados para diversos nomes de conexões tradicionais.

O port é parametrizado para todas as ligações.

Tabela 2. Conexões e parâmetros
Nome de conexão no DataStage tradicional Nome da conexão no DataStage moderno Campo do qual o valor original foi derivado no DataStage tradicional Parâmetro que recebe a referência de parâmetro Valor Padrão Notas
Sybase Enterprise SAP ASE Servidor anfitrião port = 5000  
Sybase OC SAP ASE Servidor anfitrião port = 5000  
Db2® IBM Db2 para o DataStage Instância advanced.host advanced.port = 50000  
Db2 Enterprise IBM Db2 para o DataStage Servidor advanced.host advanced.port = 50000  
Oracle Oracle Database para DataStage Servidor oracle_service_name oracle_db_port = 1522  
Oracle Enterprise Oracle Database para DataStage Servidor oracle_service_name oracle_db_port = 1522  
Hive Apache Hive Servidor anfitrião
  • port = 10000
  • database = default
  
Netezza® Corporativo IBM Netezza Performance Server para DataStage Banco de dados banco de dados
  • hostname = <hostname>
  • port = 5480
  
FTP Corporativo FTP URI anfitrião
  • connection_mode = SSH
  • port = 22
 A propriedade file_name também será configurada como um padrão no estágio de fluxo associado. O valor padrão será <file_name>.

Além de atualizar manualmente as propriedades de conexão e o valor do parâmetro, também deve-se mudar esta propriedade de uso dentro do estágio e, em seguida, compilar a tarefa.

O modo de conexão padrão é restrito ao SSH.
Conector do Azure Storage Microsoft Azure File Storage accountName, accountKey N/D https;AccountName=accountName;
AccountKey=accountKey		 Se accountName ou accountKey forem referências de parâmetros, a sequência de conexão será substituída por uma referência de parâmetro para esse campo..

Atualizar configurações de tarefa para propriedades ausentes

Quando você importa determinadas tarefas da versão tradicional do DataStage para a versão moderna, algumas propriedades não são especificadas na tarefa original e pode ser necessário especificá-las manualmente O DataStage parametriza automaticamente algumas propriedades Por exemplo, host é parametrizado para #ConnParamSet_[connection type].host#.. Por padrão, os conjuntos de parâmetros são criados para conexões importadas, a menos que a conexão use um conjunto de parâmetros existente; nesse caso, as propriedades parametrizadas são anexadas ao conjunto.

Oracle, ODBCe JDBC: Um caso especial para gerar conjuntos de parâmetros se aplica a Oracle, Db2, ODBCe JDBC Quando esses detalhes de conexão são parametrizados, os conjuntos de parâmetro são gerados com uma tag de identificador exclusivo anexada ao nome, no seguinte formato: ConnParamSet_[connection_type].[unique identifier tag]. Um conjunto de parâmetros exclusivo é gerado para cada tag de identificador exclusivo.. Por exemplo, quando duas conexões Oracle forem migradas e cada uma tiver um valor de Host diferente, dois conjuntos de parâmetros serão gerados ConnParamSet_Oracle.host1 e ConnParamSet_Oracle.host2. Se ambas as conexões tiverem o mesmo valor de Host, elas compartilharão o conjunto de parâmetros ConnParamSet_Oracle.host. As seguintes propriedades fornecem a tag de identificador exclusivo para suas conexões correspondentes:

  • Db2: Banco de dados
  • Oracle : Anfitrião
  • ODBC: tipo de origem de dados
  • JDBC: Fornecedor

ODBC: Um caso especial para a nomeação de parâmetros é ODBCConnectorPx e PxODBC, que podem inserir dsn_type no nome semelhante a ConnParamSet_[connectorName]_[dsn_type].hostname. Um padrão diferente aplica-se ao JDBC, que assume o formato ConnParamSet_JDBC.[vendor]_[property] Se a parte da sequência protocol for legível, ela será transferida, caso contrário, será cortada da sequência e terá o formato ConnParamSet_JDBC.[property]. Esse caso se aplicará se dsn_type ou protocolo estiverem disponíveis Esse cenário também se aplica ao ODBC.

Também é possível configurar o sinalizador --create-connection-paramsets como false no comando cpdctl dsjob migrate para parametrizar os detalhes da conexão como parâmetros de tarefa em vez de um ativo do conjunto de parâmetros Por exemplo, host é parametrizado para #ConnProp_[connection type]_host#.. Essa opção permite configurar valores de parâmetro para cada job individual. Para obter mais informações sobre o comando da CLI, consulte DataStage.

Após a migração, a maioria das conexões compartilham um conjunto de parâmetros com todas as conexões do mesmo tipo no fluxo migrado. Por exemplo, todas as conexões do Teradata em um fluxo migrado usarão o conjunto de parâmetros ConnParamSet_Teradata

As propriedades a seguir têm valores padrão quando parametrizada, seja no formato do parâmetro de tarefa ConnProp_[connection type]_[property] ou no formato do conjunto de parâmetros ConnParamSet_[connection type].[property] :
Apache Cassandra
local_datacenter parametrizado para #ConnParamSet_Cassandra.local_datacenter# terá um valor padrão de "datacenter1"
Apache Hive
O banco de dados parametrizado para #ConnParamSet_Hive.database# terá um valor padrão de "default"
DRS como Oracle
service_name parametrizado para #ConnParamSet_Oracle.service_name# terá um valor padrão de "orcl"
CLI do Informix®
O banco de dados parametrizado para #ConnParamSet_Informix.database# terá um valor padrão de "default"
Informix Corporativo
O banco de dados parametrizado para #ConnParamSet_Informix.database# terá um valor padrão de "default"
Carregamento do Informix
O banco de dados parametrizado para #ConnParamSet_Informix.database# terá um valor padrão de "default"
Carregamento de XPS Informix
O banco de dados parametrizado para #ConnParamSet_Informix.database# terá um valor padrão de "default"
Oracle
service_name parametrizado para #ConnParamSet_Oracle.service_name# terá um valor padrão de "orcl"
Oracle Corporativo
service_name parametrizado para #ConnParamSet_Oracle.service_name# terá um valor padrão de "orcl"

Se a propriedade ausente for port, o processo de importação produzirá avisos. Para abordar os avisos, especifique manualmente as informações nas configurações da tarefa DataStage . Em seguida, recompile a tarefa.

A tabela a seguir mostra as conexões que podem ter propriedades ausentes, as propriedades que não podem ser recuperadas, o valor padrão que será fornecido e o campo do qual o valor original foi derivado no DataStagetradicional.

Nota: alguns nomes de conexão tradicionais são mapeados para diversos nomes de conexões modernas e alguns nomes de conexões modernas são mapeados para diversos nomes de conexões tradicionais.
Tabela 3. Conexões e propriedades
Nome de conexão no DataStage tradicional Nome da conexão no DataStage moderno Propriedades ausentes que recebem automaticamente um parâmetro padrão Propriedades ausentes que recebem automaticamente um valor padrão Notas
Conector ODBC ODBC
  • nome do host
  • banco de dados
  • port = 0
  • dsn_type = DB2
  
Conector Corporativo ODBC ODBC Enterprise
  • nome do host
  • banco de dados
  • port = 0
  • dsn_type = DB2
 Se dsn_type não estiver na lista de valores permitidos, o padrão será DB2.
Conector DRS ODBC Oracle, IBM Db2 para DataStage (não disponível na versão moderna do DataStage ) advanced.hostname advanced.port = 0
  • Por padrão, a conexão será migrada como um conector Db2.
  • Se você usar um parâmetro para Tipo de banco de dados, o DRS será migrado como Db2 por padrão.
  • A propriedade RDBMS não pode ser parametrizada.. Especifique um de ODBC, Oracleou Db2 ou o fluxo será importado com estágio aleatório como um item temporário e ignorará a compilação de fluxo. É necessário excluir manualmente o estágio aleatório e incluir o desejado.
Carregamento do Informix Informix
  • anfitrião
  • senha
  • nome do usuário
 port = 1526  
Informix Enterprise (se servidor remoto = true) Informix
  • anfitrião
  • Servidor
 port = 1526  
Informix Enterprise (Se servidor remoto = false) Informix
  • nome do usuário
  • senha
  • anfitrião
  • Servidor
 port = 1526  
Informix CLI Informix
  • anfitrião
  • nome do usuário
  • senha
 port = 1526  
Carregamento de XPS Informix Informix anfitrião port = 1526  
Db2 Carregamento em Massa Z (PxDB2Z) Db2 for z/OS® anfitrião porta = 446 Em tarefas migradas que contêm essa conexão, o DataStage converte automaticamente outras propriedades em propriedades comparáveis no DataStagemoderno Depois de migrar tarefas, certifique-se de verificar todas as propriedades de conexão para seus valores adequados e forneça-as onde for necessário.

Atualizar informações de credencial

Para os estágios a seguir, deve-se substituir algumas propriedades após a conclusão do processo de importação:
  • Google BigQuery
  • Google Cloud Storage
  • Google Cloud Pub/Sub
Após a conclusão do processo de importação, especifique os valores corretos para os seguintes campos:
  • client_id
  • client_secret
  • access_ token
  • refresh_token

Ativar conexões de fluxo

Se você tiver uma tarefa no DataStage tradicional que deseja importar e que tem uma conexão, poderá ter as propriedades da conexão incluídas na definição de fluxo ao migrar a tarefa para o DataStagemoderno Para migrar a tarefa dessa maneira, deve-se usar o comando da CLI dsjob para migrar o arquivo ISX que contém as tarefas. Você também deve ativar conexões de fluxo incluindo o parâmetro --enable-local-connection no comando.

SSL configuração do certificado

SSL A configuração do certificado varia dependendo do conector. Se o conector estiver sendo migrado para um conector de plataforma (por exemplo, Microsoft SQL Server, Greenplum, SAP ASE, Informix ), você poderá fornecer o certificado SSL na interface do usuário de conexão após a migração.