0 / 0
Volver a la versión inglesa de la documentación
Migración de trabajos de DataStage
Última actualización: 09 dic 2024
Migración de trabajos de DataStage

Puede migrar trabajos de DataStage creando e importando archivos ISX que contengan la información de trabajo. Realice otras tareas posteriores a la migración cuando sea aplicable.

Procedimiento

Realice las tareas siguientes para migrar DataStage®. Después de importar el archivo ISX, es posible que se apliquen otras tareas, en función de las conexiones, las etapas y otros componentes de los trabajos migrados.
  1. Crear e importar el archivo ISX
  2. Migrar conexiones
  3. Etapas de migración
  4. Revise los conjuntos de parámetros y los valores PROJDEF
  5. Actualizar scripts que utilizan la interfaz de línea de mandatos dsjob
  6. Migrar trabajos de secuencia
  7. Vuelva a escribir el código de rutina para las subrutinas antes y después del trabajo

Crear e importar el archivo ISX

Cree y exporte un archivo ISX utilizando uno de los métodos que se listan en la tabla siguiente:

Opción Instrucciones
ISTOOL Utilice ISTOOL para crear un archivo ISX y exportarlo. Para obtener instrucciones, consulte Mandato de exportación para activos de InfoSphere DataStage and QualityStage y How to use ISTOOL to EXPORT IMPORT Information Server Components.
MettleCI Utilice MettleCI, que es un servicio de terceros, para convertir un diseño de trabajo de servidor en un diseño de trabajo paralelo equivalente y, a continuación, cree un archivo ISX y exporte el archivo al sistema. Para obtener más información, consulte Documentos de MettleCLI.
Cliente de GUI de InfoSphere Information Server Manager Utilice el cliente de la GUI de Information Server Manager para exportar el archivo ISX. Para obtener instrucciones detalladas, consulte Exportar activos
Nota: Asegúrese de que la exportación del archivo ISX incluya dependencias, como conjuntos de parámetros y definiciones de tabla. Si el soporte de carpetas está habilitado, las estructuras de carpetas se volverán a crear al importar.
Nota: DataStage, Orchestration Pipelines, y IBM Cloud® Object Storage al tamaño de instancia Large antes de importar su archivo .ISX. Después de la migración, se necesitan menos recursos y puede reducir la escala. Si está experimentando problemas incluso con un tamaño de instancia grande , es posible que tenga que personalizar la configuración. Para obtener más información, consulte troubleshooting.html#reference_mwl_byg_wpb__largeisx.
Realice los pasos siguientes para importar el archivo ISX:
  1. Abra un proyecto existente o cree uno nuevo.
  2. En el separador Activos del proyecto, pulse Nuevo activo > Constructores gráficos > DataStage.
  3. Pulse la pestaña Archivo local y, a continuación, cargue el archivo ISX desde el sistema local. A continuación, pulse Crear.
    Nota: El archivo ISX debe existir en el escritorio o en la unidad de red. No arrastre el archivo como archivo adjunto desde otra aplicación.

El informe de importación de activos contiene información de estado y mensajes de error que puede utilizar para resolver los problemas de la importación de ISX. Para obtener información sobre la visualización y el uso del informe para solucionar problemas, consulte Informe de importación de activos (DataStage).

Migrar conexiones

Si los trabajos migrados contienen conexiones, consulte Migración de conexiones en DataStage para obtener información.

Etapas de migración

Tabla 1. Etapas y sus consideraciones de migración.
Etapas Consideraciones
Procedimiento almacenado Los procedimientos almacenados se migran al conector de plataforma correspondiente.

Todos los procedimientos almacenados en conectores de tipo Db2® se migran al conector Db2 estándar, incluidos los procedimientos almacenados para conectores como Db2 for i y Db2 for z/OS®. Sustituya manualmente el conector Db2 con el tipo de conector correcto y copie sobre la llamada de procedimiento almacenado.

Si los parámetros de entrada y salida no se pueden detectar en un procedimiento almacenado, se deja tal cual y se debe actualizar después de la migración para que coincida con la nueva sintaxis. Para obtener más información, consulte Uso de procedimientos almacenados en DataStage.

Revise los conjuntos de parámetros y los valores PROJDEF

Revise los conjuntos de parámetros y verifique que sus valores predeterminados son correctos después de la migración.

La migración crea y actualiza los conjuntos de parámetros PROJDEF . Si migra un trabajo con un conjunto de parámetros PROJDEF , revise el conjunto de parámetros PROJDEF y especifique valores predeterminados para el mismo. A continuación, dentro de flujos y ejecuciones de trabajo, cualquier valor de parámetro que sea $PROJDEF utiliza el valor del conjunto de parámetros PROJDEF .

Si se han definido valores de parámetros PROJDEF en el archivo DSParams, utilice el comando cpdctl dsjob create-dsparams para transferir esos valores al entorno de ejecución de su proyecto. Para obtener más información, consulte DSParams.

Actualizar scripts que utilizan la interfaz de línea de mandatos dsjob

Si tiene scripts que utilizan dsjob para ejecutar trabajos, actualice la llamada de script a dsjob completando los pasos siguientes:
  1. Descargue cpdctl: https://github.com/IBM/cpdctl/releases/
  2. Cree un script de shell de origen (source.sh) para configurar cpdctl. Cree un archivo de texto key.txt para la clave de cifrado. Consulte el ejemplo siguiente:
    #!/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

    Cambie las referencias a dsjob por cpdctl dsjob. Es posible que tenga que ajustar las opciones de línea de mandatos para que se ajusten al estilo de línea de mandatos de DataStage . Véase DataStage.

Migrar trabajos de secuencia

Puede importar un archivo ISX para migrar un trabajo de secuencia a un flujo de interconexión. Vuelva a escribir las expresiones en CEL y vuelva a seleccionar manualmente los valores para algunos nodos de interconexión. Consulte los siguientes temas para obtener más consideraciones: Ejecutar flujos en secuencia con Orchestration Pipelines y Migrar y construir flujos de pipeline para DataStage. Consulte Migrar rutinas BASIC en DataStage para obtener información sobre cómo reescribir rutinas BASIC como scripts.

Reescribir el código de rutina para las subrutinas antes y después del trabajo

Cuando migra subrutinas antes y después del trabajo, el código de rutina se almacena en un script .sh bajo /ds-storage/projects/<projectName>/scripts/DSU.<RoutineName>.sh. Reescriba el código de la rutina de la misma forma que una rutina BASIC, siguiendo los pasos de Migrar rutinas BASIC en DataStage para recuperar los argumentos de salida, pero incluya una sentencia de salida para la subrutina antes/después del trabajo. Consulte el ejemplo siguiente:
# TODO: Update the following json string and print it as the last line of the standard output.

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