Skip to main content

Automatically create pipelines with copy activity from blob to SQL

Project description

logo

DF to Azure

Python module for fast upload of pandas DataFrame to azure 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 a 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 Database table is prepared based on the parameters in the settings/yml/adf_settings.yml
3. A pipeline is created 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")
  1. df: dataframe you wish to export
  2. tablename: desired name of the table
  3. schema: desired sql schema
  4. method: option for "create" "append" or "upsert"
  5. id_field: id field of the table. Necessary if 4 is set to True
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 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 ---
# general run settings
create="False"

# data factory settings
rg_name : ""
rg_location: "westeurope"
df_name : ""

# blob settings
ls_blob_name : "Python Blob Linked Service"
ls_blob_account_name : ""
ls_blob_container_name : ""
ls_blob_account_key : ""

# SQL settings
ls_sql_name : "Python SQL Linked Service"
ls_sql_server_name: ""
ls_sql_database_name: ""
ls_sql_database_user: ""
ls_sql_database_password: ""

# pipeline settings
trigger : True

# --- AZURE SETTINGS ---
# azure credentials for connecting to azure subscription.
client_id : ""
secret : ""
tenant : ""
subscription_id : ""

Maintained by Zypp:


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::test_duplicate_keys_upsert

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

df_to_azure-0.3.0.tar.gz (14.3 kB view hashes)

Uploaded Source

Built Distribution

df_to_azure-0.3.0-py3-none-any.whl (19.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page