Documentación de Oracle Cloud Infrastructure

Creación y supervisión de trabajos

Un trabajo es un recurso de Oracle Cloud Infrastructure que permite crear y ejecutar de forma asíncrona trabajos SQL en una única base de datos gestionada o en todas las bases de datos gestionadas de un grupo de bases de datos.

Antes de crear un trabajo y supervisar sus ejecuciones, debe:

Para ir a la sección Trabajos:

  1. Conéctese a la consola de Oracle Cloud Infrastructure.
  2. Abra el menú de navegación, haga clic en Observación y gestión. En Database Management, haga clic en Diagnóstico y gestión.
  3. En función de si desea crear un trabajo para una única base de datos gestionada o un grupo de bases de datos, vaya a una de las siguientes páginas:
  4. En el panel izquierdo, en Recursos, haga clic en Trabajos.

Los siguientes separadores se muestran en la sección Trabajos:

  • Definiciones: en este separador, puede crear un trabajo y ver los trabajos que tienen el estado Activo y creados dentro del período de tiempo seleccionado en el campo Período de tiempo.
  • Ejecuciones: en este separador, puede supervisar ejecuciones de trabajos.

Temas:

Creación de un trabajo

Puede crear un trabajo SQL para realizar operaciones administrativas en una única base de datos gestionada o un grupo de bases de datos.

La información proporcionada al crear un trabajo es para permitir que los siguientes componentes se conecten e interactúen:

  • Única base de datos gestionada o grupo de bases de datos en el que se ejecutará el trabajo.
  • Para bases de datos externas, el agente de gestión de Oracle Cloud Infrastructure que está instalado en un host y que tiene una conexión a la base de datos externa se utiliza para ejecutar el trabajo.
    Nota

    El agente de gestión no es necesario para las bases de datos y las bases de datos autónomas de Oracle Cloud.
  • El cubo de Oracle Cloud Infrastructure Object Storage en el que se almacenan los resultados del trabajo para un trabajo de tipo Consulta.

