diff --git a/docs/src/main/sphinx/connector/oracle.rst b/docs/src/main/sphinx/connector/oracle.rst
index 6bb56facfb61..75cf8ae907a7 100644
--- a/docs/src/main/sphinx/connector/oracle.rst
+++ b/docs/src/main/sphinx/connector/oracle.rst
@@ -25,16 +25,20 @@ properties in the file:
 .. code-block:: text
 
     connector.name=oracle
-    # The exact format of the connection-url varies by Oracle version. Refer to
-    # the Oracle Database documentation for version-specific information on the
-    # JDBC Thin driver.
-    connection-url=jdbc:oracle:thin:@//example.net:1521/ORCLCDB
+    # The correct syntax of the connection-url varies by Oracle version and
+    # configuration. The following example URL connects to an Oracle SID named
+    # "orcl".
+    connection-url=jdbc:oracle:thin:@example.net:1521:orcl
     connection-user=root
     connection-password=secret
 
 The ``connection-url`` defines the connection information and parameters to pass
-to the Oracle JDBC Thin driver. See the `Oracle Database JDBC driver
-documentation <https://docs.oracle.com/cd/B28359_01/java.111/b31224/urls.htm#BEIDHCBA>`_
+to the JDBC driver. The Oracle connector uses the Oracle JDBC Thin driver,
+and the syntax of the URL may be different depending on your Oracle
+configuration. For example, the connection URL is different if you are
+connecting to an Oracle SID or an Oracle service name. See the `Oracle
+Database JDBC driver documentation
+<https://docs.oracle.com/en/database/oracle/oracle-database/21/jjdbc/data-sources-and-URLs.html#GUID-088B1600-C6C2-4F19-A020-2DAF8FE1F1C3>`_
 for more information.
 
 The ``connection-user`` and ``connection-password`` are typically required and