Documentación de Oracle Cloud Infrastructure

Creación de una tarea de SQL

Una tarea de SQL en Data Integration está asociada a un procedimiento almacenado en una base de datos.

La base de datos debe estar asociada a un activo de datos que ya se ha creado en el espacio de trabajo. Para crear un activo de datos, consulte Creación de un activo de datos.

Crear una tarea SQL en un proyecto o una carpeta. Data Integration incluye un proyecto por defecto para empezar. Para crear otro proyecto o carpeta, consulte Proyectos y carpetas.

En Data Integration, por defecto, puede tener ejecuciones de tareas simultáneas o paralelas de una tarea en un momento determinado. Para no permitir ejecuciones de tareas simultáneas iniciadas manualmente, seleccione la casilla de control Desactivar ejecución simultánea de la tarea al crear la tarea. Cuando no se permiten ejecuciones de tareas simultáneas, una solicitud de ejecución para la tarea falla si ya hay una ejecución de tarea en curso que está en un estado no terminal.

    1. En la página Tareas del proyecto o la carpeta en la que desea crear una tarea, seleccione Crear tarea y, a continuación, SQL. Si necesita ayuda para buscar la página Tareas en un proyecto o carpeta, consulte Listado de tareas.
    2. En la página Crear tarea SQL, introduzca un nombre y una descripción opcional.

      El identificador es un valor generado por el sistema basado en el nombre. Puede cambiar el valor, pero después de crear y guardar la tarea, no puede actualizar el identificador.

    3. Seleccione la casilla de control Desactivar Ejecución Simultánea de la Tarea si desea no permitir ejecuciones simultáneas de esta tarea.
    4. (Opcional) En Proyecto o carpeta, haga clic en Seleccionar y seleccione un proyecto o una carpeta diferentes en los que guardar la tarea.
    5. Para guardar la tarea por primera vez, seleccione uno de los siguientes botones:

      • Crear: crea y guarda la tarea. Puede seguir creando y editando la tarea.

      • Crear y cerrar: crea y guarda la tarea, cierra la página y le devuelve a la lista de tareas de la página de detalles de proyecto o carpeta.

    6. Guarde periódicamente mientras trabaja seleccionando uno de los siguientes botones:

      • Guardar: confirma los cambios desde la última vez que se guardó. Puede continuar editando después de guardar.

      • Guardar y cerrar: confirma los cambios, cierra la página y le devuelve a la lista de tareas de la página de detalles del proyecto o carpeta.

      • Guardar como: confirma los cambios (desde la última vez que se guardó) y guarda una copia en lugar de sobrescribir la tarea actual. Puede proporcionar un nombre para la copia y seleccionar otro proyecto o carpeta para la copia o guardar la copia en el mismo proyecto o carpeta que la tarea existente.

    7. En la sección SQL, haga clic en Seleccionar y seleccione el activo de datos asociado a la base de datos en la que se guarda el procedimiento almacenado que desea utilizar.

      En la página Seleccionar SQL que aparece, seleccione los tipos directamente o parametrice los tipos de recursos solo en el orden en que se muestran los tipos.

      1. Para buscar y seleccionar tipos de recursos directamente, haga clic en Seleccionar junto a un tipo cuando esté disponible para su selección.

        • Activo de datos: nombre del activo de datos.

        • Conexión: conexión que se utilizará para acceder a la base de datos asociada al activo de datos.

        • Esquema: esquema propietario del procedimiento almacenado.

        • Procedimiento almacenado: nombre del procedimiento almacenado que se va a utilizar para esta tarea de SQL.

          Para ver los parámetros de un procedimiento almacenado antes de seleccionar el procedimiento:

          1. En el panel Seleccionar Procedimiento Almacenado, seleccione Ver Todo.
          2. En el panel Buscar procedimiento almacenado, busque el procedimiento almacenado que desee y seleccione Ver parámetros en el menú Acciones (Menú Acciones) de ese procedimiento almacenado.
      2. Para asignar parámetros a los tipos de recursos:

        1. Seleccione Asignar parámetro junto a un tipo de recurso.

        2. En la página Asignar parámetro, realice una de las siguientes acciones:

          • Seleccione un parámetro en la lista. Solo los parámetros del mismo tipo de recurso aparecen en la lista para su selección.

          • Seleccione Agregar parámetro para agregar un parámetro para el tipo de recurso.

            1. En el panel Agregar parámetro, introduzca un identificador y una descripción opcional.

            2. Defina el valor por defecto del parámetro para el tipo de recurso.

              En el caso del tipo de procedimiento almacenado, puede ver los parámetros de un procedimiento almacenado antes de seleccionarlo. Seleccione Ver todo que está junto al menú Procedimiento almacenado. En el panel de Examinar procedimiento almacenado que aparece, busque el procedimiento almacenado que desee y seleccione Ver parámetros en el menú Acciones (Menú Acciones) de ese procedimiento almacenado.

            3. Haga clic en Agregar.

              El parámetro de tipo de recurso que se agrega se selecciona automáticamente en la página Asignar parámetro.

        3. Seleccione Asignar.
      3. En la página Seleccionar SQL, seleccione Listo.

        Volverá a la página Crear tarea SQL.

    8. En la sección Configurar parámetros, seleccione Configurar para revisar la lista de parámetros y configurar sus valores.

      El número de parámetros en el procedimiento almacenado se muestra junto a Parámetros configurados. Solo se pueden configurar valores de parámetros de entrada en el procedimiento almacenado.

      El valor configurado de un parámetro de entrada debe coincidir con el tipo de datos definido de ese parámetro. Por ejemplo, no puede proporcionar un valor STRING para un parámetro de entrada cuyo tipo de datos sea NUMERIC.

      En la página Configurar parámetros de procedimiento almacenados, configure un valor de parámetro siguiendo estos pasos:

      1. En la fila del valor del parámetro de entrada que desea configurar, seleccione Configurar.
      2. En el panel Editar parámetro, introduzca un valor para el parámetro de entrada y seleccione Guardar.

        Después de configurar un parámetro de entrada, puede editar o borrar el valor.

      3. Cuando termine de configurar los parámetros de entrada, seleccione Configurar.
    9. (Opcional) En la sección Validar tarea, seleccione Validar para comprobar los valores de parámetros configurados.

      Si hay errores o advertencias, seleccione Ver mensajes. Resuelva cualquier error antes de publicar la tarea.

      Nota

      Una tarea de SQL no se puede ejecutar si los parámetros de entrada del tipo de datos NUMERIC tienen NULL como valores por defecto configurados. Para evitar fallos de ejecución de tareas, cambie un valor de NULL a 0 (cero).
    10. Cuando termine de configurar la tarea, seleccione Crear y cerrar o Guardar y cerrar.
    Publique la tarea de SQL en una aplicación en Data Integration antes de ejecutar la tarea o programe la tarea para su ejecución. Para obtener información sobre la publicación, consulte Publicación en una aplicación de Data Integration.

  • Utilice el comando oci data-integration task create-task-from-SQL-task y los parámetros necesarios para crear una tarea SQL:

    oci data-integration task create-task-from-sql-task [OPTIONS]

    Para obtener una lista completa de indicadores y opciones de variables para los comandos de la CLI, consulte la Referencia de la línea de comandos.

  • Ejecute la operación CreateTask con el subtipo de recurso adecuado para crear una tarea SQL.