Pandasql -The Best Way to Run SQL Queries in Python

Introduction

Pandas have evolved remarkably in data handling, yet some still swear by SQL’s magic. Good news! With Pandassql, you can use SQL-like tricks right in Python, especially in Jupyter Notebooks. Picture querying pandas DataFrames using just SQL syntax. Ready for the adventure of blending SQL with Pandas? And guess what? No SQL servers needed! 😎

This article was published as a part of the Data Science Blogathon.

What is Pandasql?

The saviour is python’s library, pandasql.

As the libraries’ documentation mentions:

pandasql allows you to query pandas DataFrames using SQL syntax. It works similarly to sqldf in R. pandasql seeks to provide a more familiar way of manipulating and cleaning data for people new to Python or pandas.

How to Install Panadsql?

You need to install the Python’s Library, pandasql first. It’s very simple to install. Use any of the below two methods, both use PIP installation.

• Open the terminal and run
  pip install -U pandasql
• Open your Jupyter Notebook and in any cell run
  !pip install -U pandasql

How to Use PandaSQL?

Why Should One Use SQL in Pandas?

Using SQL in Pandas can be advantageous for various data manipulation and analysis tasks, especially when you are already familiar with SQL or when your data processing requirements align with SQL’s capabilities. Let’s explore some examples to illustrate why you might want to use SQL in Pandas:

Example 1: Filtering Data

Suppose you have a Pandas DataFrame containing sales data, and you want to filter it to select only the rows where the sales amount is greater than $1,000:

pythonCopy codeimport pandas as pd
from pandasql import sqldf

# Create a sample DataFrame
data = {'Product': ['A', 'B', 'C', 'D'],
        'Sales': [800, 1200, 950, 1400]}
df = pd.DataFrame(data)

# Using SQL in Pandas
pysqldf = sqldf("SELECT * FROM df WHERE Sales > 1000")

print(pysqldf)

In this example, using SQL-like syntax makes the filtering condition clear and concise.

Example 2: Aggregation

Suppose you have a dataset of customer orders, and you want to calculate the total sales amount for each customer using Pandas:

pythonCopy codeimport pandas as pd
from pandasql import sqldf

# Create a sample DataFrame
data = {'Customer': ['Alice', 'Bob', 'Alice', 'David'],
        'OrderAmount': [100, 150, 200, 120]}
df = pd.DataFrame(data)

# Using SQL in Pandas to calculate total sales per customer
pysqldf = sqldf("SELECT Customer, SUM(OrderAmount) AS TotalSales FROM df GROUP BY Customer")

print(pysqldf)

SQL-like syntax simplifies the aggregation task, allowing you to calculate sums, averages, and other aggregations easily.

Example 3: Joining DataFrames

Suppose you have two DataFrames, one containing customer information and the other containing order information. You want to perform an inner join to combine them based on a common column, such as customer ID:

pythonCopy codeimport pandas as pd
from pandasql import sqldf

# Create sample DataFrames
customers = pd.DataFrame({'CustomerID': [1, 2, 3],
                          'CustomerName': ['Alice', 'Bob', 'Charlie']})

orders = pd.DataFrame({'OrderID': [101, 102, 103],
                       'CustomerID': [1, 2, 1],
                       'OrderAmount': [100, 150, 200]})

# Using SQL in Pandas to perform an inner join
pysqldf = sqldf("SELECT c.CustomerName, o.OrderAmount FROM customers c INNER JOIN orders o ON c.CustomerID = o.CustomerID")

print(pysqldf)

SQL-like syntax provides a clear and familiar way to express join operations.

Example 4: Complex Filtering and Subsetting

In scenarios where you need to apply complex filtering conditions or subsetting operations, SQL can simplify the task. For example, you can use SQL’s WHERE clause with logical operators:

pythonCopy codeimport pandas as pd
from pandasql import sqldf

# Create a sample DataFrame
data = {'Product': ['A', 'B', 'C', 'D'],
        'Sales': [800, 1200, 950, 1400],
        'Region': ['North', 'South', 'North', 'West']}
df = pd.DataFrame(data)

# Using SQL in Pandas for complex filtering
pysqldf = sqldf("SELECT * FROM df WHERE Sales > 1000 AND Region = 'North'")

print(pysqldf)

This approach is concise and readable when dealing with intricate conditions.

Basics

There is this one function that is used the most from this library. Its the main function sqldf. sqldf takes two parameters.

A SQL query in string format
A set of session/environment variables (globals() or locals())
It becomes tedious to specify globals() or locals(), hence whenever you import the library, run the following helper function along with. This will make things simple going forward.

from pandasql import sqldf
mysql = lambda q: sqldf(q, globals())

Syntax

Many variants of SQL are in use, and their syntaxes vary a little. Here pandasql uses the SQLite syntax. Most of the standard SQL language SQLite understands. However, it adds a few features of its own while at the same time it does omit some features. Click Here to read the document that attempts to describe what parts of the SQL language SQLite do and does not support.

pandasql automatically detects any pandas DataFrame. You can call them or query them by their name like you would have done with a SQL table.

We are going to use any one of these two basic code samples.

from pandasql import sqldf

or

from pandasql import sqldf

Import libraries and Data

For this article, we will use the data from the pandasql library itself. Let us import the dependencies and the data.

# specify globals() or locals() using the following helper function
​mysql = lambda q: sqldf(q, globals())
mysql("SELECT * FROM meat LIMIT 5;")

mysql("SELECT * FROM births LIMIT 5;")

query = '''
SELECT m.date, m.beef, m.veal, m.pork, b.births
FROM meat AS m
INNER JOIN
births AS b
ON m.date = b.date;
'''
​
mysql(query)

query = '''SELECT
            strftime('%Y', date) as year
           , SUM(beef) as beef_total
           FROM
              meat
           GROUP BY
              year
              LIMIT 5;
    '''
​
mysql(query)

query = '''SELECT
            strftime('%Y', date) as year
           , SUM(beef) as beef_total
           FROM
              meat
           GROUP BY
              year;
    '''
​
mysql(query).head(10)

#executing union all statements
query = """
        SELECT
            date
            , 'beef' AS meat_type
            , beef AS value
        FROM meat
        UNION ALL
        SELECT
            date
            , 'veal' AS meat_type
            , veal AS value
        FROM meat
        UNION ALL
        SELECT
            date
            , 'pork' AS meat_type
            , pork AS value
        FROM meat
        UNION ALL
        SELECT
            date
            , 'lamb_and_mutton' AS meat_type
            , lamb_and_mutton AS value
        FROM meat
        ORDER BY 1
    """
​
mysql(query).head(10)

# use queries within queries
query = """
    SELECT
        m1.date
        , m1.beef
    FROM
        meat m1
    WHERE m1.date IN
        (SELECT
            date
        FROM meat
        WHERE
            beef >= broilers
        ORDER BY date)
"""
​
mysql(query)