functions/Get-DbaDbPageInfo.ps1
|
#ValidationTags#CodeStyle,Messaging,FlowControl,Pipeline# function Get-DbaDbPageInfo { <# .SYNOPSIS Get-DbaDbPageInfo will return page information for a database .DESCRIPTION Get-DbaDbPageInfo is able to return information about the pages in a database. It's possible to return the information for multiple databases and filter on specific databases, schemas and tables. .PARAMETER SqlInstance The target SQL Server instance(s) .PARAMETER SqlCredential Login to the target instance using alternative credentials. Windows and SQL Authentication supported. Accepts credential objects (Get-Credential) .PARAMETER Database Filter to only get specific databases .PARAMETER Schema Filter to only get specific schemas .PARAMETER Table Filter to only get specific tables .PARAMETER InputObject Enables piping from Get-DbaDatabase .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 Tags: Database, Page Author: Chrissy LeMaire (@cl), netnerds.net Website: https://dbatools.io Copyright: (C) Chrissy LeMaire, clemaire@gmail.com License: MIT https://opensource.org/licenses/MIT .LINK https://dbatools.io/Get-DbaDbPageInfo .EXAMPLE PS C:\> et-DbaDbPageInfo -SqlInstance sql2017 Returns page information for all databases on sql2017 .EXAMPLE PS C:\> Get-DbaDbPageInfo -SqlInstance sql2017, sql2016 -Database testdb Returns page information for the testdb on sql2017 and sql2016 .EXAMPLE PS C:\> $servers | Get-DbaDatabase -Database testdb | Get-DbaDbPageInfo Returns page information for the testdb on all $servers #> [CmdLetBinding()] param ( [Alias("ServerInstance", "SqlServer")] [DbaInstanceParameter]$SqlInstance, [PSCredential]$SqlCredential, [string[]]$Database, [string[]]$Schema, [string[]]$Table, [parameter(ValueFromPipeline)] [Microsoft.SqlServer.Management.Smo.Database[]]$InputObject, [switch]$EnableException ) begin { $sql = "SELECT SERVERPROPERTY('MachineName') AS ComputerName, ISNULL(SERVERPROPERTY('InstanceName'), 'MSSQLSERVER') AS InstanceName, SERVERPROPERTY('ServerName') AS SqlInstance, [Database] = DB_NAME(DB_ID()), ss.name AS [Schema], st.name AS [Table], dbpa.page_type_desc AS PageType, dbpa.page_free_space_percent AS PageFreePercent, IsAllocated = CASE dbpa.is_allocated WHEN 0 THEN 'False' WHEN 1 THEN 'True' END, IsMixedPage = CASE dbpa.is_mixed_page_allocation WHEN 0 THEN 'False' WHEN 1 THEN 'True' END FROM sys.dm_db_database_page_allocations(DB_ID(), NULL, NULL, NULL, 'DETAILED') AS dbpa INNER JOIN sys.tables AS st ON st.object_id = dbpa.object_id INNER JOIN sys.schemas AS ss ON ss.schema_id = st.schema_id" if ($Schema) { $sql = "$sql WHERE ss.name IN ('$($Schema -join "','")')" } if ($Table) { if ($schema) { $sql = "$sql AND st.name IN ('$($Table -join "','")')" } else { $sql = "$sql WHERE st.name IN ('$($Table -join "','")')" } } } process { # Loop through all the instances foreach ($instance in $SqlInstance) { # Try connecting to the instance Write-Message -Message "Connecting to $instance" -Level Verbose try { $server = Connect-SqlInstance -SqlInstance $instance -SqlCredential $SqlCredential -MinimumVersion 11 } catch { Stop-Function -Message "Failure" -Category ConnectionError -ErrorRecord $_ -Target $instance -Continue } if ($Database) { $InputObject += $server.Databases | Where-Object { $_.Name -in $Database } } else { $InputObject += $server.Databases } } # Loop through each of databases foreach ($db in $InputObject) { # Revalidate the version of the server in case db is piped in try { if ($db.Parent.VersionMajor -ge 11) { $db.Query($sql) } else { Stop-Function -Message "Unsupported SQL Server version" -Target $db -Continue } } catch { Stop-Function -Message "Something went wrong executing the query" -ErrorRecord $_ -Target $instance -Continue } } } } |