Ir para o conteúdo

Google Pub Sub

Introdução

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

Nota

Para usar o conector do 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 Subconexão do Google Pub Sub

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

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

Configurar uma Subconexão do Google Pub Sub

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

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

Dica

Campos com í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 da variável para exibir uma lista das variáveis existentes para escolher.

  • Nome da conexão: Insira um nome a ser usado para identificar a conexão. O nome precisa ser exclusivo para cada conexão do Google Pub Sub e não deve conter barras / ou dois pontos :. Esse nome também é usado para identificar o endpoint do Google Pub Sub, que se refere tanto a uma conexão específica quanto a 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: Digite o client_email fornecido pelo arquivo JSON de credenciais conforme descrito em Pré-requisitos do Google Pub Sub.

  • Sequência de chave privada: Insira o 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 pelos agentes 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 Desativar atualização automática do conector política da organização.

  • Salvar alterações: Clique para salvar e fechar a configuração da 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 solicita que você confirme 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 solicita que você confirme 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 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 Sequência de chave privada. 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 a 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 a atribuição de 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 Google Pub/Sub não foi ativada para o projeto. Ative a API 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 origens (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 podem ser acessados no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Estes tipos de atividades estão disponíveis:

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

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

  • Receber 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 destino em uma operação.

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

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

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