Merge pull request #3895 from BrentOzarULTD/20260407_release_prep

20260407 release prep

Author: BrentOzar

Documentation/Development/Build Installation Scripts.ps1

@@ -80,7 +80,7 @@ $Details
 Write-Host "`n=== Step 1: Determine version ===" -ForegroundColor Cyan
 
 $sampleFile = Get-ChildItem -Path $RepoRoot -Filter "sp_Blitz.sql" | Select-Object -First 1
-$sampleContent = Get-Content $sampleFile.FullName -Raw
+$sampleContent = Get-Content $sampleFile.FullName -Raw -Encoding UTF8
 
 if ($sampleContent -match "SELECT\s+@Version\s*=\s*'([^']+)',\s*@VersionDate\s*=\s*'([^']+)'") {
     $currentVersion = $Matches[1]
@@ -141,10 +141,10 @@ $InstallAzurePath = Join-Path $RepoRoot "Install-Azure.sql"
 # All sp_Blitz*.sql except sp_Blitz.sql, sp_BlitzBackups.sql, sp_DatabaseRestore.sql, sp_BlitzFirst.sql
 $azureContent = Get-ChildItem -Path $RepoRoot -Filter "sp_Blitz*.sql" |
     Where-Object { $_.Name -ne "sp_Blitz.sql" -and $_.Name -notlike "*BlitzBackups*" -and $_.Name -notlike "*DatabaseRestore*" -and $_.Name -notlike "*BlitzFirst*" } |
-    ForEach-Object { Get-Content $_.FullName -Raw }
+    ForEach-Object { Get-Content $_.FullName -Raw -Encoding UTF8 }
 
 if (Test-Path $BlitzFirstPath) {
-    $azureContent += Get-Content -Path $BlitzFirstPath -Raw
+    $azureContent += Get-Content -Path $BlitzFirstPath -Raw -Encoding UTF8
 }
 
 [System.IO.File]::WriteAllText($InstallAzurePath, ($azureContent -join "`r`n"), $Utf8NoBom)
@@ -154,16 +154,16 @@ Write-Host "  Built: Install-Azure.sql"
 # All sp_*.sql except sp_BlitzInMemoryOLTP.sql and sp_BlitzFirst.sql
 $allContent = Get-ChildItem -Path $RepoRoot -Filter "sp_*.sql" |
     Where-Object { $_.Name -notlike "*BlitzInMemoryOLTP*" -and $_.Name -notlike "*BlitzFirst*" } |
-    ForEach-Object { Get-Content $_.FullName -Raw }
+    ForEach-Object { Get-Content $_.FullName -Raw -Encoding UTF8 }
 
 # Append SqlServerVersions.sql
 if (Test-Path $SqlVersionsPath) {
-    $allContent += Get-Content -Path $SqlVersionsPath -Raw
+    $allContent += Get-Content -Path $SqlVersionsPath -Raw -Encoding UTF8
 }
 
 # Append sp_BlitzFirst.sql last
 if (Test-Path $BlitzFirstPath) {
-    $allContent += Get-Content -Path $BlitzFirstPath -Raw
+    $allContent += Get-Content -Path $BlitzFirstPath -Raw -Encoding UTF8
 }
 
 [System.IO.File]::WriteAllText($InstallAllPath, ($allContent -join "`r`n"), $Utf8NoBom)

Install-All-Scripts.sql

@@ -69,7 +69,7 @@ BEGIN
 	SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED;
 
 
-	SELECT @Version = '8.31', @VersionDate = '20260406';
+	SELECT @Version = '8.32', @VersionDate = '20260407';
 	SET @OutputType = UPPER(@OutputType);
 
     IF(@VersionCheckMode = 1)
@@ -10545,6 +10545,7 @@ IF NOT EXISTS ( SELECT  1
     SET NOCOUNT OFF;
 END
 GO
+
 SET ANSI_NULLS ON;
 SET QUOTED_IDENTIFIER ON
 
@@ -10585,7 +10586,7 @@ BEGIN
 SET NOCOUNT ON;
 SET STATISTICS XML OFF;
 
-SELECT @Version = '8.31', @VersionDate = '20260406';
+SELECT @Version = '8.32', @VersionDate = '20260407';
 
 IF(@VersionCheckMode = 1)
 BEGIN
@@ -11438,6 +11439,7 @@ END
 
 END
 GO
+
 IF OBJECT_ID('dbo.sp_BlitzBackups') IS NULL
   EXEC ('CREATE PROCEDURE dbo.sp_BlitzBackups AS RETURN 0;');
 GO
@@ -11464,7 +11466,7 @@ AS
 	SET STATISTICS XML OFF;
 	SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED;
 
-	SELECT @Version = '8.31', @VersionDate = '20260406';
+	SELECT @Version = '8.32', @VersionDate = '20260407';
 
 	IF(@VersionCheckMode = 1)
 	BEGIN
@@ -12963,6 +12965,7 @@ END;
 END;
 
 GO
+
 SET ANSI_NULLS ON;
 SET ANSI_PADDING ON;
 SET ANSI_WARNINGS ON;
@@ -13263,7 +13266,7 @@ SET NOCOUNT ON;
 SET STATISTICS XML OFF;
 SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED;
 
-SELECT @Version = '8.31', @VersionDate = '20260406';
+SELECT @Version = '8.32', @VersionDate = '20260407';
 SET @OutputType = UPPER(@OutputType);
 
 IF(@VersionCheckMode = 1)
@@ -13793,6 +13796,13 @@ BEGIN
 	RETURN;
 END;
 
+/* Check database compatibility level for STRING_SPLIT support */
+IF (SELECT compatibility_level FROM sys.databases WHERE database_id = DB_ID()) < 130
+BEGIN
+    RAISERROR('sp_BlitzCache requires database compatibility level 130 or higher. If your user databases aren''t at that compat level yet, install sp_BlitzCache in master instead.', 16, 1);
+    RETURN;
+END;
+
 IF(@OutputType = 'NONE' AND (@OutputTableName IS NULL OR @OutputSchemaName IS NULL OR @OutputDatabaseName IS NULL))
 BEGIN
     RAISERROR('This procedure should be called with a value for all @Output* parameters, as @OutputType is set to NONE',12,1);
@@ -21293,6 +21303,7 @@ END; /* End of writing results to table */
 END; /*Final End*/
 
 GO
+
 SET ANSI_NULLS ON;
 SET ANSI_PADDING ON;
 SET ANSI_WARNINGS ON;
@@ -21372,7 +21383,7 @@ SET NOCOUNT ON;
 SET STATISTICS XML OFF;
 SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED;
 
-SELECT @Version = '8.31', @VersionDate = '20260406';
+SELECT @Version = '8.32', @VersionDate = '20260407';
 SET @OutputType  = UPPER(@OutputType);
 
 IF(@VersionCheckMode = 1)
@@ -21393,7 +21404,7 @@ versions for free, watch training videos on how it works, get more info on
 the findings, contribute your own code, and more.
 
 Known limitations of this version:
- - Only Microsoft-supported versions of SQL Server. Sorry, 2005 and 2000.
+ - Only Microsoft-supported versions of SQL Server. Sorry, 2014 and older.
  - Index create statements are just to give you a rough idea of the syntax. It includes filters and fillfactor.
  --        Example 1: index creates use ONLINE=? instead of ONLINE=ON / ONLINE=OFF. This is because it is important 
            for the user to understand if it is going to be offline and not just run a script.
@@ -28787,6 +28798,7 @@ BEGIN CATCH
     END CATCH;
 END
 GO
+
 IF OBJECT_ID('dbo.sp_BlitzLock') IS NULL
 BEGIN
     EXECUTE ('CREATE PROCEDURE dbo.sp_BlitzLock AS RETURN 0;');
@@ -28831,7 +28843,7 @@ BEGIN
     SET XACT_ABORT OFF;
     SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED;
 
-    SELECT @Version = '8.31', @VersionDate = '20260406';
+    SELECT @Version = '8.32', @VersionDate = '20260407';
 
     IF @VersionCheckMode = 1
     BEGIN
@@ -29359,8 +29371,38 @@ BEGIN
             AND   dxs.create_time IS NOT NULL
         )
         BEGIN
-            RAISERROR('A session with the name %s does not exist or is not currently active.', 11, 1, @EventSessionName) WITH NOWAIT;
-            RETURN;
+            IF @EventSessionName = N'system_health'
+            AND NOT EXISTS
+            (
+                SELECT
+                    1/0
+                FROM sys.database_event_sessions AS ses
+                WHERE ses.name = @EventSessionName
+            )
+            BEGIN
+                RAISERROR('
+The system_health extended events session is not available in Azure SQL DB.
+
+To use sp_BlitzLock in Azure SQL DB, you have two options:
+
+1. Create a database-scoped deadlock XE session, e.g.:
+
+   CREATE EVENT SESSION [deadlocks] ON DATABASE
+   ADD EVENT sqlserver.database_xml_deadlock_report
+   ADD TARGET package0.ring_buffer;
+   ALTER EVENT SESSION [deadlocks] ON DATABASE STATE = START;
+
+   Then call: EXEC sp_BlitzLock @EventSessionName = N''deadlocks'', @TargetSessionType = N''ring_buffer'';
+
+2. Log deadlock XML to a table and use the @TargetTableName parameter.
+', 0, 1) WITH NOWAIT;
+                RETURN;
+            END;
+            ELSE
+            BEGIN
+                RAISERROR('A session with the name %s does not exist or is not currently active.', 11, 1, @EventSessionName) WITH NOWAIT;
+                RETURN;
+            END;
         END;
     END;
 
@@ -32407,7 +32449,7 @@ BEGIN
                     en =
                         DENSE_RANK() OVER (ORDER BY dp.event_date),
                     qn =
-                        ROW_NUMBER() OVER (PARTITION BY dp.event_date ORDER BY dp.event_date),
+                        ROW_NUMBER() OVER (PARTITION BY dp.event_date ORDER BY dp.event_date) - 1,
                     dn =
                         ROW_NUMBER() OVER (PARTITION BY dp.event_date, dp.id ORDER BY dp.event_date),
                     dp.is_victim,
@@ -32492,7 +32534,7 @@ BEGIN
                     en =
                         DENSE_RANK() OVER (ORDER BY dp.event_date),
                     qn =
-                        ROW_NUMBER() OVER (PARTITION BY dp.event_date ORDER BY dp.event_date),
+                        ROW_NUMBER() OVER (PARTITION BY dp.event_date ORDER BY dp.event_date) - 1,
                     dn =
                         ROW_NUMBER() OVER (PARTITION BY dp.event_date, dp.id ORDER BY dp.event_date),
                     is_victim = 1,
@@ -32554,11 +32596,8 @@ BEGIN
                         d.en
                     ) +
                     N', Query #'
-                    + CASE
-                          WHEN d.qn = 0
-                          THEN N'1'
-                          ELSE CONVERT(nvarchar(10), d.qn)
-                      END + CASE
+                    + CONVERT(nvarchar(10), d.qn + 1)
+                      + CASE
                                 WHEN d.is_victim = 1
                                 THEN N' - VICTIM'
                                 ELSE N''
@@ -33378,6 +33417,7 @@ BEGIN
         END; /*End debug*/
     END; /*Final End*/
 GO
+
 SET ANSI_NULLS ON;
 SET ANSI_PADDING ON;
 SET ANSI_WARNINGS ON;
@@ -33397,12 +33437,14 @@ SELECT
      WHEN CONVERT(NVARCHAR(128), SERVERPROPERTY ('PRODUCTVERSION')) LIKE '10%' THEN 0
      WHEN CONVERT(NVARCHAR(128), SERVERPROPERTY ('PRODUCTVERSION')) LIKE '11%' THEN 0
      WHEN CONVERT(NVARCHAR(128), SERVERPROPERTY ('PRODUCTVERSION')) LIKE '12%' THEN 0
+     WHEN CONVERT(NVARCHAR(128), SERVERPROPERTY ('PRODUCTVERSION')) LIKE '13%'
+          AND CAST(PARSENAME(CONVERT(NVARCHAR(128), SERVERPROPERTY ('PRODUCTVERSION')), 2) AS INT) < 5026 THEN 0
 	 ELSE 1
   END
 ) = 0
 BEGIN
 	DECLARE @msg VARCHAR(8000);
