https://github.com/clarketm/csv-2-mongo
Import a CSV to MongoDB
https://github.com/clarketm/csv-2-mongo
csv csv-2-mongo import mongodb python
Last synced: 12 months ago
JSON representation
Import a CSV to MongoDB
- Host: GitHub
- URL: https://github.com/clarketm/csv-2-mongo
- Owner: clarketm
- License: mit
- Created: 2018-12-10T22:20:18.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-01-13T07:12:50.000Z (about 7 years ago)
- Last Synced: 2025-03-28T00:44:18.896Z (12 months ago)
- Topics: csv, csv-2-mongo, import, mongodb, python
- Language: Python
- Homepage:
- Size: 133 KB
- Stars: 6
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [csv-2-mongo](https://pypi.org/project/csv-2-mongo/)
[](https://pypi.org/project/csv-2-mongo/)
[](https://pepy.tech/project/csv-2-mongo)
Import a CSV to MongoDB using Python 🐍.
## Installation
```bash
$ pip install csv-2-mongo
```
## Usage
```text
Usage: csv_2_mongo.py [OPTIONS] FILE
Import a csv FILE to MongoDB
Options:
-h, --help Show this message and exit.
-v, --version Show the version and exit.
-d, --database name Database name. [default: test]
-c, --collection name Collection name. [default: test]
-H, --host host Host name. [default: 0.0.0.0]
-p, --port port Port number. [default: 27017]
-t, --timeout sec Connection timeout (seconds). [default: 5]
-f, --force Overwrite collection if exists.
-y, --yes Automatic yes to prompts.
```
> Note: CSV headers are **required** to correctly correlate MongoDB `fields` to CSV `fields`.
## Examples
Import `mammals.csv` to a `mammals` collection in the `animals` database:
```bash
$ csv-2-mongo -d animals -c mammals ./mammals.csv
```
```txt
....................................
Connecting to 0.0.0.0:27017
....................................
Import data.csv to database=animals collection=mammals [y/N]? y
Import complete!
```
Import `mammals.csv` to a `mammals` collection in the `animals` database **overwriting the collection if it exists**:
> Note: the `-f, --force` flag will overwrite the collection without a prompt. If the flag is omitted, `csv-2-mongo` will prompt you before operations with potential data loss.
```bash
$ csv-2-mongo -f -d animals -c mammals ./mammals.csv
```
```txt
....................................
Connecting to 0.0.0.0:27017
....................................
Import data.csv to database=animals collection=mammals [y/N]? y
Import complete!
```
Import `mammals.csv` to a `mammals` collection in the `animals` database running on *host* **mongo.travismclarke.com** at *port* **27111**:
```bash
$ csv-2-mongo -d animals -c mammals -H mongo.travismclarke.com -p 27111 ./mammals.csv
```
```txt
....................................
Connecting to mongo.travismclarke.com:27111
....................................
Import data.csv to database=animals collection=mammals [y/N]? y
Import complete!
```
To skip the prompt (e.g. `Import data.csv to ...`), such as running via a script, one can pass the `-y`, `--yes` flag to force a *yes* response to the confirmation prompt:
> Note: this will not suppress the *overwrite* prompt which still requires the `-f, --force` flag.
```bash
$ csv-2-mongo -y -d animals -c mammals ./mammals.csv
```
```txt
....................................
Connecting to 0.0.0.0:27017
....................................
Import complete!
```
## License
MIT © [**Travis Clarke**](https://blog.travismclarke.com/)