apache-airflow-providers-common-sql 1.13.0__py3-none-any.whl → 1.14.0__py3-none-any.whl

airflow/providers/common/sql/__init__.py

@@ -25,14 +25,11 @@ from __future__ import annotations
 
 import packaging.version
 
-__all__ = ["__version__"]
+from airflow import __version__ as airflow_version
 
-__version__ = "1.13.0"
+__all__ = ["__version__"]
 
-try:
-    from airflow import __version__ as airflow_version
-except ImportError:
-    from airflow.version import version as airflow_version
+__version__ = "1.14.0"
 
 if packaging.version.parse(packaging.version.parse(airflow_version).base_version) < packaging.version.parse(
     "2.7.0"

airflow/providers/common/sql/get_provider_info.py

@@ -28,8 +28,9 @@ def get_provider_info():
         "name": "Common SQL",
         "description": "`Common SQL Provider <https://en.wikipedia.org/wiki/SQL>`__\n",
         "state": "ready",
-        "source-date-epoch": 1714476113,
+        "source-date-epoch": 1716287213,
         "versions": [
+            "1.14.0",
             "1.13.0",
             "1.12.0",
             "1.11.1",

airflow/providers/common/sql/hooks/sql.py

@@ -185,14 +185,15 @@ class DbApiHook(BaseHook):
     def placeholder(self):
         conn = self.get_connection(getattr(self, self.conn_name_attr))
         placeholder = conn.extra_dejson.get("placeholder")
-        if placeholder in SQL_PLACEHOLDERS:
-            return placeholder
-        self.log.warning(
-            "Placeholder defined in Connection '%s' is not listed in 'DEFAULT_SQL_PLACEHOLDERS' "
-            "and got ignored. Falling back to the default placeholder '%s'.",
-            placeholder,
-            self._placeholder,
-        )
+        if placeholder:
+            if placeholder in SQL_PLACEHOLDERS:
+                return placeholder
+            self.log.warning(
+                "Placeholder defined in Connection '%s' is not listed in 'DEFAULT_SQL_PLACEHOLDERS' "
+                "and got ignored. Falling back to the default placeholder '%s'.",
+                self.conn_name_attr,
+                self._placeholder,
+            )
         return self._placeholder
 
     def get_conn(self):
@@ -578,13 +579,6 @@ class DbApiHook(BaseHook):
             chunks defined by the commit_every parameter. This only works if all rows
             have same number of column names, but leads to better performance.
         """
-        if executemany:
-            warnings.warn(
-                "executemany parameter is deprecated, override supports_executemany instead.",
-                AirflowProviderDeprecationWarning,
-                stacklevel=2,
-            )
-
         nb_rows = 0
         with self._create_autocommit_connection() as conn:
             conn.commit()

airflow/providers/common/sql/sensors/sql.py

@@ -16,16 +16,19 @@
 # under the License.
 from __future__ import annotations
 
-from typing import Any, Sequence
+from typing import TYPE_CHECKING, Any, Callable, Mapping, Sequence
 
 from airflow.exceptions import AirflowException, AirflowSkipException
 from airflow.hooks.base import BaseHook
 from airflow.providers.common.sql.hooks.sql import DbApiHook
 from airflow.sensors.base import BaseSensorOperator
 
+if TYPE_CHECKING:
+    from airflow.utils.context import Context
+
 
 class SqlSensor(BaseSensorOperator):
-    """Run a sql statement repeatedly until a criteria is met.
+    """Run a SQL statement repeatedly until a criteria is met.
 
     This will keep trying until success or failure criteria are met, or if the
     first cell is not either ``0``, ``'0'``, ``''``, or ``None``. Optional
@@ -39,37 +42,34 @@ class SqlSensor(BaseSensorOperator):
     in which case it will fail if no rows have been returned.
 
     :param conn_id: The connection to run the sensor against
-    :param sql: The sql to run. To pass, it needs to return at least one cell
+    :param sql: The SQL to run. To pass, it needs to return at least one cell
         that contains a non-zero / empty string value.
     :param parameters: The parameters to render the SQL query with (optional).
-    :param success: Success criteria for the sensor is a Callable that takes first_cell
+    :param success: Success criteria for the sensor is a Callable that takes the first_cell's value
         as the only argument, and returns a boolean (optional).
-    :param failure: Failure criteria for the sensor is a Callable that takes first_cell
-        as the only argument and return a boolean (optional).
+    :param failure: Failure criteria for the sensor is a Callable that takes the first_cell's value
+        as the only argument and returns a boolean (optional).
     :param fail_on_empty: Explicitly fail on no rows returned.
     :param hook_params: Extra config params to be passed to the underlying hook.
             Should match the desired hook constructor params.
     """
 
-    template_fields: Sequence[str] = ("sql", "hook_params")
-    template_ext: Sequence[str] = (
-        ".hql",
-        ".sql",
-    )
+    template_fields: Sequence[str] = ("sql", "hook_params", "parameters")
+    template_ext: Sequence[str] = (".hql", ".sql")
     ui_color = "#7c7287"
 
     def __init__(
         self,
         *,
-        conn_id,
-        sql,
-        parameters=None,
-        success=None,
-        failure=None,
-        fail_on_empty=False,
-        hook_params=None,
+        conn_id: str,
+        sql: str,
+        parameters: Mapping[str, Any] | None = None,
+        success: Callable[[Any], bool] | None = None,
+        failure: Callable[[Any], bool] | None = None,
+        fail_on_empty: bool = False,
+        hook_params: Mapping[str, Any] | None = None,
         **kwargs,
-    ):
+    ) -> None:
         self.conn_id = conn_id
         self.sql = sql
         self.parameters = parameters
@@ -79,7 +79,7 @@ class SqlSensor(BaseSensorOperator):
         self.hook_params = hook_params
         super().__init__(**kwargs)
 
-    def _get_hook(self):
+    def _get_hook(self) -> DbApiHook:
         conn = BaseHook.get_connection(self.conn_id)
         hook = conn.get_hook(hook_params=self.hook_params)
         if not isinstance(hook, DbApiHook):
@@ -89,7 +89,7 @@ class SqlSensor(BaseSensorOperator):
             )
         return hook
 
