DF to Azure
Python module for fast upload of pandas DataFrame to Azure SQL Database using automatic created pipelines in Azure Data Factory.
Introduction
The purpose of this project is to upload large datasets using Azure Data Factory combined with an Azure SQL Server. In steps the following process kicks off:
1. The data will be uploaded as a .csv file to Azure Blob storage.
2. A SQL table is prepared based on pandas DataFrame types,
which will be converted to the corresponding SQLAlchemy types.
3. A pipeline is created in datafactory for uploading the .csv from the Blob storage into the SQL table.
4. The pipeline is triggered, so that the .csv file is bulk inserted into the SQL table.
How it works
Based on the following attributes, it is possible to bulk insert your dataframe into the SQL Database:
from df_to_azure import df_to_azure
df_to_azure(df=df, tablename="table_name", schema="schema", method="create", id_field="col_a")
df: dataframe you wish to exporttablename: desired name of the tableschema: desired sql schemamethod: option for "create" "append" or "upsert"id_field: id field of the table. Necessary ifmethodis set to "upsert"
Important: the csv's are uploaded to a container called dftoazure, so create this in your storage account before using this module.
Upsert / create or append
It is possible to upsert the SQL table with (new) records, if present in the dataframe you want to upload. Based on the id_field, the SQL table is being checked on overlapping values. If there are new records, the "old" records will be updated in the SQL table. The new records will be uploaded and appended to the current SQL table.
Settings
To use this module, you need to add the azure subscriptions settings and azure data factory settings to your environment variables.
We recommend to work with .env files (or even better, automatically load them with Azure Keyvault) and load them in during runtime. But this is optional and they can be set as system variables as well.
Use the following template when using .env
# --- ADF SETTINGS ---
# data factory settings
rg_name : ""
rg_location: "westeurope"
df_name : ""
# blob settings
ls_blob_account_name : ""
ls_blob_container_name : ""
ls_blob_account_key : ""
# SQL settings
SQL_SERVER: ""
SQL_DB: ""
SQL_USER: ""
SQL_PW: ""
# --- AZURE SETTINGS ---
# azure credentials for connecting to azure subscription.
client_id : ""
secret : ""
tenant : ""
subscription_id : ""
Maintained by Zypp:
Support:
For support on using this module, you can reach us at hello@zypp.io
Testing
To run the test suite, use:
pytest df_to_azure
To run pytest for a single test:
pytest df_to_azure/tests/test_df_to_azure.py::test_duplicate_keys_upsert
1 maintainer
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file df_to_azure-0.5.3.tar.gz.
File metadata
- Download URL: df_to_azure-0.5.3.tar.gz
- Upload date:
- Size: 15.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/3.4.2 importlib_metadata/4.6.3 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.0 CPython/3.9.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7044bfb30574901669d4ae862a44bf6b0d4f1c239e2bf68b3bfe08b4af956148
|
|
| MD5 |
7f9052f10b540b09f739e4a3c32eb431
|
|
| BLAKE2b-256 |
ebc95f344ce51ad202ca23d2496bfe10d0159f07add1aa8d61e540a2c5f5496f
|
File details
Details for the file df_to_azure-0.5.3-py3-none-any.whl.
File metadata
- Download URL: df_to_azure-0.5.3-py3-none-any.whl
- Upload date:
- Size: 15.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/3.4.2 importlib_metadata/4.6.3 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.0 CPython/3.9.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7125abbe455379d172068f77f367a34e8fb16b07e0a51154bfab0053bd1ea8e3
|
|
| MD5 |
83f269069f36f255710f94b624b67cc2
|
|
| BLAKE2b-256 |
c9a3dee90bb14562ebc561292eb11b5ef3f115d7db8e8d84e900b9160bf76c04
|
