{"id":13500608,"url":"https://github.com/dboissier/mongo4idea","last_synced_at":"2025-09-29T03:30:42.892Z","repository":{"id":5130039,"uuid":"6295793","full_name":"dboissier/mongo4idea","owner":"dboissier","description":"MongoDB integration in Intellij","archived":true,"fork":false,"pushed_at":"2020-06-04T18:04:32.000Z","size":46891,"stargazers_count":975,"open_issues_count":76,"forks_count":109,"subscribers_count":43,"default_branch":"master","last_synced_at":"2024-09-26T05:22:09.134Z","etag":null,"topics":["database","intellij","intellij-plugin","java","mongodb"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"sionescu/bordeaux-threads","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dboissier.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.txt","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-10-19T14:00:34.000Z","updated_at":"2024-08-29T09:24:10.000Z","dependencies_parsed_at":"2022-06-25T22:33:49.745Z","dependency_job_id":null,"html_url":"https://github.com/dboissier/mongo4idea","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dboissier%2Fmongo4idea","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dboissier%2Fmongo4idea/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dboissier%2Fmongo4idea/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dboissier%2Fmongo4idea/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dboissier","download_url":"https://codeload.github.com/dboissier/mongo4idea/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234583683,"owners_count":18856280,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","intellij","intellij-plugin","java","mongodb"],"created_at":"2024-07-31T22:01:06.904Z","updated_at":"2025-09-29T03:30:42.160Z","avatar_url":"https://github.com/dboissier.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"# Mongo Plugin for IntelliJ IDEA version 0.12.2\n\n* [Jetbrains plugin page](https://plugins.jetbrains.com/idea/plugin/7141)\n* [Changelog](https://github.com/dboissier/mongo4idea/blob/master/CHANGELOG.txt)\n\n## Current builds\n\n[![Build Status](https://travis-ci.org/dboissier/mongo4idea.svg?branch=master)](https://travis-ci.org/dboissier/mongo4idea)\n\n* [0.12.2 Build for Idea 2019+](https://github.com/dboissier/mongo4idea/raw/master/snapshot/mongo4idea-0.12.2.zip)\n\n## Description\n\nThis plugin integrates MongoDB Servers with database/collections tree, Query Runner and Shell console.\n\n## Plugin Compatibility\n\nThis plugin was built for IDEA 2019 and upper versions, requires JRE 1.8 and Mongo 3.\n\n## How to install it?\n\nDownload this plugin from your IDE (Mongo Plugin)\n\n## Configuration steps\n\nWhen you open the Mongo explorer, you will see a panel:\n\n![Browser](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea-explorerWithoutDB.png)\n\n* To use the Mongo shell directly from the plugin, click on the `[wrench]`icon, set its path in the corresponding field. As alternative, you can use the Terminal plugin. \n\n![PluginConfiguration](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea_pluginConfiguration.png)\n\n\n* To add a server, click on the `[+]` icon located on the upper toolbar and a dialog will appear\n\n![ServerConfigurationGeneralTab](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea_serverConfigurationGeneralTab.png)\n\n* Set a label for your server, this will be more convenient to distinguish each of them in the Mongo explorer\n* Set the server info as the example in the above screenshot\n* If your access is restricted to a specific database, just set it in the **User Database** field\n\n* If your server requires authentication, click on the **Authentication** tab and then enter your credentials\n\n![ServerConfigurationAuthenticationTab](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea_serverConfigurationAuthenticationTab.png)\n\n* If you need to use a SSH tunnel, click on the SSH tab and then enter the corresponding settings\n\n![ServerConfigurationSSHTab](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea_serverConfigurationSSHTab.png)\n\n\nWhen you are done, click on the **Test Connection** button to check the server configuration.\n\nAdditionaly, in **Options** tab:\n\n* **[NEW]** you can change the `row limit` default value\n* you can hide some collections with **Collections to ignore** field.\n* you can set default Mongo shell parameters\n\n## Usage\n\n### Mongo Explorer\n\n![Browser](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea-explorerWithDB.png)\n\nFor each server, the tree displays its databases with all of their collections.\n\n* To edit or remove the server, right-click and select the appropriate action from the server node.\n* To view the content of your server, just double-click on it.\n* To view the content of a collection, double-click on it (or type `F4`) and the results will be displayed in an editor tab, alongside your open files.\nIf you double-click on another collection, a new tab will be created for it.\n\nIf you want clear a collection or database, you can do so by right clicking on it and selecting **Drop collection/database** (shortcut is `DELETE`). Be cautious with this operation, it should not be used in a production environment.\n\n\n**[NEW]** \n* When selecting a database or a collection, you will see the `stats` in the below panel\n* When selecting a collection, you can import JSON file by right-clicking and selecting `Import data` menu item. Select your JSON file and click on `Replace all content` option if needed.\n* When selecting a server, you can copy its configuration\n\n### Mongo collection tab view\n\nThe panel shows all documents of the collections (max 300 records by default).\n\n![Collection view](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea_collectionResults.png)\n\nYou can copy the result and paste it in a text editor.\n\nIf you want to see the results in a table view instead, click on the **Table** icon on the right of the toolbar.\n\n![Collection view](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea_tableView.png)\n\n**[NEW]** You can paginate the results by selecting the number of the documents per page below the results. You will be able to navigate with `[\u003c-]``and `[-\u003e]` icon\n\n![Collection view](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea_collectionResults_withPagination.png)\n\n\n#### Querying\n\nIf you want to run a *find* query, click on the Magnifying glass icon or use the `CTRL+F` shortcut.\n\nThe query panel will appear at the top.\n\nType your filter, projection or sort query fragment in JSON format (e.g.: `{ 'name': 'foo'}`)\n\n![Simple query view](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea_queryPanel.png)\n\nIf you want to run some aggregate queries, type your pipeline as follows:\n```js\n{'$operator1': {...}},\n{'$operator2': {...}}\n```\n\n![Aggregate query view](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea-queryAggregate.png)\n\nTyping `CTRL+SPACE` displays a popup that allows you to select a query operator.\n\nAdditionally, you can set a row limit.\n\nWhen you are done, click on the Run button (or type `CTRL+ENTER` shortcut) to see the query results.\n\n\n## Document editing\n\nAny document can be edited by double-clicking on the **object id** (or by right-clicking and select **Edit document**). A panel will open at the bottom.\n\n![Document edition](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea-documentEdition.png)\n\nYou can edit the value either by double-clicking or by typing `F2`.\nYou can delete a key by right-clicking on it and select **Delete this**\n* Click on the **save** button to send the modification to the mongo server\nYou can add a key or value (depending on the structure of your document) by right-clicking on it and select **Add a Key** (or **Add a Value**). A dialog will appear.\n\n![Document edition](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea-addKeyDialog.png)\n\nSet the key name, type and value and then validate your form.\n\nYou can also edit a document from scratch by right-clicking in the result view and select *Add* (or by typing `ALT+INSERT` shortcut)\n\n## Document deletion\n\nRight click on the `ObjectId` of the selected document and select the **Delete** action\n\n## [NEW] DBRef navigation\n\nWhen your document has a DBRef field, you can view the referenced document by right clicking on it and select **View Reference** action (shortcut is `CTRL+B` or `⌘+B`).\nThe referenced document will be displayed in the same tab. A **Back** button will appear and allow you to go back to the navigation history.\n\n\n### Mongo shell integration\n\nIf you set the mongo client path (e.g., `/usr/bin/mongo`), you can run the console by selecting a database under your mongo server node and click on the button **Mongo Shell** on the toolbar of the Mongo explorer.\n\n![Browser](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea-shell.png)\n\n### Run a file\n\nIf you need to run a JavaScript file on your mongo server, just type `CTRL+SHIFT+F10` (or right-click in your file and select Run `myscript.js file)\n\n![Document edition](https://github.com/dboissier/mongo4idea/raw/master/doc/mongo4idea-runAFile.png)\n\nSelect your server and your database then click on the run button.\n\n## How to build\n\nThis project is now built with Gradle with [Intellij plugin](https://github.com/JetBrains/gradle-intellij-plugin). At a glance, \n\n* `gradlew test` to run all unit tests\n* `gradlew runIde` to run Intellij\n* `gradlew buildPlugin` to build a distribution of the plugin\n\n## Thanks\n\nI would like to thank:\n* MongoDB team\n* Mongo Java Driver team\n* Jetbrains Team for the great sources of IntelliJ Community Edition which help me to improve this plugin\n* Mark James author of the famfamfam web site who provides beautiful icons.\n* [Jean Baptiste Potonnier](https://github.com/jbpotonnier) for the suggestion to create this plugin\n* [piddubnyi](https://github.com/kocherovf) for adding [*copy server* action](https://github.com/dboissier/mongo4idea/pull/141) and [*search in explorer* action](https://github.com/dboissier/mongo4idea/pull/138)\n* [piddubnyi](https://github.com/piddubnyi) for adding [*drop database* action](https://github.com/dboissier/mongo4idea/pull/95)\n* [dacopan](https://gitlab.com/JedAI/mongo4idea) for fixing the plugin 2019 compatibility whenever I was far far away in a galaxy\n* [mancubus77](https://github.com/dboissier/mongo4idea/pull/274) for the default SSH port\n* [cunneen](https://github.com/dboissier/mongo4idea/pull/246) for fixing edit document\n* Neko team, my first beta testers ;)\n* All users of this plugin who sent me valuable suggestions.\n* My wife and my daughters who support me to have fun in software development and also remind me my husband/father duty ;).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdboissier%2Fmongo4idea","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdboissier%2Fmongo4idea","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdboissier%2Fmongo4idea/lists"}