Para crear un trabajo:

  1. Vaya a la página Detalles de base de datos gestionada de la base de datos gestionada o a la página Detalles de grupo de bases de datos del grupo de bases de datos para el que desea crear el trabajo.
  2. En el panel izquierdo, en Recursos, haga clic en Trabajos.
  3. En la sección Trabajos, haga clic en el separador Definiciones y, a continuación, haga clic en Crear trabajo.
  4. En el panel Crear trabajo:
    1. Proporcione la siguiente información para el trabajo SQL:
      1. Nombre del trabajo: introduzca un nombre único para el trabajo.
      2. Descripción del trabajo: opcionalmente, introduzca una descripción para el trabajo.
      3. Tipo SQL: seleccione el tipo SQL. Las opciones disponibles son:
        • Consulta
        • DML
        • DDL
        • PL*SQL
      4. Elegir compartimento: seleccione el compartimento en el que desea crear el trabajo. El compartimento en el que reside la base de datos gestionada o el grupo de bases de datos está seleccionado por defecto; sin embargo, puede optar por crear el trabajo en otro compartimento.
      5. Timeout: en función del tiempo que es probable que tarde el trabajo SQL, seleccione una de las opciones de la lista desplegable y, en función de la opción seleccionada, se prioriza el trabajo.
    2. Proporcione detalles de programación para el trabajo seleccionando una de las siguientes opciones:
      • Una vez (inmediatamente): seleccione esta opción para ejecutar el trabajo una vez (inmediatamente).
      • Una vez (más tarde): seleccione esta opción para ejecutar el trabajo una vez (más tarde) y especifique la hora en que se debe ejecutar.
      • Repetitivo: seleccione esta opción para ejecutar un trabajo varias veces con la frecuencia especificada. Si desea especificar una fecha de finalización para el trabajo programado, debe seleccionar la casilla de control Definir fecha de finalización.
    3. Seleccione una de las opciones disponibles en la lista desplegable Tipo de credencial para especificar las credenciales de base de datos para conectarse a la base de datos gestionada. Para obtener información sobre los tipos de credenciales, consulte Uso de credenciales para realizar tareas de diagnóstico y gestión.
      Nota

      • Si crea un trabajo para un grupo de bases de datos, no puede utilizar credenciales con nombre y tendrá que seleccionar la opción Nueva credencial en la lista desplegable Tipo de credencial y especificar el nombre de usuario, el secreto de contraseña de usuario y el rol. Además, al crear un trabajo para un grupo de bases de datos, las credenciales de base de datos se deben aplicar a todas las bases de datos del grupo de bases de datos.
      • Al crear un trabajo programado (que se ejecutará una o varias veces), si se muestra el mensaje Se necesita una política..., haga clic en Agregar política para ver la política de entidad de recurso que otorga a los recursos de base de datos gestionada el permiso para acceder al secreto y agregarla automáticamente. El servicio Oracle Cloud Infrastructure IAM crea la política y se agrega a una recopilación de políticas denominada DBMgmt_Resource_Policy en el servicio IAM.
    4. Para un trabajo de tipo Consulta, seleccione el cubo de Object Storage en el que se almacenarán los resultados del trabajo. La sección Almacenamiento de objetos de Oracle para resultados de trabajo con la lista desplegable Nombre de cubo solo se muestra si ha seleccionado el trabajo de tipo Consulta. El cubo de Object Storage puede estar en el mismo compartimento que el trabajo o en otro compartimento, y debe tener los permisos necesarios del servicio Object Storage para seleccionar el cubo.

      Al crear un trabajo programado (que se ejecutará una o varias veces), si se muestra el mensaje Se necesita una política..., haga clic en Agregar política para ver la política de entidad de recurso que otorga a los recursos de base de datos gestionada el permiso para escribir los resultados del trabajo programado en un cubo de Object Storage y agregarla automáticamente. El servicio IAM crea la política y se agrega a una recopilación de políticas denominada DBMgmt_Resource_Policy en el servicio IAM.

      Para obtener información sobre:

    5. Haga clic en Cargar SQL para cargar el comando SQL o introdúzcalo en el campo Comando SQL. Si introduce un comando SQL, no agregue un ; o / final.
    6. Para los trabajos de tipo Consulta, DML y PL*SQL, agregue de forma opcional variables de enlace en la sección Variables de enlace. Si las variables de enlace se utilizan como marcadores de posición que se deben sustituir por valores válidos para que la sentencia se ejecute correctamente, haga clic en Agregar variable de enlace y especifique la siguiente información:
      1. Posición: seleccione la posición de la variable de enlace.
      2. Tipo: seleccione el tipo para especificar si la variable de enlace es una variable en enlace o fuera de enlace.
      3. Tipo de dato: seleccione el tipo de dato relevante.
      4. Tipo de matriz: introduzca el tipo de matriz para los tipos de dato Matriz de números y Matriz de cadenas. Tenga en cuenta que este campo no se muestra si selecciona Número, Cadena o CLOB en el campo Tipo de datos.
      5. Valor: introduzca el valor de la variable de enlace.

      Para agregar más valores de variables de enlace, haga clic en Agregar variable de enlace y proporcione la información necesaria. Para obtener información sobre las variables de enlace, consulte Variables de enlace y cursores en Oracle Database SQL Tuning Guide.

    7. También puede hacer clic en Mostrar opciones avanzadas para agregar etiquetas definidas o de formato libre al trabajo. Si tiene los permisos necesarios para crear un trabajo, también los tiene para agregar etiquetas de formato libre. Para agregar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta.

      Para obtener información sobre:

    8. Haga clic en Crear trabajo.
El nuevo trabajo se muestra en el separador Definiciones de la sección Trabajos de la base de datos gestionada o el grupo de bases de datos. El estado del trabajo es Activo si se está ejecutando e Inactivo si ya se ha ejecutado.

Puede hacer clic en el icono Acciones (Acciones) del trabajo y realizar las siguientes tareas:

  • Ver detalles: haga clic para ir a la página Detalles del trabajo y ver los detalles del trabajo, las ejecuciones de trabajos y las bases de datos gestionadas asociadas en las que se ejecuta el trabajo y realizar tareas relacionadas con las etiquetas. Para obtener más información, consulte Supervisión de ejecuciones de trabajos.
  • Clonar trabajo: haga clic para clonar el trabajo.
  • Editar trabajo: haga clic para editar los detalles de los trabajos repetitivos programados con el estado Activo.
  • Mover trabajo: haga clic para mover el trabajo del compartimento actual a otro compartimento.
  • Suprimir trabajo: haga clic para suprimir el trabajo.

