Install

Works with Drupal: ^9.3 || ^10

Using Composer to manage Drupal site dependencies

Alternative installation files

Download tar.gz 63.8 KB
MD5: fc1f255aa55ccb9b9586e98d8f41e9c8
SHA-1: 339bb92b4dbf4e1fbf24774659ebac5a21dc16cf
SHA-256: ce3e677e5430d60f330ecff1ce0de97fe814f1ed7323e698143b4d960306088e
Download zip 91.17 KB
MD5: 10308c44445d5734ddfb48440f238d06
SHA-1: d16618d18e5b27bf7a3bcf6e66d95be528e96ac3
SHA-256: b1249e27e0f175a9d75119bba9d61d59d9f942579391c0103340d74a1ebdc77c

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'
  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: 18 Nov 2025 at 05:56 UTC
Last updated: 18 Nov 2025 at 05:56 UTC
Bug fixes
New features

Other releases