Consulte os conectores compatíveis com a Application Integration.

Tarefa Firestore - Busca de documentos

Visualização

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.

A tarefa Firestore - Acesso de documento permite recuperar o conteúdo de um único documento do Firestore. Por padrão, a tarefa Firestore - Busca de documentos busca o snapshot mais recente do documento do banco de dados do Firestore.

O Firestore é um banco de dados de documentos NoSQL criado para oferecer escalonamento automático, alto desempenho e facilidade no desenvolvimento de aplicativos.

Antes de começar

Realize as seguintes tarefas no seu projeto do Google Cloud antes de configurar a tarefa Firestore - Document Get:

1. Ative a API Cloud Firestore (firestore.googleapis.com).

   Ativar a API Cloud Firestore

2. Criar um perfil de autenticação. A Application Integration usa um perfil de autenticação para se conectar a um endpoint de autenticação para a tarefa Firestore - Document Get.

   Para informações sobre como conceder papéis ou permissões adicionais a uma conta de serviço, consulte Como conceder, alterar e revogar acesso.

Configuração da tarefa Firestore - Busca de documentos

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 coloque o elemento Firestore - Document Get no editor de integração.
6. Clique no elemento Firestore - Busca de documentos do designer para conferir o painel de configuração de tarefa Firestore - Busca de documentos.
7. Acesse Autenticação e selecione o perfil de autenticação que você quer usar.

   Opcional. Se você não tiver criado um perfil de autenticação antes de configurar a tarefa, clique em + Novo perfil de autenticação e siga as etapas em Criar um novo perfil de autenticação.

8. Acesse Entrada de tarefas e configure os campos de entrada exibidos com a tabela Parâmetros de entrada de tarefas.

   As mudanças nos campos de entrada são salvas automaticamente.

Parâmetros de entrada da tarefa

Confira na tabela a seguir os parâmetros de entrada da tarefa Firestore - Busca de documentos:

Propriedade	Tipo de dados	Descrição
Região	String	Local do banco de dados do Firestore. Por exemplo, us-central1.
ProjectsId	String	É o ID do seu projeto no Google Cloud.
DatabasesId	String	ID do banco de dados do Firestore.
DocumentsId	String	Caminho ou local do documento do Firestore.

Saída da tarefa

A tarefa Firestore - Busca de documentos retorna os dados do documento no formato codificado em base64. É necessário decodificar o valor codificado em base64 para receber a string de saída.

Dica: é possível codificar ou decodificar dados em base64 usando o comando base64 no Linux ou macOS ou Base64.exe no Windows. As linguagens de programação e de script normalmente incluem bibliotecas para codificação em Base64. Para exemplos de linha de comando, consulte Decodificar base64 na documentação do Cloud Text-to-Speech.

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.

A seguir

1. Adicione bordas e condições de borda.
2. Teste e publique sua integração.
3. Configure um gatilho.
4. Adicione uma tarefa de mapeamento de dados.
5. Confira todas as tarefas para os serviços do Google Cloud.