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