Documentación de Oracle Cloud Infrastructure

Configuración de parámetros entrantes para tareas

Este procedimiento solo se aplica a tareas donde se han asignado parámetros o en los flujos de datos subyacentes de las tareas de integración.

Los parámetros asignados tienen valores por defecto que se utilizan durante el diseño y el tiempo de ejecución del pipeline.

Si lo desea, puede sustituir el valor por defecto de un parámetro entrante en el tiempo del diseño y en el tiempo de ejecución. También puede sustituir el valor por defecto de un parámetro que se utilice dentro de una expresión en un parámetro entrante.

Para sustituir un valor, puede definir directamente otro valor en el tiempo de diseño o agregar un parámetro definido por el usuario de pipeline para que el valor se defina en tiempo de ejecución. Si corresponde, también puede asignar a la entrada un valor de parámetro del sistema o un valor de una salida de un operador anterior.

  1. En el lienzo de un pipeline, seleccione la tarea para la que desea ver o configurar valores para los parámetros entrantes.
  2. En el panel Propiedades de la tarea seleccionada, seleccione Configuración.
  3. Junto a Parámetros entrantes configurados, revise el número de parámetros entrantes configurados y disponibles.
    Por ejemplo, 4/0 significa que hay cuatro parámetros entrantes disponibles en esta tarea y que ninguno se ha reconfigurado.
  4. Seleccione Configurar junto a Parámetros entrantes configurados.
  5. En la página Configurar parámetros entrantes, revise las entradas que se pueden reconfigurar.
    Una entrada tiene un Valor por defecto. Si se reconfigura el parámetro entrante, la entrada tiene un Valor configurado. Un valor configurado puede ser un nombre de parámetro definido por el usuario con el valor configurado entre paréntesis.
  6. (Opcional) En la fila del tipo y el valor de parámetro que desea reconfigurar, seleccione Configurar.
    Si el parámetro entrante ya se ha reconfigurado, seleccione Editar para cambiar el valor configurado o seleccione Borrar para eliminar el valor.
  7. En la página Configurar parámetro entrante para <tipo> que Se muestra para el parámetro seleccionado, realice una de las opciones del parámetro de configuración de entrada, y a continuación, seleccione Listo para volver a la página anterior.

    Tenga en cuenta lo siguiente al configurar los parámetros entrantes:

    • Si una tarea está configurada para ejecutarse en el servicio OCI Data Flow, utilice el siguiente formato si está editando los valores de parámetro por defecto para OCI_DF_LOG_BUCKET y OCI_DF_ARTIFACT_BUCKET: oci://<bucket-name>@<tenancy-name>

    • Si la estrategia de extracción incremental para un origen de BICC está configurada para utilizar una fecha gestionada por el parámetro del sistema de Data Integration SYS.LAST_LOAD_DATE, no puede cambiar el valor de fecha durante el tiempo de diseño.

    • Si la estrategia de extracción incremental para un origen de BICC está configurada para utilizar una fecha de última extracción con parámetros que ha agregado, puede cambiar el valor de fecha durante el tiempo de diseño y el tiempo de ejecución.

    • Si se configura una entidad de datos de destino con parámetros para utilizar la estrategia de fusión, puede cambiar la selección de clave de fusión.

    • Para un activo de datos con parámetros que requiere una ubicación temporal: si selecciona un activo de datos que no tiene una ubicación temporal por defecto especificada en ese activo de datos, Data Integration muestra una notificación de advertencia. Cuando vea la notificación, seleccione una de las siguientes opciones:
      • Actualice el activo de datos añadiendo una ubicación temporal por defecto.
      • Elija otro activo de datos que tenga una ubicación temporal por defecto.

    • Para una tarea de OCI Data Flow con parámetros:

      • Con una unidad de controlador o ejecutor con parámetros, las OCPU y los valores de memoria se ignoran si se configura una unidad no flexible en el parámetro. Las OCPU y los valores de memoria se utilizan solo al configurar una unidad flexible como valor de parámetro.

      • Con OCPU con parámetros y valores de memoria para una unidad flexible, asegúrese de especificar un valor que esté en el rango de valores aceptable para esa propiedad. Los valores aceptables para las OCPU dependen de la unidad flexible. Los valores aceptables para la memoria dependen del valor de OCPU.

    Opción de entrada Descripción
    Asignar un valor

    Sustituya el valor por defecto de este parámetro especificando un valor directamente. La forma de especificar un valor depende del tipo de parámetro entrante.

    Por ejemplo, introduzca un valor en un campo para un tipo numérico, de cadena o de fecha, pero utilice un menú para seleccionar un valor para un parámetro de tipo activo de datos, conexión, esquema y entidad de datos. Para un tipo de condición o de expresión, utilice el editor de condiciones o de expresiones.
    Salida de operador anterior

    Para utilizar un valor de salida de un operador anterior como entrada de este parámetro, seleccione un valor de la lista de salidas disponibles.

    Solo están disponibles para su selección las salidas del mismo tipo que el parámetro entrante.

    Por ejemplo, si un parámetro entrante es STRING, solo estarán disponibles SYS.STATUS y SYS.ERROR_MESSAGE.
    Asignar un parámetro

    Especifique un parámetro de pipeline para definir otro valor cuando se ejecute el pipeline. Puede asignar un parámetro definido por el usuario o un parámetro del sistema como entrada del parámetro entrante.

    • Usar parámetros definidos por el usuario: seleccione un parámetro definido por el usuario existente de la lista de parámetros disponibles, si los hay. Solo están disponibles para su selección los parámetros del mismo tipo que el parámetro entrante.

      Si corresponde, seleccione Agregar parámetro para crear el parámetro en el pipeline que desea seleccionar. En el panel de Agregar parámetro que se muestra, introduzca un nombre y la descripción opcional para el parámetro. No se puede cambiar el tipo de datos, que es el mismo que el tipo del parámetro entrante. El modo en que defina el resto de campos de un parámetro depende del tipo entrante. Para crear el parámetro, seleccione Agregar. Por defecto, se selecciona el parámetro definido por el usuario recién agregado.

    • Usar parámetros de sistema: seleccione un parámetro del sistema de la lista de parámetros disponibles generados por el sistema de tiempo de ejecución, si los hay. Solo están disponibles para su selección los parámetros del sistema del mismo tipo que el parámetro entrante. Los parámetros del sistema OCID se tratan como STRING.

      Por ejemplo, si un parámetro entrante es VARCHAR, solo están disponibles TASK_RUN_NAME, TASK_RUN_KEY, PARENT_TASK_RUN_KEY, TASK_SCHEDULE_TIMEZONE, PIPELINE_NAME y PIPELINE_IDENTIFIER.
  8. En la página Configurar parámetros entrantes, revise el valor por defecto y el valor configurado del parámetro que acaba de reconfigurar.
    Un valor configurado puede ser un nombre de parámetro definido por el usuario con el valor configurado entre paréntesis.
  9. Repita los pasos 6 y 7 para configurar otros valores de entrada, según sea necesario. También puede seleccionar Editar o Borrar para cambiar un valor configurado anteriormente.
  10. En la página Configurar parámetros entrantes, seleccione Configurar cuando haya terminado la configuración de valores para los parámetros entrantes en la tarea.