DB drivers: db.statement inclusion of sqlcomment as opt-in

[tammy-baylis-swi]

Description

Supports new, optional kwarg enable_attribute_commenter to opt into db.statement span attribute inclusion of sqlcomment for these db driver instrumentors:

• psycopg2 instrumentor
• psycopg instrumentor
• mysqlclient instrumentor
• PyMySQL instrumentor

Partially addresses #3107

Depends on approval and merge of #3115. Keeping this as draft for now.

Type of change

Breaking because db.statement span attribute inclusion of sqlcomment currently always happens if sqlcommenter enabled. It'll be opt-in with this update, so might break for those users relying on the feature introduced in 0.50b0.

• Breaking change (fix or feature that would cause existing functionality to not work as expected)

How Has This Been Tested?

• tox -e py312-test-instrumentation-psycopg2
• tox -e py312-test-instrumentation-psycopg
• tox -e py312-test-instrumentation-mysqlclient
• tox -e py312-test-instrumentation-pymysq;

Does This PR Require a Core Repo Change?

• No.

Checklist:

See contributing.md for styleguide, changelog guidelines, and more.

• Followed the style guidelines of this project
• Changelogs have been updated
• Unit tests have been added
• Documentation has been updated <-- docstrings will be updated after merge conflict resolution with Add docstring for instrument_connection() and tests for database drivers #3108