-	SELECT @msg = 'Sorry, sp_BlitzWho doesn''t work on versions of SQL prior to 2016.' + REPLICATE(CHAR(13), 7933);
+	SELECT @msg = 'Sorry, sp_BlitzWho doesn''t work on versions of SQL prior to 2016 SP2.' + REPLICATE(CHAR(13), 7933);
 	PRINT @msg;
 	RETURN;
 END;
@@ -33442,7 +33484,7 @@ BEGIN
 	SET STATISTICS XML OFF;
 	SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED;
 
-	SELECT @Version = '8.31', @VersionDate = '20260406';
+	SELECT @Version = '8.32', @VersionDate = '20260407';
 
 	IF(@VersionCheckMode = 1)
 	BEGIN
@@ -33463,7 +33505,7 @@ versions for free, watch training videos on how it works, get more info on
 the findings, contribute your own code, and more.
 
 Known limitations of this version:
- - Only SQL Server 2016 and newer. Sorry, 2014 and earlier.
+ - Only SQL Server 2016 SP2 and newer. Sorry, 2016 SP1 and earlier.
  - If @OutputDatabaseName and @OutputSchemaName are populated, the database and
    schema must already exist. We will not create them, only the table.
 
@@ -34496,6 +34538,7 @@ EXEC sp_executesql @StringToExecute,
 
 END
 GO 
