diff --git a/docs/dev/table_api.md b/docs/dev/table_api.md
index 8ca602d3a31e36bcf67f8d8c7d3054f3cfa5eedc..543945cf865e921b021e4ca5f336e36bfdf19628 100644
--- a/docs/dev/table_api.md
+++ b/docs/dev/table_api.md
@@ -1165,6 +1165,12 @@ groupItem:
 
 ```
 
+For a better definition of SQL queries within a Java String, Flink SQL uses a lexical policy similar to Java:
+
+- The case of identifiers is preserved whether or not they are quoted.
+- After which, identifiers are matched case-sensitively.
+- Unlike Java, back-ticks allow identifiers to contain non-alphanumeric characters (e.g. <code>"SELECT a AS `my field` FROM t"</code>).
+
 
 {% top %}