Driver: Add page about ODBC

[amotl]

About

What the title says.

Preview

https://cratedb-guide--411.org.readthedocs.build/connect/odbc/

[coderabbitai]

Walkthrough

Adds comprehensive ODBC documentation to the Connect guide: inserts an ODBC driver card and odbc/index into drivers, removes the [ODBC] link from shared links, adds an isql subsection to CLI docs, and introduces new ODBC pages (install, configure, and language-specific examples).

Changes

Cohort / File(s)	Summary
Index & toctree docs/connect/index.md	Inserted ODBC driver grid-card markup and added odbc/index to the Drivers by language toctree.
Links include docs/_include/links.md	Removed the [ODBC] external link reference from the shared links include.
ODBC landing & overview docs/connect/odbc/index.md	New ODBC landing page with setup widget, DSN/driver guidance, and multi-language connectivity examples.
Install & configuration docs/connect/odbc/install.md, docs/connect/odbc/configure.md, docs/connect/odbc/install-dropdown.md	New cross‑OS installation instructions, driver registration/odbcinst examples, DSN and DSN‑less connection examples, and an install dropdown include.
Language examples docs/connect/odbc/csharp.md, docs/connect/odbc/python.md, docs/connect/odbc/erlang.md, docs/connect/odbc/visualbasic.md	New language-specific guides with sample connection strings, queries, result handling, and teardown for C#, Python (pyodbc/turbodbc), Erlang, and Visual Basic.
Links & resources docs/connect/odbc/links.md	New link reference definitions and front matter for ODBC resources (orphan: true).
CLI additions docs/connect/application.md	Added isql subsection describing unixODBC usage with tabbed examples for CrateDB Cloud and localhost.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

• Check consistency of connection strings, DSN examples, and SSL/Cloud placeholders across pages.
• Verify OS package names, installation commands, and odbcinst snippets in install.md.
• Confirm removal of [ODBC] in docs/_include/links.md does not break references or toctree entries.

Possibly related PRs

• Chore: Improve UI responsiveness, specifically for smaller screen sizes #426 — Modifies drivers grid styling/layout; related because this PR inserts an ODBC grid-card into that layout.
• Navigation: Relocate reference links in learning path sections #379 — Overlaps edits to docs/_include/links.md and docs/connect/index.md (ODBC link/card changes).
• Drivers: Fix broken links. Improve wording. #338 — Also updates the drivers/connect index that this PR augments with an ODBC entry.

Suggested labels

cross linking, guidance

Suggested reviewers

• kneth
• bmunkholm
• seut

Poem

🐇 I hopped through pages, left an ODBC card bright,
Install tabs and snippets, tucked in just right.
From isql to Python and C#’s small cheer,
I scattered examples and hopped out of here —
A carrot of docs, crunchy and light. 🥕

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	You can run @coderabbitai generate docstrings to improve docstring coverage.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title Check	✅ Passed	The PR title "Driver: Add page about ODBC" accurately reflects the primary change in this pull request. The changeset adds comprehensive ODBC driver documentation including an index page, installation and configuration guides, language-specific examples (C#, Erlang, Python, Visual Basic), and CLI integration documentation. The title is concise, specific, and clearly communicates the main addition to a developer reviewing the git history. It does not use vague terms or misleading descriptions.
Description Check	✅ Passed	The PR description is minimal but directly related to the changeset. It confirms the addition of ODBC documentation and provides a preview link to the generated documentation. While the description lacks extensive detail, the evaluation criteria specify that level of detail is not important and the check should pass as long as the description is related in some way to the changeset. The description is not off-topic or misleading.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch odbc

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 53c46e4 and a22281d.

📒 Files selected for processing (1)

• docs/connect/odbc/csharp.md (1 hunks)

🧰 Additional context used

🪛 markdownlint-cli2 (0.18.1)

docs/connect/odbc/csharp.md

3-3: No space inside hashes on closed atx style heading

(MD020, no-missing-space-closed-atx)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)

• GitHub Check: Build docs

🔇 Additional comments (5)

docs/connect/odbc/csharp.md (5)

1-10: Documentation structure and content look good.

The page clearly explains the ODBC .NET Data Provider and links to the appropriate Microsoft documentation. The modular include approach for installation instructions is sound.

---

22-36: Verify System.Data.Odbc version constraint.

The csproj uses Version="9.*" for System.Data.Odbc. Please verify this version range aligns with your current documentation guidance and the minimum supported .NET versions. Consider adding a note about .NET version compatibility if needed.

---

38-57: C# code example is well-structured and follows best practices.

The example correctly demonstrates:

• Proper use of ODBC classes (OdbcConnection, OdbcCommand, OdbcDataReader)
• Correct using statements for resource cleanup
• Appropriate query execution and result reading pattern

---

64-65: Verify the included file exists and is appropriate.

The code references ../_cratedb.md via include. Ensure this shared file exists in the expected location and contains relevant CrateDB Cloud guidance.

---

71-79: CrateDB Cloud connection guidance is clear and complete.

The SSL/TLS configuration using Sslmode=require is correct and well-documented. Example connection string properly shows the required parameter substitutions.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[seut]

Thanks!

[matriv]

nice!