Add JDBC URL parameter for MySQL
Cherry-pick of
@@ -22,6 +22,23 @@ connection properties as appropriate for your setup:
connection-user=root
connection-password=secret
+The ``connection-url`` defines the connection information and parameters to pass
+to the MySQL JDBC driver. The supported parameters for the URL are
+available in the `MySQL Developer Guide
+<https://dev.mysql.com/doc/connector-j/8.0/en/>`_.
+
+For example, the following ``connection-url`` allows you to
+configure the JDBC driver to interpret time values based on UTC as a timezone on
+the server, and serves as a `workaround for a known issue
+<https://dev.mysql.com/doc/connector-j/8.0/en/connector-j-usagenotes-known-issues-limitations.html>`_.
+
+.. code-block:: text
+
+ connection-url=jdbc:mysql://example.net:3306?serverTimezone=UTC
+
+The ``connection-user`` and ``connection-password`` are typically required and
+determine the user credentials for the connection, often a service user.
+
Multiple MySQL Servers
^^^^^^^^^^^^^^^^^^^^^^
