Conectores

Os fluxos de trabalho publicam conectores para facilitar o acesso a outros produtos do Google Cloud em um fluxo de trabalho. Para uma referência detalhada dos conectores disponíveis, consulte a referência sobre conectores. Para amostras de fluxo de trabalho que demonstram como usar um conector, consulte Amostras de conectores.

Os conectores podem ser usados para se conectar a outras APIs do Google Cloud em um fluxo de trabalho, ajudando você a integrar seus fluxos de trabalho a outros produtos do Google Cloud. Por exemplo, é possível usar conectores para publicar mensagens do Pub/Sub, ler ou gravar dados em um banco de dados do Firestore ou recuperar chaves de autenticação do Secret Manager.

Autenticação

Os conectores usam autenticação integrada do Identity and Access Management para interagir com outros produtos do Google Cloud. Observe que um fluxo de trabalho que usa um conector ainda precisa ter as permissões apropriadas atribuídas à conta de serviço dele para se autenticar corretamente a uma determinada API. Por exemplo, para publicar uma mensagem no Pub/Sub, a conta de serviço associada ao fluxo de trabalho precisa receber o papel roles/pubsub.publisher. Para saber mais sobre a autenticação em outros produtos do Google Cloud, consulte Como fazer solicitações autenticadas de dentro de um fluxo de trabalho.

Comportamento durante novas tentativas e operações de longa duração

Os conectores têm comportamento integrado para lidar com novas tentativas e operações de longa duração.

Novas tentativas

Todos os conectores aplicam a seguinte política de repetição e configurações de tratamento de erros:

Operações de longa duração

Para chamadas que realizam uma operação de longa duração, os seguintes comportamentos são aplicados:

  • Os fluxos de trabalho bloqueiam a execução do fluxo de trabalho até que a operação seja concluída ou falhe.

  • As chamadas expiram após 30 minutos.

  • Os conectores pesquisam operações de longa duração periodicamente. Os fluxos de trabalho usam uma espera exponencial de 1,25 ao fazer pesquisas, começando com um segundo e diminuindo a 60 segundos entre as pesquisas. Cada tentativa de pesquisa conta como uma etapa faturável.

  • Quando ocorre um erro durante uma operação de longa duração, os fluxos de trabalho geram um erro OperationError. O erro inclui um atributo adicional, error, que contém detalhes específicos da operação.

Firestore

O conector do Firestore permite que você se conecte às APIs do Firestore a partir de um fluxo de trabalho.

O conector do Firestore é compatível apenas com bancos de dados criados no Modo nativo. As operações falharão se usadas em um banco de dados no modo Datastore. Para saber mais sobre a diferença entre o modo nativo e o modo Datastore,consulte Como escolher entre o modo nativo e o modo Datastore.