+
 IF OBJECT_ID('dbo.CommandExecute') IS NULL
 BEGIN
 	PRINT 'sp_DatabaseRestore is about to install, but you have not yet installed the Ola Hallengren maintenance scripts.'
@@ -34557,7 +34600,7 @@ SET STATISTICS XML OFF;
 
 /*Versioning details*/
 
-SELECT @Version = '8.31', @VersionDate = '20260406';
+SELECT @Version = '8.32', @VersionDate = '20260407';
 
 IF(@VersionCheckMode = 1)
 BEGIN
@@ -36189,6 +36232,7 @@ IF OBJECT_ID( 'tempdb..#SplitDiffBackups' ) IS NOT NULL DROP TABLE #SplitDiffBac
 IF OBJECT_ID( 'tempdb..#SplitLogBackups' ) IS NOT NULL DROP TABLE #SplitLogBackups;
 END
 GO
+
 IF OBJECT_ID('dbo.sp_ineachdb') IS NULL
     EXEC ('CREATE PROCEDURE dbo.sp_ineachdb AS RETURN 0')
 GO
@@ -36228,7 +36272,7 @@ BEGIN
   SET NOCOUNT ON;
   SET STATISTICS XML OFF;
 
-  SELECT @Version = '8.31', @VersionDate = '20260406';
+  SELECT @Version = '8.32', @VersionDate = '20260407';
 
   IF(@VersionCheckMode = 1)
   BEGIN
