Improve SQL syntax error messages in parser (#14437)

[khushishukla2813]

Which issue does this PR close?

Closes #14437

Rationale for this change

The current SQL syntax error messages in DataFusion lack detailed context, making debugging difficult for users.
This PR improves error reporting by:
Showing unexpected tokens in the error message.
Displaying exact line and column numbers for better debugging.
Providing helpful hints when possible.

What changes are included in this PR?

Enhanced parser_err! macro** to include token details, line, and column.
Modified expected function to return more precise error locations.
Added a test case (test_parser_error_message) to verify the improved error messages.

Are these changes tested?

Yes ✅

• A new test case was added in parser.rs to check:
  • Correct error message format.
  • Proper token identification in error messages.
  • Correct line and column output.

Are there any user-facing changes?

Yes ✅

• Error messages now provide clearer debugging information.
• No breaking changes to existing APIs.

[alamb]

Thanks @khushishukla2813 -- looks like this one needs some test changes. Marking as a draft for now while you work on the CI failures

[github-actions]

Thank you for your contribution. Unfortunately, this pull request is stale because it has been open 60 days with no activity. Please remove the stale label or comment or this will be closed in 7 days.