apache-airflow-providers-common-sql 1.21.0rc1__tar.gz → 1.23.0__tar.gz

{apache_airflow_providers_common_sql-1.21.0rc1 → apache_airflow_providers_common_sql-1.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: apache-airflow-providers-common-sql
-Version: 1.21.0rc1
+Version: 1.23.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>
@@ -20,15 +20,14 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: System :: Monitoring
-Requires-Dist: apache-airflow>=2.9.0rc0
-Requires-Dist: more-itertools>=9.0.0
+Requires-Dist: apache-airflow>=2.9.0
 Requires-Dist: sqlparse>=0.5.1
+Requires-Dist: more-itertools>=9.0.0
 Requires-Dist: apache-airflow-providers-openlineage ; extra == "openlineage"
-Requires-Dist: pandas>=2.1.2,<2.2 ; extra == "pandas" and (python_version>="3.9")
-Requires-Dist: pandas>=1.5.3,<2.2 ; extra == "pandas" and (python_version<"3.9")
+Requires-Dist: pandas>=2.1.2,<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.21.0/changelog.html
-Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.21.0
+Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.23.0/changelog.html
+Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.23.0
 Project-URL: Slack Chat, https://s.apache.org/airflow-slack
 Project-URL: Source Code, https://github.com/apache/airflow
 Project-URL: Twitter, https://x.com/ApacheAirflow
@@ -37,23 +36,6 @@ Provides-Extra: openlineage
 Provides-Extra: pandas
 
 
-.. Licensed to the Apache Software Foundation (ASF) under one
-   or more contributor license agreements.  See the NOTICE file
-   distributed with this work for additional information
-   regarding copyright ownership.  The ASF licenses this file
-   to you under the Apache License, Version 2.0 (the
-   "License"); you may not use this file except in compliance
-   with the License.  You may obtain a copy of the License at
-
-..   http://www.apache.org/licenses/LICENSE-2.0
-
-.. Unless required by applicable law or agreed to in writing,
-   software distributed under the License is distributed on an
-   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-   KIND, either express or implied.  See the License for the
-   specific language governing permissions and limitations
-   under the License.
-
  .. Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
     distributed with this work for additional information
@@ -71,8 +53,7 @@ Provides-Extra: pandas
     specific language governing permissions and limitations
     under the License.
 
- .. NOTE! THIS FILE IS AUTOMATICALLY GENERATED AND WILL BE
-    OVERWRITTEN WHEN PREPARING PACKAGES.
+ .. NOTE! THIS FILE IS AUTOMATICALLY GENERATED AND WILL BE OVERWRITTEN!
 
  .. IF YOU WANT TO MODIFY TEMPLATE FOR THIS FILE, YOU SHOULD MODIFY THE TEMPLATE
     `PROVIDER_README_TEMPLATE.rst.jinja2` IN the `dev/breeze/src/airflow_breeze/templates` DIRECTORY
@@ -80,7 +61,7 @@ Provides-Extra: pandas
 
 Package ``apache-airflow-providers-common-sql``
 
-Release: ``1.21.0.rc1``
+Release: ``1.23.0``
 
 
 `Common SQL Provider <https://en.wikipedia.org/wiki/SQL>`__
@@ -93,7 +74,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.21.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.23.0/>`_.
 
 Installation
 ------------
@@ -135,4 +116,5 @@ 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.21.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.23.0/changelog.html>`_.
+

{apache_airflow_providers_common_sql-1.21.0rc1 → apache_airflow_providers_common_sql-1.23.0}/README.rst

@@ -1,21 +1,4 @@
 
-.. Licensed to the Apache Software Foundation (ASF) under one
-   or more contributor license agreements.  See the NOTICE file
-   distributed with this work for additional information
-   regarding copyright ownership.  The ASF licenses this file
-   to you under the Apache License, Version 2.0 (the
-   "License"); you may not use this file except in compliance
-   with the License.  You may obtain a copy of the License at
-
-..   http://www.apache.org/licenses/LICENSE-2.0
-
-.. Unless required by applicable law or agreed to in writing,
-   software distributed under the License is distributed on an
-   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-   KIND, either express or implied.  See the License for the
-   specific language governing permissions and limitations
-   under the License.
-
  .. Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
     distributed with this work for additional information
@@ -33,8 +16,7 @@
     specific language governing permissions and limitations
     under the License.
 
- .. NOTE! THIS FILE IS AUTOMATICALLY GENERATED AND WILL BE
-    OVERWRITTEN WHEN PREPARING PACKAGES.
+ .. NOTE! THIS FILE IS AUTOMATICALLY GENERATED AND WILL BE OVERWRITTEN!
 
  .. IF YOU WANT TO MODIFY TEMPLATE FOR THIS FILE, YOU SHOULD MODIFY THE TEMPLATE
     `PROVIDER_README_TEMPLATE.rst.jinja2` IN the `dev/breeze/src/airflow_breeze/templates` DIRECTORY
@@ -42,7 +24,7 @@
 
 Package ``apache-airflow-providers-common-sql``
 
-Release: ``1.21.0.rc1``
+Release: ``1.23.0``
 
 
 `Common SQL Provider <https://en.wikipedia.org/wiki/SQL>`__
@@ -55,7 +37,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.21.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.23.0/>`_.
 
 Installation
 ------------
@@ -97,4 +79,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.21.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.23.0/changelog.html>`_.

{apache_airflow_providers_common_sql-1.21.0rc1 → apache_airflow_providers_common_sql-1.23.0}/pyproject.toml

@@ -1,4 +1,3 @@
-
 # Licensed to the Apache Software Foundation (ASF) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -16,10 +15,9 @@
 # specific language governing permissions and limitations
 # under the License.
 
-# NOTE! THIS FILE IS AUTOMATICALLY GENERATED AND WILL BE
-# OVERWRITTEN WHEN PREPARING PACKAGES.
+# NOTE! THIS FILE IS AUTOMATICALLY GENERATED AND WILL BE OVERWRITTEN!
 
-# IF YOU WANT TO MODIFY THIS FILE, YOU SHOULD MODIFY THE TEMPLATE
+# IF YOU WANT TO MODIFY THIS FILE EXCEPT DEPENDENCIES, YOU SHOULD MODIFY THE TEMPLATE
 # `pyproject_TEMPLATE.toml.jinja2` IN the `dev/breeze/src/airflow_breeze/templates` DIRECTORY
 [build-system]
 requires = ["flit_core==3.10.1"]
@@ -27,7 +25,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "apache-airflow-providers-common-sql"
-version = "1.21.0.rc1"
+version = "1.23.0"
 description = "Provider package apache-airflow-providers-common-sql for Apache Airflow"
 readme = "README.rst"
 authors = [
@@ -53,15 +51,32 @@ classifiers = [
     "Topic :: System :: Monitoring",
 ]
 requires-python = "~=3.9"
+
+# The dependencies should be modified in place in the generated file
+# Any change in the dependencies is preserved when the file is regenerated
 dependencies = [
-    "apache-airflow>=2.9.0rc0",
-    "more-itertools>=9.0.0",
+    "apache-airflow>=2.9.0",
     "sqlparse>=0.5.1",
+    "more-itertools>=9.0.0",
+]
+
+# The optional dependencies should be modified in place in the generated file
+# Any change in the dependencies is preserved when the file is regenerated
+[project.optional-dependencies]
+"pandas" = [
+    # In pandas 2.2 minimal version of the sqlalchemy is 2.0
+    # https://pandas.pydata.org/docs/whatsnew/v2.2.0.html#increased-minimum-versions-for-dependencies
+    # However Airflow not fully supports it yet: https://github.com/apache/airflow/issues/28723
+    # In addition FAB also limit sqlalchemy to < 2.0
+    "pandas>=2.1.2,<2.2",
+]
+"openlineage" = [
+    "apache-airflow-providers-openlineage"
 ]
 
 [project.urls]
-"Documentation" = "https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.21.0"
-"Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.21.0/changelog.html"
+"Documentation" = "https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.23.0"
+"Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-common-sql/1.23.0/changelog.html"
 "Bug Tracker" = "https://github.com/apache/airflow/issues"
 "Source Code" = "https://github.com/apache/airflow"
 "Slack Chat" = "https://s.apache.org/airflow-slack"
@@ -70,14 +85,9 @@ dependencies = [
 
 [project.entry-points."apache_airflow_provider"]
 provider_info = "airflow.providers.common.sql.get_provider_info:get_provider_info"
-[project.optional-dependencies]
-"openlineage" = [
-    "apache-airflow-providers-openlineage",
-]
-"pandas" = [
-    "pandas>=2.1.2,<2.2;python_version>=\"3.9\"",
-    "pandas>=1.5.3,<2.2;python_version<\"3.9\"",
-]
 
 [tool.flit.module]
 name = "airflow.providers.common.sql"
+
+[tool.pytest.ini_options]
+ignore = "tests/system/"

{apache_airflow_providers_common_sql-1.21.0rc1 → apache_airflow_providers_common_sql-1.23.0/src}/airflow/providers/common/sql/LICENSE

@@ -199,55 +199,3 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-
-============================================================================
-   APACHE AIRFLOW SUBCOMPONENTS:
-
-   The Apache Airflow project contains subcomponents with separate copyright
-   notices and license terms. Your use of the source code for the these
-   subcomponents is subject to the terms and conditions of the following
-   licenses.
-
-
-========================================================================
-Third party Apache 2.0 licenses
-========================================================================
-
-The following components are provided under the Apache 2.0 License.
-See project link for details. The text of each license is also included
-at 3rd-party-licenses/LICENSE-[project].txt.
-
-    (ALv2 License) hue v4.3.0 (https://github.com/cloudera/hue/)
-    (ALv2 License) jqclock v2.3.0 (https://github.com/JohnRDOrazio/jQuery-Clock-Plugin)
-    (ALv2 License) bootstrap3-typeahead v4.0.2 (https://github.com/bassjobsen/Bootstrap-3-Typeahead)
-    (ALv2 License) connexion v2.7.0 (https://github.com/zalando/connexion)
-
-========================================================================
-MIT licenses
-========================================================================
-
-The following components are provided under the MIT License. See project link for details.
-The text of each license is also included at 3rd-party-licenses/LICENSE-[project].txt.
-
-    (MIT License) jquery v3.5.1 (https://jquery.org/license/)
-    (MIT License) dagre-d3 v0.6.4 (https://github.com/cpettitt/dagre-d3)
-    (MIT License) bootstrap v3.4.1 (https://github.com/twbs/bootstrap/)
-    (MIT License) d3-tip v0.9.1 (https://github.com/Caged/d3-tip)
-    (MIT License) dataTables v1.10.25 (https://datatables.net)
-    (MIT License) normalize.css v3.0.2 (http://necolas.github.io/normalize.css/)
-    (MIT License) ElasticMock v1.3.2 (https://github.com/vrcmarcos/elasticmock)
-    (MIT License) MomentJS v2.24.0 (http://momentjs.com/)
-    (MIT License) eonasdan-bootstrap-datetimepicker v4.17.49 (https://github.com/eonasdan/bootstrap-datetimepicker/)
-
-========================================================================
-BSD 3-Clause licenses
-========================================================================
-The following components are provided under the BSD 3-Clause license. See project links for details.
-The text of each license is also included at 3rd-party-licenses/LICENSE-[project].txt.
-
-    (BSD 3 License) d3 v5.16.0 (https://d3js.org)
-    (BSD 3 License) d3-shape v2.1.0 (https://github.com/d3/d3-shape)
-    (BSD 3 License) cgroupspy 0.2.1 (https://github.com/cloudsigma/cgroupspy)
-
-========================================================================
-See 3rd-party-licenses/LICENSES-ui.txt for packages used in `/airflow/www`

{apache_airflow_providers_common_sql-1.21.0rc1 → apache_airflow_providers_common_sql-1.23.0/src}/airflow/providers/common/sql/__init__.py

@@ -29,7 +29,7 @@ from airflow import __version__ as airflow_version
 
 __all__ = ["__version__"]
 
-__version__ = "1.21.0"
+__version__ = "1.23.0"
 
 if packaging.version.parse(packaging.version.parse(airflow_version).base_version) < packaging.version.parse(
     "2.9.0"

apache_airflow_providers_common_sql-1.23.0/src/airflow/providers/common/sql/dialects/dialect.py

@@ -0,0 +1,211 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from __future__ import annotations
+
+import re
+from collections.abc import Iterable, Mapping
+from typing import TYPE_CHECKING, Any, Callable, TypeVar
+
+from methodtools import lru_cache
+
+from airflow.utils.log.logging_mixin import LoggingMixin
+
+if TYPE_CHECKING:
+    from sqlalchemy.engine import Inspector
+
+T = TypeVar("T")
+
+
+class Dialect(LoggingMixin):
+    """Generic dialect implementation."""
+
+    pattern = re.compile(r"[^\w]")
+
+    def __init__(self, hook, **kwargs) -> None:
+        super().__init__(**kwargs)
+
+        from airflow.providers.common.sql.hooks.sql import DbApiHook
+
+        if not isinstance(hook, DbApiHook):
+            raise TypeError(f"hook must be an instance of {DbApiHook.__class__.__name__}")
+
+        self.hook: DbApiHook = hook
+
+    @property
+    def placeholder(self) -> str:
+        return self.hook.placeholder
+
+    @property
+    def inspector(self) -> Inspector:
+        return self.hook.inspector
+
+    @property
+    def insert_statement_format(self) -> str:
+        return self.hook.insert_statement_format
+
+    @property
+    def replace_statement_format(self) -> str:
+        return self.hook.replace_statement_format
+
+    @property
+    def escape_word_format(self) -> str:
+        return self.hook.escape_word_format
+
+    @property
+    def escape_column_names(self) -> bool:
+        return self.hook.escape_column_names
+
+    def escape_word(self, word: str) -> str:
+        """
+        Escape the word if necessary.
+
+        If the word is a reserved word or contains special characters or if the ``escape_column_names``
+        property is set to True in connection extra field, then the given word will be escaped.
+
+        :param word: Name of the column
+        :return: The escaped word
+        """
+        if word != self.escape_word_format.format(self.unescape_word(word)) and (
+            self.escape_column_names or word.casefold() in self.reserved_words or self.pattern.search(word)
+        ):
+            return self.escape_word_format.format(word)
+        return word
+
+    def unescape_word(self, word: str | None) -> str | None:
+        """
+        Remove escape characters from each part of a dotted identifier (e.g., schema.table).
+
+        :param word: Escaped schema, table, or column name, potentially with multiple segments.
+        :return: The word without escaped characters.
+        """
+        if not word:
+            return word
+
+        escape_char_start = self.escape_word_format[0]
+        escape_char_end = self.escape_word_format[-1]
+
+        def unescape_part(part: str) -> str:
+            if part.startswith(escape_char_start) and part.endswith(escape_char_end):
+                return part[1:-1]
+            return part
+
+        return ".".join(map(unescape_part, word.split(".")))
+
+    @classmethod
+    def extract_schema_from_table(cls, table: str) -> tuple[str, str | None]:
+        parts = table.split(".")
+        return tuple(parts[::-1]) if len(parts) == 2 else (table, None)  # type: ignore[return-value]
+
+    @lru_cache(maxsize=None)
+    def get_column_names(
+        self, table: str, schema: str | None = None, predicate: Callable[[T], bool] = lambda column: True
+    ) -> list[str] | None:
+        if schema is None:
+            table, schema = self.extract_schema_from_table(table)
+        column_names = list(
+            column["name"]
+            for column in filter(
+                predicate,
+                self.inspector.get_columns(
+                    table_name=self.unescape_word(table),
+                    schema=self.unescape_word(schema) if schema else None,
+                ),
+            )
+        )
+        self.log.debug("Column names for table '%s': %s", table, column_names)
+        return column_names
+
+    @lru_cache(maxsize=None)
+    def get_target_fields(self, table: str, schema: str | None = None) -> list[str] | None:
+        target_fields = self.get_column_names(
+            table,
+            schema,
+            lambda column: not column.get("identity", False) and not column.get("autoincrement", False),
+        )
+        self.log.debug("Target fields for table '%s': %s", table, target_fields)
+        return target_fields
+
+    @lru_cache(maxsize=None)
+    def get_primary_keys(self, table: str, schema: str | None = None) -> list[str] | None:
+        if schema is None:
+            table, schema = self.extract_schema_from_table(table)
+        primary_keys = self.inspector.get_pk_constraint(
+            table_name=self.unescape_word(table),
+            schema=self.unescape_word(schema) if schema else None,
+        ).get("constrained_columns", [])
+        self.log.debug("Primary keys for table '%s': %s", table, primary_keys)
+        return primary_keys
+
+    def run(
+        self,
+        sql: str | Iterable[str],
+        autocommit: bool = False,
+        parameters: Iterable | Mapping[str, Any] | None = None,
+        handler: Callable[[Any], T] | None = None,
+        split_statements: bool = False,
+        return_last: bool = True,
+    ) -> tuple | list[tuple] | list[list[tuple] | tuple] | None:
+        return self.hook.run(sql, autocommit, parameters, handler, split_statements, return_last)
+
+    def get_records(
+        self,
+        sql: str | list[str],
+        parameters: Iterable | Mapping[str, Any] | None = None,
+    ) -> Any:
+        return self.hook.get_records(sql=sql, parameters=parameters)
+
+    @property
+    def reserved_words(self) -> set[str]:
+        return self.hook.reserved_words
+
+    def _joined_placeholders(self, values) -> str:
+        placeholders = [
+            self.placeholder,
+        ] * len(values)
+        return ",".join(placeholders)
+
+    def _joined_target_fields(self, target_fields) -> str:
+        if target_fields:
+            target_fields = ", ".join(map(self.escape_word, target_fields))
+            return f"({target_fields})"
+        return ""
+
+    def generate_insert_sql(self, table, values, target_fields, **kwargs) -> str:
+        """
+        Generate the INSERT SQL statement.
+
+        :param table: Name of the target table
+        :param values: The row to insert into the table
+        :param target_fields: The names of the columns to fill in the table
+        :return: The generated INSERT SQL statement
+        """
+        return self.insert_statement_format.format(
+            table, self._joined_target_fields(target_fields), self._joined_placeholders(values)
+        )
+
+    def generate_replace_sql(self, table, values, target_fields, **kwargs) -> str:
+        """
+        Generate the REPLACE SQL statement.
+
+        :param table: Name of the target table
+        :param values: The row to insert into the table
+        :param target_fields: The names of the columns to fill in the table
+        :return: The generated REPLACE SQL statement
+        """
+        return self.replace_statement_format.format(
+            table, self._joined_target_fields(target_fields), self._joined_placeholders(values)
+        )

apache_airflow_providers_common_sql-1.23.0/src/airflow/providers/common/sql/dialects/dialect.pyi

@@ -0,0 +1,82 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# This is automatically generated stub for the `common.sql` provider
+#
+# This file is generated automatically by the `update-common-sql-api stubs` pre-commit
+# and the .pyi file represents part of the "public" API that the
+# `common.sql` provider exposes to other providers.
+#
+# Any, potentially breaking change in the stubs will require deliberate manual action from the contributor
+# making a change to the `common.sql` provider. Those stubs are also used by MyPy automatically when checking
+# if only public API of the common.sql provider is used by all the other providers.
+#
+# You can read more in the README_API.md file
+#
+"""
+Definition of the public interface for airflow.providers.common.sql.src.airflow.providers.common.sql.dialects.dialect
+isort:skip_file
+"""
+
+from collections.abc import Iterable, Mapping
+from typing import Any, Callable, TypeVar
+
+from _typeshed import Incomplete as Incomplete
+from sqlalchemy.engine import Inspector as Inspector
+
+from airflow.utils.log.logging_mixin import LoggingMixin as LoggingMixin
+
+T = TypeVar("T")
+
+class Dialect(LoggingMixin):
+    hook: Incomplete
+    def __init__(self, hook, **kwargs) -> None: ...
+    def escape_word(self, column_name: str) -> str: ...
+    def unescape_word(self, value: str | None) -> str | None: ...
+    @property
+    def placeholder(self) -> str: ...
+    @property
+    def insert_statement_format(self) -> str: ...
+    @property
+    def replace_statement_format(self) -> str: ...
+    @property
+    def escape_word_format(self) -> str: ...
+    @property
+    def inspector(self) -> Inspector: ...
+    @classmethod
+    def extract_schema_from_table(cls, table: str) -> tuple[str, str | None]: ...
+    def get_column_names(
+        self, table: str, schema: str | None = None, predicate: Callable[[T], bool] = ...
+    ) -> list[str] | None: ...
+    def get_target_fields(self, table: str, schema: str | None = None) -> list[str] | None: ...
+    def get_primary_keys(self, table: str, schema: str | None = None) -> list[str] | None: ...
+    def run(
+        self,
+        sql: str | Iterable[str],
+        autocommit: bool = False,
+        parameters: Iterable | Mapping[str, Any] | None = None,
+        handler: Callable[[Any], T] | None = None,
+        split_statements: bool = False,
+        return_last: bool = True,
+    ) -> tuple | list[tuple] | list[list[tuple] | tuple] | None: ...
+    def get_records(
+        self, sql: str | list[str], parameters: Iterable | Mapping[str, Any] | None = None
+    ) -> Any: ...
+    @property
+    def reserved_words(self) -> set[str]: ...
+    def generate_insert_sql(self, table, values, target_fields, **kwargs) -> str: ...
+    def generate_replace_sql(self, table, values, target_fields, **kwargs) -> str: ...

apache_airflow_providers_common_sql-1.23.0/src/airflow/providers/common/sql/doc/adr/0003-introduce-notion-of-dialects-in-dbapihook.md

@@ -0,0 +1,61 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ -->
+
+# 3. Introduce notion of dialects in DbApiHook
+
+Date: 2025-01-07
+
+## Status
+
+Accepted
+
+## Context
+
+This ADR describes the proposition why we wanted to introduce dialects in the ``DBAPIHook`` as we experienced
+that the ``_insert_statement_format`` and ``_replace_statement_format`` string formatting properties used by the
+``insert_rows`` method in the ``DbApiHook`` where lacking in some cases as the number of parameters passed to the
+string format are hard-coded and aren't always sufficient when using different database through the
+generic JBDC and ODBC connection types.
+
+That's why we wanted a generic approach in which the code isn't tied to a specific database hook.
+
+For example when using MsSQL through ODBC instead of the native ``MsSqlHook``, you won't have the merge into
+(e.g. replace) functionality for MSSQL when using the ODBC connection type as that one was only available in
+the native ``MsSqlHook``.
+
+That's where the notion of dialects come into play and allow us to benefit of the same functionalities
+independently of which connection type you want to use (ODBC/JDBC or native if available) for a specific
+database.
+
+
+## Decision
+
+We decided the introduce the notion of dialects which allows us to implement database specific functionalities
+independently of the used connection type (e.g. hook).  That way when using for example the ``insert_rows`` method on
+the ``DbApiHook`` for as well ODBC as JDBC as native connection types, it will always be possible to use the replace
+into (e.g. merge into) functionality as that won't be tied to a specific implementation with a Hook an thus the
+connection type.
+
+
+## Consequences
+
+The consequence of this decision is that from now on database specific implementations should be done within the
+dialect for that database instead of the specialized hook, unless the connection type is tied to the hook,
+meaning that there is only one connection type possible and an ODBC/JDBC and in the future maybe even ADBC
+(e.g. Apache Arrow) isn't available.