@@ -36564,6 +36608,7 @@ OPTION (MAXRECURSION 0);
   DEALLOCATE dbs;
 END
 GO
+
 IF OBJECT_ID('dbo.sp_kill') IS NULL
 	EXEC ('CREATE PROCEDURE dbo.sp_kill AS RETURN 0;');
 GO
@@ -36637,7 +36682,7 @@ BEGIN
 	SOFTWARE.
 	*/
 
-	SELECT @Version = '8.31', @VersionDate = '20260406';
+	SELECT @Version = '8.32', @VersionDate = '20260407';
 
 	IF(@VersionCheckMode = 1)
 	BEGIN
@@ -37214,13 +37259,24 @@ For more info, visit http://FirstResponderKit.org
 		IF @Debug = 1
 			RAISERROR('Creating/updating persistent output table...', 0, 1) WITH NOWAIT;
 
-		SET @ObjectFullName = @OutputDatabaseName + N'.' + @OutputSchemaName + N'.' + @OutputTableName;
+		IF @AzureSQLDB = 1
+			SET @ObjectFullName = @OutputSchemaName + N'.' + @OutputTableName;
+		ELSE
+			SET @ObjectFullName = @OutputDatabaseName + N'.' + @OutputSchemaName + N'.' + @OutputTableName;
 
 		/* Create table if it doesn't exist */
