Skip to main content

etlantic-pyspark

PySpark reference execution plugin and portable transform compiler for ETLantic 0.54.

Note: This plugin and ETLantic core use Beta classifiers for documented single-tenant pilots. Classifiers are not an enterprise SLA.

Install

pip install etlantic-pyspark
# Optional Delta Lake support:
pip install "etlantic-pyspark[delta]"

Portable transform compiler

from etlantic import Profile

Profile(
    name="spark-local",
    spark_engine="pyspark",
    portable_transform_policy="require",
)

Entry point: etlantic.transform_compilersetlantic_pyspark:create_transform_compiler.

Claims portable-relational-kernel/1 and portable-relational/1. Lowers dtcs.transform-plan/2 to native Spark DataFrame/Column expressions. This is the recommended transformation path and remains eligible for adaptive execution. Automatic Python/Pandas UDF fallback is forbidden.

Native Spark plugin

Register @Transformation.implementation("pyspark") handlers only for Spark behavior outside the portable compiler's claims. They take Spark DataFrames (or lists of contract models), return Spark DataFrames, pin the step to PySpark, and are not eligible for adaptive execution.

Native capabilities

  • Lazy Spark region fusion with preserved logical identities
  • Local Spark provider (local[*]) — secrets resolved only at session acquire
  • Native-expression preference with UDF policy diagnostics
  • Contract ↔ Spark schema mapping (lossy/unknown never guessed)
  • Valid/invalid row separation
  • Delta-compatible write intents (append/overwrite/merge) when Delta is enabled
  • Structured Streaming foundation (experimental)

Native UDF policy stays separate. Default CI uses sparkless; set SPARKLESS_TEST_MODE=pyspark for real JVM Catalyst checks.

Not included: managed cloud providers (Databricks/EMR/Connect).

PySpark tutorial · Compatibility · Source · Issues

Release files for etlantic-pyspark 0.54.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for etlantic-pyspark 0.54.0
File Size Uploaded
etlantic_pyspark-0.54.0.tar.gz 22.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for etlantic-pyspark 0.54.0
File Interpreter ABI Platform
etlantic_pyspark-0.54.0-py3-none-any.whl Python 3 none any Details

Total release size: 48.7 kB

Release files / etlantic_pyspark-0.54.0.tar.gz

Download URL etlantic_pyspark-0.54.0.tar.gz
Size 22.5 kB
Tags Source
SHA-256 checksum
How to use checksums
84ecf1dad71003d7c3952dda1d1367df1df785172ebffc4219fa85b9c72f237a
BLAKE2b-256 checksum
How to use checksums
c3bce9fab4bb55f2e29bc52b3145f1cb233df97f4db9a595e2f9993aa93f3fc8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / etlantic_pyspark-0.54.0-py3-none-any.whl

Download URL etlantic_pyspark-0.54.0-py3-none-any.whl
Size 26.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
360104a65174f2c49d1ddda9b6eb086df309033a95deeedcdaf294f3c6bf7ad8
BLAKE2b-256 checksum
How to use checksums
b5be4c3cd7cd9f0a29fecf8d03b88b3b4c652b0f284158401cf71acc4705ba49
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page