fix dbapi executemany insert routing

[joe-clickhouse]

Summary

• Preserve SQL semantics for parameterized DB-API executemany() inserts
• Retain Native bulk inserts for safe bare-VALUES and compiled SQLAlchemy paths
• Fail closed when Native routing can't be proven safe
• Fix expressions, bind reuse, quoted identifiers, bind_expression() types, and joined-table inheritance

Closes #930
Closes #932
Closes #934

Checklist

Delete items not relevant to your PR:

• Unit and integration tests covering the common scenarios were added
• A human-readable description of the changes was provided to include in CHANGELOG
• For significant changes, documentation in https://github.com/ClickHouse/clickhouse-docs was updated with further explanations or tutorials

[workflow-authentication-public]

Docs drift check: resolved, docs now match this PR's changes.

[Copilot]

Pull request overview

Fixes DB-API executemany() routing while retaining safe Native insert paths.

Changes:

• Preserves SQL semantics for parameterized inserts.
• Adds validated Native plans for bare VALUES and SQLAlchemy inserts.
• Updates row counts, tests, documentation, and changelog.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
clickhouse_connect/dbapi/cursor.py	Implements routing, validation, and row counting.
clickhouse_connect/cc_sqlalchemy/dialect.py	Builds safe SQLAlchemy Native insert plans.
tests/unit_tests/test_driver/test_cursor.py	Tests DB-API routing and results.
tests/unit_tests/test_sqlalchemy/test_native_insert.py	Tests SQLAlchemy Native planning.
tests/unit_tests/test_sqlalchemy/test_query_settings.py	Updates settings coverage.
tests/integration_tests/test_dbapi.py	Adds DB-API regressions.
tests/integration_tests/test_sqlalchemy/test_inserts.py	Adds SQLAlchemy integration coverage.
docs/driver-api.mdx	Documents DB-API behavior.
docs/sqlalchemy.mdx	Documents SQLAlchemy routing.
CHANGELOG.md	Records the user-facing fix.

---

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.