[SPARK-42924] Clarify the comment of parameterized SQL args

• Type: Documentation
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.4.0
• Fix Version/s: 3.4.0
• Component/s: SQL
• Assignee: Max Gekk
• Reporter: Max Gekk
• Created: 26/Mar/23 12:38
• Updated: 27/Mar/23 05:54
• Resolved: 27/Mar/23 05:54

Description

Make the comment more clear and highlight that input strings are parsed (not evaluated), and considered as SQL literal expressions. Also while parsing the fragments w/ SQL comments in the string values are skipped.

Issue Links

• relates to: SPARK-41271 Parameterized SQL