Library and CLI to move relational data from one place to another - DBs/CSV/gsheets/dataframes/...
Project description
Records mover is a command-line tool and Python library you can use to move relational data from one place to another.
Relational data here means anything roughly "rectangular" - with columns and rows. For example, it supports reading and writing from:
- Databases, including using native high-speed methods of import/export of bulk data. Redshift, Vertica and PostgreSQL are well-supported, with some support for BigQuery and MySQL.
- CSV files
- Parquet files (initial support)
- Google Sheets
- Pandas DataFrames
- Records directories - a structured directory of CSV/Parquet/etc files containing some JSON metadata about their format and origins. Records directories are especially helpful for the ever-ambiguous CSV format, where they solve the problem of 'hey, this may be a CSV - but what's the schema? What's the format of the CSV itself? How is it escaped?'
Records mover can be exended expand to handle additional databases and data file types. Databases are supported by building on top of their SQLAlchemy drivers. Records mover is able to auto-negotiate the most efficient way of moving data from one to the other.
CLI use example
Installing:
pip3 install 'records_mover[cli,postgres-binary,redshift-binary]'
Loading a CSV into a database:
mvrec file2table foo.csv redshiftdb1 myschema1 mytable1
Copying a table from a PostgreSQL to a Redshift database:
mvrec --help
mvrec table2table postgresdb1 myschema1 mytable1 redshiftdb2 myschema2 mytable2
Note records mover will automatically build an appropriate CREATE TABLE
statement on the target end if the table doesn't already exist.
Note that the connection details for the database names here must be configured using db-facts.
For more installation notes, see INSTALL.md. To understand the security model here, see SECURITY.md.
CLI use demo (table creation and loading)
Python library use example
First, install records_mover. We'll also use Pandas, so we'll install that, too, as well as a driver for Postgres.
pip3 install records_mover[pandas,postgres-source]
Now we can run this code:
#!/usr/bin/env python3
# Pull in the records-mover library - be sure to run the pip install above first!
from records_mover import sources, targets, move
from pandas import DataFrame
import sqlalchemy
import os
sqlalchemy_url = f"postgresql+psycopg2://username:{os.environ['DB_PASSWORD']}@hostname/database_name"
db_engine = sqlalchemy.create_engine(sqlalchemy_url)
df = DataFrame.from_dict([{'a': 1}]) # or make your own!
source = sources.dataframe(df=df)
target = targets.table(schema_name='myschema',
table_name='mytable',
db_engine=db_engine)
results = move(source, target)
When moving data, the sources supported can be found here, and the targets supported can be found here.
Advanced Python library use example
Here's another example, using some additional features:
- Loading from an existing dataframe.
- Secrets management using db-facts, which is a way to configure credentials in YAML files or even fetch them dynamically from your secrets store.
- Logging configuration to show the internal processing steps (helpful in optimizing performance or debugging issues)
you can use this:
#!/usr/bin/env python3
# Pull in the records-mover library - be sure to run the pip install above first!
from records_mover import Session
from pandas import DataFrame
session = Session()
session.set_stream_logging()
records = session.records
db_engine = session.get_default_db_engine()
df = DataFrame.from_dict([{'a': 1}]) # or make your own!
source = records.sources.dataframe(df=df)
target = records.targets.table(schema_name='myschema',
table_name='mytable',
db_engine=db_engine)
results = records.move(source, target)
Python library API documentation
You can can find more API documentation here. In particular, note:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for records_mover-1.5.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2166a1f646697d2561fb6d77d588642a55d19c7fd81ae609d7c34b5ea4ee8219 |
|
MD5 | 6e59f91cb260a2ba03300d9a30fa8f9a |
|
BLAKE2b-256 | 525ec91d695303f674423ea3b39fe013de7809862e75d94b5125e462b0820abf |