apache-airflow-providers-common-sql 1.30.1__tar.gz → 1.30.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/NOTICE +1 -1
  2. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/PKG-INFO +11 -8
  3. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/README.rst +5 -4
  4. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/changelog.rst +44 -0
  5. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/index.rst +4 -4
  6. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/operators.rst +23 -0
  7. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/provider.yaml +4 -1
  8. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/pyproject.toml +8 -4
  9. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/__init__.py +1 -1
  10. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/hooks/sql.py +43 -16
  11. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/operators/generic_transfer.pyi +1 -1
  12. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/operators/sql.py +3 -0
  13. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/sensors/sql.pyi +1 -1
  14. apache_airflow_providers_common_sql-1.30.4/tests/system/common/sql/example_sql_value_check.py +62 -0
  15. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/operators/test_sql.py +19 -10
  16. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/LICENSE +0 -0
  17. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/.latest-doc-only-change.txt +0 -0
  18. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/commits.rst +0 -0
  19. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/conf.py +0 -0
  20. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/connections.rst +0 -0
  21. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/dataframes.rst +0 -0
  22. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/dialects.rst +0 -0
  23. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/installing-providers-from-sources.rst +0 -0
  24. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/integration-logos/sql.png +0 -0
  25. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/security.rst +0 -0
  26. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/docs/supported-database-types.rst +0 -0
  27. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/__init__.py +0 -0
  28. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/__init__.py +0 -0
  29. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/__init__.py +0 -0
  30. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/README_API.md +0 -0
  31. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/dialects/__init__.py +0 -0
  32. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/dialects/dialect.py +0 -0
  33. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/dialects/dialect.pyi +0 -0
  34. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/doc/adr/0001-record-architecture-decisions.md +0 -0
  35. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/doc/adr/0002-return-common-data-structure-from-dbapihook-derived-hooks.md +0 -0
  36. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/doc/adr/0003-introduce-notion-of-dialects-in-dbapihook.md +0 -0
  37. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/get_provider_info.py +0 -0
  38. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/get_provider_info.pyi +0 -0
  39. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/hooks/__init__.py +0 -0
  40. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/hooks/handlers.py +0 -0
  41. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/hooks/handlers.pyi +0 -0
  42. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/hooks/sql.pyi +0 -0
  43. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/operators/__init__.py +0 -0
  44. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/operators/generic_transfer.py +0 -0
  45. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/sensors/__init__.py +0 -0
  46. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/sensors/sql.py +0 -0
  47. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/triggers/__init__.py +0 -0
  48. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/triggers/sql.py +0 -0
  49. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/triggers/sql.pyi +0 -0
  50. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/src/airflow/providers/common/sql/version_compat.py +0 -0
  51. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/conftest.py +0 -0
  52. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/system/__init__.py +0 -0
  53. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/system/common/__init__.py +0 -0
  54. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/system/common/sql/__init__.py +0 -0
  55. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/system/common/sql/example_generic_transfer.py +0 -0
  56. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/system/common/sql/example_sql_column_table_check.py +0 -0
  57. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/system/common/sql/example_sql_execute_query.py +0 -0
  58. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/system/common/sql/example_sql_insert_rows.py +0 -0
  59. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/system/common/sql/example_sql_threshold_check.py +0 -0
  60. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/__init__.py +0 -0
  61. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/__init__.py +0 -0
  62. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/__init__.py +0 -0
  63. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/dialects/__init__.py +0 -0
  64. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/dialects/test_dialect.py +0 -0
  65. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/hooks/__init__.py +0 -0
  66. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/hooks/test_dbapi.py +0 -0
  67. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/hooks/test_handlers.py +0 -0
  68. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/hooks/test_sql.py +0 -0
  69. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/hooks/test_sqlparse.py +0 -0
  70. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/operators/__init__.py +0 -0
  71. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/operators/test_generic_transfer.py +0 -0
  72. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/operators/test_sql_execute.py +0 -0
  73. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/sensors/__init__.py +0 -0
  74. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/sensors/test_sql.py +0 -0
  75. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/triggers/__init__.py +0 -0
  76. {apache_airflow_providers_common_sql-1.30.1 → apache_airflow_providers_common_sql-1.30.4}/tests/unit/common/sql/triggers/test_sql.py +0 -0
@@ -1,5 +1,5 @@
1
1
  Apache Airflow
