Use o nó Oracle no DataWorks para desenvolver, agendar e integrar tarefas Oracle a outros jobs. Este tópico descreve como desenvolver uma tarefa com um nó Oracle.
Informações básicas
O Oracle é um sistema de gerenciamento de banco de dados relacional (RDBMS) usado para armazenar e processar dados. Ele oferece serviços confiáveis, eficientes e seguros de gerenciamento e análise de dados. Para mais informações, consulte Oracle.
Pré-requisitos
-
Fluxo de negócios criado.
O Data Studio executa operações de desenvolvimento específicas do mecanismo com base em fluxos de negócios. Crie um fluxo de negócios antes de criar um nó. Para mais informações, consulte Criar um fluxo de negócios.
-
Fonte de dados Oracle criada.
Para acessar seu banco de dados Oracle, adicione-o ao DataWorks como uma fonte de dados Oracle. Para mais informações, consulte Fonte de dados Oracle.
NotaOs nós Oracle suportam apenas fontes de dados Oracle criadas com uma string de conexão JDBC.
(Opcional; obrigatório para usuários do Resource Access Management (RAM)) Usuário RAM usado no desenvolvimento da tarefa adicionado ao workspace de destino e com a função Development ou Workspace Administrator atribuída (esta última concede permissões amplas — atribua com cautela). Para mais informações sobre como adicionar membros e conceder permissões, consulte Adicionar membros a um workspace.
Limitações
Regiões suportadas: China (Hangzhou), China (Shanghai), China (Beijing), China (Shenzhen), China (Chengdu), China (Hong Kong), Singapura, Malásia (Kuala Lumpur), Alemanha (Frankfurt), EUA (Silicon Valley) e EUA (Virginia).
Etapa 1: Criar nó Oracle
-
Faça login no console do DataWorks. Na região de destino, clique em no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to Data Development.
Clique com o botão direito no fluxo de trabalho desejado e escolha .
Na caixa de diálogo Create Node, insira um Name para o nó e clique em OK. Após criar o nó, desenvolva e configure sua tarefa.
Etapa 2: Desenvolver tarefa Oracle
(Opcional) Selecionar fonte de dados Oracle
Se o workspace tiver várias fontes de dados Oracle, selecione a apropriada. Caso exista apenas uma fonte de dados Oracle, ela será usada por padrão.
Os nós Oracle suportam apenas fontes de dados Oracle criadas com uma string de conexão JDBC.
Desenvolver código SQL: Exemplo simples
Escreva a tarefa no editor de código. O exemplo a seguir consulta informações básicas sobre todas as tabelas acessíveis ao usuário atual:
SELECT * FROM ALL_TABLES;
Desenvolver código SQL: Usar parâmetros de agendamento
O DataWorks fornece o recurso Scheduling Parameter, que permite passar valores dinamicamente ao código das tarefas agendadas. Defina variáveis no código da tarefa usando o formato ${variable_name}. Em seguida, acesse Scheduling Settings > Scheduling Parameter no painel direito do editor de nós para atribuir um valor à variável. Para mais informações sobre os formatos suportados e a configuração de parâmetros de agendamento, consulte Formatos suportados para parâmetros de agendamento e Configurar e usar parâmetros de agendamento.
Exemplo: Consultar proprietários, nomes e datas de criação das tabelas criadas desde o mês anterior até o momento. O parâmetro de agendamento a está definido como $[add_months(yyyymm,-1)], que representa o mês anterior.
Veja o código de exemplo a seguir.
SELECT owner, object_name, created
FROM all_objects
WHERE object_type = 'TABLE' AND created >= TO_TIMESTAMP('${a}', 'YYYY-MM-DD');
Etapa 3: Configurar agendamento da tarefa
Para executar periodicamente a tarefa do nó, clique em Scheduling no lado direito da página de edição do nó e defina as configurações de agendamento conforme necessário. Para mais informações, consulte Visão geral das propriedades de agendamento de tarefas.
Configure o Rerun attribute e os Parent Nodes do nó antes de enviá-lo.
Etapa 4: Testar código da tarefa
Execute as operações de teste abaixo conforme necessário para verificar se a tarefa se comporta conforme o esperado.
-
(Opcional) Selecione um grupo de recursos e atribua valores personalizados aos parâmetros.
Clique no ícone
na barra de ferramentas. Na caixa de diálogo Parameter, selecione o grupo de recursos de agendamento para teste.Se o código da tarefa usar variáveis de parâmetro de agendamento, atribua valores a elas aqui para teste. Para mais detalhes sobre a lógica de atribuição de parâmetros, consulte Processo de depuração de tarefas.
-
Salve e execute o código da tarefa.
Clique no ícone
na barra de ferramentas para salvar o código da tarefa. Em seguida, clique no ícone
para executar a tarefa. -
(Opcional) Execute testes de fumaça (smoke testing).
Para validar se a tarefa agendada do nó executa conforme o esperado no ambiente de desenvolvimento, realize testes de fumaça durante ou após o envio do nó. Para mais informações, consulte Executar testes de fumaça.
Etapa 5: Enviar e publicar a tarefa
Após configurar a tarefa do nó, envie-a e publique-a. Depois de publicada, o nó executa periodicamente com base na configuração de agendamento.
Clique no ícone
na barra de ferramentas para salvar o nó.-
Clique no ícone
na barra de ferramentas para enviar a tarefa do nó.Na caixa de diálogo Submission, insira uma Change Description. Opcionalmente, escolha se deseja exigir revisão de código após o envio.
NotaConfigure o Rerun attribute e os Parent Nodes do nó antes de enviá-lo.
A revisão de código ajuda a garantir a qualidade e evita erros causados pela publicação direta de código não revisado em produção. Se a revisão de código estiver ativada, os revisores deverão aprovar o código do nó enviado antes da publicação. Para mais informações, consulte Revisão de código.
Se você usar um workspace no modo padrão, após enviar a tarefa com sucesso, clique em Publish no canto superior direito da página de edição do nó para implantar a tarefa no ambiente de produção. Para mais informações, consulte Publicar uma tarefa.
Próximas etapas
Depois de publicada, a tarefa executa periodicamente com base em sua configuração. Para monitorar o status, clique em O&M no canto superior direito da página do editor de nós para acessar o Operation Center e visualizar o status de agendamento e execução. Para mais informações, consulte Gerenciar tarefas agendadas.