Skip to content

docs(mssql): data types, multi-statement queries, version differences and known issues - #3106

Merged
salevine merged 1 commit into
mainfrom
docs/app-16556-mssql-data-types
Nov 18, 2026
Merged

salevine merged 1 commit into
mainfrom
docs/app-16556-mssql-data-types

Conversation

@salevine

Copy link
Copy Markdown
Contributor

Description

Rewrites the Microsoft SQL Server reference page (connect-data/reference/querying-mssql.md). Linear: APP-16556.

Do not merge before Appsmith v2.8 is released. The page describes v2.8 behaviour that ships with appsmithorg/appsmith#42639, the SQL Server JDBC driver upgrade from 11.2 to 13.6. Each difference is marked "v2.8 and later" or "before v2.8".

What the page adds:

  • Supported servers: SQL Server 2019, 2022 and 2025, and Azure SQL. TLS 1.2 or later. The driver version for each Appsmith version.
  • Connection parameters: match the current form labels and defaults. When to use each SSL mode, and a faster failed "Test configuration" from v2.8.
  • Query examples: new examples for getting the new ID with OUTPUT, IN lists with STRING_SPLIT, and stored procedures with output parameters.
  • Prepared statements: how a bound value's type is detected, and the N'…' prefix when prepared statements are off.
  • Data types: how every SQL Server type comes back, with notes on date-times, large numbers, exponent-form decimals, spatial and hierarchy types, rowversion and time values.
  • Queries with several statements: only the first result is returned, how affectedRows is counted, error handling, and SET options that stay on pooled connections.
  • Differences between versions: a table of every behaviour that changed in v2.8.
  • Known issues before v2.8: with workarounds.
  • Troubleshooting: a table of common errors.

Every behaviour on the page was checked in the driver upgrade testing:

  • automated tests on SQL Server 2019, 2022 and 2025, run with both driver versions;
  • manual tests on Azure SQL.

The results are in the APP-16536 test plan.

🤖 Generated with Claude Code

… and known issues

Expands the SQL Server page with:

- supported servers and the driver version for each Appsmith version;
- how each data type comes back, with examples and workarounds;
- prepared statements, and how bound values are typed;
- queries with several statements, stored procedures and SET options;
- the differences between Appsmith before v2.8 and v2.8 and later;
- known issues before v2.8, with workarounds;
- a troubleshooting table.

The behaviour is from the driver upgrade testing for APP-16536.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
appsmith-docs Ready Ready Preview Nov 18, 2026 12:37am UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — bff35ad2 Deployed Nov 18, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant