Add PyMySQL instrumentor support for sqlcommenting

[tammy-baylis-swi]

Description

Updates PyMySQL instrumentor to support sqlcommenting.

Depends on # 2897

Fixes # 2902

Type of change

Please delete options that are not relevant.

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How Has This Been Tested?

Added unit tests. Used local installations of opentelemetry-instrumentation-dbapi (in ##2897) and upstream dependencies with this updated downstream instrumentor on a Flask app that use PyMySQL to query MySQL with general logs enabled to check sqlcomments.

Example general log entry after this update, which now includes sqlcomment:

2024-10-30T19:33:46.830661Z 25 Query SELECT * FROM city WHERE id = '1818' /*db_driver='pymysql%3A1.4.6',dbapi_level='2.0',dbapi_threadsafety=1,driver_paramstyle='pyformat',mysql_client_version='1.4.6',traceparent='00-f8688332bc5467bfa8fe1a9753d7271a-f7add29c81e79082-01'*/

Example corresponding exported span, whose span ID matches sqlcomment traceparent span ID:

InstrumentationScope opentelemetry.instrumentation.pymysql 0.49b0.dev
Span #0
    Trace ID       : f8688332bc5467bfa8fe1a9753d7271a
    Parent ID      : c125e4709cfe1361
    ID             : f7add29c81e79082
    Name           : SELECT
    Kind           : Client
    Start time     : 2024-10-30 19:33:46.829773588 +0000 UTC
    End time       : 2024-10-30 19:33:46.833294379 +0000 UTC
    Status code    : Unset
    Status message :
Attributes:
     -> db.system: Str(mysql)
     -> db.name: Str(world)
     -> db.statement: Str(SELECT * FROM city WHERE id = %s)
     -> db.user: Str(world)
     -> net.peer.name: Str(mysql-world-db)
     -> net.peer.port: Int(3306)

Does This PR Require a Core Repo Change?

• Yes. - Link to PR:
• 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

[tammy-baylis-swi]

Going to close this and put in a fresh PR later. There's more that I want to add.

[tammy-baylis-swi]

Re-opening this PR for review, when others have a moment please 😺

I researched how this instrumentation's support of sqlcommenting would affect prepared statements that PyMySQL driver might generate. The driver implementation seems to not support prepared statements (absence in docs here), so it seems to not be an issue.

[tammy-baylis-swi]

Working on revisions similar to #2941 at the moment. Will update when done and ready.

EDIT: This is done.