DataWorks:Nó do OceanBase

Informações básicas

O OceanBase é um banco de dados relacional distribuído desenvolvido pelo Ant Group e pela alibaba. Ele oferece forte consistência de dados, alta disponibilidade, alto desempenho, escalabilidade online e custos reduzidos. Além disso, apresenta alta compatibilidade com padrões SQL e bancos de dados relacionais tradicionais. Para mais informações, consulte What is OceanBase.

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 Create a business flow.

• Adicione seu banco de dados OceanBase como uma source de dados do ApsaraDB for OceanBase no dataworks. Para saber como criar uma source de dados, consulte Data source management. Para obter detalhes sobre o uso de uma source de dados do ApsaraDB for OceanBase no dataworks, consulte ApsaraDB for OceanBase data source.

  Nota

  Os nós do OceanBase suportam apenas sources de dados do OceanBase criadas com uma string de conexão JDBC.

• Conexão de rede estabelecida entre sua source de dados e um grupo de recursos.

  Certifique-se de que a source de dados desejada esteja conectada ao grupo de recursos que você pretende utilizar. Para mais informações sobre como configurar a conectividade de rede, consulte Establish a network connection between a resource group and a data source.

• (Opcional; obrigatório para usuários do Resource Access Management (RAM)) O usuário RAM utilizado para o desenvolvimento de tarefas foi adicionado ao workspace de destino e recebeu a função Development ou Workspace Administrator (que concede permissões amplas — atribua com cautela). Para mais informações sobre como adicionar membros e conceder permissões, consulte Add members to a workspace.

Limitações

Regiões suportadas: China (Hangzhou), China (Shanghai), China (Beijing), China (Shenzhen), China (Chengdu), China (Hong Kong), Singapore, Malaysia (Kuala Lumpur), Germany (Frankfurt), US (Silicon Valley) e US (Virginia).

Etapa 1: Criar um nó do OceanBase

1. Faça login no console do DataWorks. Na região de destino, clique em Data Development and O&M > Data Development no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to Data Development.

2. Clique com o botão direito no fluxo de trabalho de destino e escolha Create Node > Database > OceanBase.

3. Na caixa de diálogo Create Node, insira um Name para o nó e clique em OK. Após a criação, use o nó para desenvolver e configure sua tarefa.

Etapa 2: Desenvolver uma tarefa do OceanBase

(Opcional) Selecionar uma source de dados do OceanBase

Se seu workspace possuir múltiplas sources de dados do OceanBase, selecione qual usar na página de configuração do nó. Caso haja apenas uma, ela será selecionada automaticamente.

Escrever código SQL: Exemplo básico

No editor de código do nó do OceanBase, escreva o código SQL da sua tarefa. O código a seguir serve como exemplo.

SELECT * FROM usertablename;

Escrever código SQL: Usar parâmetros de agendamento

O recurso Scheduling Parameter do dataworks permite passar valores dinamicamente para o código em tarefas agendadas periodicamente. Defina variáveis no seu código usando o formato ${variable_name}. No painel de navegação à direita, clique na aba Scheduling e atribua valores às variáveis na seção Scheduling Parameter. Para mais informações sobre os formatos suportados e como configurar parâmetros de agendamento, consulte Supported formats for scheduling parameters e Configure and use scheduling parameters.

O código a seguir serve como exemplo.

SELECT '${var}'; -- Example of using a scheduling parameter.

Etapa 3: Configurar o agendamento da tarefa

Para executar a tarefa do nó periodicamente, 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 Overview of task scheduling properties.

Etapa 4: Testar o código da tarefa

execute as operações de teste abaixo conforme necessário para verifique se a tarefa se comporta conforme o esperado.

1. (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 sua tarefa usar variáveis de parâmetro de agendamento, atribua valores a elas aqui para fins de teste. Para mais informações sobre a lógica de atribuição de parâmetros, consulte Task debugging process.

2. salve e execute o código da tarefa.

   Clique no ícone na barra de ferramentas para salvar o código da sua tarefa. Em seguida, clique no ícone para executar a tarefa.

3. (Opcional) Realize testes de fumaça (smoke testing).

   Para executar testes de fumaça no ambiente de desenvolvimento e verificar se a tarefa agendada do nó roda conforme o esperado, realize esses testes durante ou após o envio do nó. Para mais informações, consulte Perform smoke testing.

Etapa 5: Enviar e publicar a tarefa

Após configure a tarefa do nó, envie-a e publique-a. Uma vez publicada, o nó será executado periodicamente com base na sua configuração de agendamento.

1. Clique no ícone na barra de ferramentas para salve o nó.

2. Clique no ícone na barra de ferramentas para envie 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.

   Nota

   • configure 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 devem aprovar o código do nó enviado antes da publicação. Para mais informações, consulte Code review.

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 Publish a task.

Próximas etapas

Operações da tarefa: Após o envio e a publicação, a tarefa é executada periodicamente com base na configuração do nó. Clique em O&M no canto superior direito da página de edição do nó para acesse o Operation Center e visualize o status de agendamento e execução da tarefa agendada. Para mais informações, consulte Managing Scheduled Tasks.