​
Getting Started with MongoDB BI Connector Configuration

​
Requirements:

  • Active MongoDB BI Connector instance.
  • Allow connections from Databrain to your MongoDB BI Connector.
    • For details on setting up IP whitelisting and ensuring secure connectivity, refer to our guide on:

Allow Access to our IP
  • Choose the Databrain Workspace to which you wish to connect the data.

​
Setup Guide:

  1. Ensure Connector Accessibility:
    • Ensure your MongoDB BI Connector is active and accessible from the machine running Databrain.
    • Accessibility is dependent on your MongoDB user privileges and network settings. The easiest way to verify if Databrain can connect to your MongoDB BI Connector is via the check connection tool in the UI. For detailed setup and permissions, refer to the MongoDB BI Connector documentation.
  2. Fill Up Connection Info:
    • Provide the necessary information to connect to your MongoDB BI Connector:
      • Integration Name: [Pick a name to help you identify this integration in Databrain]
      • Host: [Enter your MongoDB BI connector Hostname]
      • Port: 3306 (or enter your specific MongoDB BI Connector Port)
      • Username: [Enter your MongoDB BI Connector User]
      • Password: [Enter the password associated with the username]

​
Encryption:

  • Ensure you have SSL/TLS set up for your MongoDB BI Connector if you require encrypted connections from Databrain for enhanced security.

​
Permissions:

  • Sync the BI connector with intervals, based on schema change frequency.
  • Whitelist the IP address.
  • Grant read access to schemas (usage) and tables, noting that access to only tables may not suffice in certain databases.
Replace the placeholders inside the square brackets with actual values when filling in the details.

​
Locating the Configuration Details in MongoDB BI Connector

  1. Integration Name:
    • This is a custom name you decide for identification within Databrain. Choose a name that’s relevant and descriptive for your MongoDB BI Connector source.
  2. Host:
    • This is the server address where your MongoDB BI Connector is running. For remote servers, it would be the IP address or domain name of the server.
    • Check the MongoDB BI Connector’s configuration or startup parameters to confirm the host details.
  3. Port:
    • By default, MongoDB BI Connector listens on port 3306. However, this might be different based on your setup.
    • Confirm the specific port by checking the BI Connector’s configuration or the command-line arguments used to start it.
  4. Username:
    • The MongoDB BI Connector uses the MongoDB database’s authentication when set up with authentication. You’d use the same credentials as those to connect to your MongoDB cluster.
    • If you’re not sure about the credentials, consult with your MongoDB administrator or the person who set up the BI Connector.
  5. Password:
    • The password associated with the username. This would be the same password used for the MongoDB cluster when authentication is enabled.
    • For security reasons, passwords are typically not displayed in configurations. Ensure you have it stored securely or consult your MongoDB administrator if unsure.
  6. Permissions:
    • To synchronize the schema in a BI connector when auto-sync is not enabled, it’s necessary to manually configure the auto-sync interval. This interval should be adjusted based on the frequency of schema changes; if changes occur frequently, a shorter interval should be set.