Install

Works with Drupal: ^10.3 || ^11

Using Composer to manage Drupal site dependencies

Alternative installation files

Download tar.gz 82.8 KB
MD5: c452ba79afa65955526bb4beab4f2bc2
SHA-1: 1a9012d500010cab37cd23366b34bd920732dbe6
SHA-256: dbb0ebaac3380f46e20cfe3e3fc88372694cdf03efeec6b422842b7406b7effe
Download zip 113.61 KB
MD5: 266cb11c9ee3e7748a673da07075e601
SHA-1: 537dbf4fcb281e3da5427103e5994e394396ea66
SHA-256: 5661c42ea258cb8aee87bae0f6243a48e8b88e47073993a07d9b78bdf32c1220

Release notes

Release notes follow the 5.0.x development branch - please read carefully and test in non-production environments before upgrading.

Migration Guide

Upgrading from 4.4.x

  1. Backup your database before upgrading
  2. Update composer:
    • composer require 'drupal/sqlsrv:^5.0@beta'
  3. Run database updates:
    • drush updatedb
    • This will deploy the new REGEXP function to your SQL Server database
  4. Clear caches:
    • drush cache:rebuild
  5. Test thoroughly: Especially if you use:
    • Custom transaction handling code
    • High-concurrency operations (cache clears, bulk imports)
    • REGEXP pattern matching in queries

Optional: Disable NOLOCK for Specific Queries

If you need to disable NOLOCK hints for specific cache reads:

  • Use query options: $query->addMetaData('sqlsrv_use_nolock', FALSE);

Breaking Changes

None for end users. All changes are backward compatible. The removal of SupportsTemporaryTablesInterface is internal only - it's now implemented from Drupal core.

Known Issues

  • None at this time

Removed Features

Deprecated Interfaces

  • Removed SupportsTemporaryTablesInterface (now in Drupal core)
  • Connection class now implements core's SupportsTemporaryTablesInterface
  • No breaking changes for end users - interface moved to core

Obsolete Tests Removed

  • Removed DeleteTruncateTest.php - redundant with core tests
  • Removed SelectTest.php - replaced by ConditionNamespaceTest
  • Removed MergeTest.php - covered by core and ConditionNamespaceTest
  • Removed NewDatabaseFailureTest.php - redundant scenarios
  • Removed database statement monitoring tests - obsolete functionality

These removals reduce test maintenance burden without reducing coverage

Resources

Created by: code poet
Created on: 29 Oct 2025 at 21:47 UTC
Last updated: 29 Oct 2025 at 21:47 UTC
New features

Other releases