Criar e Monitorar Jobs

Um job é um recurso do Oracle Cloud Infrastructure que permite criar e executar jobs SQL de forma assíncrona em um único Banco de Dados Gerenciado ou em todos os Bancos de Dados Gerenciados de um Grupo de Bancos de Dados.

Antes de criar um job e monitorar suas execuções e outras execuções, você deve:

Para ir para a seção Jobs:

  1. Acesse a console do Oracle Cloud Infrastructure.
  2. Abra o menu de navegação, clique em Observabilidade e Gerenciamento. Em Database Management, clique em Diagnóstico e Gerenciamento.
  3. Dependendo se você deseja criar um job para um único Banco de Dados Gerenciado ou um Grupo de Bancos de Dados, vá para uma destas páginas:
  4. No painel esquerdo, em Recursos, clique em Jobs.

As seguintes guias são exibidas na seção Jobs:

  • Definições: Nesta guia, você pode criar um job e exibir os jobs que estão no estado Ativo e foram criados dentro do período selecionado no campo Período.
  • Execuções: Nesta guia, você pode monitorar processamentos e execuções de jobs.

Criar um Job

Você pode criar um job SQL para executar operações administrativas em um único Banco de Dados Gerenciado ou em um Grupo de Bancos de Dados.

As informações fornecidas ao criar um job são para permitir que os seguintes componentes se conectem e interajam:

  • O único Banco de Dados Gerenciado ou o Grupo de Bancos de Dados no qual o job será executado.
  • Para Bancos de Dados Externos, o serviço Management Agent do Oracle Cloud Infrastructure que é instalado em um host e tem uma conexão com o serviço External Database é usado para executar o job.
    Observação

    O serviço Management Agent não é obrigatório para Bancos de Dados do Oracle Cloud e Autonomous Databases.
  • O bucket do serviço Object Storage do Oracle Cloud Infrastructure no qual os resultados de um job do tipo Consulta são armazenados.

