Skip to content

8.1.0-preview1 release notes - #5096

Draft
mdaigle wants to merge 5 commits into
mainfrom
dev/mdaigle/release-notes-108
Draft

mdaigle wants to merge 5 commits into
mainfrom
dev/mdaigle/release-notes-108

Conversation

@mdaigle

@mdaigle mdaigle commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

Description

Maintain release notes for milestone 8.1.0-preview1.
Verified source branch: main, commit 091d505c9a27ff88e1618273d8ce01b3701c057b.
src/Microsoft.Data.SqlClient/Versions.props declares SqlClientNextVersion=8.1.0-preview1, exactly matching this milestone.
This automation-managed documentation-only PR targets current main. Keep draft while the milestone is open; no release is published or milestone changed.

Latest reconciliation:

  • Document [Scheduled Run] Localized resource files from OneLocBuild #5120's nine additional authentication configuration, registration, and token messages in all 13 Abstractions satellite resource sets. Verified every new resource value against neutral Strings.resx: all nine remain English in every culture. Do not present this synchronization as newly translated diagnostics.
  • Update the Abstractions notes, core summary, and matching changelog. Remove the unsupported count of five previously translated messages. Preserve existing customer-facing content, contributor credits, five package/version indexes, companion links, and release formatting without invented dates.
  • Fix Managed CI Managed Identity User ID #5122 changes Managed Instance CI configuration only; it is not a customer-facing driver authentication fix and is excluded.
  • Preserve asynchronous Always Encrypted parameter-discovery key loading ([Async AE 1] Add async key cache #5077, [Async AE 2] Add async crypto utilities #5079, [Async AE 3] Load keys asynchronously during parameter discovery #5080), synchronous-provider fallback, cancellation, per-key cache load gates, and the thread-safety requirement for custom providers. Key operations are awaited inline; no deferred-key queue is claimed. Remaining synchronous cache/result/bulk-copy/enclave-package paths are documented; this is not end-to-end asynchronous Always Encrypted support.
  • Preserve negotiated encryption diagnostics and partial-implementation limits, pool/login timeout defaults, name-mapped bulk-copy metadata discovery, awaited enclave attestation, managed-SNI fixes, transaction-disposal and batch-cancellation fixes, and dependency updates.

Package coverage:

  • Microsoft.Data.SqlClient: functional/API changes and dependency updates; this refresh clarifies the companion diagnostic summary.
  • Extensions.Abstractions: authentication diagnostics, satellite resource synchronization, and dependencies.
  • Extensions.Azure and AzureKeyVaultProvider: dependency updates and family version alignment, with no newly introduced provider API.
  • Internal.Logging: alignment-only, retaining its internal-use warning.
  • Microsoft.SqlServer.Server: independently versioned, with no separate release in this milestone.

Evidence and reconciliation:

  • The approved generator .github/prompts/release-notes.prompt.md, template, skill instructions, and unmodified supporting Python script were read from the verified current main SHA above. The skill ran with explicit --repo dotnet/SqlClient and session-local output; no downloaded metadata is committed.
  • All 38 merged milestone PRs are ancestors of the verified source tip; one closed/unmerged PR is excluded. All 49 commits since v8.0.0-preview1 were reconciled: the 11 outside this milestone are stabilization tests/pipeline/version work and release-note documentation, not additional customer-facing changes.
  • New source changes since the preceding reconciliation are Abstractions satellite resources and CI configuration. Shipping dependency/project/version metadata is unchanged. Verified resources, resource-manager ownership, and framework-independent embedding on main.
  • Core shipping nuspec dependency groups match net462/net10.0/netstandard2.0 exactly. All four companion dependency sets and target frameworks match their main projects and central versions; family versions align to the full prerelease version.
  • Existing PR history was preserved and current main integrated without force-pushing. The incremental documentation change is three files; the complete PR diff against current main contains only 12 release-note/index/changelog files. No servicing branch code is imported.
  • Main maps only to this exact active preview. Preview2 and 8.1 GA wait for an active-version match or an existing servicing branch; the 8.0 API revert is not substituted into these notes.

Unresolved publication details:

  • No release date is established. The full milestone version identifies these notes; prerelease build stamping may append a build suffix and is not proof of publication.
  • Native SNI remains [8.0.0-preview1.26309.4, 9.0.0), not an inferred 8.1 version.
  • Official buildSqlServer=false selects published Server 1.0.0; building Server instead selects independently versioned 1.1.0-preview1 plus its build suffix. Confirm final build parameters/package contents before publication.
  • The servicing-note PRs independently add shared changelog/index entries; reconcile shared-index context as those PRs land rather than importing their code or duplicating notes.

Issues

Tracks milestone 108, without closing it or changing assignments.
References #2353, #4642, #4985, #3672, #4834, #5045, #4971, #5042, #5070, and #5120.

Testing

  • git diff --check - passed.
  • git diff --cached --check - passed before committing.
  • python C:\Users\mdaigle\.copilot\session-state\a6bfea28-993e-4c7f-a2af-130e2e01d597\files\validate_notes.py with PYTHONUTF8=1 - passed: all three managed PRs' scoped paths, introduced/related links, exact core shipping dependency tables, core/changelog change-text parity, and merged-PR ancestors; all four preview companion dependency/TFM/alignment sets; nine neutral-English resource entries in each of 13 satellite cultures.
  • node --test .github\scripts\tests\is-release-notes-only.test.cjs - passed: 62 tests, zero skipped.
  • Inspected the complete incremental three-file diff and complete 12-file documentation-only diff against current main.
  • No existing Markdown/link CLI is configured; .markdownlint.jsonc configures an editor extension. Supplemental checks are session-local, not committed. Historical unrelated changelog links are outside this change's scope.
  • Product builds/tests were not run because this PR changes Markdown only.
  • Tests added or updated (not applicable; documentation checks performed)
  • Public API changes documented (existing integration limits preserved)
  • Verified against customer repro (not applicable; documentation only)
  • Ensure no breaking changes introduced (documentation only; existing compatibility guidance preserved)

Guidelines

Please review the contribution guidelines before submitting a pull request:

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 17, 2026 17:15
@github-project-automation github-project-automation Bot moved this to To triage in SqlClient Board Nov 17, 2026
@mdaigle mdaigle mentioned this pull request Nov 17, 2026
3 of 4 tasks

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues block the documentation-only release notes and index updates.

No open issues 🎉

What changed in this PR

Adds documentation-only release notes for SqlClient 8.1.0-preview1 and its four companion packages, describing changes since 8.0.0-preview1 without assigning a publication date.

Changes:

  • Documents encryption-information API limitations, the pool/login timeout default change, bulk-copy improvements, asynchronous enclave attestation, and reliability fixes.
  • Records companion-package diagnostics, dependency updates, version alignment, and supported platforms.
  • Adds five version indexes and updates the central release index and changelog while preserving earlier notes.
File Description
release-notes/​README.md Links all five packages’ preview notes.
release-notes/​Internal/​Logging/​8.1/​README.md Adds the Logging 8.1 release index.
release-notes/​Internal/​Logging/​8.1/​8.1.0-preview1.md Documents version alignment and internal-use restrictions.
release-notes/​Extensions/​Azure/​8.1/​README.md Adds the Azure extension 8.1 release index.
release-notes/​Extensions/​Azure/​8.1/​8.1.0-preview1.md Lists dependency updates and supported platforms.
release-notes/​Extensions/​Abstractions/​8.1/​README.md Adds the Abstractions 8.1 release index.
release-notes/​Extensions/​Abstractions/​8.1/​8.1.0-preview1.md Describes localized authentication diagnostics and dependencies.
release-notes/​add-ons/​AzureKeyVaultProvider/​8.1/​README.md Adds the Key Vault provider 8.1 release index.
release-notes/​add-ons/​AzureKeyVaultProvider/​8.1/​8.1.0-preview1.md Documents dependency updates and package alignment.
release-notes/​8.1/​README.md Adds the core driver 8.1 release index.
release-notes/​8.1/​8.1.0-preview1.md Details driver changes, limitations, fixes, and dependencies.
CHANGELOG.md Adds the preview summary and companion-package links.

Review effort: Balanced

mdaigle and others added 2 commits November 18, 2026 09:06
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…tency

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 18, 2026 17:09

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

The documentation-only PR includes public getter behavior, networking, and CI changes without corresponding product build or test validation.

No open issues 🎉

Review effort: Balanced

@codecov

codecov Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 70.47%. Comparing base (17bef7b) to head (bae4e4c).
⚠️ Report is 23 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #5096      +/-   ##
==========================================
+ Coverage   68.99%   70.47%   +1.48%     
==========================================
  Files         314      315       +1     
  Lines       45857    70026   +24169     
==========================================
+ Hits        31638    49353   +17715     
- Misses      14219    20673    +6454     
Flag Coverage Δ
CI-SqlClient ?
sqlclient-pr 70.47% <ø> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Reconcile current main and document async parameter-discovery provider dispatch, concurrent key-cache loads, provider compatibility, and remaining synchronous paths.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 19, 2026 17:13

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

The supplied diff includes 20 C# files beyond the described 12 documentation files, leaving the intended review scope and applicable validation unclear.

No open issues 🎉

Review effort: Balanced

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 20, 2026 17:12

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues were identified for the documentation-only release notes and index updates.

No open issues 🎉

Review effort: Balanced

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: To triage

Development

Successfully merging this pull request may close these issues.

2 participants