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

[tammy-baylis-swi]

Description

Supports new, optional kwarg enable_attribute_commenter at DB-API integration to opt into db.statement span attribute inclusion of sqlcomment.

Partially addresses #3107

Is required to update driver-level instrumentors like psycopg2, mysqlclient, etc in this PR: #3121

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, for instrumentation of any of psycopg2, psycopg, mysqlclient, PyMySQL. Those instrumentors will be updated in this PR: #3121

• 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-dbapi

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 <-- I updated the docs of the 'concrete' db instrumentor PRs as part of DB drivers: db.statement inclusion of sqlcomment as opt-in #3121

[xrmx]

@alexmojaki PTAL

[alexmojaki]

LGTM, thanks!