Migración de conexiones en DataStage

Última actualización: 12 mar 2025

Complete las tareas siguientes después de migrar trabajos que contienen conexiones.

Actualizar información de conexión
Especificar información de nombre de host y número de puerto
Actualizar valores de trabajo para las propiedades que faltan
Actualizar información de credenciales
Habilitar conexiones de flujo

Actualizar información de conexión

La tabla siguiente proporciona una visión general de las acciones necesarias después de migrar trabajos que contienen conexiones.

Tabla 1. Conexiones y acciones
Escenario	Acciones
La información de conexión o las credenciales se incluyen directamente dentro del trabajo.	El servicio de migración crea una conexión con las credenciales. A continuación, puede crear un flujo de DataStage® , compilar este flujo, crear un trabajo de DataStage y el trabajo está listo para ejecutarse después de la migración. Con las conexiones de flujo, al migrar un trabajo de DataStage tradicional, si las propiedades que se incrustan en el trabajo son diferentes de las propiedades del objeto de conexión de datos, las propiedades de conexión que se incrustan en el DataStage tradicional se añadirán a la definición del trabajo.
La conexión está parametrizada.	Si no hay credenciales en el sistema de origen: para cada tipo exclusivo de base de datos con una referencia de parámetro a la que se hace referencia en el archivo ISX de origen, DataStage crea una nueva conexión con los parámetros. Las propiedades se migran tal cual. Compatibilidad con funcionalidades que no están presentes en el DataStage tradicional: Aunque puede compilar y ejecutar el trabajo, estas características adicionales no funcionarán: conexión de prueba, navegador de activos, vista previa de datos, importación de un activo de datos conectado. Además, no podrá utilizar la conexión con otros servicios o herramientas de proyecto como, por ejemplo, cuadernos, Data Refineryo Watson Machine Learning. Si desea utilizar las características adicionales o utilizar la conexión en otras herramientas, edite la conexión del proyecto y cambie los parámetros a los valores reales.
Las propiedades no tienen mapeos uno a uno entre DataStage tradicional y DataStage en IBM Cloud Pak® for Data.	Parámetros generados automáticamente desde un flujo migrado: Algunas propiedades no tienen correlaciones de uno a uno. Estas propiedades se añaden a los conjuntos de parámetros generados automáticamente. Para direccionar estos parámetros, realice los pasos siguientes: Después de la migración, abra cada conjunto de parámetros, proporcione los valores predeterminados y, a continuación, compile. Aborde los problemas surgidos durante la compilación y, a continuación, ejecute el trabajo que se ha creado durante la migración para el flujo de DataStage migrado correspondiente. Si la función de conexión de flujo está activada, DataStage crea un trabajo que contiene una conexión de flujo con los conjuntos de parámetros. La mayoría de las propiedades de conexión que se parametrizaron en el trabajo tradicional de DataStage también se parametrizarán en el flujo importado. Para habilitar las conexiones de flujo, consulte Habilitar conexiones de flujo.

Especificar información de nombre de host y número de puerto

En los trabajos de la versión tradicional de DataStage, la información de conexión de datos podría especificarse en forma de referencia a un parámetro.

Al importar uno de estos trabajos a la versión moderna de DataStage, no se reconoce la información de conexión y el proceso de importación produce advertencias. Para abordar los avisos, especifique manualmente la información en los valores de trabajo de DataStage . A continuación, vuelva a compilar el trabajo.

La tabla siguiente muestra las conexiones que pueden tener este problema, los valores predeterminados de los parámetros y los campos de DataStage tradicional de los que se deriva la información de parámetros.

Nota: Algunos nombres de conexión tradicionales se correlacionan con varios nombres de conexión modernos y algunos nombres de conexión modernos se correlacionan con varios nombres de conexión tradicionales.

El port está parametrizado para todas las conexiones.

