DataWorks:Nó SQL Server

Contexto

O SQL Server é um sistema de gerenciamento de banco de dados relacional (RDBMS) que armazena e processa dados. Ele oferece serviços confiáveis, eficientes e seguros de gerenciamento e análise de dados. Para mais informações, consulte SQL Server.

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.

• Fonte de dados do SQL Server com string de conexão JDBC configurada. Para mais informações, consulte Data source management.

• (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 detalhes 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).

• Stored procedures não são suportadas.

Etapa 1: Criar nó SQL Server

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 desejado e escolha Create Node > Database > SQL Server.

3. Na caixa de diálogo Create Node, insira um Name para o nó e clique em OK.

Etapa 2: Desenvolver tarefa SQL Server

(Opcional) Selecionar fonte de dados SQL Server

Se o workspace tiver múltiplas fontes de dados SQL Server, selecione a fonte necessária na página de edição do nó. Caso exista apenas uma fonte de dados SQL Server, ela será usada por padrão.

Desenvolver código SQL: Exemplo simples

No editor de código do nó, escreva o código SQL da tarefa. O exemplo abaixo consulta informações básicas de todas as tabelas de usuário em um banco de dados SQL Server:

SELECT * FROM sys.tables;

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

O DataWorks oferece o recurso Scheduling Parameter, que permite passar valores dinamicamente para o código em cenários de agendamento periódico. Defina variáveis no código da tarefa usando o formato ${variable_name}. Em seguida, no painel de navegação à direita do editor de nós, acesse Scheduling Properties > Scheduling Parameter para atribuir um valor à variável. Para mais detalhes sobre os formatos suportados e a configuração de parâmetros de agendamento, consulte Supported formats for scheduling parameters e Configure and use scheduling parameters.

Exemplo: Consultar os nomes e datas de criação de todas as tabelas definidas pelo usuário criadas no último ano. O parâmetro de agendamento a está definido como $[add_months(yyyymmdd,-12)], que representa a data de um ano atrás.

O código a seguir apresenta um exemplo.

SELECT name, create_date
FROM sys.tables
WHERE type = 'U' AND create_date >= '${a}';

Etapa 3: Configurar 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 código da tarefa

Execute as operações de teste abaixo conforme necessário para validar 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 tarefa usar variáveis de parâmetro de agendamento, atribua valores a elas neste local para teste. Para mais detalhes 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 tarefa. Em seguida, clique no ícone para executar a tarefa.

3. (Opcional) Execute 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 corretamente, 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 configurar a tarefa do nó, envie-a e publique-a. Depois de publicada, o nó executa periodicamente com base na configuração de agendamento definida.

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

2. 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.

   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 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 executa periodicamente conforme a configuração do nó. Clique em O&M no canto superior direito da página de edição do nó para acessar o Operation Center e visualizar o status de agendamento e execução da tarefa programada. Para mais informações, consulte Managing Scheduled Tasks.