En el separador Ejecuciones de la sección Trabajos, puede ver las ejecuciones de trabajos asociadas. Las ejecuciones de trabajo para el período de tiempo seleccionado en el campo Período de tiempo se muestran junto con una visión general del estado de las ejecuciones de trabajo: Finalizado correctamente, Con fallos y En curso. Puede hacer clic en los enlaces de estado de ejecución para filtrar las ejecuciones por estado.

Nota

Las ejecuciones de trabajos para bases de datos de Oracle Cloud tienen un límite de tiempo de 50 minutos. Si la ejecución del trabajo supera este límite, falla y se muestra un error.

Puede crear consultas en las métricas y alarmas sobre el estado del trabajo en el servicio Oracle Cloud Infrastructure Monitoring mediante la métrica dbmgmtJobExecutionsCount. Para obtener más información, consulte Métricas de diagnóstico y gestión para bases de datos Oracle.

A continuación, se muestra un ejemplo de una consulta que puede utilizar para crear una alarma de "trabajo fallido":

dbmgmtJobExecutionsCount[1m]{managedDbId = "<OCID of the Oracle Database>", status = "Failed"}.mean()

En la consulta, la dimensión managedDbId se utiliza para notificarle de cualquier trabajo con fallos para la base de datos gestionada cuyo OCID se menciona en la consulta. Del mismo modo, puede utilizar las siguientes dimensiones:

  • managedDbGroupId: para recibir una notificación de los trabajos con fallos para todas las bases de datos gestionadas de un grupo de bases de datos.
  • jobId: se le notificará si falla un trabajo concreto.

Para obtener más información sobre cómo crear una alarma, consulte Creación de una alarma básica.

Supervisión de ejecuciones de trabajos

Puede supervisar las ejecuciones de un trabajo enviado para una base de datos gestionada o un grupo de bases de datos. Se crea una ejecución de trabajo para cada una de las bases de datos gestionadas asociadas al trabajo, y una ejecución de trabajo es la suma de ejecuciones de un trabajo específico que se haya ejecutado en una fecha programada.

Para ver las ejecuciones de trabajos:

  1. Vaya a la página Detalles de base de datos gestionada o Detalles de grupo de bases de datos.
  2. En el panel izquierdo, en Ámbito, asegúrese de que el compartimento en el que se creó el trabajo esté seleccionado.
  3. En el panel izquierdo, en Recursos, haga clic en Trabajos.
  4. En la sección Trabajos, haga clic en el separador Definiciones y, a continuación, haga clic en el nombre del trabajo. También puede hacer clic en el icono Acciones correspondiente (Acciones) y en Ver detalles.

Se muestra la página Detalles del trabajo, que proporciona los detalles del trabajo, las ejecuciones del trabajo y las bases de datos gestionadas asociadas en las que se ejecuta el trabajo. En esta página, puede realizar tareas como editar, mover y suprimir el trabajo y utilizar etiquetas. Además, también puede supervisar la ejecución de cada trabajo y su estado. Para hacerlo:

  1. En la sección Ejecuciones de trabajos, amplíe una ejecución de trabajo y haga clic en un enlace de ejecución de trabajo.

    El enlace de ejecución del trabajo tiene el siguiente formato:

    <Name of job>_<Name of Managed Database>_YYYY-MM-DD'T'HH:MM:SS.SSS
  2. En la página Detalles de ejecución de trabajo, revise los detalles como el estado de ejecución del trabajo, el SQL asociado a la ejecución y la duración de la ejecución del trabajo. Tenga en cuenta que la duración es el tiempo que tarda en terminar todo el flujo de trabajo de ejecución de trabajos y no solo el tiempo que tarda en ejecutarse SQL en la base de datos.
  3. Para un trabajo de tipo Consulta, haga clic en Descargar salida para descargar la salida de ejecución del trabajo en un archivo .txt.
    Nota

    La opción Descargar salida solo está disponible para trabajos de tipo Consulta y solo puede utilizar esta opción si tiene los permisos de servicio necesarios de Oracle Cloud Infrastructure Object Storage. Para obtener más información, consulte Permisos adicionales necesarios para utilizar diagnóstico y gestión.