[sfc-gh-yuwang]

Stacked on #4485 (SNOW-4432458, SQL error line mapping per session) and targets main: until #4484 and #4485 merge, the diff also contains their commits. This PR's own commits are the SNOW-4432455 ones.

Summary

• Registers dataframe_trace_on_error as a trace debug feature: session.debug.enable_dataframe_trace_on_error() (or set(dataframe_trace_on_error=True)) adds the lineage of a failed dataframe to the errors of that session.
• wrap_exception reads it from the session of the failed plan; is_tracing_enabled(session) reads only the session; tracing_flags_on() (the publicapi fast path, which has no session) checks the count of tracing sessions.
• configure_development_features now sets all three features in every active session and as the defaults of new ones. The context module keeps no debug flag: removes context._enable_dataframe_trace_on_error.
• CHANGELOG: adds dataframe_trace_on_error to the features of the Session.debug entry.

With this PR, session.debug.set(eager_schema_validation=True, dataframe_trace_on_error=True, trace_sql_errors_to_dataframe=True) or the per-feature session.debug.enable_<feature>() / disable_<feature>() configure one session, and configure_development_features(...) stays the shortcut for every session.

Test plan

• New test_lineage_trace_is_per_session: two sessions in one process; only the session with the feature on adds the lineage to the error.
• New unit test_tracing_flags_on_counts_the_tracing_sessions. The publicapi unit tests turn the trace on through a session instead of the global.
• Unit: no new failures compared with main.
• SFCTEST0, Python 3.11: SQL error, CTE, query line interval, test_df_trace_*.py, debug trace, context, session, eager validation and CTE suites: 921 passed, 1 skipped, 1 xpassed.
• Python 3.10: CTE, test_df_trace_*.py, debug trace, eager validation and context suites: 622 passed, 1 skipped.

Generated with Snowflake CoCo

[codecov-commenter]

Codecov Report

❌ Patch coverage is 85.71429% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 95.47%. Comparing base (aad22f1) to head (40c1fb5).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
...lake/snowpark/_internal/analyzer/snowflake_plan.py	71.42%	0 Missing and 4 partials ⚠️

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #4487   +/-   ##
=======================================
  Coverage   95.47%   95.47%           
=======================================
  Files         179      179           
  Lines       46927    46922    -5     
  Branches     8110     8106    -4     
=======================================
- Hits        44803    44800    -3     
+ Misses       1332     1331    -1     
+ Partials      792      791    -1     

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.