Getting Started with Dataform on Google Cloud Platform (GCP)

 Dataform is a powerful tool for managing and automating data workflows, specifically designed for teams working with Google BigQuery. It allows you to create efficient data pipelines, organize SQL code, and implement practices like dependency management and automatic documentation.

In this blog, we'll walk you through how to set up a workspace inside a Dataform repository, explain the default folder structure, explore the main tabs, and provide some JavaScript functions to make your workflow more dynamic and reusable.

Setting Up Your Dataform Workspace

Assuming you already have a Google Cloud Platform (GCP) project and BigQuery set up, the next step is to navigate to Dataform within the BigQuery Studio.

Once inside Dataform, you will work within a repository. Within this repository, you can create multiple workspaces for different tasks or environments, such as development, staging, or production.

To get started:

  1. Navigate to your Dataform repository.
  2. Create or open an existing workspace to begin working on your data pipelines.

Default Folder Structure in Dataform

When you create a new workspace, Dataform provides a predefined folder structure:

  • definitions/: Contains SQL or data transformation scripts.
  • includes/: Holds reusable SQL snippets or helper functions in JavaScript.
  • models/: Where you define your core SQL models for data transformations.
  • datasets/: Organize the datasets, views, or incremental outputs.
  • tests/: Write unit tests to ensure the correctness and quality of your data transformations.

This structure helps to keep your codebase neat and manageable, especially as your project scales.

Managing Workflow in Dataform

Workflows in Dataform are built using SQL actions and transformations defined in the models/ directory. Dataform automatically generates a dependency graph, which ensures that each transformation runs in the correct order based on table dependencies. This feature is especially useful for tracking data lineage and understanding how data flows through your pipeline.

Tabs in Dataform

When working in Dataform, you'll come across several key tabs that make it easy to manage your transformations and workflows:

  • Code: This is where you write, edit, and organize your SQL code, as well as define models and scripts.
  • Compile Graph: This tab shows the dependency graph between all tables, allowing you to visualize and manage dependencies.
  • Executions: This tab lets you view previous runs of your workflow, showing details of each execution's performance and errors.
  • Start Execution: This tab allows you to manually run the entire workflow or specific parts of it. It’s particularly useful when you need to trigger an on-demand refresh of your tables.

Making Workflows Dynamic with JavaScript

Dataform allows you to incorporate JavaScript within your SQL transformations, making it easier to handle repetitive tasks, manage variables, and make your queries more flexible. Below are a few useful functions that you can implement.

Dynamically Declare Tables

Instead of hardcoding table names throughout your scripts, you can store them in an array and declare them dynamically. Here's an example of a JavaScript function that does this:


const tables = [
  { name: "table1", database: "my-database", schema: "my-schema" },
  { name: "table2", database: "my-database", schema: "my-schema" },
  { name: "table3", database: "my-database", schema: "my-schema" },
];

// Function to generate and apply table declarations
function generateTableDeclarations() {
  tables.forEach(table => {
    declare({
      type: "declaration",
      schema: table.schema,
      name: table.name,
      database: table.database
    });
  });
}

// Call the function to generate the declarations
generateTableDeclarations();

With this function, you can easily add, remove, or update tables without modifying multiple files.

Using Variables for Dynamic Queries

You can also use JavaScript to create variables that make your queries dynamic, ensuring that they can be reused across different queries. Here’s an example:


// Create variables for multiple queries
const selling_date = "2023-01-01";

module.exports = { selling_date };


You can now reference selling_date in your SQL transformations without hardcoding the value in multiple places.

Conclusion

Dataform is a powerful tool for managing and automating data pipelines on GCP, especially when working with BigQuery. By leveraging its workspace structure, the flexibility of JavaScript, and the built-in dependency graph, you can build efficient, dynamic workflows that are easy to manage and scale.

If you liked this post, don’t forget to share and comment below!




Share:

How to manage SQL Data Analytics Workflows at Enterprise Level

 

In today’s fast-paced enterprise environment, managing SQL data analytics workflows effectively is critical to ensure data-driven decision-making. However, many companies still face significant challenges in their data processes, such as:

  • Monolithic SQL Queries: Large, complex queries often grow into unmanageable blocks of code. These monolithic SQL scripts can be difficult to understand, debug, or scale, especially as the business logic becomes more complex with added transformations and KPIs.

  • Lack of Collaboration: It's common for analysts and data engineers to save queries locally on their hard drives or scattered across shared folders. This ad-hoc way of working leads to siloed knowledge, lack of version control, and no easy way for others to collaborate or improve on existing work.

  • No Knowledge Sharing: Without centralized documentation or tools that encourage modularity, knowledge gets trapped in individuals’ heads. If a key analyst leaves the company or moves to a different role, the company often loses valuable institutional knowledge.

  • Ad-hoc Development: Many teams operate in an ad-hoc mode, where queries are quickly hacked together to get immediate results but aren’t built with scalability, reusability, or long-term maintenance in mind. This often leads to duplication of efforts, inconsistent metrics, and brittle workflows.