Tabla 2. Conexiones y parámetros
Nombre de conexión en DataStage tradicional	Nombre de conexión en DataStage moderno	Campo del que se ha derivado el valor original en DataStage tradicional	Parámetro que recibe la referencia de parámetro	Valor predeterminado	Notas
Sybase Enterprise	SAP ASE	Servidor	Anfitrión	port = 5000
Sybase OC	SAP ASE	Servidor	Anfitrión	port = 5000
Db2®	IBM Db2 para DataStage	Instancia	advanced.host	advanced.port = 50000
Db2 Enterprise	IBM Db2 para 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ón	port = 10000 database = default
Netezza® Empresa	IBM Netezza Performance Server para DataStage	Base de datos	base de datos	hostname = <hostname> port = 5480
FTP Enterprise	FTP	URI	Anfitrión	connection_mode = SSH port = 22	La propiedad file_name también se establecerá en un valor predeterminado en la etapa de flujo asociada. El valor predeterminado será <file_name>. Además de actualizar manualmente las propiedades de conexión y el valor de parámetro, también debe cambiar esta propiedad de uso dentro de la etapa y, a continuación, compilar el trabajo. La modalidad de conexión predeterminada está restringida a SSH.
Azure Storage Connector	Microsoft Azure File Storage	accountName, accountKey	N/A	https;AccountName=accountName; AccountKey=accountKey	Si accountName o accountKey son referencias de parámetro, la serie de conexión se sustituye por una referencia de parámetro para ese campo.

Actualizar valores de trabajo para propiedades que faltan

Cuando importa determinados trabajos de la versión tradicional de DataStage a la versión moderna, algunas propiedades no se especifican en el trabajo original y es posible que tenga que especificarlas manualmente. DataStage parametriza automáticamente algunas propiedades. Por ejemplo, host está parametrizado en #ConnParamSet_[connection type].host#. De forma predeterminada, los conjuntos de parámetros se crean para las conexiones importadas a menos que la conexión utilice un conjunto de parámetros existente, en cuyo caso las propiedades parametrizadas se añaden al conjunto.

Oracle, ODBCy JDBC: se aplica un caso especial para generar conjuntos de parámetros a Oracle, Db2, ODBCy JDBC. Cuando estos detalles de conexión están parametrizados, los conjuntos de parámetros se generan con una etiqueta de identificador exclusivo añadida al nombre, en el formato siguiente: ConnParamSet_[connection_type].[unique identifier tag]. Se genera un conjunto de parámetros exclusivo para cada etiqueta de identificador exclusivo. Por ejemplo, cuando se migran dos conexiones de Oracle y cada una tiene un valor de host diferente, se generarán dos conjuntos de parámetros, ConnParamSet_Oracle.host1 y ConnParamSet_Oracle.host2. Si ambas conexiones tienen el mismo valor de host, compartirán el conjunto de parámetros ConnParamSet_Oracle.host. Las propiedades siguientes proporcionan la etiqueta de identificador exclusivo para sus conexiones correspondientes:

Db2: Base de datos
Oracle : Host
ODBC: Tipo de origen de datos
JDBC: Proveedor

ODBC: Un caso especial para la denominación de parámetros es ODBCConnectorPx y PxODBC, que podrían insertar dsn_type en el nombre de forma similar a ConnParamSet_[connectorName]_[dsn_type].hostname. Se aplica un patrón diferente a JDBC, que tiene el formato ConnParamSet_JDBC.[vendor]_[property]. Si la parte de serie protocol es legible, se traspasará, de lo contrario se cortará de la serie y tomará el formato ConnParamSet_JDBC.[property]. Este caso se aplica si dsn_type o protocol están disponibles. Este escenario también se aplica a ODBC.

También puede establecer el distintivo --create-connection-paramsets en false en el mandato cpdctl dsjob migrate para parametrizar los detalles de conexión como parámetros de trabajo en lugar de un activo de conjunto de parámetros. Por ejemplo, host está parametrizado en #ConnProp_[connection type]_host#. Esta opción le permite establecer valores de parámetro para cada trabajo individual. Para obtener más información sobre el mandato de CLI, consulte Herramientas de línea de mandatos deDataStage.

Después de migrar, la mayoría de las conexiones comparten un conjunto de parámetros con todas las conexiones del mismo tipo en el flujo migrado. Por ejemplo, todas las conexiones Teradata de un flujo migrado utilizarán el conjunto de parámetros ConnParamSet_Teradata.

Las propiedades siguientes tienen valores predeterminados cuando se parametrizan, ya sea en el formato del parámetro de trabajo ConnProp_[connection type]_[property] o en el formato del conjunto de parámetros ConnParamSet_[connection type].[property] :

