feat(sqlalchemy): Support span streaming

[alexander-alderman-webb]

Description

Adapt add_query_source() analogously to changes to add_http_request_source() in #6084.

Add record_sql_queries_supporting_streaming() based on record_sql_queries() so that the streaming path is not triggered for other ORM integrations until they support the streaming trace lifecycle. Once the last ORM integration supports span-streaming the functions can be de-duplicated.

Set <unknown SQL query> as the name when the description was previously None.

Adapting Tests

sed commands used for converting transaction context managers:

• sed -i '' 's/start_transaction(name="test_transaction", sampled=True)/sentry_sdk.tracing.start_span(name="custom parent")/g'
• sed -i '' 's/start_transaction(name="test_transaction", sampled=True)/sentry_sdk.traces.start_span(name="custom parent")/g'
• sed -i '' 's/with start_transaction(name="foo")/sentry_sdk.traces.start_span(name="custom parent")/g'
• sed -i '' 's/start_transaction(name="foo")/sentry_sdk.traces.start_span(name="custom parent")/g'
• sed -i '' 's/start_transaction(name="test")/sentry_sdk.traces.start_span(name="custom parent")/g'

sed commands used for converting code source attributes:

• sed -i '' 's/CODE_LINENO/CODE_LINE_NUMBER/g'
• sed -i '' 's/CODE_FILEPATH/CODE_FILE_PATH/g'

sed commands used for converting event capture:

• sed -i '' 's/events = capture_events()/items = capture_items("event", "transaction", "span")/g'
• sed -i '' 's/capture_events,/capture_items,/g'
• sed -i '' 's/capture_events)/capture_items)/g'
• sed -i '' '/(event,) = events/d'

sed commands used for converting op:

• sed -i '' 's/- op/- sentry.op/g'
• sed -i '' 's/span.get("op")/span["attributes"].get("sentry.op")/g'

sed commands used for converting description:

• sed -i '' 's/span.get("description")/span["name"]/g'
• sed -i '' 's/description = spans[0]["description"]/name = spans[0]["name"]/g'
• sed -i '' 's/description/name/g'

sed commands used for converting data to attributes:

• sed -i '' 's/data = span.get("data", {})/attributes = span["attributes"]/g'
• sed -i '' 's/in data/in attributes/g'
• sed -i '' 's/data.get/attributes.get/g'
• sed -i '' 's/event["spans"]/spans/g'
• sed -i '' 's/span["data"]/span["attributes"]/g'

sed commands used for converting timestamps:

• sed -i '' 's/span.start_timestamp/span._start_timestamp/g'
• sed -i '' 's/span.timestamp/span._timestamp/g'

Issues

Reminders

• Please add tests to validate your changes, and lint your code using tox -e linters.
• Add GH Issue ID & Linear ID (if applicable)
• PR title should use conventional commit style (feat:, fix:, ref:, meta:)
• For external contributors: CONTRIBUTING.md, Sentry SDK development docs, Discord community

[github-actions]

Codecov Results 📊

✅ 2215 passed | ⏭️ 244 skipped | Total: 2459 | Pass Rate: 90.08% | Execution Time: 5m 51s

📊 Comparison with Base Branch

Metric	Change
Total Tests	—
Passed Tests	📈 +16
Failed Tests	—
Skipped Tests	📉 -16

✨ No test changes detected

All tests are passing successfully.

❌ Patch coverage is 9.84%. Project has 12704 uncovered lines.
❌ Project coverage is 41.16%. Comparing base (base) to head (head).

Files with missing lines (2)

File	Patch %	Lines
tracing_utils.py	76.81%	⚠️ 183 Missing and 52 partials
sqlalchemy.py	10.64%	⚠️ 84 Missing

Coverage diff

@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
- Coverage    41.19%    41.16%    -0.03%
==========================================
  Files          190       190         —
  Lines        21405     21592      +187
  Branches      7581      7210      -371
==========================================
+ Hits          8817      8888       +71
- Misses       12588     12704      +116
- Partials       479       451       -28

---

Generated by Codecov Action

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 98c67f0. Configure here.}

[sentrivana]

Looking great overall! Just not sure about a handful of attributes.

[sentrivana]

db.name was deprecated in favor of db.system.name, so we should use that in streaming mode

[sentrivana]

This should be db.namespace in streaming mode

[sentrivana]

Any reason not to adapt the existing record_sql_queries instead? Why a new func, if we still support both streaming and legacy mode in it?

[sentrivana]

We're setting these as attributes couple lines later, but none of them seems to be in conventions?

[sentrivana]

I believe this check should apply to both streaming and non streaming modes, so I'd move it outside of the isinstance branch