These challenges not only slow down workflows but also introduce risks in data quality, reporting accuracy, and scalability. To overcome these, companies need structured, modular, and version-controlled workflows that enable collaboration, automation, and knowledge sharing across teams.

In this blog, we’ll explore how to manage two distinct types of data analytics workflows—ETL & Descriptive Report Generation and Exploratory Data Analysis (EDA)—at the enterprise level. We'll look at the tools available on various cloud platforms (Google Cloud Platform, Microsoft Azure, and AWS) as well as cross-platform tools like Databricks and Snowflake, which can address these challenges.


1. ETL & Descriptive Report Generation

ETL (Extract, Transform, Load) and Descriptive Report Generation workflows are essential for transforming raw data into structured reports and KPIs that drive business decisions. These workflows are typically designed around well-defined schemas (star or snowflake) and produce outputs consumed by BI tools like Power BI.

Key Characteristics:

  • Data Transformation-Heavy: The primary focus is on transforming raw, often unstructured data into clean, organized, and structured datasets.
  • KPI & Business Logic: These workflows incorporate a heavy amount of business rules to calculate metrics that are critical for day-to-day operations.
  • Structured Data Schemas: Data is typically organized in star or snowflake schemas for efficient querying and reporting.
  • BI Tool Integration: Outputs are often integrated into BI tools such as Power BI for dashboards, reports, and further analysis by business users.

Common Challenges:

  1. Monolithic SQL Queries: Many ETL workflows still rely on huge SQL scripts with numerous subqueries, Common Table Expressions (CTEs), and hardcoded business logic. These scripts are difficult to maintain and debug as they grow in complexity.

  2. Redundant Code: When SQL logic is not modular, it’s common for different team members to replicate the same transformations or KPIs across different queries, leading to duplication of efforts and inconsistencies in the data.

  3. Hard to Scale: As data volume grows, monolithic queries become slow and less efficient. Without proper modularity, it’s hard to optimize individual components of a query or pipeline.

  4. Collaboration Gaps: Saving queries on local machines or in isolated folders leads to a lack of collaboration. Team members cannot easily share or reuse code, resulting in fragmented knowledge and inconsistent reporting across departments.

Solution: Modular SQL Workflows

To address these challenges, modular SQL tools and workflows can break down complex SQL logic into smaller, reusable components. This ensures consistency, maintainability, and scalability. Here’s how modular SQL tools help:

  • Reusability: Centralize business logic, KPIs, and transformations in reusable SQL modules.
  • Collaboration: Use version control systems like Git to manage SQL queries, making them accessible and shareable across teams.
  • Maintainability: Smaller SQL components are easier to debug and improve, reducing the risk of human error and improving performance.
  • Automation: Automate scheduling and execution of these modular SQL workflows, ensuring that reports and transformations are always up-to-date.


2. Exploratory Data Analysis (EDA)

In contrast to ETL and Descriptive Report Generation, Exploratory Data Analysis (EDA) is an iterative, experiment-driven approach used by data scientists and analysts to uncover insights, trends, and patterns in data. Unlike ETL processes, EDA is not about generating structured outputs for BI tools but rather about flexibility, exploration, and discovery.

Key Characteristics:

  • Statistics-Heavy: EDA often involves statistical techniques to understand data distributions, correlations, and anomalies.
  • Python and Open-Source Libraries: The Python programming language, along with libraries like Pandas, Matplotlib, Seaborn, and Plotly, is commonly used for data wrangling and visualization in EDA workflows.
  • Interactive Visualization: Visualization is critical for uncovering insights in EDA, with tools that allow analysts to quickly plot and visualize datasets.
  • Iterative and Exploratory: The focus here is on flexibility. EDA workflows allow for rapid prototyping and hypothesis testing, with analysts frequently switching between different coding environments.

Common Challenges:

  1. Fragmented Tools: Many enterprises lack unified platforms that allow data scientists to switch seamlessly between SQL, Python, and visualization tools. This fragmentation can slow down the analysis process and hinder collaboration.

  2. Lack of Version Control: Notebooks are often developed ad-hoc, leading to poor version control, making it hard to track changes or reproduce results later.

  3. Collaboration Barriers: Unlike SQL-based ETL workflows, EDA can be harder to share across teams due to the reliance on notebooks and Python environments.