Apache Cassandra: local_datacenter parametrizado a #ConnParamSet_Cassandra.local_datacenter# tendrá un valor por defecto de "datacenter1"
Apache Hive: base de datos parametrizada a #ConnParamSet_Hive.database# tendrá un valor por defecto de "default"
DRS como Oracle: service_name parametrizado a #ConnParamSet_Oracle.service_name# tendrá un valor por defecto de "orcl"
CLI de Informix®: base de datos parametrizada a #ConnParamSet_Informix.database# tendrá un valor por defecto de "default"
Informix Enterprise: base de datos parametrizada a #ConnParamSet_Informix.database# tendrá un valor por defecto de "default"
Informix Cargar: base de datos parametrizada a #ConnParamSet_Informix.database# tendrá un valor por defecto de "default"
Informix Carga de XPS: base de datos parametrizada a #ConnParamSet_Informix.database# tendrá un valor por defecto de "default"
Oracle: service_name parametrizado a #ConnParamSet_Oracle.service_name# tendrá un valor por defecto de "orcl"
Oracle Empresa: service_name parametrizado a #ConnParamSet_Oracle.service_name# tendrá un valor por defecto de "orcl"

Si la propiedad que falta es port, el proceso de importación genera avisos. Para abordar los avisos, especifique manualmente la información en los valores de trabajo de DataStage . A continuación, vuelva a compilar el trabajo.

La tabla siguiente muestra las conexiones que pueden tener propiedades que faltan, las propiedades que no se pueden recuperar, el valor predeterminado que se dará y el campo del que se derivó el valor original en DataStagetradicional.

Tabla 3. Conexiones y propiedades
Nombre de conexión en DataStage tradicional	Nombre de conexión en DataStage moderno	Faltan propiedades a las que se proporciona automáticamente un parámetro predeterminado	Faltan propiedades a las que se asigna automáticamente un valor predeterminado	Notas
Conector ODBC	ODBC	nombre de host base de datos	port = 0 dsn_type = DB2
ODBC Enterprise Connector	ODBC Enterprise	nombre de host base de datos	port = 0 dsn_type = DB2	Si dsn_type no está en la lista de valores permitidos, el valor predeterminado es DB2.
DRS Connector	ODBC, Oracle, IBM Db2 for DataStage (no disponible en la versión moderna de DataStage)	advanced.hostname	advanced.port = 0	La conexión, de forma predeterminada, se migrará como un conector Db2. Si utiliza un parámetro para el Tipo de base de datos, DRS se migra como Db2 de forma predeterminada. La propiedad RDBMS no se puede parametrizar. Especifique uno de ODBC, Oracleo Db2 o el flujo se importará con una etapa aleatoria como marcador de posición y se omitirá la compilación del flujo. Debe suprimir manualmente la etapa aleatoria y añadir la que desee.
Informix Cargar	Informix	Anfitrión Contraseña nombre de usuario	port = 1526
Informix Enterprise (si servidor remoto = true)	Informix	Anfitrión servidor	port = 1526
Informix Enterprise (Si el servidor remoto = false)	Informix	nombre de usuario Contraseña Anfitrión servidor	port = 1526
CLI de Informix	Informix	Anfitrión nombre de usuario Contraseña	port = 1526
Informix Carga de XPS	Informix	Anfitrión	port = 1526
Db2 Carga masiva Z (PxDB2Z)	Db2 for z/OS®	Anfitrión	puerto = 446	En los trabajos migrados que contienen esta conexión, DataStage convierte automáticamente otras propiedades en otras comparables en DataStagemoderno. Después de migrar trabajos, asegúrese de comprobar todas las propiedades de conexión para sus valores adecuados y proporcionarlos donde sea necesario.

Actualizar información de credenciales

Para las etapas siguientes, debe sustituir algunas propiedades una vez finalizado el proceso de importación:

Google BigQuery
Google Cloud Storage
Google Cloud Pub/Sub

Una vez finalizado el proceso de importación, especifique los valores correctos para los campos siguientes:

client_id
client_secret
access_ token
refresh_token

Habilitar conexiones de flujo

Si tiene un trabajo en DataStage tradicional que desea importar que tiene una conexión, puede tener las propiedades de conexión incluidas en la definición de flujo al migrar el trabajo a DataStagemoderno. Para migrar el trabajo de esta forma, debe utilizar el mandato de CLI dsjob para migrar el archivo ISX que contiene los trabajos. También debe habilitar las conexiones de flujo añadiendo el parámetro --enable-local-connection al mandato.

Configuración del certificado SSL

La configuración del certificado SSL varía en función del conector. Si el conector se está migrando a un conector de plataforma (por ejemplo, Microsoft SQL Server, Greenplum, SAP ASE, Informix), puede proporcionar el certificado SSL en la interfaz de usuario de conexión después de la migración.

¿Fue útil el tema?

0/1000