Ir para o conteúdo

Conexão MongoDB

Introdução

Uma conexão MongoDB, criada usando o conector MongoDB, estabelece acesso ao MongoDB. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades MongoDB 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).

Criar ou editar uma conexão MongoDB

Uma nova conexão MongoDB é criada usando o conector MongoDB a partir de uma dessas localizações:

Uma conexão MongoDB existente pode ser editada a partir dessas localizações:

Configurar uma conexão MongoDB

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

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da Conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão MongoDB e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint MongoDB, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Nome de Usuário: Insira o nome de usuário do cluster MongoDB.

  • Senha: Insira a senha do cluster MongoDB.

    Nota

    Se você não estiver se conectando a um cluster MongoDB existente, consulte os pré-requisitos do MongoDB para informações de configuração.

  • Conectar Usando: Selecione o método para inserir as informações de conexão, seja Formulário ou String de Conexão.

    • Formulário: Expande os campos onde você especifica um Host e um Banco de Dados a serem usados para uma conexão MongoDB.

      • Host: Insira o nome do host do cluster MongoDB.

      • Banco de Dados: Insira o nome de um banco de dados presente no cluster MongoDB.

      • Configurações Opcionais: Clique para expandir configurações opcionais adicionais:

        • Parâmetros Adicionais da String de Conexão: Insira opções adicionais para a conexão MongoDB. Para uma lista de opções suportadas, consulte as Opções da String de Conexão na documentação de referência do MongoDB.

        • Conectar Usando uma Lista de Sementes DNS: Selecione para se conectar usando uma lista de sementes DNS em vez do formato de conexão padrão. Se esta configuração for selecionada, também é recomendável selecionar Habilitar SSL/TLS. Para mais informações, consulte o Formato de Conexão da Lista de Sementes DNS na documentação de referência do MongoDB.

          Importante

          Tanto Conectar Usando uma Lista de Sementes DNS quanto Habilitar SSL/TLS são necessários para conectar ao MongoDB no Azure Cosmos DB.

        • Habilitar Escritas Repetíveis: Selecione para tentar automaticamente novamente operações de escrita. Para mais informações, veja Escritas Repetíveis na documentação de referência do MongoDB.

        • Habilitar Leituras Repetíveis: Selecione para tentar automaticamente novamente operações de leitura. Para mais informações, veja Leituras Repetíveis na documentação de referência do MongoDB.

        • Habilitar SSL/TLS: Selecione para proteger a conexão.

    • String de Conexão: Expande os campos onde você especifica uma string de conexão a ser usada para uma conexão MongoDB.

      • URL de Conexão: Insira a string de conexão do MongoDB. Para mais informações sobre o formato da string aceito neste campo, veja Formato da URI da String de Conexão na documentação de referência do MongoDB.

      • Configurações Opcionais: Clique para expandir configurações opcionais adicionais:

        • Conectar Usando uma Lista de Sementes DNS: Selecione para conectar usando uma lista de sementes DNS em vez do formato de conexão padrão. Se esta configuração for selecionada, também é recomendado selecionar Habilitar SSL/TLS. Para mais informações, veja Formato de Conexão da Lista de Sementes DNS na documentação de referência do MongoDB.

          Importante

          Tanto Conectar Usando uma Lista de Sementes DNS quanto Habilitar SSL/TLS são necessários para conectar ao MongoDB no Azure Cosmos DB.

        • Habilitar Escritas Repetíveis: Selecione para automaticamente repetir operações de escrita. Para mais informações, veja Escritas Repetíveis na documentação de referência do MongoDB.

        • Habilitar Leituras Repetíveis: Selecione para automaticamente repetir operações de leitura. Para mais informações, veja Leituras Repetíveis na documentação de referência do MongoDB.

        • Habilitar SSL/TLS: Selecione para proteger a conexão.

  • Testar: 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 suspender o download da versão mais recente do conector usando a política de organização Desabilitar Atualização Automática do Conector.

    Importante

    Se sua conexão estiver falhando e tudo parecer correto, certifique-se de que você permitiu os endereços IP necessários descritos nos pré-requisitos do MongoDB.

  • 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 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 (veja Dependências de Componentes, Exclusão e Remoção). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximos passos

Após uma conexão com o MongoDB ter sido criada, você coloca um tipo de atividade na tela de design para criar instâncias de atividade que serão usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações de menu para uma conexão e seus tipos de atividade estão acessíveis a partir do painel do projeto e da paleta de componentes de design. Para mais detalhes, veja os Menus de ações em Conceitos básicos de conectores.

Estes tipos de atividade estão disponíveis:

  • Consulta: Recupera um objeto do MongoDB e é destinado a ser usado como uma fonte em uma operação.

  • Upsert: Atualiza um objeto existente ou cria um novo objeto no MongoDB e é destinado a ser usado como um alvo em uma operação.

  • Inserir: Coloca um objeto no MongoDB e é destinado a ser usado como um alvo em uma operação.

  • Atualizar: Coloca um objeto no MongoDB e é destinado a ser usado como um alvo em uma operação.

  • Excluir: Exclui um objeto do MongoDB e é destinado a ser usado como um alvo em uma operação.