Consulte os conectores compatíveis com a Application Integration.
Tarefa do Conectores
A tarefa Conectores permite que você se conecte de forma rápida e segura aos vários serviços do Google Cloud e a outros aplicativos comerciais usando os conectores prontos para uso disponíveis nos Conectores de integração.
Veja a lista de todos os conectores compatíveis com a Application Integration em Referência de conectores.Antes de começar
- Verifique se você tem o papel do IAM de Administrador do Connectors (
roles/connectors.admin
) no projeto do Google Cloud. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso. - Saiba mais sobre os conceitos gerais dos Integration Connectors.
- Para se conectar aos serviços do Google Cloud e a outros aplicativos comerciais usando um conector, verifique se você anexou uma conta de serviço gerenciada pelo usuário à integração. Se a integração não tiver uma conta de serviço gerenciada pelo usuário configurada, a conta de serviço padrão (
service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com
) será usada para autenticação por padrão. - Verifique se a conta de serviço tem o papel do IAM necessário. Para informações sobre como conceder papéis a uma conta de serviço, consulte Gerenciar o acesso a contas de serviço.
Adicionar uma tarefa do Connectors
Para adicionar a tarefa "Conectores" à sua integração, faça o seguinte:
- No console do Google Cloud, acesse a página Application Integration.
- 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.
- Selecione uma integração existente ou clique em Criar integração para criar uma nova.
Se você estiver criando uma integração:
- Digite um nome e uma descrição no painel Create Integration.
- Selecione uma região para a integração.
- 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.
- Clique em Criar.
Isso abre a integração na página do editor de integração.
- Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas disponíveis.
- Clique e coloque o elemento Conectores no editor de integração.
Configurar a tarefa do Conectores
Para configurar uma tarefa de conectores, faça o seguinte:
- Clique no elemento de tarefa dos Conectores no designer para ver o painel de configuração da
tarefa dos Conectores.
Também é possível clicar no
para editar o nome da tarefa. - Clique em Configurar conector.
- É possível selecionar uma conexão existente na região ou criar uma nova. Para configurar uma conexão existente, siga as etapas a seguir na página Editor de tarefas de conectores:
- Em Selecionar conectores, selecione a região da conexão.
- Escolha uma conexão existente na lista de conexões disponíveis na região selecionada.
- Clique em Próxima.
- Na lista Tipo, selecione Entidades ou Ações.
- Se você selecionar Entidades, a lista de entidades compatíveis com a conexão será exibida na seção Definir entidades/ações. Selecione uma entidade seguida pela operação que será executada nela.
- Se você selecionar Ações, a lista de ações compatíveis com a conexão será exibida na coluna Definir entidades/ações. Selecione uma ação para a conexão. As entidades e ações compatíveis são baseadas no tipo de conector. Veja a lista de todos os conectores compatíveis com a Application Integration em Referência de conectores. Para ver as ações e entidades compatíveis com um conector, consulte a documentação específica.
Se o conector for compatível com a consulta SQL personalizada, será possível selecionar a opção Executar consulta personalizada na lista Ações. Por exemplo, para ver como adicionar uma consulta SQL personalizada a um conector do BigQuery, consulte Executar consulta SQL personalizada.
Para saber mais sobre entidades e ações, consulte Entidades, operações e ações.
- Clique em Concluído para concluir a configuração da conexão e feche o painel.
A imagem a seguir mostra um layout de amostra da página Editor de tarefas dos conectores.
Configurar variáveis de entrada e saída da tarefa
O painel de configuração de tarefas dos Conectores exibe as variáveis Entrada de tarefas e Saída de tarefas, que são geradas automaticamente com base na entidade e operação ou na ação selecionada na caixa de diálogo Configurar conector da tarefa. Essas variáveis podem ser configuradas e acessadas como entradas para a tarefa atual ou saídas para tarefas seguintes ou condicionais configuradas na integração atual.
Para configurar as variáveis Entrada de tarefa ou Saída de tarefa, clique na variável correspondente para abrir o painel Configurar variável e execute as seguintes etapas:
- Insira o valor da variável no campo Valor padrão.
- (Opcional) Selecione Usar como entrada para a integração ou Usar como saída para a integração.
- Clique em Save.
Para mais informações sobre os parâmetros de entrada e saída da tarefa de conectores, consulte Operações de entidade.
Operações de entidade
É possível executar operações CRUD (criar, ler, atualizar e excluir) nas entidades de um conector. Cada uma dessas operações de entidade tem um conjunto diferente de parâmetros de entrada e saída. A tabela a seguir descreve os parâmetros de entrada e saída das várias operações de entidade.
Nome da operação | Parâmetros de entrada | Parâmetros de saída |
---|---|---|
Lista |
|
|
Get | entityId | connectorOutputPayload |
Criar | connectorInputPayload | connectorOutputPayload |
Atualizar |
|
connectorOutputPayload |
Excluir |
|
N/A |
Parâmetros de entrada
A tabela a seguir descreve os parâmetros de entrada para as várias operações de entidade.
Nome do parâmetro | Tipo de dados | Descrição |
---|---|---|
entityId | String | Um identificador exclusivo da linha que você quer acessar. Normalmente, Por exemplo, para receber uma linha específica de uma tabela do MySQL, |
connectorInputPayload | JSON | Os dados reais a serem adicionados ou atualizados em uma entidade. O exemplo a seguir mostra o
snippet JSON de uma linha de dados a ser adicionada a uma tabela:
{ "employee_first_name": "John", "employee_emailID": "test-05@test.com" } Neste exemplo, |
filterClause | String | Restringe o resultado das operações com base em uma condição. Para mais informações sobre como adicionar uma cláusula de filtro, consulte Adicionar um filtro para uma operação. |
listEntitiesPageSize | Inteiro |
Especifica o número de resultados que precisam ser retornados em uma página. Uma página é um agrupamento lógico dos registros em um conjunto de resultados. O conceito de uma página é útil quando se espera um grande número de registros no conjunto de resultados. Se o conjunto de resultados for grande, a tarefa Connecters poderá falhar, já que há um limite no tamanho dos dados que a tarefa Connecters pode processar. Ao dividir o resultado em blocos menores, é possível evitar esse problema. Por exemplo, se você espera 1.000 registros no conjunto de resultados, defina
|
listEntitiesPageToken | String | Um identificador de página (token) que permite acessar uma página específica. Consiga o valor de um token da página do parâmetro de saída |
listEntitiesSortByColumns | Matriz de strings | Nome da coluna pelo qual você quer classificar o conjunto de resultados.
|
Parâmetros de saída
A tabela a seguir descreve os parâmetros de saída para as várias operações de entidade.
Nome do parâmetro | Tipo de dados | Descrição |
---|---|---|
connectorOutputPayload | JSON | A saída de uma operação no formato JSON. |
listEntitiesNextPageToken | String |
É um identificador gerado pelo sistema para uma página. Pense no token como um ponteiro pelo qual é possível acessar uma página específica do conjunto de resultados. Se você tiver dividido o
conjunto de resultados em várias páginas definindo o parâmetro Por exemplo, considere que você definiu o parâmetro Se o conjunto de resultados tiver um grande número de páginas, considere usar a tarefa
Para cada repetição para chamar repetidamente a tarefa Conectores e usar
a tarefa Mapeamento de dados
para atribuir automaticamente valores de token ao
parâmetro de entrada |
Cláusula de filtro para operações de entidade
É possível restringir os registros processados pela tarefa Conectores usando a variável Filtrar cláusula, disponível como uma Entrada de tarefas. Por exemplo, no caso de uma operação
delete, é possível adicionar um filtro para excluir registros com um orderId
específico.
A cláusula de filtro só pode ser aplicada às seguintes operações de entidade:
- Lista
- Excluir
- Atualizar
Ao selecionar qualquer uma dessas operações, a seção Entrada de tarefa da tarefa do Conectores mostra o campo Cláusula de filtro automaticamente.
Adicionar uma cláusula de filtro
Para adicionar um filtro, execute os seguintes passos:
- Clique no elemento de tarefa dos Conectores no designer para ver o painel de configuração da tarefa dos Conectores.
- Expanda a seção Entrada de tarefas e clique na variável de string filterCláusula(conectores).
A caixa de diálogo "Configurar variável" será exibida.
- Digite a cláusula de filtro (seguindo a syntax) no campo Valor padrão.
- Clique em Save.
Filtrar sintaxe e exemplos de cláusula
Uma cláusula de filtro tem o seguinte formato:
FIELD_NAME CONDITION FILTER_VALUE
Examples
OwnerId = '0053t000007941XAAQ'
PoNumber < 2345
OrderNumber = 00110 AND StatusCode = 'Draft'
TotalAmount > 2500
ShippingPostalCode = 94043 OR ShippingPostalCode = 77002
Uso de variáveis em uma cláusula de filtro
Não é possível usar uma variável de integração diretamente em uma cláusula de filtro. Se você quiser usar uma variável de integração, primeiro configure uma tarefa de mapeamento de dados para criar um mapeamento entre a variável e a cláusula de filtro.A tabela a seguir mostra um mapeamento de exemplo entre uma variável de integração e a variável filterClause(Connectors)
:
Entrada | Saída |
---|---|
PRIMARY_KEY_ID = ' .CONCAT(INTEGRATION_VARIABLE) .CONCAT(') |
filterClause(Connectors) |
PRIMARY_KEY_ID = '
é inserido como um Valor na linha de entrada.
Criação de conexão inline
É possível usar a tarefa de conectores para criar uma conexão diretamente nos Integration Connectors.
Antes de começar
Criar uma conexão
Para criar uma nova conexão usando a Application Integration, siga estas etapas:
- Clique no elemento de tarefa dos Conectores no designer para ver o painel de configuração da tarefa dos Conectores.
- Clique em Configurar conector.
A página Editor de tarefas de conectores é exibida.
- Ignore o campo Região.
- Clique em Conexão e selecione a opção Criar conexão no menu suspenso.
- Conclua as etapas a seguir no painel Criar conexão:
- Na etapa Local, escolha o local da conexão.
- Clique em Região e selecione um local na lista suspensa.
- Clique em Próxima.
- Na etapa Detalhes da conexão, forneça detalhes sobre a conexão:
- Conector: selecione o tipo de conector que você quer criar na lista suspensa. Para informações sobre a lista de conectores compatíveis, consulte Todos os Integration Connectors.
- Versão do conector: escolha uma versão disponível do tipo de conector selecionado na lista suspensa.
- Nome da conexão: insira um nome para a instância de conexão.
- (Opcional) Insira uma descrição para a instância de conexão.
- (Opcional) Marque Ativar o Cloud Logging para armazenar os dados de registro da instância de conexão.
- Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
- (Opcional) Clique em Configurações avançadas para definir as configurações do nó da conexão.
Para mais informações, consulte a documentação da conexão correspondente em Integration Connectors.
- (Opcional) Clique em + ADICIONAR RÓTULO para adicionar um rótulo à conexão na forma de um par de chave-valor.
- Clique em Próxima.
-
Na etapa Autenticação, forneça os detalhes de autenticação da conexão.
- Os métodos de autenticação preenchidos durante essa etapa são baseados no tipo de conexão que está sendo criada.
Tipos de conexão diferentes usam métodos de autenticação distintos. Para mais informações, consulte a seção Configurar a autenticação da documentação da conexão correspondente em Integration Connectors.
- Clique em Próxima.
- Os métodos de autenticação preenchidos durante essa etapa são baseados no tipo de conexão que está sendo criada.
- Revisão: revise os detalhes de conexão e autenticação.
- Clique em Criar.
- Na etapa Local, escolha o local da conexão.
Práticas recomendadas
- Para informações sobre os limites de uso que se aplicam à tarefa Conectores, consulte Limites de uso.
- Para informações sobre como resolver problemas de falhas em Conectores, consulte Usar registros para solucionar problemas e rastrear falhas do conector.
Estratégia de solução de erros
A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.