[integration spec] Update docs/integration-index.md

[chernser]

Summary

• Added information about release and upgrades
• Updates table for choosing library. Added hybrid case when both API can be used.

No unresolved comments left from https://github.com/ClickHouse/clickhouse-java/pull/2914/changes#diff-7aebad82453fb90dbfb9423402810122f9328c9fd647fcbab4941c316d4baf8d

Checklist

Delete items not relevant to your PR:

• Closes #
• 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