Solution: Collaborative Notebook Environments

To support the exploratory nature of EDA workflows, notebook environments like Databricks, Google Cloud’s Vertex AI Notebooks, and Azure Fabric can be used. These environments allow data scientists to:

  • Switch Between SQL and Python: Seamlessly integrate SQL queries with Python code for data wrangling and statistics.
  • Visualization: Use Python-based libraries like Matplotlib, Seaborn, and Plotly for quick visualizations.
  • Prototyping: Rapidly experiment with different approaches without needing to build and maintain large SQL workflows.
  • Version Control: Incorporate Git and other version control tools directly into the notebook environment to track changes and collaborate effectively.

Recommended Tools for Enterprise Workflows

1. Google Cloud Platform (GCP)

  • ETL & Descriptive Reports: Use Dataform to modularize SQL queries and manage ETL processes. Dataform enables teams to centralize business logic and automate SQL workflows.
  • Exploratory Data Analysis: Leverage Vertex AI Notebooks for an interactive, exploratory environment that integrates SQL and Python, with support for version control and collaboration.

2. Microsoft Azure

  • ETL & Descriptive Reports: Azure Fabric can be used to manage data pipelines and build modular SQL workflows that feed into Power BI.
  • Exploratory Data Analysis: Azure Fabric also provides notebook environments similar to Databricks, allowing teams to conduct EDA, statistical analysis, and rapid prototyping.

3. Amazon Web Services (AWS)

  • ETL & Descriptive Reports: AWS offers AWS Glue for ETL operations and Amazon Redshift with stored procedures for modular SQL workflows. Redshift integrates well with Power BI.
  • Exploratory Data Analysis: SageMaker Studio Notebooks offer an integrated environment for Python-heavy EDA workflows with support for multiple languages, making it easy to conduct interactive analyses.

4. Cross-Cloud Tools: Databricks & Snowflake

  • Databricks: Works across all major cloud platforms (GCP, Azure, AWS) and offers robust notebook environments for both ETL and EDA. Databricks allows modular SQL and Python to be seamlessly combined in one workflow, making it a versatile tool for data analytics.
  • Snowflake: Snowflake is another cross-cloud solution that provides excellent support for modular SQL workflows, making it ideal for structured ETL processes. It also supports Python-based data manipulation through its Snowpark feature.

Conclusion

Effectively managing SQL data analytics workflows at an enterprise level requires using the right tools to address specific challenges. Modularizing SQL queries, ensuring collaboration, version control, and adopting flexible notebook environments are critical components of building scalable, maintainable data workflows. With cloud providers like GCP, Azure, and AWS offering robust solutions, and cross-cloud platforms like Databricks and Snowflake providing flexibility and advanced functionality, companies have powerful tools at their disposal to optimize both ETL and Exploratory Data Analysis workflows.

Share:

Transforming Data with Databricks PySpark

  

Azure Databricks is a collaborative, notebook-style platform that simplifies big data tasks with Apache Spark. Using PySpark, you can easily manipulate large datasets for ETL processes. The notebooks allow you to switch between SQL for quick queries and Python for flexible coding, all while visualizing your data with built-in charts. This integration makes for an efficient and interactive data workflow.

In this blog, we’ll dive into key PySpark functionalities essential for effective ETL processes. We’ll start with how to read Delta tables, which provide efficient data storage and retrieval. Next, we’ll explore data profiling to help you understand your dataset better. We’ll then cover filtering techniques to refine your data, address missing values to ensure data integrity, and handle duplicates to maintain clean datasets. After that, we’ll discuss grouping data for meaningful insights and finish with pivoting to reshape your data for better analysis. Finally, we’ll conclude by demonstrating how to create a new Databricks Delta table for efficient data management.

To kick things off, let’s look at how to read data from Hive Metastore tables using PySpark. This is a crucial first step in your ETL process, allowing you to load and manipulate your datasets easily. Here’s a simple line of code to get started:

df = spark.table("your_database.your_table")

Caching: You can cache the DataFrame after reading it to improve performance for subsequent actions:

df = spark.table("your_database.your_table").cache()

Selecting Specific Columns: To load only specific columns, you can chain the select() method:

df = spark.table("your_database.your_table").select("column1", "column2")

Filtering Rows: You can also filter rows immediately after reading the table:

df = spark.table("your_database.your_table").filter(df.column1 > 100)

Using SQL Queries: Instead of directly using spark.table(), you can create a temporary view and run SQL queries:

