external_table_troubleshooting

Diagnose and fix dbt models loading 0 rows from misconfigured Snowflake external tables.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mporenta/airflow --skill external-table-troubleshooting
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: external_table_troubleshooting
Source: https://github.com/mporenta/airflow/tree/main/.claude/skills/external_table_troubleshooting
Command: npx skills add https://github.com/mporenta/airflow --skill external-table-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Troubleshoot and resolve cases where dbt models execute successfully but load 0 rows due to external table misconfigurations or missing data in the underlying S3 sources.

Core Features & Use Cases

  • Validate external table existence and correct S3 paths for staging vs production.
  • Facilitate creation or refreshing of external tables and ensure dbt uses the proper raw database.
  • Provide a repeatable, documented workflow to diagnose and fix 0-row loads in data pipelines.

Quick Start

Verify the target environment and S3 data, then run the external-table creation and dbt steps to rebind external tables and reload data.

Frequently Asked Questions about external_table_troubleshooting

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

FAQPage Schema
Why does my dbt model run successfully but load 0 rows from Snowflake external tables?▼

When dbt models load 0 rows, the cause is typically external table misconfigurations or missing data in the underlying S3 sources. Verifying S3 data existence and environment alignment identifies whether the issue is configuration or source data.

How do I fix Snowflake external tables returning 0 rows from S3?▼

Fix this by verifying S3 data availability and environment-specific paths, then executing external table creation or refresh commands in Snowflake. Re-running the dbt models afterward ensures the pipeline binds to the correct raw database and loads data properly.

How do I verify S3 paths for staging vs production external tables in dbt?▼

Validate external table existence and confirm the S3 paths match the target staging or production environment. Ensuring dbt uses the proper raw database prevents environment misalignment from causing 0-row loads.

Do I need to refresh Snowflake external tables before re-running dbt models?▼

Yes, refreshing or recreating Snowflake external tables is required before re-running dbt models. This ensures the external table metadata recognizes available S3 data, preventing recurring 0-row issues in the data pipeline.

What is the best way to prevent recurring 0-row loads in dbt and Snowflake pipelines?▼

The best way to prevent recurring 0-row loads is to enforce a repeatable workflow that includes environment alignment, external table management, and S3 data validation. This ensures sources are populated and tables are refreshed before dbt execution.