Ir para o conteúdo

Conexão do Google Pub Sub

Introdução

Uma conexão Google Pub Sub, criada usando o conector Google Pub Sub, estabelece acesso ao Google Pub/Sub. Depois que uma conexão é configurada, você pode criar instâncias de atividades do Google Pub Sub associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Nota

Para usar o conector Google Pub Sub, você deve criar uma conta de serviço, conceder funções e obter determinadas credenciais no Google Cloud Platform, conforme descrito em Pré-requisitos do Google Pub Sub.

Criar Ou Editar uma Conexão do Google Pub Sub

Uma nova conexão do Google Pub Sub é criada usando o conector do Google Pub Sub de um destes locais:

Uma conexão existente do Google Pub Sub pode ser editada nestes locais:

Configurar uma Conexão do Google Pub Sub

Cada elemento da interface do usuário da tela de configuração de conexão do Google Pub Sub é descrito abaixo.

Configuração de conexão do Google Pub Sub

Dica

Campos com um ícone de variável Ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para usar para identificar a conexão. O nome deve ser exclusivo para cada conexão do Google Pub Sub e não deve conter barras. /ou dois pontos :. Este nome também é usado para identificar o endpoint do Google Pub Sub, que se refere a uma conexão específica e suas atividades.

  • ID do projeto: Insira o project_id fornecido pelo arquivo JSON de credenciais conforme descrito em Pré-requisitos do Google Pub Sub.

  • Email do cliente: Insira o client_email fornecido pelo arquivo JSON de credenciais conforme descrito em Pré-requisitos do Google Pub Sub.

  • Private Key String: Insira a private_key fornecido pelo arquivo JSON de credenciais conforme descrito em Pré-requisitos do Google Pub Sub. A chave privada deve ser inserida neste formato:

    -----BEGIN PRIVATE KEY-----<private_key>-----END PRIVATE KEY-----

    Nota

    Todos os caracteres de nova linha (\n) presente no private_key string deve ser substituída por um retorno de carro no campo Private Key String. Caso contrário, ocorrerá um erro ao testar a conexão.

  • Usar configurações de proxy (somente Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar configurações de proxy do agente privado.

  • Teste: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a Desabilitar atualização automática do conector política da organização.

  • Salvar alterações: Clique para salvar e fechar a configuração de conexão.

  • Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Possíveis Erros de Conexão

Estes são os possíveis erros de conexão e suas soluções:

Erro Causa Solução
An error occurred: com.google.common.base.Preconditions.checkArgument(ZLjava/lang/String;CLjava/lang/Object;)V A versão do agente é muito antiga. Certifique-se de que a versão do agente que está sendo usada seja a versão 10.60 ou posterior.
An error occurred: java.io.IOException: Invalid PKCS#8 data Caracteres de nova linha (\n) estão presentes na Private Key String. Substitua quaisquer caracteres de nova linha por um retorno de carro.
An error occurred: io.grpc.StatusRuntimeException: PERMISSION_DENIED: User not authorized to perform this action. O pubsub.topics.list ou pubsublite.topics.list permissão não foi concedida à conta de serviço do Google Pub/Sub. Consulte Pré-requisitos do Google Pub Sub para obter informações sobre como atribuir funções e permissões.
An error occurred: io.grpc.StatusRuntimeException: PERMISSION_DENIED: Cloud Pub/Sub API has not been used in project 730922392691 before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/pubsub.googleapis.com/overview?project=730922392691 then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry. A API do Google Pub/Sub não foi habilitada para o projeto. Habilitar a API do Google Pub/Sub para o projeto.

Próximos Passos

Após a criação de uma conexão do Google Pub Sub, você coloca um tipo de atividade na quadro de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

As ações de menu para uma conexão e seus tipos de atividade são acessíveis a partir do painel do projeto e da paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Esses tipos de atividade estão disponíveis:

  • Mensagem de reconhecimento: Reconhece mensagens de uma assinatura no Google Pub/Sub e deve ser usado como alvo em uma operação.

  • Criar Tópico: Cria tópicos no Google Pub/Sub e deve ser usado como alvo em uma operação.

  • Obter mensagem: Recupera mensagens de uma assinatura no Google Pub/Sub e deve ser usado como fonte em uma operação.

  • Publicar mensagem: Publica mensagens em um tópico no Google Pub/Sub e deve ser usado como alvo em uma operação.

  • Criar assinatura: Cria assinaturas no Google Pub/Sub e deve ser usado como alvo em uma operação.

  • Ouvir mensagem: Consome mensagens de uma assinatura do Google Pub/Sub e deve ser usado como uma fonte em uma operação.

  • Excluir: Exclui assinaturas ou tópicos do Google Pub/Sub e deve ser usado como alvo em uma operação.