etlantic-sql
PostgreSQL reference SQL execution plugin for ETLantic 0.20.
pip install 'etlantic==0.22.0' 'etlantic-sql==0.22.0'
# or: pip install 'etlantic[sql]'
export ETLANTIC_SQL_URL=postgresql+psycopg://user:pass@localhost:5432/etlantic
# SQLite is fine for demos only:
# export ETLANTIC_SQL_URL=sqlite+pysqlite:///:memory:
Uses SQLAlchemy Core. Driver dependencies stay out of etlantic core.
Wiring
from etlantic import Profile
Profile(name="sql-prod", sql_engine="sql")
The etlantic.sql_plugins entry point named sql registers
etlantic_sql:create_plugin. Profiles select it with sql_engine="sql";
keep connection URLs in environment-backed configuration or secret providers,
not in plans.
Register @Transformation.implementation("sql") handlers that take
RelationRef inputs and return SQL query handles (not fetched rows).
Capabilities
- SQL→SQL fusion without intermediate Python row fetch
- Durable run-scoped staging tables (not session TEMP)
- Insert-select / CTAS-style publication
- Fail-closed planning when required capabilities are missing
Not included: MERGE / upsert (sql_merge=False). Requiring merge fails
at planning.
Examples
python examples/sql_to_sql.py
python examples/sql_boundary_hybrid.py
python examples/sql_transactional_write.py
python examples/sql_failure_recovery.py
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file etlantic_sql-0.22.0.tar.gz.
File metadata
- Download URL: etlantic_sql-0.22.0.tar.gz
- Upload date:
- Size: 20.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
13efb2cece7d4e3cd250fa8b875038ab7a5aca05df0b4603da30d94b36d3a026
|
|
| MD5 |
593df8118dbea080660aa02ddaeda92f
|
|
| BLAKE2b-256 |
a924869fc6b1185b517135d3099448cecd0a50203b56b5a3acb23cdeb37849d6
|
File details
Details for the file etlantic_sql-0.22.0-py3-none-any.whl.
File metadata
- Download URL: etlantic_sql-0.22.0-py3-none-any.whl
- Upload date:
- Size: 26.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8b7b0813d5947e3db97acaf6c9dc9d6163702794905108decf219c86d80a0a37
|
|
| MD5 |
69277a48c6fa5e71068c0f49d5f8235d
|
|
| BLAKE2b-256 |
56f697209ea17d841f4b672476b1b9489a8a27807645e56d4a5ec76b9b77fd40
|
