Show current SQL recursion limit in RecursionLimitExceeded error message

[kumarlokesh]

Which issue does this PR close?

• Closes Improve SQL parser recursion limit error message #15623.

Rationale for this change

What changes are included in this PR?

• Added recursion_limit (available through SQL parser options) field to DFParser
  struct to track the current recursion limit
• Updated error handling to include the current recursion limit value in error messages
• Ensured consistent error handling for recursion limit across different parsing scenarios:
  • COPY INTO statements
  • General statement parsing
  • Native and sqlparser-rs parser paths
• Updated error message format would be:
  SQL error: RecursionLimitExceeded (current limit: {recursion_limit})

Are these changes tested?

Are there any user-facing changes?

[kumarlokesh]

@comphead updated the PR after resolving merge conflicts.

[comphead]

thanks @kumarlokesh The code now looks much more aligned.

perhaps we can factor out

                        self.parser
                             .parse_statement()
                             .map(|stmt| Statement::Statement(Box::from(stmt)))
                             .map_err(|e| match e {
                                 ParserError::RecursionLimitExceeded => {
                                     DataFusionError::SQL(
                                         ParserError::RecursionLimitExceeded,
                                         Some(format!(
                                             " (current limit: {})",
                                             self.options.recursion_limit
                                         )),
                                     )
                                 }
                                 other => DataFusionError::SQL(other, None),
                             })

into helper method

But it can be done in followup PR

[xudong963]

thanks @kumarlokesh The code now looks much more aligned.

perhaps we can factor out

                        self.parser
                             .parse_statement()
                             .map(|stmt| Statement::Statement(Box::from(stmt)))
                             .map_err(|e| match e {
                                 ParserError::RecursionLimitExceeded => {
                                     DataFusionError::SQL(
                                         ParserError::RecursionLimitExceeded,
                                         Some(format!(
                                             " (current limit: {})",
                                             self.options.recursion_limit
                                         )),
                                     )
                                 }
                                 other => DataFusionError::SQL(other, None),
                             })

into helper method

But it can be done in followup PR

+1 for this to reduce duplicated code

[kumarlokesh]

thanks @kumarlokesh The code now looks much more aligned.
perhaps we can factor out

                        self.parser
                             .parse_statement()
                             .map(|stmt| Statement::Statement(Box::from(stmt)))
                             .map_err(|e| match e {
                                 ParserError::RecursionLimitExceeded => {
                                     DataFusionError::SQL(
                                         ParserError::RecursionLimitExceeded,
                                         Some(format!(
                                             " (current limit: {})",
                                             self.options.recursion_limit
                                         )),
                                     )
                                 }
                                 other => DataFusionError::SQL(other, None),
                             })

into helper method
But it can be done in followup PR

+1 for this to reduce duplicated code

@comphead @xudong963 addressed here dea5fe5.

[xudong963]

Thank you @kumarlokesh @comphead