dataform-bigquery

Generates and validates Dataform SQLX pipeline code for BigQuery ELT workflows.

Updated Aug 26, 2026
One-click install
npx skills add https://github.com/Lathika-laa/Recipe_Box --skill dataform-bigquery-lathika-laa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dataform-bigquery
Source: https://github.com/Lathika-laa/Recipe_Box/tree/main/.github/.gemini/skills/dataform-bigquery
Command: npx skills add https://github.com/Lathika-laa/Recipe_Box --skill dataform-bigquery-lathika-laa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building correct Dataform pipelines for BigQuery requires deep knowledge of SQLX syntax, incremental table semantics, source declarations, and GCS ingestion patterns. This Skill guides an AI through the full lifecycle of creating, modifying, and validating Dataform projects so pipelines compile cleanly and follow BigQuery best practices. ## Core Features & Use Cases - Pipeline Generation & Modification: Creates and edits SQLX actions, source declarations, and incremental tables, with automatic data cleaning and SQL optimization applied to every change. - Environment Setup & Validation: Verifies dataform and bq CLI installation, initializes repositories with workflow_settings.yaml, manages .df-credentials.json, and validates via dataform compile and dry runs. - GCS Ingestion & BigLake Support: Builds external tables from GCS files with resilient CSV parsing options and handles 4-part BigLake Iceberg naming through schema concatenation. - Use Case: Ask the assistant to append daily CSV files from a GCS bucket into an existing BigQuery table; it will create the external table declaration, an incremental SQLX action with cleaned and schema-aligned columns, then compile and dry-run the pipeline. ## Quick Start Ask the assistant to create a Dataform pipeline that loads data from a GCS bucket into a BigQuery table and validate it with a dry run.

Frequently Asked Questions about dataform-bigquery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Dataform pipeline for BigQuery?▼

Initialize a repository with dataform init, define source declarations for input tables, and write SQLX actions for transformations. Validate the pipeline with dataform compile and dataform run --dry-run before any real execution.

How to append data to an existing BigQuery table with Dataform?▼

Use a SQLX action with type: "incremental" and set the name to the existing target table. The body must contain only a SELECT statement whose columns match the target schema; Dataform auto-generates the INSERT, and no declaration file is needed for the target.

Can Dataform query BigLake Iceberg tables with 4-part names?▼

Dataform does not natively support 4-part Project.Catalog.Dataset.Table names in declarations. Concatenate the catalog and namespace into the schema field, for example schema: "my_catalog.my_namespace", then reference the table normally with ref().

Why does dataform run --dry-run fail with table not found errors?▼

Dry runs fail with "Table not found" when upstream tables defined in the project have not been materialized in BigQuery yet. These specific errors can be ignored; rely on dataform compile, manual SQL inspection, and bq query --dry_run instead.

How do I ingest CSV files from GCS into BigQuery using Dataform?▼

Create an external table in a SQLX operations file pointing at the GCS URI. Use STRING for all CSV columns and set allow_jagged_rows, allow_quoted_newlines, and ignore_unknown_values to true for resilient parsing.