Basic MongoDB Setup

connect a mongo db database (replica set) add a generic mongodb data source go ahead and gather the basic details database host or ip address of the srv host record database port # (default is 27017) 27017 is the fixed port we use to connect to your server (ask support if needing to change) mongodb specifications required replicaset or standalone instance of mongodb primary replicaset node information mongodb version 3 1+ (talk w/ support if other versions needed) determine which way to connect tls or ssh tunneling as of july 2021 only the default ssl approach is available this is just like if you were to connect from your mongodb shell, compass, etc for example mongodb has some good which may be incorporated in a future release (contact support if you have urgent needs) firewalls on your database server should allow incoming connections through the public internet on your mongodb port (typically 27017 unless your network guys have changed it) be sure to grantlist/whitelist our datalakehouse io ip addresses https //www datalakehouse io/platform/grantlist ip addresses for your database server network access for example, in mongodb atlas this is done by navigating in the left side panel security > network access then clicking on the add ip addressess button instructions (basic connection setup) scroll down to ensure you review all steps, as needed remember datalakehouse io connects to your database instance with credentials supplied by you we store your credentials securely with our bank grade protocols create a datalakehouse user on the mongodb server (atlas or shell) if using mongodb atlas log into mongodb atlas click on your respective organization and select the project in the left menu under security click database access click add new database user choose 'password' as the authentication method enter a password that aligns with your policies and store it in a safe place for your reference in the subsequent connection steps under database user privileges, select the option 'grant sepcific privileges', then the specific privileges area will appear under specific privileges you will need to have two privilege rows configured when finished, so select the first role from the dropdown as 'readanydatabase', then click the '+ add another role' and select the 'read' option and in this new row enter the term 'local in the database field; leaving the collection field blank click the add user button in the bottom right of the form if using mongodb shell connect to the mongodb server with your admin user create a user for datalakehouse using the following shell logic replacing the logic below for user and pwd \<password> and choose a good password that complies with your security policies we recommend the user name 'datalakehouse sync reader' but be sure to align with your policies oplog size & change streams configurations we use both oplog https //docs mongodb com/v5 0/reference/glossary/#std term oplog and change streams https //docs mongodb com/v5 0/changestreams/ to sync your data and we recommend at least 48 hours sizing of the oplog for data retention but we highly recommend setting oplog sizing to retain 5 7 days worth of data you can set the size for the oplog by following the steps change the oplog size for replica set https //docs mongodb com/manual/tutorial/change oplog size/ mongodb atlas change the oplog size of the cluster https //docs atlas mongodb com/cluster config/additional options/#set oplog size contact support if you are unsure of how to set the oplog size on the connection form enter your credentials and other information enter in the name/alias field, the name you'll use within datalakehouse io to differentiate this connection from others enter in the target schema prefix field, is the prefix of schema(s) that gets created on your destination target connection database for each of the schemas you load in this connection so if your database has a schema named 'dbo' the target connection when synced will have a schema in that target database named the value of this field + ' dbo' alphanumeric characters only it must start and end with a letter but can contain an underscore( ) enter in the server/host field, the name of the public server name or the ip address (most customers use the ip for this field) if you have a mongodb+srv // connection, enter the primary replica set with no port number, ex mymongo prod mongodb net if you have a biconnector or mongodb // connection, enter the main node with the port, ex mymongo prod server mongodb net 27017 enter in the port field, where this database is accessible and the firewall restrictions are open for mongodb we always assume port 27017 enter in the database field, the name of the database to connect enter in the userame/alias field, the username of user you created in the steps above to give access to datalakehouse io leave auth type field alone it is set to password because datalakehouse is using ssl/tls and requires username and password credentials to access the database enter in the password field, the password for the user you created in the steps above click on save & test to save the connection and test that we can connect if updating the form click save & test or just test clicking on save & test will again save any changes such as the password change, etc you will not be able to change the prefix of the schema that will be the target in the destination any test of the connection will attempt to connect to your database with the credentials and info provided a message of success or failure will be shown if success you'll be prompted with the schema objects objects of the database and will need to complete the final steps for configuration shown below if failure happens with the test connection, the connection is still saved but you will need to correct the failure based on the failure reason information provided in the message other information about this connection from time to time we will update the instruction set here to inform you about this connection or how specifically we must connect to optimally synchronize your data there is also great article here or srv connection strings, https //www mongodb com/developer/article/srv connection strings/ https //www mongodb com/developer/article/srv connection strings/