Tarefa do Script de transformação de dados

A tarefa do script transformador de dados permite escrever, editar e avaliar modelos personalizados em Jsonnet (em inglês) para realizar o mapeamento de dados na sua integração.

Para mais informações sobre o mapeamento de dados no Application Integration, consulte Visão geral do mapeamento de dados.

Configurar a tarefa do script transformador de dados

Para adicionar uma tarefa do script transformador de dados à sua integração, siga estas etapas:

  1. No console do Google Cloud, acesse a página Application Integration.

    Acessar o Application Integration

  2. No menu de navegação, clique em Integrações.

    A página Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.

  3. Selecione uma integração ou clique em Criar integração para criar uma nova.

    Caso você esteja criando uma nova integração, siga estas etapas:

    1. Insira um nome e uma descrição no painel Criar integração.
    2. Selecione uma região para a integração.
    3. Selecione uma conta de serviço para a integração. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas de integração.
    4. Clique em Criar.

    Isso abre a integração na página do editor de integração.

  4. Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas e conectores disponíveis.
  5. Clique e posicione o elemento do script transformador de dados no editor de integração.
  6. Clique no elemento do script transformador de dados no designer para visualizar o painel de configuração de tarefas do script transformador de dados.
  7. Clique em Abrir editor do script transformador de dados.
  8. O editor do script transformador de dados é exibido com um exemplo de modelo comentado em Jsonnet padrão.
  9. Escreva seu código Jsonnet e feche o editor quando ele for concluído. Todas as alterações serão salvas automaticamente.

Como usar o editor do script transformador de dados

Use o editor do script transformador de dados para acessar as variáveis de integração, realizar atribuições de variáveis e adicionar ou modificar variáveis na sua integração. O editor do script transformador de dados fornece os seguintes recursos para enriquecer sua experiência de scripting:

  • Destaque de sintaxe/código, recuo e numeração de linhas para facilitar a legibilidade do código e o reconhecimento da estrutura.
  • Um minimapa que exibe uma visão geral de alto nível do código do script e ajuda na navegação rápida.
  • Opção clique para copiar o código na área de transferência.

Para abrir o editor, acesse o painel de configuração da tarefa do script transformador de dados e clique em Abrir editor do script transformador de dados.

Por padrão, o editor de scripts do Transformador de Dados importa functions, uma biblioteca personalizada predefinida contendo um conjunto de funções Jsonnet para mapeamento de dados no Application Integration. Para detalhes sobre as funções personalizadas disponíveis, consulte Funções do transformador de dados.

A imagem a seguir mostra o layout de amostra do editor de script do Data Transformer:

imagem mostrando o editor de script do transformador de dados imagem mostrando o editor de script do transformador de dados

Acessar variáveis de integração

Para ler uma variável de integração existente no editor do Script transformador de dados, use a função extVar da biblioteca functions predefinida.

Exemplo: leia e atualize as variáveis de integração existentes usando o editor do script transformador de dados.

Script em Jsonnet

local f = import "functions"; // Import predefined Data Transformer function library

local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello"
local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World"
{
  OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar"
  "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var"
}

Saída

imagem mostrando exemplo de script transformador de dados imagem mostrando exemplo de script transformador de dados

Referência de uso do JSONnet

O jsonnet é uma linguagem puramente funcional e os programas dela são compostos de expressões. Para saber como formar essas expressões, consulte Expressões Jsonnet.

Cotas e limites

Para informações sobre os limites de uso que se aplicam à tarefa Script do transformador de dados, consulte Limites de uso.

A seguir