From 2a6bee53a3bc8621f4221d0be215a53c90ea3121 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Edgar=20Ram=C3=ADrez=20Mondrag=C3=B3n?=
 <16805946+edgarrmondragon@users.noreply.github.com>
Date: Wed, 4 Dec 2024 10:56:24 -0600
Subject: [PATCH] packaging: SQL taps now require SQLAlchemy 2.0+ (#2797)

---
 .../tap-template/{{cookiecutter.tap_id}}/pyproject.toml       | 3 +++
 docs/guides/sql-tap.md                                        | 4 ++++
 2 files changed, 7 insertions(+)

diff --git a/cookiecutter/tap-template/{{cookiecutter.tap_id}}/pyproject.toml b/cookiecutter/tap-template/{{cookiecutter.tap_id}}/pyproject.toml
index bf1deb719..4161643a4 100644
--- a/cookiecutter/tap-template/{{cookiecutter.tap_id}}/pyproject.toml
+++ b/cookiecutter/tap-template/{{cookiecutter.tap_id}}/pyproject.toml
@@ -38,6 +38,9 @@ fs-s3fs = { version = "~=1.1.1", optional = true }
 {%- if cookiecutter.stream_type in ["REST", "GraphQL"] %}
 requests = "~=2.32.3"
 {%- endif %}
+{%- if cookiecutter.stream_type == "SQL" %}
+sqlalchemy = "~=2.0.36"
+{%- endif %}
 
 [tool.poetry.group.dev.dependencies]
 pytest = ">=8"
diff --git a/docs/guides/sql-tap.md b/docs/guides/sql-tap.md
index 9e3eda34e..68b171f84 100644
--- a/docs/guides/sql-tap.md
+++ b/docs/guides/sql-tap.md
@@ -1,5 +1,9 @@
 # Building SQL taps
 
+```{warning}
+Starting with version `0.43.0`, SQL taps require SQLAlchemy 2.0 or newer.
+```
+
 ## Mapping SQL types to JSON Schema
 
 Starting with version `0.41.0`, the Meltano Singer SDK provides a clean way to map SQL types to JSON Schema. This is useful when the SQL dialect you are using has custom types that need to be mapped accordingly to JSON Schema.