diff --git a/user_guide_src/source/database/metadata.rst b/user_guide_src/source/database/metadata.rst
index 1845a0440b7a..2de5abc0e063 100644
--- a/user_guide_src/source/database/metadata.rst
+++ b/user_guide_src/source/database/metadata.rst
@@ -94,11 +94,6 @@ Usage example:
 
 .. literalinclude:: metadata/006.php
 
-If you have run a query already you can use the result object instead of
-supplying the table name:
-
-.. literalinclude:: metadata/007.php
-
 The following data is available from this function if supported by your
 database:
 
@@ -111,6 +106,17 @@ database:
 
 .. note:: Since v4.4.0, SQLSRV supported ``nullable``.
 
+$query->getFieldData()
+----------------------
+
+If you have run a query already you can use the result object instead of
+supplying the table name:
+
+.. literalinclude:: metadata/007.php
+
+.. note:: The data returned is different from the data from ``$db->getFieldData()``.
+    If you cannot get the data you need, use ``$db->getFieldData()``.
+
 List the Indexes in a Table
 ===========================