Fix invalid DMV columns in three report functions (1.6.4.0)

Found via live runs against a local SQL 2022 plus a static validation of every DMV query through
sys.dm_exec_describe_first_result_set.

- Get-sqmMissingIndexes: join used mid.index_group_handle, which does not exist in
  sys.dm_db_missing_index_details (only index_handle). Fixed to mid.index_handle = mig.index_handle.
- Get-sqmOperationStatus: AutoSeed query used non-existent columns total_size_bytes / start_time /
  estimated_completion_time_ms from sys.dm_hadr_physical_seeding_stats. Switched to the real columns
  database_size_bytes / start_time_utc / estimate_time_complete_utc (remaining time via DATEDIFF ms),
  aliased to the names the PowerShell side expects.
- Get-sqmAlwaysOnFailoverHistory: optional SQL supplement read ars.role_start_time, which does not
  exist in sys.dm_hadr_availability_replica_states. Replaced with the valid column
  current_configuration_commit_start_time_utc (UTC approximation; Event Log 1480 stays authoritative),
  plus UTC comparison and NULL guard.

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

Author: Uwe Janke

CHANGELOG.md

@@ -1,5 +1,22 @@
 # sqmSQLTool — Changelog
 
+## [1.6.4.0] — 2026-06-22
+
+### 🔧 Fixes — ungültige DMV-Spalten (gefunden per Live-Lauf + statischer DMV-Validierung gegen SQL 2022)
+
+- **Get-sqmMissingIndexes**: Join referenzierte `mid.index_group_handle`, das es in
+  `sys.dm_db_missing_index_details` nicht gibt (nur `index_handle`). Query lieferte „Ungültiger
+  Spaltenname index_group_handle" → keine Ergebnisse. Join korrigiert auf
+  `mid.index_handle = mig.index_handle`.
+- **Get-sqmOperationStatus**: AutoSeed-Query nutzte die nicht existierenden Spalten `total_size_bytes`,
+  `start_time` und `estimated_completion_time_ms` aus `sys.dm_hadr_physical_seeding_stats`. Korrigiert
+  auf die realen Spalten `database_size_bytes`, `start_time_utc` und `estimate_time_complete_utc`
+  (Restzeit per `DATEDIFF` in ms), per Alias auf die erwarteten Namen abgebildet.
+- **Get-sqmAlwaysOnFailoverHistory**: optionale SQL-Ergänzung las `ars.role_start_time`, das es in
+  `sys.dm_hadr_availability_replica_states` nicht gibt. Ersetzt durch die valide Spalte
+  `current_configuration_commit_start_time_utc` (UTC-Näherung; maßgeblich bleibt das Event Log,
+  EventID 1480). UTC-Vergleich und NULL-Schutz ergänzt.
+
 ## [1.6.3.0] — 2026-06-22
 
 ### 🔧 Fixes — dbatools-Parameter-/Cmdlet-Drift (gefunden per statischem Audit gegen dbatools 2.8.1, validiert gegen lokalen SQL 2022)

Public/Get-sqmAlwaysOnFailoverHistory.ps1

@@ -16,10 +16,10 @@
     Liefert die Cluster-Perspektive des Failovers. Nur verfuegbar wenn WSFC
     installiert und der Log aktiv ist (-IncludeClusterLog).
 
-    Ergaenzung: sys.dm_hadr_availability_replica_states.role_start_time
-    Zeigt den Zeitpunkt des letzten Rollenwechsels der lokalen Replica.
-    Wird als zusaetzliche Zeile mit Source 'RoleStartTime' ausgegeben wenn
-    -SqlInstance angegeben ist.
+    Ergaenzung: sys.dm_hadr_availability_replica_states.current_configuration_commit_start_time_utc
+    (Naeherung fuer den Rollenzeitpunkt der lokalen Replica - ein echtes role_start_time gibt es in
+    dieser DMV nicht). Wird als zusaetzliche Zeile mit Source 'RoleStartTime' ausgegeben wenn
+    -SqlInstance angegeben ist. Massgeblich bleibt das Event Log (EventID 1480).
 
     FailoverType-Erkennung:
     - 'Planned'   : EventID 1480, Message enthaelt "user" oder "manual"
@@ -321,7 +321,9 @@ SELECT
     ag.name                        AS AGName,
     ar.replica_server_name         AS ReplicaName,
     ars.role_desc                  AS CurrentRole,
