functions/New-DbaXESmartReplay.ps1
|
function New-DbaXESmartReplay { <# .SYNOPSIS This Response type can be used to replay execution related events to a target SQL Server instance. .DESCRIPTION This Response type can be used to replay execution related events to a target SQL Server instance. The events that you can replay are of the type sql_batch_completed and rpc_completed: all other events are ignored. .PARAMETER SqlInstance The SQL Instances that you're connecting to. .PARAMETER SqlCredential Credential object used to connect to the SQL Server as a different user .PARAMETER Database Name of the initial catalog to connect to. Statements will be replayed by changing database to the same database where the event was originally captured, so this property only controls the initial database to connect to. .PARAMETER Events Each Response can be limited to processing specific events, while ignoring all the other ones. When this attribute is omitted, all events are processed. .PARAMETER Filter You can specify a filter expression by using this attribute. The filter expression is in the same form that you would use in a SQL query. For example, a valid example looks like this: duration > 10000 AND cpu_time > 10000 .PARAMETER DelaySeconds Delay Seconds .PARAMETER ReplayIntervalSeconds Replay Interval Seconds .PARAMETER FailOnSingleEventViolation Fail on single event violation .PARAMETER IsSingleEvent Is a single event .PARAMETER StopOnError Stops the replay when the first error is encountered. When false, pipes the error messages to the log and to the console output and proceeds with the replay. .PARAMETER EnableException By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message. This avoids overwhelming you with "sea of red" exceptions, but is inconvenient because it basically disables advanced scripting. Using this switch turns this "nice by default" feature off and enables you to catch exceptions with your own try/catch. .NOTES Website: https://dbatools.io Copyright: (C) Chrissy LeMaire, clemaire@gmail.com License: GNU GPL v3 https://opensource.org/licenses/GPL-3.0 SmartTarget: by Gianluca Sartori (@spaghettidba) .LINK https://dbatools.io/New-DbaXESmartReplay https://github.com/spaghettidba/XESmartTarget/wiki .EXAMPLE $response = New-DbaXESmartReplay -SqlInstance sql2017 -Database planning Start-DbaXESmartTarget -SqlInstance sql2016 -Session loadrelay -Responder $response Replays events from sql2016 on sql2017. #> [CmdletBinding()] param ( [parameter(Mandatory, ValueFromPipeline)] [Alias("ServerInstance", "SqlServer")] [DbaInstanceParameter[]]$SqlInstance, [PSCredential]$SqlCredential, [parameter(Mandatory)] [string]$Database, [string[]]$Events= "sql_batch_completed", [string]$Filter, [int]$DelaySeconds, [switch]$StopOnError, [switch]$IsSingleEvent, [switch]$FailOnSingleEventViolation, [int]$ReplayIntervalSeconds, [switch]$EnableException ) begin { try { Add-Type -Path "$script:PSModuleRoot\bin\XESmartTarget\XESmartTarget.Core.dll" -ErrorAction Stop } catch { Stop-Function -Message "Could not load XESmartTarget.Core.dll" -ErrorRecord $_ -Target "XESmartTarget" return } } process { if (Test-FunctionInterrupt) { return } foreach ($instance in $SqlInstance) { try { Write-Message -Level Verbose -Message "Connecting to $instance" $server = Connect-SqlInstance -SqlInstance $instance -SqlCredential $SqlCredential -MinimumVersion 11 } catch { Stop-Function -Message "Failure" -Category ConnectionError -ErrorRecord $_ -Target $instance -Continue } try { $replay = New-Object -TypeName XESmartTarget.Core.Responses.ReplayResponse $replay.ServerName = $instance $replay.DatabaseName = $Database $replay.Events = $Events $replay.StopOnError = $StopOnError $replay.Filter = $Filter $replay.DelaySeconds = $DelaySeconds #$replay.IsSingleEvent = $IsSingleEvent #$replay.FailOnSingleEventViolation = $FailOnSingleEventViolation $replay.ReplayIntervalSeconds = $ReplayIntervalSeconds if ($SqlCredential) { $replay.UserName = $SqlCredential.UserName $replay.Password = $SqlCredential.GetNetworkCredential().Password } $replay } catch { Stop-Function -Message "Failure" -ErrorRecord $_ -Target "XESmartTarget" -Continue } } } } |