Skip to content

MongoDB User Guide Eng

suhyunjeon edited this page Sep 28, 2013 · 11 revisions

Tadpole DB HUB(MongoDB) User Guide

Date : 17 Aug 2013 Written : HyunJong Cho(

Welcome to Tadpole! This is a web-based DB Query tool. You can connect variety DB in web browser and can control function for each users(user or admin or dba and so on). The goal is a DB HUB for all DB.

Now we are supporting - Amazon RDS, CUBRID, MarisDB, Oracle, MySQL, MSSQL, PostgreSQL, SQLite, MongoDB. Tadpole lets you creatively focus on your project by simply the amount of work needed for a given task.

List of tested

  • Amazon RDS : aws-java-sdk-1.4.7
  • CUBRID : 8.4.x ~
  • Oracle : 10g ~
  • MySQL : 5.4.x ~
  • MariaDB : 5.5.x ~
  • MSSQL : 2000 ~
  • PostgreSQL : 9.1.x ~
  • SQLite : 3.7.2 ~
  • MongoDB : 2.0.5 ~


This is explain for MongoDB



  1. JAVA 1.6.x(Mac 1.7.x)
  2. Linux, Mac, Windows, Tomcat 6.x (If you want to user the other O.S, connect me :
  3. Download :
  4. Reference more :

Getting Started

Standalone installation

  1. Execute TadpoleDBHub-1.x.x\tadpole-standalone.exe
  2. After install, automatically run a web-browser(OR you can install the TadpoleForDBToolsStartup by double click). It will happen to you when you first start that you can't find the page to the web-browser cause engine is starting. Don't freak out. Let's click F5(Refresh)button.
  3. Open the web-browser and start '' ps) Tadpole DB is TadpoleDBHub-1.x.x/configuration/tadpole/db/tadpole-system.db. Please install new version and backup.

Install Tomcat

  1. Did you have installed Tadpole before? OK. Please backup a apache-tomcat-6.x.x/work/Catalina/localhost/tadpole/eclipse/configuration/tadpole/db/tadpole-system.db file. And delete apache-tomcat-6.x.x/work directory.
  2. Change war name to tadpole.war from TadpoleDBHub1.x.x-tadpole.war.
  3. The WAR file should be in the webapp directory path. And Tomcat should be installed and running.
  4. If the context root is tadpole, start in the web-browser.
  5. If you upgrade to data of old data, copy to tadpole-system.db from a backup file(number1. apache-tomcat-6.x.x/work/Catalina/localhost/tadpole/eclipse/configuration/tadpole/db/tadpole-system.db) in same directory.



  1. Test mode window.
  2. Tadpole has Admin, Manager, User(Developer). First DEFAULT USER made.
  1. If you want to try test mode, you don't need to EMAIL ADDRESS, PASSWORD. We supported 'admin login/user login' for test mode.
  2. Add new user : ((


  1. Role of database administrator managing all DB(except password) and user created system.
  2. Admin managing user groups. Sharing and using DB and resources with users. If you create a user administrator for the first time, you will need to provide administrator permission to add project group. It is possible create / remove DB. User role can't add DB.
  3. DBA can see user list and db, managing executed query by users.
  4. User is current using account. Users must have specific roles within a user group, and they can login after provide administrator permission. Then they can use added db by administrator and can share query with the other users.

The whole view of Tadpole

Tadpole part

  1. Toolbar : Connection DB, save, authority(if it is a 'manager' or an 'admin' user), environment and so on.
  2. Database List : New create DB, delete, shared user's data.
  3. Object Explorer : Show the Object(Table, View)' list of selected to the Database List.
  4. Main UI : Show the DB Query editor, MongoDB profile viewer and main job viewer.


A toolbar is a GUI widget on which on-screen buttons, icons, menu, or other input or output elements are placed. And limited permission. 'Manager' can use all function, 'User' can't create DB, delete, profile functions.


  • Show connection DB window.
  • Save data in current SQL Editor.
  • Show SQL Editor selected 'Database List' window.
  • Show ERD Editor selected 'Database List' window.
  • Delete shared resources selected 'Database List' window.
  • Show user, db information.
  • Show history information all DB.
  • Show environment information.
  • Show bug, request issues.(need to Github account)
  • Show system preferences.
  • Close button.(If standalone, program shutdown, or run Tomcat, logout)

Database List

Display DB list which do allow the connections. Use shared connection information to user in same groups.

Add DB and Use

Only Manager permission user can add DB.

Add DB : Toolbar connection-toolbar-btn click.

connection dialog

  1. DB List for connection
  2. System preference to management Tadpole
  • Server type : Input DB of server type
  • Server type -> Production Server : You are able to add a new admin user directly to the database. IF generate user can't delete Collection in admin DB.
  • Server type -> Developer Server : This is development DB and you can do all thing for except permission.
  • Server type -> Others Server : This is add other uses of a DB and you can do all thing for except permission.
  • Group : DB group to add connection information. If you want to manage group by DB, it is a good tip. And you can use group name by your job name or purpose of a database.
  • Name : DB name for Database List.
  1. Input database information selected no.1.
  2. Additional information connected no.2.
  • Readonly Connection : Can't delete, update and so on connected DB. Only SELECT statements is possible in SQL Editor.
  • Table Filters : The filter is hidden and shown in the 'Object Explore'.
  • Show Tables : Setup display table list of 'Object Explore'. When tables are more than 1000, it is good tip.
  1. Test, Save, Cancel to saved DB.
  • Test Connection : Display the information, when it is possible for a connection to input information of no.2.
  • Confirm : Add DB.
  • Cancel : Cancel add DB.

Connected DB

If you add DB in the 'Database List', display in the group.


  1. Display 'DB icon [D] add name (account information)'. DB name tag
  • First : DB list
  • [D] : acronym of Developer Server. Production Server is [P], Others Server is [O].
  • Added name.
  • Added account DB information. (Normal user can't see).
  1. If you select DB, display Object(For example, selected Collections of DB, Indexes, JavaScript) to 'Object explore'.
  2. If you double-click DB, open instance information of DB, summary Collection, DB rock, a replica set, sharding information.
  3. If it is a SELECT DB after, right-click on this mouse, display action for execute as user permission.
  • Refresh : Search again from the 'Database List' for the newest.
  • Web console : open MongoDB WebConsole.
  • Server Status : Displaying DB process user info dialog.
  • GridFS : Displaying dialog of result by GridFS.
  • Top : Open DB used information dialog.
  • ERD -> All Table ERD : Displaying relationship by referential integrity.
  • ERD -> Create ERD : Displaying window to draw ERD, drag and drop tables to 'Object Explore'.
  • Administer -> Profile : Displaying executed SQL query information in DB.
  • Administer -> User management : Open dialog DB user management.
  • Administer -> DB Information : Displaying Object(For examplem, selectted Collections of DB, Indexes, JavaScript) in 'Object Explore'.
  • Administer -> Session List : Displaying Session list running DB.
  • Administer -> Import : Get data to MongoDB connected DB in tadpole db hub.
  • Administer -> Delete Database : Remove DB. Notice! DROP database drops all tables in the database and deletes the database and connected DB information.

Object Explorer

If database selected in the 'Database List', displaying Collections, Indexes, JavaScript.

mongo object

Filter : Search Collection.

  • Double click Table name -> display select query in SQL Editor.
  • Display comments on table name Table to mouseover event.
  1. If you selected Collection, displaying field information of Collection.
  2. If you double click Collection, displaying selected Collection window.
  3. If you select Collection, and right-clicking, displaying popup menu.
  • Create Collection : Create the Collection.
  • Drop Collection : Drop the Collection.
  • Refresh Collection : Refresh from the current window for the newest.
  • Generate Statement : Collection : Add new row in Collection.
  • Rename Collection : Modify Collection name.
  • ReIndex Collection : Reindex in Connection. Caution! If Collection had many data, think again.

Database Information Editor

Displaying connected MongoDB of all Connection information. You can see this editor to Connection Manager by double-click db.

mongodb all connection

  • Name Filter : Filtering by Collection name.
  • If you select Collection, displaying field information of the Collection.
  • If you double-click Collection, moving to search window of the Collection.
  • Displaying summary information of DB in bottom.

Find Collection

Searching Collection information. There is search window by JSON. Displaying search results in Tree(and Table) view. And if you click Ctrl + Space in editor, displaying Field information.

mongodb find collection

  1. Collection Search window
  • Input where command as below. If you search query = op field, see as below. {op : 'query'}
  • Find : Input find information. For example, screen captured picture : find 'item_id = 7'
  • Field : Displaying quantity of filed searched results in screen captured picture. If you want displaying all fields, you don't input anything.
  • Sort : Search quantity DESC in in screen captured picture.
  • Skip : Skip search results.
  • Limit : Limit only 100 data selected result.
  1. Query plan : Open dialog query explain information of where command.
  • Server message : Open the search server log dialog.
  • Search: Starting search.
  1. Displaying search result.
  • Tree View : Displaying search results in Tree view. You can modify value by click Value.
  • Table View : Displaying search results in Table view. If you double-click result, it will change in Tree view.
  • Tadpole Message : Displaying search failed information.
  1. Executing command line by select results.


Upload files or download files to MongoDB GridFS.

mongodb  gridfs

  1. bucket : Search bucket name
  2. File Name : Search file name
  3. Skip : Skip count search result
  4. Limit : Limit count search result
  5. Search Button : Search result
  6. Insert Button : Input dialog
  7. Delete Button : Delete button after select file
  8. Download Button : file download

If you click Insert button, open a window. See!

gridfa insert

  1. Bucket Name : Input bucket name for save.
  2. Select File button : Select a file to upload.
  3. Upload button : Selected a file to upload from Select File.
  4. OK button : Save.


The database profiler collects fine grained data about MongoDB write operations, cursors, database commands on a running mongodb instance.


  1. Start Profiling button : If you never start profile in mongoDB, click the button to start profile.
  2. Stop Profiling button : Stop profile mongoDB.
  3. Remove Profile Data button : Remove profile data.
  4. Display text: Refresh view
  5. Great then(millis) text: Query execution time
  6. Limit text: Limit the number of results from this query.
  7. Start Refresh : Starting search Great then, limit.
  8. Stop Refresh : Stoping search.

You can performance tuning query by search. If you double-click the row for need tuning, or click Show Detail button, open the tuning window. query tuning


Displaying ER diagram to read information from a MongoDB collection. If you click All Table ERD in Connection Manager, showing ER diagram of all db Collection. If you click Create ERD Diagram, you can display only what user want Collection in Object Explorer.

mongodb erd


This import to mongoDB from connected tadpole db data. You can input a whole table or query to import in mongoDB.

If you get tables data, the table name is RDB in tadpole DB. Or getting collection names with mongoDB


You can use query information for import data. import-query

Session List

  • MariaDB, MySQL can see Session List. session-list

Session List is displayed Session list executed in the DB. And you can close Long time to execute or shutdown query.

  1. Collection shortcuts of Session List.
  2. Display current SQL statements.
  3. If you select query of number ②, display SQL statements executed query.

User Management

User list of group, manage db list and add a user, change stop use. Or select executed query list of user, but only administrator and DBA can be use.


Display all user list, if you double-click user, displaying 'Executed SQL Management'. This is executed previously is executed again on the viewer.