feat!: Dedicated SQLInterface and SQLSyntax errors

[alexander-beedie]

As previously discussed, this implements dedicated SQL-specific errors.
(Currently it's a mix of ComputeError and InvalidOperation).

New errors:

• SQLSyntaxError: otherwise-supported syntax that was used incorrectly (for example: incorrect number of parameters passed to a valid SQL function).
• SQLInterfaceError: almost every other error that can come specifically from the SQL interface (unimplemented functions, references to unregistered tables, etc).

Also:

• Updates syntax errors such that they reference the actual SQL function name, not the internal parser Enum (eg: "ARRAY_TO_STRING" instead of "ArrayToString").

Examples

• Syntax errors:

  (function only expects 1-2 parameters)

  import polars as pl
  df = pl.DataFrame({"n": [5.55, -10.0, 66.999]})
  
  df.sql("SELECT ROUND(n,1,2,3) FROM self")
  # SQLSyntaxError:
  #  invalid number of arguments for ROUND; expected 1 or 2, found 4

  (incorrect parameter type)

  df.sql("SELECT ROUND(n,'aaaa') FROM self")
  # SQLSyntaxError:
  #  invalid 'n_decimals' for ROUND ('aaaa')

• Interface error:

  (syntax is fine, but no such table was registered)

  pl.sql("SELECT * FROM some_unknown_table")
  # SQLInterfaceError:
  #  relation 'some_unknown_table' was not found

[codecov]

Codecov Report

Attention: Patch coverage is 43.47826% with 91 lines in your changes are missing coverage. Please review.

Project coverage is 81.51%. Comparing base (5974ac7) to head (4c636e3).
Report is 5 commits behind head on main.

Files	Patch %	Lines
crates/polars-sql/src/sql_expr.rs	35.93%	41 Missing ⚠️
crates/polars-sql/src/functions.rs	43.18%	25 Missing ⚠️
crates/polars-sql/src/context.rs	42.85%	20 Missing ⚠️
crates/polars-sql/src/table_functions.rs	57.14%	3 Missing ⚠️
crates/polars-error/src/lib.rs	0.00%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #16635      +/-   ##
==========================================
- Coverage   81.51%   81.51%   -0.01%     
==========================================
  Files        1414     1414              
  Lines      185995   186010      +15     
  Branches     3026     3026              
==========================================
+ Hits       151608   151620      +12     
- Misses      33856    33859       +3     
  Partials      531      531              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[ritchie46]

Nice, I will wait until we can move the breaking PR's.