Para criar um job:

  1. Vá para a página Detalhes do banco de dados gerenciado do Banco de Dados Gerenciado ou para a página Detalhes do grupo de bancos de dados do Grupo de Bancos de Dados cujo job você deseja criar.
  2. No painel esquerdo, em Recursos, clique em Jobs.
  3. Na seção Jobs, clique na guia Definições e, em seguida, clique em Criar job.
  4. No painel Criar job:
    1. Forneça as seguintes informações para o job SQL:
      1. Nome do job: Informe um nome exclusivo para o job.
      2. Descrição do job: Como alternativa, informe uma descrição para o job.
      3. Tipo de SQL: Selecione o tipo de SQL. As opções disponíveis são:
        • Consulta
        • DML
        • DDL
        • PL*SQL
      4. Escolher compartimento: Selecione o compartimento no qual você deseja criar o job. O compartimento no qual o Banco de Dados Gerenciado ou o Grupo de Bancos de Dados reside é selecionado por padrão; no entanto, você pode optar por criar o job em outro compartimento.
      5. Timeout: Dependendo do tempo que o job SQL provavelmente levará, selecione uma das opções na lista drop-down e, com base na opção selecionada, o job será priorizado.
    2. Forneça detalhes da programação do job selecionando uma das seguintes opções:
      • Uma vez (imediatamente): Selecione para executar o job uma vez (imediatamente).
      • Uma vez (posterior): Selecione para executar o job uma vez (posterior) e especifique a hora em que ele deve ser executado.
      • Repetição: Selecione para executar um job várias vezes na frequência especificada. Se quiser especificar uma data final para o job programado, marque a caixa de seleção Definir data final.
    3. Selecione uma das opções disponíveis na lista drop-down Tipo de credencial para especificar as credenciais do banco de dados a serem conectadas ao Banco de Dados Gerenciado. Para obter informações sobre tipos de credenciais, consulte Usar Credenciais para Executar Tarefas de Diagnóstico e Gerenciamento.
      Observação

      • Se estiver criando um job para um Grupo de Bancos de Dados, você não poderá usar credenciais nomeadas e terá que selecionar a opção Nova credencial na lista drop-down Tipo de credencial e especificar o nome do usuário, o segredo da senha do usuário e a atribuição. Além disso, ao criar um job para um Grupo de Bancos de Dados, as credenciais do banco de dados devem ser aplicadas a todos os bancos de dados do Grupo de Bancos de Dados.
      • Ao criar um job programado (a ser executado uma ou várias vezes), se a mensagem Uma política for necessária... for exibida, clique em Adicionar política para exibir a política do controlador de recursos que concede aos recursos do Banco de Dados Gerenciado a permissão para acessar o segredo e adicioná-lo automaticamente. O serviço Oracle Cloud Infrastructure IAM cria a política e é adicionado a uma coleção de políticas chamadas DBMgmt_Resource_Policy no serviço IAM.
    4. Para um job do tipo Consulta, selecione o bucket do serviço Object Storage no qual os resultados do job serão armazenados. A seção Armazenamento de objetos Oracle para resultados do job com a lista drop-down Nome do bucket só será exibida se você tiver selecionado o job do tipo Consulta. O bucket do serviço Object Storage pode estar no mesmo compartimento do job ou em outro compartimento e você deve ter as permissões necessárias do serviço Object Storage para selecionar o bucket.

      Ao criar um job programado (a ser executado uma ou várias vezes), se a mensagem Uma política for necessária... for exibida, clique em Adicionar política para exibir a política do controlador de recursos que concede aos recursos do Banco de Dados Gerenciado a permissão para gravar os resultados do job programado em um bucket do Object Storage e adicioná-lo automaticamente. O serviço IAM cria a política e é adicionado a uma coleção de políticas chamadas DBMgmt_Resource_Policy no serviço IAM.

      Para obter informações sobre:

    5. Clique em Carregar SQL para carregar o comando SQL ou informá-lo no campo comando SQL. Se estiver informando um comando SQL, não adicione ; ou / à direita.
    6. Para jobs dos tipos Consulta, DML e PL*SQL, opcionalmente adicione variáveis de bind na seção Variáveis de bind. Se as variáveis de bind forem usadas como placeholders que devem ser substituídos por valores válidos para que a instrução seja executada com sucesso, clique em Adicionar variável de bind e especifique as seguintes informações:
      1. Posição: Selecione a posição da variável de bind.
      2. Tipo: Selecione o tipo para especificar se a variável de bind é uma variável in-bind ou out-bind.
      3. Tipo de dados: Selecione o tipo de dados relevante.
      4. Tipo de matriz: Informe o tipo de matriz para os tipos de dados Matriz de números e Matriz de strings. Observe que esse campo não será exibido se você selecionar Número, String ou CLOB no campo Tipo de dados.
      5. Valor: Informe o valor da variável de ligação.

      Para adicionar mais valores de variáveis de bind, clique em Adicionar variável de bind e forneça as informações necessárias. Para obter informações sobre variáveis de bind, consulte Bind Variables and Cursors no Oracle Database SQL Tuning Guide.

    7. Opcionalmente, clique em Mostrar opções avançadas para adicionar tags de formato livre ou definidas ao job. Se você tiver as permissões necessárias para criar um job, também terá permissões para adicionar tags de formato livre. Para adicionar uma tag definida, você deverá ter permissões para usar o namespace de tag.

      Para obter informações sobre:

    8. Clique em Criar job.
O novo job é listado na guia Definições da seção Jobs do Banco de Dados Gerenciado ou do Grupo de Bancos de Dados. O status do job será Ativo se estiver sendo executado e Inativo se já tiver sido executado.

