Conexão MongoDB¶

Introdução¶

Uma conexão MongoDB, criada usando o conector MongoDB, estabelece acesso ao MongoDB. Depois que uma conexão for configurada, você poderá criar instâncias de atividades do 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).

Crie Ou Edite uma Conexão MongoDB¶

Uma nova conexão MongoDB é criada usando o conector MongoDB de um destes locais:

• A aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).
• A página Conexões globais (consulte Criar uma conexão global em Conexões Globais).

Uma conexão MongoDB existente pode ser editada nestes locais:

• A aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).
• A aba Componentes do painel do projeto (consulte Menu Ações do componente em Guia Componentes do painel do projeto).
• A página Conexões globais (consulte Editar uma conexão global em Conexões Globais).

Configurar uma Conexão MongoDB¶

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

• Nome da conexão: Insira um nome a ser usado 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 a suas atividades.

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

• Senha: Insira o cluster MongoDB senha.

  Nota

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

• Conectar usando: Selecione o método para inserir informações de conexão, Formulário ou Sequência de conexão.

  • Formulário: Expande os campos onde você especifica um Host e Database para usar em uma conexão MongoDB:

    

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

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

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

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

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

        Importante

        Ambos Conectar usando uma lista de valores de DNS e Ativar SSL/TLS são necessários para se conectar ao MongoDB no Azure Cosmos BD.

      • Ativar gravações que podem ser repetidas: Selecione para repetir automaticamente as operações de gravação. Para obter mais informações, consulte Gravações Repetidas na referência do MongoDB documentação.

      • Ativar leituras repetíveis: Selecione para repetir automaticamente as operações de leitura. Para obter mais informações, consulte Leituras retentáveis na referência do MongoDB documentação.

      • Ativar 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 obter mais informações sobre o formato de string aceito neste campo, consulte Formato de URI de string de conexão na referência do MongoDB documentação.

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

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

        Importante

        Ambos Conectar usando uma lista de valores de DNS e Ativar SSL/TLS são necessários para se conectar ao MongoDB no Azure Cosmos BD.

      • Ativar gravações que podem ser repetidas: Selecione para repetir automaticamente as operações de gravação. Para obter mais informações, consulte Gravações Repetidas na referência do MongoDB documentação.

      • Ativar leituras repetíveis: Selecione para repetir automaticamente as operações de leitura. Para obter mais informações, consulte Leituras retentáveis na referência do MongoDB documentação.

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

• 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.

  Importante

  Se sua conexão estiver falhando e tudo parecer correto, certifique-se de incluir na lista de permissões os endereços IP necessários descritos em 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 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.

Próximos Passos¶

Após a criação de uma conexão MongoDB, 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 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:

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

• Inserir: Atualiza um objeto existente ou cria um novo objeto no MongoDB e deve ser usado como destino em uma operação.

• Inserir: Coloca um objeto no MongoDB e deve ser usado como destino em uma operação.

• Atualizar: Coloca um objeto no MongoDB e deve ser usado como destino em uma operação.

• Excluir: Exclui um objeto do MongoDB e deve ser usado como destino em uma operação.