DataWorks:Nó do PostgreSQL

Informações básicas

O PostgreSQL é um sistema de gerenciamento de banco de dados relacional (RDBMS) open-source poderoso e flexível. Ele oferece um modelo de dados robusto, alta escalabilidade e estabilidade, além de um conjunto rico de funcionalidades principais. Para mais informações, consulte PostgreSQL.

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.

• source de dados do PostgreSQL criada.

  Adicione seu banco de dados PostgreSQL como uma source de dados do PostgreSQL no DataWorks antes de acessar os dados. Para mais informações, consulte source de dados do PostgreSQL.

  Nota

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

• (Opcional; obrigatório para usuários do Resource Access Management (RAM)) Usuário RAM usado para o desenvolvimento da tarefa adicionado ao workspace de destino e com a função Development ou Workspace Administrator atribuída (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.

Limites

Este recurso está disponível nas seguintes regiões: 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ó do PostgreSQL

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

3. 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 a tarefa no editor correspondente.

Etapa 2: Desenvolver tarefa do PostgreSQL

(Opcional) Selecionar source de dados do PostgreSQL

Se o workspace tiver múltiplas sources de dados do PostgreSQL, selecione a necessária na página do editor de nós. Caso exista apenas uma source de dados, o DataWorks a utiliza por padrão.

Desenvolver código SQL: exemplo simples

No editor de código do nó do PostgreSQL, escreva o script SQL da tarefa. O exemplo a seguir mostra como consultar informações sobre todas as tabelas base em um banco de dados PostgreSQL:

SELECT * FROM information_schema.tables
WHERE table_type = 'BASE TABLE';

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

O DataWorks fornece o Scheduling Parameter para passar valores dinamicamente ao código em jobs agendados. Defina variáveis no código da tarefa usando o formato ${variable_name}. Em seguida, no painel à direita do editor de nós, acesse Scheduling Settings > Scheduling Parameter para atribuir um valor a cada variável. Para mais informações sobre formatos suportados e configuração, consulte Formatos de parâmetros de agendamento e Configurar e usar parâmetros de agendamento.

Exemplo: Consultar informações sobre todas as tabelas base em um banco de dados. Defina o valor do parâmetro a como BASE_TABLE.

Código de exemplo:

SELECT * FROM information_schema.tables
WHERE table_type = '${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 configure as definições de agendamento conforme necessário. Para mais informações, consulte Visão geral das propriedades de agendamento de tarefas.

Etapa 4: Testar código da tarefa

Realize as operações de teste abaixo conforme necessário para verificar 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 utilizar 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.

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 validar se a tarefa agendada executa corretamente no ambiente de desenvolvimento, realize testes de fumaça durante ou após o envio do nó. Para mais informações, consulte Realizar 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 publicado, 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 deverão aprovar o código do nó enviado antes da publicação. Para mais informações, consulte Revisão de código.

Se estiver usando 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

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 agendada. Para mais informações, consulte Gerenciar tarefas agendadas.