-    def poke(self, context: Any):
+    def poke(self, context: Context) -> bool:
         hook = self._get_hook()
 
         self.log.info("Poking: %s (with parameters %s)", self.sql, self.parameters)

airflow/providers/common/sql/sensors/sql.pyi

@@ -39,7 +39,8 @@ from airflow.exceptions import (
 from airflow.hooks.base import BaseHook as BaseHook
 from airflow.providers.common.sql.hooks.sql import DbApiHook as DbApiHook
 from airflow.sensors.base import BaseSensorOperator as BaseSensorOperator
-from typing import Any, Sequence
+from airflow.utils.context import Context as Context
+from typing import Any, Callable, Mapping, Sequence
 
 class SqlSensor(BaseSensorOperator):
     template_fields: Sequence[str]
@@ -55,13 +56,13 @@ class SqlSensor(BaseSensorOperator):
     def __init__(
         self,
         *,
-        conn_id,
-        sql,
-        parameters: Incomplete | None = None,
-        success: Incomplete | None = None,
-        failure: Incomplete | None = None,
+        conn_id: str,
+        sql: str,
+        parameters: Mapping[str, Any] | None = None,
+        success: Callable[[Any], bool] | None = None,
+        failure: Callable[[Any], bool] | None = None,
         fail_on_empty: bool = False,
-        hook_params: Incomplete | None = None,
+        hook_params: Mapping[str, Any] | None = None,
         **kwargs,
     ) -> None: ...
-    def poke(self, context: Any): ...
+    def poke(self, context: Context) -> bool: ...

{apache_airflow_providers_common_sql-1.13.0.dist-info → apache_airflow_providers_common_sql-1.14.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: apache-airflow-providers-common-sql
-Version: 1.13.0
+Version: 1.14.0
 Summary: Provider package apache-airflow-providers-common-sql for Apache Airflow
 Keywords: airflow-provider,common.sql,airflow,integration
 Author-email: Apache Software Foundation <dev@airflow.apache.org>
@@ -27,8 +27,8 @@ Requires-Dist: sqlparse>=0.4.2
 Requires-Dist: apache-airflow-providers-openlineage ; extra == "openlineage"
 Requires-Dist: pandas>=1.2.5,<2.2 ; extra == "pandas"
 Project-URL: Bug Tracker, https://github.com/apache/airflow/issues
-Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.13.0/changelog.html
-Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.13.0
+Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.14.0/changelog.html
+Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.14.0
 Project-URL: Slack Chat, https://s.apache.org/airflow-slack
 Project-URL: Source Code, https://github.com/apache/airflow
 Project-URL: Twitter, https://twitter.com/ApacheAirflow
@@ -80,7 +80,7 @@ Provides-Extra: pandas
 
 Package ``apache-airflow-providers-common-sql``
 
-Release: ``1.13.0``
+Release: ``1.14.0``
 
 
 `Common SQL Provider <https://en.wikipedia.org/wiki/SQL>`__
@@ -93,7 +93,7 @@ This is a provider package for ``common.sql`` provider. All classes for this pro
 are in ``airflow.providers.common.sql`` python package.
 
 You can find package information and changelog for the provider
-in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.13.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.14.0/>`_.
 
 Installation
 ------------
@@ -135,4 +135,4 @@ Dependent package
 ==============================================================================================================  ===============
 
 The changelog for the provider package can be found in the
-`changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.13.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.14.0/changelog.html>`_.

{apache_airflow_providers_common_sql-1.13.0.dist-info → apache_airflow_providers_common_sql-1.14.0.dist-info}/RECORD

@@ -1,19 +1,19 @@
 airflow/providers/common/sql/LICENSE,sha256=ywUBpKZc7Jb96rVt5I3IDbg7dIJAbUSHkuoDcF3jbH4,13569
 airflow/providers/common/sql/README_API.md,sha256=CxhaS8EedZ4dcbLUPC4-GLCMaY3OH96oHxXttUGU06E,5932
-airflow/providers/common/sql/__init__.py,sha256=4rYZjNENBZoNjNv7RMVPssgnMxnlrnMMgvBWNOa6wd8,1586
-airflow/providers/common/sql/get_provider_info.py,sha256=NxIIRHQakcE1UEaY4Tks8C0_3ovRxMXAyXR7DFUseDk,2996
+airflow/providers/common/sql/__init__.py,sha256=k0Ryh4awxoZH0cPucAClfGxISsmhjTBWgUEN2SFSy-k,1498
+airflow/providers/common/sql/get_provider_info.py,sha256=xQaoDaRU_bu3uDKwh3OXT_lyXVjuHmnOlvDdDlkCXP8,3018
 airflow/providers/common/sql/doc/adr/0001-record-architecture-decisions.md,sha256=TfANqrzoFto9PMOMza3MitIkXHGLx2kY_BhhF-N0_ow,1675
 airflow/providers/common/sql/doc/adr/0002-return-common-data-structure-from-dbapihook-derived-hooks.md,sha256=ze5w9IVS-HkUwdZvPW8_JaJaVwel7-N6XdEVN4pTuCE,8457
 airflow/providers/common/sql/hooks/__init__.py,sha256=9hdXHABrVpkbpjZgUft39kOFL2xSGeG4GEua0Hmelus,785
-airflow/providers/common/sql/hooks/sql.py,sha256=Yp3xs08lMq8s7KVUXvNOyT5XiIFYDbki1mUcyZGijKQ,29781
+airflow/providers/common/sql/hooks/sql.py,sha256=x-jW6oSmCWU5RS3Ev9Hnau7M884KEUdaoXIKAlXHWKQ,29603
 airflow/providers/common/sql/hooks/sql.pyi,sha256=iwsV-yalhYz5aBdPqaNl1x0YYYqjP75N18moKXbVYQU,5570
 airflow/providers/common/sql/operators/__init__.py,sha256=9hdXHABrVpkbpjZgUft39kOFL2xSGeG4GEua0Hmelus,785
 airflow/providers/common/sql/operators/sql.py,sha256=QuM-Dqsg1ytyYl26_-pN-cKuIQEAiwvmDpbcAemLFnI,48231
 airflow/providers/common/sql/operators/sql.pyi,sha256=f66uuQmDvj6rsX36tGTbEpm6zK3R4Opmy5i6OmdSI7w,8554
 airflow/providers/common/sql/sensors/__init__.py,sha256=9hdXHABrVpkbpjZgUft39kOFL2xSGeG4GEua0Hmelus,785
-airflow/providers/common/sql/sensors/sql.py,sha256=t4RiXUZGrr_FgcRo5QV-rIwNgo7qNuyafqP-GzWJuFY,5683
-airflow/providers/common/sql/sensors/sql.pyi,sha256=4tj_m6r4ropcZYKokcVeHf4lx5fZFLExlj7QBKjfo8o,2576
-apache_airflow_providers_common_sql-1.13.0.dist-info/entry_points.txt,sha256=h8UXRp2crPuGmYVYRM5oe168qIh7g-4t2QQbVMizKjI,106
-apache_airflow_providers_common_sql-1.13.0.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
-apache_airflow_providers_common_sql-1.13.0.dist-info/METADATA,sha256=_r9Y-ot1X90bvoODAklmtJFUVUxvfls-jfa3syRsMA0,6108
-apache_airflow_providers_common_sql-1.13.0.dist-info/RECORD,,
+airflow/providers/common/sql/sensors/sql.py,sha256=yy8prgci9YPM8rgK8RCjtYxvInb-DxiZaFCucMnTJUg,5969
+airflow/providers/common/sql/sensors/sql.pyi,sha256=hDt9OeV5SHpz4s8yHhohrEUzNuKBgT4IHOU5b9rQnKo,2706
+apache_airflow_providers_common_sql-1.14.0.dist-info/entry_points.txt,sha256=h8UXRp2crPuGmYVYRM5oe168qIh7g-4t2QQbVMizKjI,106
+apache_airflow_providers_common_sql-1.14.0.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+apache_airflow_providers_common_sql-1.14.0.dist-info/METADATA,sha256=5wbiaVM87g6LRfJtbGedL-xGulRELFaEGWF1G8hN3Tc,6108
+apache_airflow_providers_common_sql-1.14.0.dist-info/RECORD,,