diff --git a/core/lib/Drupal/Core/Database/Connection.php b/core/lib/Drupal/Core/Database/Connection.php
index 791bf7a..e9bd364 100644
--- a/core/lib/Drupal/Core/Database/Connection.php
+++ b/core/lib/Drupal/Core/Database/Connection.php
@@ -987,12 +987,17 @@ public function escapeAlias($field) {
    * a backslash. Use this to do a search for a verbatim string without any
    * wildcard behavior.
    *
+   * You must use a query builder like $connection->select() in order to use
+   * $connection->escapeLike() on all supported database systems. Using
+   * $connection->escapeLike() with $connection->query() or
+   * $connection->queryRange() is not supported.
+   *
    * For example, the following does a case-insensitive query for all rows whose
    * name starts with $prefix:
    * @code
-   * $result = db_query(
+   * $result = $connection->query(
    *   'SELECT * FROM person WHERE name LIKE :pattern',
-   *   array(':pattern' => db_like($prefix) . '%')
+   *   array(':pattern' => $connection->escapeLike($prefix) . '%')
    * );
    * @endcode
    *