-		SET @StringToExecute = N'USE ' + @OutputDatabaseName + N';
-			IF EXISTS(SELECT * FROM ' + @OutputDatabaseName + N'.INFORMATION_SCHEMA.SCHEMATA WHERE QUOTENAME(SCHEMA_NAME) = ''' + @OutputSchemaName + N''')
-			AND NOT EXISTS (SELECT * FROM ' + @OutputDatabaseName + N'.INFORMATION_SCHEMA.TABLES WHERE QUOTENAME(TABLE_SCHEMA) = ''' + @OutputSchemaName + N''' AND QUOTENAME(TABLE_NAME) = ''' + @OutputTableName + N''')
-			CREATE TABLE ' + @OutputSchemaName + N'.' + @OutputTableName + N' (
+		IF @AzureSQLDB = 1
+			SET @StringToExecute = N'
+				IF EXISTS(SELECT * FROM INFORMATION_SCHEMA.SCHEMATA WHERE QUOTENAME(SCHEMA_NAME) = ''' + @OutputSchemaName + N''')
+				AND NOT EXISTS (SELECT * FROM INFORMATION_SCHEMA.TABLES WHERE QUOTENAME(TABLE_SCHEMA) = ''' + @OutputSchemaName + N''' AND QUOTENAME(TABLE_NAME) = ''' + @OutputTableName + N''')
+				CREATE TABLE ' + @ObjectFullName + N' (';
+		ELSE
+			SET @StringToExecute = N'
+				IF EXISTS(SELECT * FROM ' + @OutputDatabaseName + N'.INFORMATION_SCHEMA.SCHEMATA WHERE QUOTENAME(SCHEMA_NAME) = ''' + @OutputSchemaName + N''')
+				AND NOT EXISTS (SELECT * FROM ' + @OutputDatabaseName + N'.INFORMATION_SCHEMA.TABLES WHERE QUOTENAME(TABLE_SCHEMA) = ''' + @OutputSchemaName + N''' AND QUOTENAME(TABLE_NAME) = ''' + @OutputTableName + N''')
+				CREATE TABLE ' + @ObjectFullName + N' (';
+
+		SET @StringToExecute = @StringToExecute + N'
 				Id INT IDENTITY(1,1) NOT NULL PRIMARY KEY CLUSTERED,
 				ServerName NVARCHAR(128) NULL,
 				CheckDate DATETIMEOFFSET NULL,
@@ -37405,7 +37461,10 @@ For more info, visit http://FirstResponderKit.org
 			IF @OutputDatabaseName IS NOT NULL AND @OutputSchemaName IS NOT NULL AND @OutputTableName IS NOT NULL
 				AND EXISTS (SELECT * FROM sys.databases WHERE QUOTENAME([name]) = @OutputDatabaseName)
 			BEGIN
-				SET @ObjectFullName = @OutputDatabaseName + N'.' + @OutputSchemaName + N'.' + @OutputTableName;
+				IF @AzureSQLDB = 1
+						SET @ObjectFullName = @OutputSchemaName + N'.' + @OutputTableName;
+					ELSE
+						SET @ObjectFullName = @OutputDatabaseName + N'.' + @OutputSchemaName + N'.' + @OutputTableName;
 				SET @StringToExecute = N'UPDATE ot
 					SET ot.KillStartedTime = t.KillStartedTime,
 						ot.KillEndedTime = t.KillEndedTime,
@@ -37443,6 +37502,7 @@ For more info, visit http://FirstResponderKit.org
 END;
 GO
 
+
 IF (OBJECT_ID('dbo.SqlServerVersions') IS NULL)
 BEGIN
 
@@ -37957,6 +38017,7 @@ VALUES
     (10, 1600, 'RTM ', '', '2008-08-06', '2014-07-08', '2019-07-09', 'SQL Server 2008', 'RTM ')
 ;
 GO
+
 IF OBJECT_ID('dbo.sp_BlitzFirst') IS NULL
   EXEC ('CREATE PROCEDURE dbo.sp_BlitzFirst AS RETURN 0;');
 GO
@@ -38006,7 +38067,7 @@ SET NOCOUNT ON;
 SET STATISTICS XML OFF;
 SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED;
 
-SELECT @Version = '8.31', @VersionDate = '20260406';
+SELECT @Version = '8.32', @VersionDate = '20260407';
 
 IF(@VersionCheckMode = 1)
 BEGIN