Fix #47555: PostgreSQL URI driver issue (#47709)

* Fix #47555: PostgreSQL URI scheme issue

* Fix: allow configuring PostgreSQL connection driver

Added support for customizing the PostgreSQL connection driver (`postgres` vs `postgresql`)
via the `postgres_driver` option in the extra JSON field.

* Fix #47555: PostgreSQL URI scheme issue

* Fix: allow configuring PostgreSQL connection driver

Added support for customizing the PostgreSQL connection driver (`postgres` vs `postgresql`)
via the `postgres_driver` option in the extra JSON field.

* Add the documentation for the 'designator' parameter in the PostgreSQL extras section

* Remove the code that constructs the URI based on connection type

* Update get_uri method docstring

* Clarify that get_uri() does not return a SQLAlchemy URI

* Fix rst-backticks

* Remove designer description

* Fix format code with ruff

---------

Co-authored-by: LIU ZHE YOU <68415893+jason810496@users.noreply.github.com>

Author: Dong-yeong0

airflow/models/connection.py

@@ -247,7 +247,13 @@ def _create_host(protocol, host) -> str | None:
         return host
 
     def get_uri(self) -> str:
-        """Return connection in URI format."""
+        """
+        Return the connection URI in Airflow format.
+
+        The Airflow URI format examples: https://airflow.apache.org/docs/apache-airflow/stable/howto/connection.html#uri-format-example
+
+        Note that the URI returned by this method is **not** SQLAlchemy-compatible, if you need a SQLAlchemy-compatible URI, use the :attr:`~airflow.providers.common.sql.hooks.sql.DbApiHook.sqlalchemy_url`
+        """
         if self.conn_type and "_" in self.conn_type:
             self.log.warning(
                 "Connection schemes (type: %s) shall not contain '_' according to RFC3986.",

docs/apache-airflow/howto/connection.rst

@@ -419,6 +419,10 @@ convenience method :py:meth:`~airflow.models.connection.Connection.get_uri`.  It
     >>> print(f"AIRFLOW_CONN_{c.conn_id.upper()}='{c.get_uri()}'")
     AIRFLOW_CONN_SOME_CONN='mysql://myname:mypassword@myhost.com?this_param=some+val&that_param=other+val%2A'
 
+.. note::
+
+   The ``get_uri()`` method return the connection URI in Airflow format, **not** a SQLAlchemy-compatible URI. if you need a SQLAlchemy-compatible URI for database connections, use :attr:`~airflow.providers.common.sql.hooks.sql.DbApiHook.sqlalchemy_url` property instead.
+
 Additionally, if you have created a connection, you can use ``airflow connections get`` command.
 
 .. code-block:: console