ENH: Adding hint to to_sql

[mpak123]

This PR adds a new hints parameter to DataFrame.to_sql() and Series.to_sql() that allows users to pass database-specific query hints to optimize INSERT performance. The parameter accepts a dictionary mapping dialect names (e.g., 'oracle', 'mysql', 'postgresql') to complete hint strings (e.g., {'oracle': '/*+ APPEND PARALLEL(4) */', 'mysql': 'DELAYED'}). Users have full control over hint formatting as pandas passes the strings as-is without modification. SQLite raises a UserWarning since hints aren't supported, and ADBC connections raise NotImplementedError. Includes comprehensive tests and documentation updates.

• closes ENH: Adding hint to to_sql #61370 (Replace xxxx with the GitHub issue number)
• Tests added and passed if fixing a bug or adding a new feature
• All code checks passed.
• Added type annotations to new arguments/methods/functions.
• Added an entry in the latest doc/source/whatsnew/vX.X.X.rst file if fixing a bug or adding a new feature.

[mpak123]

Pyodide CI job failures seem to be unrelated to the code changes made.

[mroeschke]

Thanks for the pull request. Since the parameter is highly specific to Oracle databases, I am a little hesitant to add a new keyword since to_sql should be general to all databases.

[mpak123]

Thanks for the pull request. Since the parameter is highly specific to Oracle databases, I am a little hesitant to add a new keyword since to_sql should be general to all databases.

@mroeschke I tried to make the implementation as general as possible for as many different databases that support hints. Would you suggest for now to create a new function users could use specifically for oracle databases?

[WillAyd]

@mpak123 does SQLAlchemy offer any built-in functionality to handle this? We do try to keep our implementation very "database agnostic," instead deferring to third party libraries that specialize further into the database world.