Visualização — Data Transformer Script task

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

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.

Saiba mais sobre o mapeamento de dados na Application Integration em 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 existente ou clique em Criar integração para criar uma nova.

   Se você estiver criando uma integração:

   1. Digite um nome e uma descrição no painel Create Integration.
   2. Selecione uma região para a integração.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   3. Selecione uma conta de serviço para a integração. Você pode 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.
      Observação:a opção de selecionar uma conta de serviço só vai aparecer se você tiver ativado a governança de integração na região selecionada.
   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 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 access 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 Data Transformer Script importa functions, uma biblioteca personalizada predefinida que contém um conjunto de funções Jsonnet para o mapeamento de dados na 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:

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.

Cuidado: Jsonnet não permite usar hifens (-) como parte de um nome de identificador. Por exemplo, um nome de variável ou nome de função. Se você quiser usar um hífen (-) como parte de um nome de variável, declare a variável entre aspas duplas, como mostrado no exemplo a seguir.

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

Práticas recomendadas

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

A seguir

• Consulte Funções do transformador de dados (Prévia)