.. change::
- :tags: engine, postgresql, usecase
+ :tags: postgresql, usecase
:tickets: 4392
- A :class:`.URL` connection now supports multiple hosts for PostgreSQL. Any
- query that contains multiple hosts will now group the hosts as a string
- instead of a tuple of strings. Pull request courtesy Ramon Williams.
+ The psycopg2 dialect now support PostgreSQL multiple host connections, by
+ passing host/port combinations to the query string. Pull request courtesy
+ Ramon Williams.
+
+ .. seealso::
+
+ :ref:`psycopg2_multi_host`
\ No newline at end of file
:tags: mysql, usecase
:tickets: 5462
- Adjusted the :meth:`MySQLDDLCompiler.visit_create_index` to implement
- indexing with expressions and functions on the MySQL dialect as accepted by
- MySQL 8. Pull request courtesy Ramon Williams.
+ Adjusted the MySQL dialect to correctly parenthesize functional index
+ expressions as accepted by MySQL 8. Pull request courtesy Ramon Williams.
:tags: change, mysql
:tickets: 5539
- Add new MySQL reserved words: `cube`, `lateral`.
-
- Reference https://dev.mysql.com/doc/refman/8.0/en/keywords.html :
-
- * CUBE (R); became reserved in 8.0.1
- * LATERAL (R); added in 8.0.14 (reserved)
+ Add new MySQL reserved words: ``cube``, ``lateral`` added in MySQL 8.0.1
+ and 8.0.14, respectively; this indicates that these terms will be quoted if
+ used as table or column identifier names.
:tags: bug, ext, associationproxy
:tickets: 5541, 5542
- It's not possible right now to use an association proxy element as a plain
- column expression to be SELECTed from or used in a SQL function. An
- informative error is now raised when this occurs.
+ An informative error is now raised when attempting to use an association
+ proxy element as a plain column expression to be SELECTed from or used in a
+ SQL function; this use case is not currently supported.
:tags: bug, pool
:tickets: 5582
- The following pool parameters were not being propagated to the new pool
- created when :meth:`_engine.Engine.dispose` were called: ``pre_ping``,
- ``use_lifo``. Additionally the ``recycle`` and ``reset_on_return``
- parameters were not propagated for the :class:`_engine.AssertionPool`
- class. These issues have been fixed.
+ Fixed issue where the following pool parameters were not being propagated
+ to the new pool created when :meth:`_engine.Engine.dispose` were called:
+ ``pre_ping``, ``use_lifo``. Additionally the ``recycle`` and
+ ``reset_on_return`` parameter is now propagated for the
+ :class:`_engine.AssertionPool` class.
:tags: bug, sql
:tickets: 5618
- Fixed bug where an error was not raised for lower-case :func:`_sql.column`
- added to lower-case :func:`_sql.table` object. This now raises
- :class:`_exc.ArgumentError` which has always been the case for upper-case
- :class:`_schema.Column` and :class:`_schema.Table`.
\ No newline at end of file
+ Fixed bug where an error was not raised in the case where a
+ :func:`_sql.column` were added to more than one :func:`_sql.table` at a
+ time. This raised correctly for the :class:`_schema.Column` and
+ :class:`_schema.Table` objects. An :class:`_exc.ArgumentError` is now
+ raised when this occurs.
\ No newline at end of file
:tags: bug, tests
:tickets: 5635
- Fixed incompatibilities in the test suite that prevented the tests from
- working with Pytest 6.x.
+ Fixed incompatibilities in the test suite when running against Pytest 6.x.
:tags: bug, sql
:tickets: 5644
- Fixed issue where a plain pickle dumps call of the :class:`_sql.Over`
- construct didn't work.
+ Fixed issue where the ``pickle.dumps()`` operation against
+ :class:`_expression.Over` construct would produce a recursion overflow.
`PQconnectdbParams \
<http://www.postgresql.org/docs/9.1/static/libpq-connect.html#LIBPQ-PQCONNECTDBPARAMS>`_
-Multiple Hosts in Connection String
+.. _psycopg2_multi_host:
+
+Specfiying mutiple fallback hosts
------------------------------------
psycopg2 supports multiple connection points in the connection string.