2
- Copyright 2016-2025 The Apache Software Foundation
2
+ Copyright 2016-2026 The Apache Software Foundation
3
3
 
4
4
  This product includes software developed at
5
5
  The Apache Software Foundation (http://www.apache.org/).
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: apache-airflow-providers-common-sql
3
- Version: 1.30.1
3
+ Version: 1.30.4
4
4
  Summary: Provider package apache-airflow-providers-common-sql for Apache Airflow
5
5
  Keywords: airflow-provider,common.sql,airflow,integration
6
6
  Author-email: Apache Software Foundation <dev@airflow.apache.org>
@@ -23,7 +23,7 @@ Classifier: Topic :: System :: Monitoring
23
23
  License-File: LICENSE
24
24
  License-File: NOTICE
25
25
  Requires-Dist: apache-airflow>=2.11.0
26
- Requires-Dist: apache-airflow-providers-common-compat>=1.10.1
26
+ Requires-Dist: apache-airflow-providers-common-compat>=1.12.0
27
27
  Requires-Dist: sqlparse>=0.5.1
28
28
  Requires-Dist: more-itertools>=9.0.0
29
29
  Requires-Dist: methodtools>=0.4.7
@@ -31,9 +31,10 @@ Requires-Dist: apache-airflow-providers-openlineage ; extra == "openlineage"
31
31
  Requires-Dist: pandas[sql-other]>=2.1.2 ; extra == "pandas" and ( python_version <"3.13")
32
32
  Requires-Dist: pandas>=2.2.3 ; extra == "pandas" and ( python_version >="3.13")
33
33
  Requires-Dist: polars>=1.26.0 ; extra == "polars"
34
+ Requires-Dist: sqlalchemy>=1.4.49 ; extra == "sqlalchemy"
34
35
  Project-URL: Bug Tracker, https://github.com/apache/airflow/issues
35
- Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.1/changelog.html
36
- Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.1
36
+ Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.4/changelog.html
37
+ Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.4
37
38
  Project-URL: Mastodon, https://fosstodon.org/@airflow
38
39
  Project-URL: Slack Chat, https://s.apache.org/airflow-slack
39
40
  Project-URL: Source Code, https://github.com/apache/airflow
@@ -41,6 +42,7 @@ Project-URL: YouTube, https://www.youtube.com/channel/UCSXwxpWZQ7XZ1WL3wqevChA/
41
42
  Provides-Extra: openlineage
42
43
  Provides-Extra: pandas
43
44
  Provides-Extra: polars
45
+ Provides-Extra: sqlalchemy
44
46
 
45
47
 
46
48
  .. Licensed to the Apache Software Foundation (ASF) under one
@@ -67,7 +69,7 @@ Provides-Extra: polars
67
69
 
68
70
  Package ``apache-airflow-providers-common-sql``
69
71
 
70
- Release: ``1.30.1``
72
+ Release: ``1.30.4``
71
73
 
72
74
 
73
75
  `Common SQL Provider <https://en.wikipedia.org/wiki/SQL>`__
@@ -80,7 +82,7 @@ This is a provider package for ``common.sql`` provider. All classes for this pro
80
82
  are in ``airflow.providers.common.sql`` python package.
81
83
 
82
84
  You can find package information and changelog for the provider
83
- in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.1/>`_.
85
+ in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.4/>`_.
84
86
 
85
87
  Installation
86
88
  ------------
@@ -98,7 +100,7 @@ Requirements
98
100
  PIP package Version required
99
101
  ========================================== ==================
100
102
  ``apache-airflow`` ``>=2.11.0``
101
- ``apache-airflow-providers-common-compat`` ``>=1.10.1``
103
+ ``apache-airflow-providers-common-compat`` ``>=1.12.0``
102
104
  ``sqlparse`` ``>=0.5.1``
103
105
  ``more-itertools`` ``>=9.0.0``
104
106
  ``methodtools`` ``>=0.4.7``
@@ -133,8 +135,9 @@ Extra Dependencies
133
135
  ``pandas`` ``pandas[sql-other]>=2.1.2; python_version <"3.13"``, ``pandas>=2.2.3; python_version >="3.13"``
134
136
  ``openlineage`` ``apache-airflow-providers-openlineage``
135
137
  ``polars`` ``polars>=1.26.0``
138
+ ``sqlalchemy`` ``sqlalchemy>=1.4.49``
136
139
  =============== ================================================================================================
137
140
 
138
141
  The changelog for the provider package can be found in the
139
- `changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.1/changelog.html>`_.
142
+ `changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.4/changelog.html>`_.
140
143
 
@@ -23,7 +23,7 @@
23
23
 
24
24
  Package ``apache-airflow-providers-common-sql``
25
25
 
26
- Release: ``1.30.1``
26
+ Release: ``1.30.4``
27
27
 
28
28
 
29
29
  `Common SQL Provider <https://en.wikipedia.org/wiki/SQL>`__
@@ -36,7 +36,7 @@ This is a provider package for ``common.sql`` provider. All classes for this pro
36
36
  are in ``airflow.providers.common.sql`` python package.
37
37
 
38
38
  You can find package information and changelog for the provider
39
- in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.1/>`_.
39
+ in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.4/>`_.
40
40
 
41
41
  Installation
42
42
  ------------
@@ -54,7 +54,7 @@ Requirements
54
54
  PIP package Version required
55
55
  ========================================== ==================
56
56
  ``apache-airflow`` ``>=2.11.0``
57
- ``apache-airflow-providers-common-compat`` ``>=1.10.1``
57
+ ``apache-airflow-providers-common-compat`` ``>=1.12.0``
58
58
  ``sqlparse`` ``>=0.5.1``
59
59
  ``more-itertools`` ``>=9.0.0``
60
60
  ``methodtools`` ``>=0.4.7``
@@ -89,7 +89,8 @@ Extra Dependencies
89
89
  ``pandas`` ``pandas[sql-other]>=2.1.2; python_version <"3.13"``, ``pandas>=2.2.3; python_version >="3.13"``
90
90
  ``openlineage`` ``apache-airflow-providers-openlineage``
91
91
  ``polars`` ``polars>=1.26.0``
92
+ ``sqlalchemy`` ``sqlalchemy>=1.4.49``
92
93
  =============== ================================================================================================
93
94
 
94
95
  The changelog for the provider package can be found in the
95
- `changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.1/changelog.html>`_.
96
+ `changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.4/changelog.html>`_.
@@ -25,6 +25,50 @@
25
25
  Changelog
26
26
  ---------
27
27
 
28
+ 1.30.4
29
+ ......
30
+
31
+ Misc
32
+ ~~~~
33
+
34
+ * ``Add SQLAlchemy to the dev‑dependency group in providers (#60472)``
35
+
36
+ .. Below changes are excluded from the changelog. Move them to
37
+ appropriate section above if needed. Do not delete the lines(!):
38
+
39
+ 1.30.3
40
+ ......
41
+
42
+ Misc
43
+ ~~~~
44
+
45
+ * ``Consume ''AirflowOptionalProviderFeatureException'' from compat sdk in providers (#60335)``
46
+ * ``New year means updated Copyright notices (#60344)``
47
+ * ``Assorted SQLA2/Mypy fixes (#60094)``
48
+ * ``Add proper dependencies for sqlalchemy - common.sql (#59945)``
49
+ * ``Migrate common provider to use airflow.sdk.configuration.conf (#59989)``
50
+
51
+ .. Below changes are excluded from the changelog. Move them to
52
+ appropriate section above if needed. Do not delete the lines(!):
53
+
54
+ 1.30.2
55
+ ......
56
+
57
+ Misc
58
+ ~~~~
59
+
60
+ * ``Remove top-level SDK reference in Core (#59817)``
61
+ * ``Extract shared "module_loading" distribution (#59139)``
62
+
63
+ Doc-only
64
+ ~~~~~~~~
65
+
66
+ * ``Add missing fields to SQLValueCheckOperator docstring (#59409)``
67
+
68
+ .. Below changes are excluded from the changelog. Move them to
69
+ appropriate section above if needed. Do not delete the lines(!):
70
+ * ``TaskInstance unused method cleanup (#59835)``
71
+
28
72
  1.30.1
29
73
  ......
30
74
 
@@ -79,7 +79,7 @@ apache-airflow-providers-common-sql package
79
79
  `Common SQL Provider <https://en.wikipedia.org/wiki/SQL>`__
80
80
 
81
81
 
82
- Release: 1.30.1
82
+ Release: 1.30.4
83
83
 
84
84
  Provider package
85
85
  ----------------
@@ -103,7 +103,7 @@ The minimum Apache Airflow version supported by this provider distribution is ``
103
103
  PIP package Version required
104
104
  ========================================== ==================
105
105
  ``apache-airflow`` ``>=2.11.0``
106
- ``apache-airflow-providers-common-compat`` ``>=1.10.1``
106
+ ``apache-airflow-providers-common-compat`` ``>=1.12.0``
107
107
  ``sqlparse`` ``>=0.5.1``
108
108
  ``more-itertools`` ``>=9.0.0``
109
109
  ``methodtools`` ``>=0.4.7``
@@ -135,5 +135,5 @@ Downloading official packages
135
135
  You can download officially released packages and verify their checksums and signatures from the
136
136
  `Official Apache Download site <https://downloads.apache.org/airflow/providers/>`_
137
137
 
138
- * `The apache-airflow-providers-common-sql 1.30.1 sdist package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_sql-1.30.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_sql-1.30.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_sql-1.30.1.tar.gz.sha512>`__)
139
- * `The apache-airflow-providers-common-sql 1.30.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_sql-1.30.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_sql-1.30.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_sql-1.30.1-py3-none-any.whl.sha512>`__)
138
+ * `The apache-airflow-providers-common-sql 1.30.4 sdist package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_sql-1.30.4.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_sql-1.30.4.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_sql-1.30.4.tar.gz.sha512>`__)
139
+ * `The apache-airflow-providers-common-sql 1.30.4 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_sql-1.30.4-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_sql-1.30.4-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_sql-1.30.4-py3-none-any.whl.sha512>`__)
@@ -148,6 +148,29 @@ The below example demonstrates how to instantiate the SQLTableCheckOperator task
148
148
  :end-before: [END howto_operator_sql_table_check]
149
149
 
150
150
 
151
+ .. _howto/operator:SQLValueCheckOperator:
152
+
153
+ Check value against expected
154
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
155
+
156
+ Use the :class:`~airflow.providers.common.sql.operators.sql.SQLValueCheckOperator` to compare a SQL query result
157
+ against an expected value, with some optionally specified tolerance for numeric results.
158
+ The parameters for this operator are:
159
+
160
+ - ``sql`` - the sql query to be executed, as a templated string.
161
+ - ``pass_value`` - the expected value to compare the query result against.
162
+ - ``tolerance`` (optional) - numerical tolerance for comparisons involving numeric values.
163
+ - ``conn_id`` (optional) - the connection ID used to connect to the database.
164
+ - ``database`` (optional) - name of the database which overwrites the name defined in the connection.
165
+
166
+ The below example demonstrates how to instantiate the SQLValueCheckOperator task.
167
+
168
+ .. exampleinclude:: /../tests/system/common/sql/example_sql_value_check.py
169
+ :language: python
170
+ :dedent: 4
171
+ :start-after: [START howto_operator_sql_value_check]
172
+ :end-before: [END howto_operator_sql_value_check]
173
+
151
174
  .. _howto/operator:SQLThresholdCheckOperator:
152
175
 
153
176
  Check values against a threshold
@@ -22,12 +22,15 @@ description: |
22
22
  `Common SQL Provider <https://en.wikipedia.org/wiki/SQL>`__
23
23
 
24
24
  state: ready
25
- source-date-epoch: 1765298925
25
+ source-date-epoch: 1769460904
26
26
  # Note that those versions are maintained by release manager - do not update them manually
27
27
  # with the exception of case where other provider in sources has >= new provider version.
28
28
  # In such case adding >= NEW_VERSION and bumping to NEW_VERSION in a provider have
29
29
  # to be done in the same PR
30
30
  versions:
31
+ - 1.30.4
32
+ - 1.30.3
33
+ - 1.30.2
31
34
  - 1.30.1
32
35
  - 1.30.0
33
36
  - 1.29.0
@@ -25,7 +25,7 @@ build-backend = "flit_core.buildapi"
25
25
 
26
26
  [project]
27
27
  name = "apache-airflow-providers-common-sql"
28
- version = "1.30.1"
28
+ version = "1.30.4"
29
29
  description = "Provider package apache-airflow-providers-common-sql for Apache Airflow"
30
30
  readme = "README.rst"
31
31
  license = "Apache-2.0"
@@ -59,7 +59,7 @@ requires-python = ">=3.10"
59
59
  # After you modify the dependencies, and rebuild your Breeze CI image with ``breeze ci-image build``
60
60
  dependencies = [
61
61
  "apache-airflow>=2.11.0",
62
- "apache-airflow-providers-common-compat>=1.10.1",
62
+ "apache-airflow-providers-common-compat>=1.12.0",
63
63
  "sqlparse>=0.5.1",
64
64
  "more-itertools>=9.0.0",
65
65
  # The methodtools dependency is necessary since the introduction of dialects:
@@ -82,6 +82,9 @@ dependencies = [
82
82
  "polars" = [
83
83
  "polars>=1.26.0"
84
84
  ]
85
+ "sqlalchemy" = [
86
+ "sqlalchemy>=1.4.49",
87
+ ]
85
88
 
86
89
  [dependency-groups]
87
90
  dev = [
@@ -96,6 +99,7 @@ dev = [
96
99
  "apache-airflow-providers-mysql",
97
100
  "apache-airflow-providers-postgres",
98
101
  "apache-airflow-providers-odbc",
102
+ "apache-airflow-providers-common-sql[sqlalchemy]"
99
103
  ]
100
104
 
101
105
  # To build docs:
@@ -124,8 +128,8 @@ apache-airflow-providers-common-sql = {workspace = true}
124
128
  apache-airflow-providers-standard = {workspace = true}
125
129
 
126
130
  [project.urls]
127
- "Documentation" = "https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.1"
128
- "Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.1/changelog.html"
131
+ "Documentation" = "https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.4"
132
+ "Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.30.4/changelog.html"
129
133
  "Bug Tracker" = "https://github.com/apache/airflow/issues"
130
134
  "Source Code" = "https://github.com/apache/airflow"
131
135
  "Slack Chat" = "https://s.apache.org/airflow-slack"
@@ -29,7 +29,7 @@ from airflow import __version__ as airflow_version
29
29
 
30
30
  __all__ = ["__version__"]
31
31
 
32
- __version__ = "1.30.1"
32
+ __version__ = "1.30.4"
33
33
 
34
34
  if packaging.version.parse(packaging.version.parse(airflow_version).base_version) < packaging.version.parse(
35
35
  "2.11.0"
@@ -29,16 +29,29 @@ import sqlparse
29
29
  from deprecated import deprecated
30
30
  from methodtools import lru_cache
31
31
  from more_itertools import chunked
32
- from sqlalchemy import create_engine, inspect
33
- from sqlalchemy.engine import make_url
34
- from sqlalchemy.exc import ArgumentError, NoSuchModuleError
35
32
 
36
- from airflow.configuration import conf
37
- from airflow.exceptions import AirflowOptionalProviderFeatureException, AirflowProviderDeprecationWarning
38
- from airflow.providers.common.compat.sdk import AirflowException, BaseHook
33
+ try:
34
+ from sqlalchemy import create_engine, inspect
35
+ from sqlalchemy.engine import make_url
36
+ from sqlalchemy.exc import ArgumentError, NoSuchModuleError
37
+ except ImportError:
38
+ create_engine = None # type: ignore[assignment]
39
+ inspect = None # type: ignore[assignment]
40
+ make_url = None # type: ignore[assignment]
41
+ ArgumentError = Exception # type: ignore[misc,assignment]
42
+ NoSuchModuleError = Exception # type: ignore[misc,assignment]
43
+
44
+
45
+ from airflow.exceptions import AirflowProviderDeprecationWarning
46
+ from airflow.providers.common.compat.module_loading import import_string
47
+ from airflow.providers.common.compat.sdk import (
48
+ AirflowException,
49
+ AirflowOptionalProviderFeatureException,
50
+ BaseHook,
51
+ conf,
52
+ )
39
53
  from airflow.providers.common.sql.dialects.dialect import Dialect
40
54
  from airflow.providers.common.sql.hooks import handlers
41
- from airflow.utils.module_loading import import_string
42
55
 
43
56
  if TYPE_CHECKING:
44
57
  from pandas import DataFrame as PandasDataFrame
@@ -304,6 +317,12 @@ class DbApiHook(BaseHook):
304
317
  :param engine_kwargs: Kwargs used in :func:`~sqlalchemy.create_engine`.
305
318
  :return: the created engine.
306
319
  """
320
+ if create_engine is None:
321
+ raise AirflowOptionalProviderFeatureException(
322
+ "SQLAlchemy is required to generate the connection URI. "
323
+ "Install it with: pip install 'apache-airflow-providers-common-sql[sqlalchemy]'"
324
+ )
325
+
307
326
  if engine_kwargs is None:
308
327
  engine_kwargs = {}
309
328
 
@@ -318,22 +337,30 @@ class DbApiHook(BaseHook):
318
337
 
319
338
  @property
320
339
  def inspector(self) -> Inspector:
340
+ if inspect is None:
341
+ raise AirflowOptionalProviderFeatureException(
342
+ "SQLAlchemy is required for database inspection. "
343
+ "Install it with: pip install 'apache-airflow-providers-common-sql[sqlalchemy]'"
344
+ )
321
345
  return inspect(self.get_sqlalchemy_engine())
322
346
 
323
347
  @cached_property
324
348
  def dialect_name(self) -> str:
325
- try:
326
- return make_url(self.get_uri()).get_dialect().name
327
- except (ArgumentError, NoSuchModuleError, ValueError):
328
- config = self.connection_extra
329
- sqlalchemy_scheme = config.get("sqlalchemy_scheme")
330
- if sqlalchemy_scheme:
331
- return sqlalchemy_scheme.split("+")[0] if "+" in sqlalchemy_scheme else sqlalchemy_scheme
332
- return config.get("dialect", "default")
349
+ if make_url is not None:
350
+ try:
351
+ return make_url(self.get_uri()).get_dialect().name
352
+ except (ArgumentError, NoSuchModuleError, ValueError):
353
+ pass
354
+
355
+ config = self.connection_extra
356
+ sqlalchemy_scheme = config.get("sqlalchemy_scheme")
357
+ if sqlalchemy_scheme:
358
+ return sqlalchemy_scheme.split("+")[0] if "+" in sqlalchemy_scheme else sqlalchemy_scheme
359
+ return config.get("dialect", "default")
333
360
 
334
361
  @cached_property
335
362
  def dialect(self) -> Dialect:
336
- from airflow.utils.module_loading import import_string
363
+ from airflow.providers.common.compat.module_loading import import_string
337
364
 
338
365
  dialect_info = self._dialects.get(self.dialect_name)
339
366
 
@@ -38,7 +38,7 @@ from _typeshed import Incomplete as Incomplete
38
38
 
39
39
  from airflow.models import BaseOperator
40
40
  from airflow.providers.common.sql.hooks.sql import DbApiHook as DbApiHook
41
- from airflow.utils.context import Context as Context
41
+ from airflow.sdk import Context
42
42
 
43
43
  class GenericTransfer(BaseOperator):
44
44
  template_fields: Sequence[str]
@@ -862,6 +862,9 @@ class SQLValueCheckOperator(BaseSQLOperator):
862
862
  :param sql: the sql to be executed. (templated)
863
863
  :param conn_id: the connection ID used to connect to the database.
864
864
  :param database: name of database which overwrite the defined one in connection
865
+ :param pass_value: the value to check against
866
+ :param tolerance: (optional) the tolerance allowed to pass records within for
867
+ numeric queries
865
868
  """
866
869
 
867
870
  __mapper_args__ = {"polymorphic_identity": "SQLValueCheckOperator"}
@@ -38,7 +38,7 @@ from typing import Any
38
38
  from _typeshed import Incomplete as Incomplete
39
39
 
40
40
  from airflow.providers.common.compat.sdk import BaseSensorOperator
41
- from airflow.utils.context import Context as Context
41
+ from airflow.sdk import Context
42
42
 
43
43
  class SqlSensor(BaseSensorOperator):
44
44
  template_fields: Sequence[str]
@@ -0,0 +1,62 @@
1
+ #
2
+ # Licensed to the Apache Software Foundation (ASF) under one
3
+ # or more contributor license agreements. See the NOTICE file
4
+ # distributed with this work for additional information
5
+ # regarding copyright ownership. The ASF licenses this file
6
+ # to you under the Apache License, Version 2.0 (the
7
+ # "License"); you may not use this file except in compliance
8
+ # with the License. You may obtain a copy of the License at
9
+ #
10
+ # http://www.apache.org/licenses/LICENSE-2.0
11
+ #
12
+ # Unless required by applicable law or agreed to in writing,
13
+ # software distributed under the License is distributed on an
14
+ # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15
+ # KIND, either express or implied. See the License for the
16
+ # specific language governing permissions and limitations
17
+ # under the License.
18
+ from __future__ import annotations
19
+
20
+ from airflow import DAG
21
+ from airflow.providers.common.sql.operators.sql import SQLValueCheckOperator
22
+ from airflow.sdk.timezone import datetime
23
+
24
+ connection_args = {
25
+ "conn_id": "sales_db",
26
+ "conn_type": "Postgres",
27
+ "host": "postgres",
28
+ "schema": "postgres",
29
+ "login": "postgres",
30
+ "password": "postgres",
31
+ "port": 5432,
32
+ }
33
+
34
+ with DAG(
35
+ "example_sql_value_check_query",
36
+ description="Example DAG for SQLValueCheckOperator.",
37
+ default_args=connection_args,
38
+ start_date=datetime(2025, 12, 15),
39
+ schedule=None,
40
+ catchup=False,
41
+ ) as dag:
42
+ """
43
+ ### Example SQL value check DAG
44
+
45
+ Runs the SQLValueCheckOperator against the Airflow metadata DB.
46
+ """
47
+
48
+ # [START howto_operator_sql_value_check]
49
+ value_check = SQLValueCheckOperator(
50
+ task_id="threshhold_check",
51
+ conn_id="sales_db",
52
+ sql="SELECT count(distinct(customer_id)) FROM sales LIMIT 50;",
53
+ pass_value=40,
54
+ tolerance=5,
55
+ )
56
+ # [END howto_operator_sql_value_check]
57
+
58
+
59
+ from tests_common.test_utils.system_tests import get_test_run # noqa: E402
60
+
61
+ # Needed to run the example DAG with pytest (see: tests/system/README.md#run_via_pytest)
62
+ test_run = get_test_run(dag)
@@ -18,21 +18,13 @@
18
18
  from __future__ import annotations
19
19
 
20
20
  import datetime
21
+ import importlib.util
21
22
  import inspect
22
23
  from unittest import mock
23
24
  from unittest.mock import MagicMock
24
25
 
25
26
  import pytest
26
27
 
27
- try:
28
- import importlib.util
29
-
30
- if not importlib.util.find_spec("airflow.sdk.bases.hook"):
31
- raise ImportError
32
-
33
- BASEHOOK_PATCH_PATH = "airflow.sdk.bases.hook.BaseHook"
34
- except ImportError:
35
- BASEHOOK_PATCH_PATH = "airflow.hooks.base.BaseHook"
36
28
  from airflow import DAG
37
29
  from airflow.exceptions import AirflowProviderDeprecationWarning
38
30
  from airflow.models import Connection
@@ -60,8 +52,19 @@ from tests_common.test_utils.dag import sync_dag_to_db
60
52
  from tests_common.test_utils.db import clear_db_dag_bundles, clear_db_dags, clear_db_runs, clear_db_xcom
61
53
  from tests_common.test_utils.markers import skip_if_force_lowest_dependencies_marker
62
54
  from tests_common.test_utils.providers import get_provider_min_airflow_version
55
+ from tests_common.test_utils.taskinstance import TaskInstanceWrapper
63
56
  from tests_common.test_utils.version_compat import AIRFLOW_V_3_0_1, AIRFLOW_V_3_0_PLUS
64
57
 
58
+ try:
59
+ import importlib.util
60
+
61
+ if not importlib.util.find_spec("airflow.sdk.bases.hook"):
62
+ raise ImportError
63
+
64
+ BASEHOOK_PATCH_PATH = "airflow.sdk.bases.hook.BaseHook"
65
+ except ImportError:
66
+ BASEHOOK_PATCH_PATH = "airflow.hooks.base.BaseHook"
67
+
65
68
  if AIRFLOW_V_3_0_PLUS:
66
69
  from airflow.utils.types import DagRunTriggeredByType
67
70
 
@@ -1151,7 +1154,13 @@ class TestSqlBranch:
1151
1154
  )
1152
1155
 
1153
1156
  ti = dr.get_task_instance(task_id)
1154
- ti.task = self.dag.get_task(ti.task_id)
1157
+ task = self.dag.get_task(ti.task_id)
1158
+
1159
+ if AIRFLOW_V_3_0_PLUS:
1160
+ ti.task = self.scheduler_dag.get_task(ti.task_id)
1161
+ ti = TaskInstanceWrapper(ti, task)
1162
+ else:
1163
+ ti.task = task
1155
1164
 
1156
1165
  return ti
1157
1166