Workload
Teradata ETL pipelines to BigQuery
Re-home batch and incremental ETL-staging, dedupe, SCD patterns, and orchestration-from Teradata into BigQuery with an explicit run contract and validation gates that prevent KPI drift.
Quick answer
Re-home batch and incremental ETL-staging, dedupe, SCD patterns, and orchestration-from Teradata into BigQuery with an explicit run contract and validation gates that prevent KPI drift.
Back to pair pageContext
Why this breaks
Teradata ETL systems often carry decades of operational behavior: restartability patterns, control tables, load windows, and incremental rules shaped by Teradata’s PI/AMP execution model and tooling (BTEQ, FastLoad/TPump, MultiLoad, TPT). When migrated naïvely, jobs may “run” in BigQuery but produce drift or miss SLAs because the run contract was never made explicit. Common symptoms after cutover:
- Duplicates or missing updates because watermarks and tie-breakers were implicit - SCD dimensions drift during backfills, restarts, or late-arrival corrections - Control-table driven restart logic breaks; reruns double-apply or silently skip - Performance collapses because pipelines lose pruning-aware staging boundaries - Orchestration dependencies and retries change, turning failures into silent data issues
Approach
How conversion works
- Inventory & classify ETL jobs, dependencies, schedules, and operational controls (control tables, restart markers, load windows). - Extract the run contract: business keys, incremental boundaries, dedupe rules, SCD strategy, error handling, and restartability semantics. - Re-home transformations using BigQuery-native staging (landing -> typed staging -> dedupe -> apply) with partitioning/clustering aligned to load windows. - Rebuild restartability: idempotency keys, applied-batch tracking, and deterministic ordering so retries are safe. - Re-home orchestration (Composer/Airflow, dbt, or your runner) with explicit DAG dependencies, retries, and alerts. - Gate cutover with evidence: golden outputs + incremental integrity simulations (reruns, backfills, late-arrival injections) and rollback-ready criteria.
Coverage
Supported constructs
Representative Teradata ETL constructs we commonly migrate to BigQuery (exact coverage depends on your estate).
| Source | Target | Notes |
|---|---|---|
| BTEQ / SQL scripts with control tables | BigQuery SQL + control tables for restartability | Applied-window tracking and idempotent reruns made explicit. |
| FastLoad/TPump/MultiLoad patterns | Landing + typed staging + partition-scoped apply | Replace load-tool semantics with deterministic staging boundaries. |
| Incremental loads (watermarks, load windows) | Explicit high-water mark + late window policy | Auditable and testable under retries/backfills. |
| SCD Type-1 / Type-2 apply logic | MERGE + end-date/current-flag patterns | Backfills and restarts validated as first-class scenarios. |
| Staging/volatile tables | Dataset staging + temp tables / materializations | Concurrency-safe and pruning-aligned. |
| Workload management constraints | Reservations/slots + concurrency controls | Predictable batch windows and BI refresh coexistence. |
Compare
How workload changes
| Topic | Teradata | BigQuery | Notes |
|---|---|---|---|
| Incremental correctness | Often encoded in control tables, load windows, and restart conventions | Explicit high-water marks + deterministic staging + integrity gates | Correctness becomes auditable and repeatable under retries/backfills. |
| Staging and apply | Load tools + volatile tables + PI/AMP locality | Landing -> typed staging -> dedupe -> partition-scoped apply | Pruning and layout drive stable cost and runtime. |
| Orchestration | Enterprise schedulers + script chains | Composer/dbt/native orchestration with explicit DAG contracts | Retries, alerts, and dependencies are modeled and monitored. |
| Cost and capacity | Platform resource governance + workload classes | Bytes scanned + slot time + reservation strategy | Batch windows require pruning-aware design and capacity posture. |
Examples
Examples
Canonical BigQuery apply pattern for incremental ETL: stage -> dedupe deterministically -> MERGE with scoped partitions + applied-window tracking. Adjust keys, partitions, and casts to your model.
-- Control table for load windows (restartability)
CREATE TABLE IF NOT EXISTS `proj.control.load_windows` (
job_name STRING NOT NULL,
window_start TIMESTAMP NOT NULL,
window_end TIMESTAMP NOT NULL,
status STRING NOT NULL,
applied_at TIMESTAMP
);
-- Example: mark a window as STARTED
INSERT INTO `proj.control.load_windows` (job_name, window_start, window_end, status)
VALUES (@job_name, @window_start, @window_end, 'STARTED'); -- Stage -> dedupe (deterministic) -> apply (partition-scoped)
CREATE TEMP TABLE stg AS
SELECT
CAST(id AS STRING) AS id,
CAST(status AS STRING) AS status,
CAST(amount AS NUMERIC) AS amount,
event_ts,
SAFE_CAST(src_seq AS INT64) AS src_seq,
ingested_at
FROM `proj.raw.orders`
WHERE event_ts >= @window_start AND event_ts < @window_end;
CREATE TEMP TABLE stg_dedup AS
SELECT *
FROM stg
QUALIFY ROW_NUMBER() OVER (
PARTITION BY id
ORDER BY event_ts DESC, src_seq DESC, ingested_at DESC
) = 1;
DECLARE min_d DATE DEFAULT (SELECT MIN(DATE(event_ts)) FROM stg_dedup);
DECLARE max_d DATE DEFAULT (SELECT MAX(DATE(event_ts)) FROM stg_dedup);
MERGE `proj.mart.fact_orders` t
USING stg_dedup s
ON t.id = s.id
AND DATE(t.updated_at) BETWEEN min_d AND max_d
WHEN MATCHED THEN UPDATE SET
t.status = s.status,
t.amount = s.amount,
t.updated_at = s.event_ts
WHEN NOT MATCHED THEN
INSERT (id, status, amount, updated_at)
VALUES (s.id, s.status, s.amount, s.event_ts); -- Mark the load window as APPLIED (idempotency marker)
UPDATE `proj.control.load_windows`
SET status = 'APPLIED', applied_at = CURRENT_TIMESTAMP()
WHERE job_name = @job_name
AND window_start = @window_start
AND window_end = @window_end
AND status = 'STARTED'; Workload Assessment
Migrate Teradata ETL with restartability intact
We inventory your Teradata ETL estate, formalize the run contract (windows, restartability, SCD), migrate a representative pipeline end-to-end, and deliver parity evidence with cutover gates.
Book assessmentAvoid
Common pitfalls
- Assuming Teradata load tools map 1:1: FastLoad/TPump patterns need BigQuery-native staging and apply strategy.
- Implicit restart logic: control-table conventions not recreated, causing reruns to double-apply or skip.
- Non-deterministic dedupe: ROW_NUMBER without stable tie-breakers, leading to drift under retries.
- PI/AMP assumptions carried over: join and staging shapes that relied on locality now reshuffle large datasets.
- Unbounded applies: MERGE/upsert jobs scan full targets without partition-scoped boundaries.
- Schema evolution surprises: upstream types widen; downstream typed tables fail or truncate.
- No incremental integrity tests: parity looks fine on a one-time run but breaks under backfills/late data.
Proof
Validation approach
- Execution checks: pipeline runs reliably under representative volumes and schedules.
- Structural parity: partition-level row counts and column profiles (null/min/max/distinct) for key tables.
- KPI parity: aggregates by key dimensions for critical marts and dashboards.
- Incremental integrity (mandatory): - _Idempotency:_ rerun same load window -> no net change - _Restart simulation:_ fail mid-run -> resume -> correct final state - _Backfill:_ historical windows replay without SCD drift - _Late-arrival:_ inject late corrections -> only expected rows change
- Cost/performance gates: pruning verified; scan bytes and runtime thresholds set for top jobs.
- Operational readiness: retry/alerting tests and rollback criteria defined before cutover.
Execution
Migration steps
A sequence that keeps pipeline correctness measurable and cutover controlled.
-
01
Inventory ETL jobs, schedules, and dependencies
Extract job chains, upstream/downstream dependencies, SLAs, retry policies, and control-table conventions. Identify business-critical marts and consumers.
-
02
Formalize the run contract
Define load windows/high-water marks, business keys, deterministic ordering/tie-breakers, dedupe rules, late-arrival policy, and SCD strategy. Make restartability explicit.
-
03
Rebuild transformations on BigQuery-native staging
Implement landing -> typed staging -> dedupe -> apply, with partitioning/clustering aligned to load windows and BI access paths. Define schema evolution policy (widen/quarantine/reject).
-
04
Re-home orchestration and operations
Implement DAGs in Composer/Airflow or your orchestrator: dependencies, retries, alerts, and concurrency. Recreate control-table driven restart logic with idempotent markers.
-
05
Run parity and incremental integrity gates
Golden outputs + KPI aggregates, restart simulations, idempotency reruns, late-data injections, and backfill windows. Cut over only when thresholds pass and rollback criteria are defined.
FAQ
Frequently asked questions
Is Teradata ETL migration just rewriting BTEQ scripts? +
No. The critical work is preserving the run contract: load windows, restartability, dedupe/tie-break rules, SCD semantics, and operational error handling. Script translation is only one component.
How do you handle restartability and reruns? +
We recreate restart semantics explicitly: applied-window tracking, deterministic ordering, idempotent staging/apply, and failure-mode simulations so reruns never double-apply or silently skip.
Can you keep pipelines incremental in BigQuery? +
Yes. We implement explicit high-water marks and late-arrival windows, use partition-scoped applies, and validate incremental integrity with reruns/backfills/late injections.
How do you avoid BigQuery cost surprises for ETL? +
We design pruning-aware staging boundaries and choose partitioning/clustering aligned to load windows. Validation includes scan bytes/runtime baselines and regression thresholds for your top jobs.
Migration Acceleration
Cut over pipelines with proof-backed gates
Get an actionable migration plan with restart simulations, incremental integrity tests, reconciliation evidence, and cost/performance baselines-so ETL cutover is controlled and dispute-proof.
Next reads
Related pages
- Read more
End-to-end approach: what breaks, validation gates, and cutover plan.
- Read more
Replace PI/AMP-era tuning with pruning-aware SQL, layout, and regression gates in BigQuery.
- Read more
How we define parity contracts, thresholds, and evidence for sign-off.
- Read more
Keep spend predictable and catch regressions early.