spark.sql("CREATE OR REPLACE TEMP VIEW temp_view AS
SELECT * FROM your_database.your_table")
df = spark.sql("SELECT column1, column2 FROM temp_view WHERE column1 > 100")

These customizations can help tailor the data loading process to meet your specific needs.

After successfully reading your Hive Metastore table, the next critical step in the ETL process is data profiling. Data profiling allows you to gain a deeper understanding of your dataset, uncovering insights about its structure, quality, and content. By examining aspects such as data types, null values, unique counts, and distribution, you can identify potential issues and make informed decisions on how to handle them. Let’s explore the key techniques and tools in PySpark that will help you effectively profile your data.

To get the total number of rows in the DataFrame, you can use the count() method:

row_count = df.count()

To check if there are duplicates in your DataFrame, use this custom function which prints out the results 

from pyspark.sql import functions as F

def check_duplicate_rows(df, cols):

    """
    To check if there are duplicates: Count the number of distinct rows in a subset and compare it with the number of total rows.
    If they're the same, there are no duplicates in the selected subset. Otherwise, duplicates exist.

    # Call the function
    cols_to_check = ['col1', 'col2', 'col3']  # Replace with the actual column names
    check_duplicate_rows(df, cols_to_check)

    """

    counts_df = df.groupBy(cols).count().filter(F.col('count') > 1)

    if counts_df.count() == 0:
        print("Total Row {} and Unique Row {} are equal. Therefore, there are no duplicate rows for the given
subset".format(df.count(), df.distinct().count()))
    else:
        print("Total Row {} and Unique Row {} are not equal. Therefore, there are {} duplicate rows for the given
subset \nDuplicate rows below:".format(df.count(), df.distinct().count(), counts_df.count()))
        display(counts_df)


# Example usage:
# cols_to_check = ['col1', 'col2', 'col3']  # Replace with the actual column names
# check_duplicate_rows(df, cols_to_check)


To check how many null values in any subset of columns you specify, as well as what is the percentage of nulls in total row count, use this custom function 


from pyspark.sql.functions import col, round, sum as spark_sum

def null_check(df, columns):
    """
    Count the number of null values in the specified columns of a PySpark DataFrame.

    Parameters:
    - df: PySpark DataFrame
        The DataFrame to check for null values.
    - columns: list of str
        A list of column names to check for null values.

    Returns:
    - PySpark DataFrame
        A DataFrame with three columns: "column_name", "null_count", and "null_percent".

    Call Example:
      cols = test_df.columns
      result_df = null_check(test_df, cols)
      result_df.show()

    """
    row_count = df.count()

    null_counts = []
    for column in columns:
        null_count = df.select(spark_sum(col(column).isNull().cast("int")).alias(column)).collect()[0][column]
        null_percent = null_count / row_count
        column_info = (column, null_count, null_percent)
        null_counts.append(column_info)

    # Create a PySpark DataFrame to hold the results
    result_df = spark.createDataFrame(null_counts, ["column_name", "null_count", "null_percent"])

    # Round the null_percent column
    result_df = result_df.withColumn("null_percent", round(col("null_percent"), 2))

    return result_df

To visualize the distribution of a specific column, you can create a histogram using Plotly Express. First, ensure you have the required libraries installed:

pip install plotly

Then, convert your DataFrame to a Pandas DataFrame and create the histogram:

import plotly.express as px

# Convert to Pandas DataFrame
pandas_df = df.toPandas()

# Create a histogram for a specific column (e.g., "column_name")
fig = px.histogram(pandas_df, x="column_name", title="Histogram of Column Name")
fig.show()

By obtaining the row count, null counts, and duplicate counts, along with visualizing your data through a histogram, you can gain valuable insights into your dataset, helping you make informed decisions for the next steps in your ETL process.


After profiling your data, the next step in the ETL process is filtering, which allows you to refine your dataset by keeping only the relevant rows. Filtering is crucial for data quality and ensuring that your analysis focuses on the most pertinent information.

In PySpark, you can filter data using the filter() or where() methods. Both methods work similarly, allowing you to specify conditions for selecting rows.

Basic Filtering Example

Here’s a simple example of filtering rows where a specific column meets a certain condition. For instance, to filter rows where the value in the "age" column is greater than 30:

filtered_df = df.filter(df.age > 30)

Alternatively, you can use SQL-like syntax for filtering:

filtered_df = df.filter('age > 30')

You can also use the where() method in a similar way:

filtered_df = df.where(df.age > 30)

You can filter using multiple conditions with logical operators like & (and) and | (or). For example, to filter for rows where "age" is greater than 30 and "salary" is less than 60,000:

filtered_df = df.filter((df.age > 30) & (df.salary < 60000))
filtered_df = df.filter('age > 30 AND salary < 60000')

Filtering your dataset is an essential part of the ETL process that allows you to focus on the relevant data for analysis. Using the filter() or where() methods in PySpark makes it easy to refine your DataFrame based on specific conditions, whether using method chaining or SQL-like syntax, helping you prepare for the next steps in your data journey.

Once you've filtered your dataset, the next crucial task is to handle any null values that may still be present. Nulls can significantly impact your analysis, so it's vital to address them appropriately. Let's explore some effective techniques for managing null values in PySpark, including filtering them out, backfilling, forward filling, and imputing with the mean.

You can easily filter out rows with null values in a specific column:

cleaned_df = df.filter(df.column_name.isNotNull())

To backfill null values in a column, you can use the fillna() method with a specific value:

(Backfilling replaces null values with the next valid observation in the column)

backfilled_df = df.fillna(method='backfill')

To forward fill null values, use:

(forward filling fills nulls with the most recent valid observation before the null.)

forward_filled_df = df.fillna(method='ffill')

 To replace null values with the mean of a specific column, first calculate the mean and then use fillna():

mean_value = df.select(mean(df.column_name)).first()[0]
imputed_df = df.fillna(mean_value, subset=['column_name'])

After handling null values, another important step in the ETL process is to address duplicates within your dataset. Duplicates can skew your analysis and lead to inaccurate results, making it essential to identify and remove them. In PySpark, you can easily drop duplicate rows from your DataFrame to ensure data integrity.

To remove duplicate rows from your DataFrame, you can use the dropDuplicates() method. This method removes all rows that have the same values across all specified columns. Here’s how to do it:

To drop duplicates across all columns, simply call:
cleaned_df = df.dropDuplicates()

If you want to drop duplicates based on specific columns, you can pass those column names as a list:
cleaned_df = df.dropDuplicates(['column1', 'column2'])

After ensuring your dataset is clean and free of duplicates, the next steps involve grouping and reshaping your data for deeper analysis. Grouping data allows you to aggregate values based on specific categories, while pivoting provides a way to reorganize your data for better readability and insights. Let’s explore basic examples of both techniques using PySpark.

To group your data and perform aggregate functions, you can use the groupBy() method. This method enables you to summarize your dataset based on one or more columns. Here’s a basic example:

Suppose you want to calculate the average salary by department. You can achieve this as follows:

average_salary_df = df.groupBy("department").agg(avg("salary").alias("average_salary"))

Once you have grouped your data, you may find that certain aggregations could be more insightful if presented in a different format. This is where pivoting comes into play. Pivoting allows you to transform unique values from one column into multiple columns in the resulting DataFrame, providing a clearer view of your data relationships.

For instance, if you want to see the total sales by product category and region, you can do this:

pivot_df = df.groupBy("region").pivot("product_category").agg(sum("sales"))


Grouping and pivoting are powerful techniques that enable you to gain valuable insights from your data. By using the groupBy() method for aggregation and pivot() for reshaping your DataFrame, you can enhance your analysis and make data-driven decisions with greater clarity.

After processing your data, saving it as a Delta table is a crucial step for efficient storage and retrieval. Delta tables provide ACID transactions, scalable metadata handling, and unifies batch and streaming data processing.

To write a DataFrame as a Delta table in PySpark, you can use the built-in write method. Here's how to do it:

df.write.format("delta") \
    .mode("append") \  # Use "overwrite" to replace existing data
    .option("overwriteSchema", "true") \
    .partitionBy("partition_column") \  # Specify your partition column
    .saveAsTable("schema.table_name")  # Provide schema and table name


Key Options

  • format("delta"): Specifies that the data is stored in Delta format.
  • mode("append"): Determines the write mode; use "overwrite" to replace existing data.
  • option("overwriteSchema", "true"): Allows updates to the schema if it changes.
  • partitionBy("partition_column"): Specifies the column for partitioning the table.
  • saveAsTable("schema.table_name"): Saves the DataFrame as a table in the given schema

In this blog, we explored essential PySpark functionalities for effective ETL processes, including reading Delta tables, performing data profiling, filtering, handling null values, removing duplicates, and leveraging grouping and pivoting techniques. Finally, we discussed how to write your processed data as a Delta table for efficient management.

If you found this blog helpful, please like, share, and leave your comments below! We’d love to hear your thoughts and experiences with PySpark and Delta tables.


Share:

Recent Posts