-    ars.role_start_time            AS RoleStartTime
+    -- sys.dm_hadr_availability_replica_states hat KEIN role_start_time. Naechstbeste valide Spalte
+    -- ist current_configuration_commit_start_time_utc (UTC) als Naeherung fuer den Rollenzeitpunkt.
+    ars.current_configuration_commit_start_time_utc AS RoleStartTime
 FROM sys.dm_hadr_availability_replica_states ars
 JOIN sys.availability_replicas ar
     ON ar.replica_id = ars.replica_id
@@ -336,7 +338,8 @@ WHERE ars.is_local = 1
 						foreach ($row in $rows)
 						{
 							if ($AvailabilityGroup -and $row.AGName -ne $AvailabilityGroup) { continue }
-							if ($row.RoleStartTime -lt $Since) { continue }
+							# RoleStartTime ist UTC; gegen UTC vergleichen. NULL (z.B. Secondary) ueberspringen.
+							if (-not $row.RoleStartTime -or $row.RoleStartTime -lt $Since.ToUniversalTime()) { continue }
 
 							$computerResults.Add([PSCustomObject]@{
 								ComputerName      = $computer

Public/Get-sqmMissingIndexes.ps1

@@ -150,7 +150,8 @@ SELECT TOP $Top
     mid.database_id                                  AS DatabaseId,
     mid.index_handle                                 AS IndexHandle
 FROM sys.dm_db_missing_index_details   mid
-INNER JOIN sys.dm_db_missing_index_groups      mig  ON mid.index_group_handle = mig.index_group_handle
+-- sys.dm_db_missing_index_details hat KEIN index_group_handle, nur index_handle.
+INNER JOIN sys.dm_db_missing_index_groups      mig  ON mid.index_handle = mig.index_handle
 INNER JOIN sys.dm_db_missing_index_group_stats migs ON mig.index_group_handle = migs.group_handle
 WHERE DB_NAME(mid.database_id) NOT IN ('master','model','msdb','tempdb')
   AND (migs.user_seeks + migs.user_scans) >= $MinSeeks

Public/Get-sqmOperationStatus.ps1

@@ -110,17 +110,20 @@ WHERE r.command IN ('BACKUP DATABASE', 'RESTORE DATABASE', 'BACKUP LOG', 'RESTOR
 				# 2. AutoSeed Operationen ueber sys.dm_hadr_physical_seeding_stats abrufen
 				# Diese DMV existiert ab SQL Server 2016
 				$autoSeedQuery = @"
-SELECT 
+-- Echte Spalten von sys.dm_hadr_physical_seeding_stats: database_size_bytes (nicht total_size_bytes),
+-- start_time_utc (nicht start_time), estimate_time_complete_utc (UTC-Zeit, nicht *_ms). Per Alias auf die
+-- vom PowerShell-Teil erwarteten Namen abgebildet; Restzeit aus der UTC-Zielzeit in ms umgerechnet.
+SELECT
     local_database_name AS database_name,
     role_desc,
     internal_state_desc,
     transfer_rate_bytes_per_second,
     transferred_size_bytes,
-    total_size_bytes,
-    start_time,
-    estimated_completion_time_ms,
-    CASE 
-        WHEN total_size_bytes > 0 THEN (transferred_size_bytes * 100.0 / total_size_bytes)
+    database_size_bytes AS total_size_bytes,
+    start_time_utc AS start_time,
+    DATEDIFF(second, GETUTCDATE(), estimate_time_complete_utc) * 1000 AS estimated_completion_time_ms,
+    CASE
+        WHEN database_size_bytes > 0 THEN (transferred_size_bytes * 100.0 / database_size_bytes)
         ELSE 0
     END AS percent_complete
 FROM sys.dm_hadr_physical_seeding_stats

sqmSQLTool.psd1

@@ -17,7 +17,7 @@
 	RootModule			   = 'sqmSQLTool.psm1'
 
 	# Version number of this module.
-	ModuleVersion		   = '1.6.3.0'
+	ModuleVersion		   = '1.6.4.0'
 
 	# ID used to uniquely identify this module
 	GUID				   = 'c4b10ba2-aee2-4d8d-ad86-a6e97c346ba6'
@@ -243,7 +243,7 @@
 			# IconUri = ''
 
 			# ReleaseNotes of this module
-			ReleaseNotes = 'See CHANGELOG.md and GitHub: https://github.com/JankeUwe/sqmSQLTool/releases/tag/v1.6.3.0'
+			ReleaseNotes = 'See CHANGELOG.md and GitHub: https://github.com/JankeUwe/sqmSQLTool/releases/tag/v1.6.4.0'
 
 			# External module dependencies
 			ExternalModuleDependencies = @('dbatools')