Você pode clicar no ícone Ações (Ações) do job e executar as seguintes tarefas:

  • Exibir detalhes: Clique para ir até a página Detalhes do job e exibir os detalhes do job, processamentos e execuções de jobs, os Bancos de Dados Gerenciados associados nos quais o job é executado e execute tarefas relacionadas à tag. Para obter mais informações, consulte Monitorar Processamentos e Execuções de Jobs.
  • Clonar job: Clique para clonar o job.
  • Editar job: Clique para editar os detalhes dos jobs repetidos programados no estado Ativo.
  • Mover job: Clique para mover o job do compartimento atual para outro compartimento.
  • Excluir job: Clique para excluir o job.

Na guia Processamentos da seção Jobs, você pode exibir os processamentos e execuções de job associados. As execuções de job para o período selecionado no campo Período são exibidas juntamente com uma visão geral do status das execuções do job: Bem-sucedidas, Com Falha e Em andamento. Você pode clicar nos links de status de execução para filtrar as execuções por status.

Observação

As execuções de job para Bancos de Dados do Oracle Cloud têm um limite de tempo de 50 minutos. Se a execução do job exceder esse limite, ela falhará e um erro será exibido.

Você pode construir consultas métricas e criar alarmes no status da execução do job no serviço Oracle Cloud Infrastructure Monitoring usando a métrica dbmgmtJobExecutionsCount. Para obter mais informações, consulte Métricas de Diagnóstico e Gerenciamento para Bancos de Dados Oracle.

Veja um exemplo de consulta que você pode usar para criar um alarme de "job com falha":

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

Na consulta, a dimensão managedDbId é usada para notificá-lo de qualquer job com falha para o Banco de Dados Gerenciado cujo OCID é mencionado na consulta. Da mesma forma, você pode usar as seguintes dimensões:

  • managedDbGroupId: Para ser notificado sobre jobs com falha para todos os Bancos de Dados Gerenciados em um Grupo de Bancos de Dados.
  • jobId: A ser notificado se um job específico falhar.

Para obter mais informações sobre como criar um alarme, consulte Criando um Alarme Básico.

Monitorar Processamentos e Execuções de Jobs

Você pode monitorar as execuções e execuções de um job submetido para um Banco de Dados Gerenciado ou Grupo de Bancos de Dados. Uma execução de job é criada para cada Banco de Dados Gerenciado associado ao job e um processamento de job é a soma de execuções de um job específico processadas em uma data programada.

Para exibir processamentos e execuções de jobs:

  1. Vá para a página Detalhes do banco de dados gerenciado ou Detalhes do grupo de bancos de dados.
  2. No painel esquerdo em Escopo, certifique-se de que o compartimento no qual o job foi criado esteja selecionado.
  3. No painel esquerdo, em Recursos, clique em Jobs.
  4. Na seção Jobs, clique na guia Definições e, em seguida, clique no nome do job. Se preferir, clique no ícone Ações correspondente (Ações) e clique em Exibir detalhes.

A página Detalhes do job é exibida e fornece os detalhes do job, dos processamentos de job e das execuções, além dos Bancos de Dados Gerenciados associados nos quais o job é executado. Nesta página, você pode executar tarefas como editar, mover e excluir o job e usar tags. Além disso, você também pode monitorar cada execução de job e seu status. Para fazer isso:

  1. Na seção Execuções de job, expanda uma execução de job e clique em um link de execução de job.

    O link de execução de job está no seguinte formato:

    <Name of job>_<Name of Managed Database>_YYYY-MM-DD'T'HH:MM:SS.SSS
  2. Na página Detalhes da execução do job, verifique os detalhes como o status da execução do job, a SQL associada à execução e a duração da execução do job. Observe que a duração é o tempo necessário para que todo o workflow de execução do job seja concluído e não apenas o tempo necessário para que a SQL seja executada no banco de dados.
  3. Para um job do tipo Consulta, clique em Fazer download da saída para fazer download da saída de execução do job para um arquivo .txt.
    Observação

    A opção Fazer download da saída só está disponível para jobs do tipo Consulta e você só poderá usar essa opção se tiver as permissões necessárias do serviço Oracle Cloud Infrastructure Object Storage. Para obter mais informações, consulte Permissões Adicionais Necessárias para Usar Diagnóstico e Gerenciamento.