Get-SqlAssessmentItem
Возвращает проверки рекомендаций оценки SQL, доступные для выбранного объекта SQL Server.
Синтаксис
Get-SqlAssessmentItem
[-Check <String[]>]
[[-InputObject] <PSObject>]
[-Configuration <PSObject>]
[-MinSeverity <SeverityLevel>]
[-FlattenOutput]
[<CommonParameters>]
Описание
Командлет Get-SqlAssessmentItem находит все доступные проверки рекомендаций для каждого входного объекта. Дополнительные сведения см. в обзоре API оценки SQL.
Этот командлет принимает следующие типы входных данных:
- Microsoft.SqlServer.Management.Smo.Server
- Microsoft.SqlServer.Management.Smo.Database
- Microsoft.SqlServer.Management.Smo.AvailabilityGroup
- Microsoft.SqlServer.Management.Smo.FileGroup
- Microsoft.SqlServer.Management.Smo.RegisteredServers.RegisteredServer
- Строка, содержащая путь к любому объекту указанных выше типов
- Коллекция объектов
Входные объекты можно получить с помощью командлетов SqlServer, таких как Get-SqlInstance и Get-SqlDatabase или простой PowerShell.
такие командлеты, как Get-Item и Get-ChildItem. Кроме того, командлет поддерживает поставщик PowerShell SQL Server, чтобы он смог получить объект по пути. Путь можно передать явным образом, в противном случае будет использоваться текущий путь.
Доступность проверка для выбранного объекта зависит от версии SQL Server, платформы и типа объекта. Кроме того, существуют проверки, предназначенные для конкретных баз данных, таких как tempdb
или master
. Кроме того, можно фильтровать проверки по тегам, именам и серьезности с помощью параметров -MinSeverity и -Check.
С помощью командлета Get-SqlAssessmentItem можно получить список проверок, применимых к данному объекту SQL Server. Кроме того, выходные данные этого командлета можно использовать в качестве аргумента -Check для командлета Invoke-SqlAssessment .
Пользовательские конфигурации можно применять с помощью параметра -Configuration. Примеры настройки доступны на сайте GitHub.
поддержка SQL Server на виртуальных машинах Azure
С помощью командлетов оценки SQL можно оценить экземпляр SQL Server на виртуальной машине Azure не только как локальный SQL Server, но и как правила, относящиеся к SQL Server на виртуальной машине Azure (которые используют сведения о конфигурации виртуальной машины). Например, правило AzSqlVmSize проверяет, что виртуальная машина, на которую размещен экземпляр SQL Server на виртуальной машине Azure, имеет рекомендуемый размер.
Чтобы использовать такие правила, подключитесь к Azure с помощью модуля Azure PowerShell и убедитесь, что установлен модуль Az.ResourceGraph.
Выполните вход с помощью Azure PowerShell, прежде чем вызывать оценку SQL для SQL Server на экземпляре виртуальной машины Azure. В примере 13 показан интерактивный процесс входа и выбор подписки.
ПРИМЕЧАНИЕ. Можно использовать подключение к учетной записи Azure, сохраняемое между сеансами PowerShell, т. е. вызвать Connect-AzAccount в одном сеансе и опустить эту команду позже. Однако для текущей версии командлетов оценки SQL требуется, чтобы модуль Az.ResourceGraph был импортирован явным образом в этом случае: Import-Module Az.ResourceGraph
Примеры
Пример 1. Получение проверок для локального экземпляра по умолчанию
PS:> Get-SqlInstance -ServerInstance 'localhost' | Get-SqlAssessmentItem
Target: [LOCAL]
ID ON Name Origin
-- -- ---- ------
TF1204 True TF 1204 returns deadlock information Microsoft Ruleset 0.1.202
BlackboxTrace True Blackbox trace is configured and running Microsoft Ruleset 0.1.202
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth True Some TempDB data files have different... Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
...
В этом примере возвращаются все проверки, доступные для экземпляра по умолчанию SQL Server, запущенного на текущем компьютере.
Пример 2. Получение проверок с помощью командлета Get-Item
PS:> Get-Item SQLSERVER:\SQL\localhost\default | Get-SqlAssessmentItem
Target: [LOCAL]
ID ON Name Origin
-- -- ---- ------
TF1204 True TF 1204 returns deadlock information Microsoft Ruleset 0.1.202
BlackboxTrace True Blackbox trace is configured and running Microsoft Ruleset 0.1.202
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth True Some TempDB data files have different... Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
...
В этом примере возвращаются все проверки, доступные для экземпляра по умолчанию SQL Server, запущенного на текущем компьютере.
Пример 3. Получение проверок с путем к целевому объекту
PS:> Get-SqlAssessmentItem SQLSERVER:\SQL\localhost\default
Target: [LOCAL]
ID ON Name Origin
-- -- ---- ------
TF1204 True TF 1204 returns deadlock information Microsoft Ruleset 0.1.202
BlackboxTrace True Blackbox trace is configured and running Microsoft Ruleset 0.1.202
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth True Some TempDB data files have different... Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
...
В этом примере возвращаются все проверки, доступные для экземпляра по умолчанию SQL Server, запущенного на текущем компьютере.
Пример 4. Получение проверок с применением пользовательской конфигурации
PS:> Get-SqlDatabase master -ServerInstance . |
Get-SqlAssessmentItem -Configuration C:\rulesetA.json, D:\rulesetB.json
Target: [LOCAL]
ID ON Name Origin
-- -- ---- ------
TF1204 False TF 1204 returns deadlock information Microsoft Ruleset 0.1.202
BlackboxTrace True Blackbox trace is configured and running Microsoft Ruleset 0.1.202
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth False Some TempDB data files have different... Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
SomeCustomCheck True Some custom check Ruleset A 1.0
AnotherCustomCheck True Another custom check Ruleset B 1.0
...
В этом примере возвращаются все доступные проверки с примененной пользовательской конфигурацией, полученной из указанных JSON-файлов. Сведения о настройке см. в папке примеров оценки SQL на сайте GitHub.
Пример 5. Получение проверок для всех экземпляров на localhost
PS:> Get-SqlInstance -ServerInstance localhost | Get-SqlAssessmentItem
Target: [LOCAL]
ID ON Name Origin
-- -- ---- ------
TF1204 True TF 1204 returns deadlock information Microsoft Ruleset 0.1.202
BlackboxTrace True Blackbox trace is configured and running Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
Target: [LOCAL\INSTANCE1]
ID ON Name Origin
-- -- ---- ------
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth True Some TempDB data files have different... Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
...
В этом примере показано, как командлет Get-SqlAssessmentItem принимает набор экземпляров SQL Server через конвейер.
Пример 6. Получение проверок для всех экземпляров с именами, заканчивающиеся числами
PS:> Get-SqlInstance -ServerInstance localhost | Where { $_.Name -Match '.*\d+' } | Get-SqlAssessmentItem
Target: [LOCAL\INSTANCE1]
ID ON Name Origin
-- -- ---- ------
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth True Some TempDB data files have different... Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
...
В этом примере показано, как командлет Get-SqlAssessmentItem принимает набор экземпляров SQL Server через конвейер. Обрабатываются только экземпляры, имя которых заканчивается цифрами.
Пример 7. Получение проверок для базы данных по пути
PS:> Get-SqlAssessmentItem SQLSERVER:\SQL\localhost\default\Databases\master
TargetObject: [master]
ID ON Name Origin
-- -- ---- ------
AutoCreateStats True Auto-Create Statistics should be on Microsoft Ruleset 0.1.202
HintsUsageInModules False Hints usage in modules Microsoft Ruleset 0.1.202
FullBackup True Full backup is missed or outdated Microsoft Ruleset 0.1.202
DuplicateIndexes True Duplicate Indexes Microsoft Ruleset 0.1.202
RedundantIndexes True Redundant Indexes Microsoft Ruleset 0.1.202
...
В этом примере показано, как командлет Get-SqlAssessmentItem принимает путь к базе данных SQL Server.
Пример 8. Получение проверок высокого уровня серьезности для базы данных
PS:> cd SQLSERVER:\SQL\localhost\default\Databases\master
PS:> Get-SqlAssessmentItem -MinSeverity High
В этом примере показано, как get-SqlAssessmentItem возвращает доступные проверки с высоким уровнем серьезности для базы данных master. Он принимает текущее расположение поставщика PowerShell в качестве целевого объекта.
Пример 9. Получение проверок высокого уровня серьезности для базы данных
PS:> $db = Get-SqlDatabase master -ServerInstance localhost
PS:> Get-SqlAssessmentItem $db -MinSeverity High
В этом примере показано, как get-SqlAssessmentItem возвращает доступные проверки с высоким уровнем серьезности для базы данных master.
Пример 10. Получение проверок по тегу
PS:> Get-SqlDatabase -ServerInstance . | Get-SqlAssessmentItem -Check Backup
TargetObject: [master]
ID ON Name Origin
-- -- ---- ------
FullBackup True Full backup is missed or outdated Microsoft Ruleset 0.1.202
TargetObject: [msdb]
ID ON Name Origin
-- -- ---- ------
FullBackup True Full backup is missed or outdated Microsoft Ruleset 0.1.202
В этом примере показан командлет Get-SqlAssessmentItem, возвращающий все проверки, связанные с резервным копированием, для всех баз данных в локальном экземпляре SQL Server по умолчанию.
Пример 11. Запуск интерактивных проверок
PS:> $serverInstance = Get-SqlInstance -ServerInstance '(local)'
PS:> $checks = Get-SqlAssessmentItem $serverInstance | Select Id, Description | Out-GridView -PassThru
PS:> Invoke-SqlAssessment $serverInstance -Check $checks
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Во второй строке этого примера показано, как получить проверки для $serverInstance и выбрать некоторые из них в интерактивном режиме. Выбранные элементы хранятся в переменной массива, которую затем можно использовать в качестве входных данных для командлета Invoke-SqlAssessment . В этом случае в процессе оценки будут выполняться только выбранные проверки.
Пример 12. Явное указание учетных данных
PS> $cred = Get-Credential
PowerShell credential request
Enter your credentials.
User: Administrator
Password for user Administrator: ********
PS> $db = Get-SqlDatabase master -ServerInstance 10.0.3.118 -Credential $cred
PS> Get-SqlAssessmentItem $db
TargetObject: [master]
ID ON Name Origin
-- -- ---- ------
AutoCreateStats True Auto-Create Statistics should be on Microsoft Ruleset 0.1.202
FullBackup True Full backup is missed or outdated Microsoft Ruleset 0.1.202
DuplicateIndexes True Duplicate Indexes Microsoft Ruleset 0.1.202
RedundantIndexes True Redundant Indexes Microsoft Ruleset 0.1.202
...
В этом примере показано, как получить список проверка оценки SQL с явно указанными учетными данными.
Пример 13. Получение списка правил оценки SQL для SQL Server на экземпляре виртуальной машины Azure
PS> Connect-AzAccount
PS> Set-Subscription My-Pay-As-You-Go
PS> $cred = Get-Credential
PowerShell credential request
Enter your credentials.
User: Administrator
Password for user Administrator: ********
PS> $inst = Get-SqlInstance -ServerInstance 10.0.3.118 -Credential $cred
PS> Get-SqlAssessmentItem $inst
TargetObject: [ContosoAzureSql]
ID ON Name Origin
-- -- ---- ------
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth True Some TempDB data files have different... Microsoft Ruleset 0.1.202
AzSqlVmSize True VM size is not memory-optimized Microsoft Ruleset 0.1.202
...
В этом примере показано, как получить список правил, применимых к определенному SQL Server на экземпляре виртуальной машины Azure.
Активное подключение к подписке Azure позволяет выполнять проверки, связанные с Azure (в этом примере — AzSqlVmSize). Первая строка подключается к учетной записи Azure для получения данных из azure Resource Graph. Вторая строка является необязательной.
Для выполнения этих проверок для оценки SQL требуется модуль Az.ResourceGraph.
Параметры
-Check
Одна или несколько проверок, идентификаторов проверка или тегов.
Для каждого объекта проверка get-SqlAssessmentItem возвращает этот проверка, если он поддерживает входной объект.
Для каждого идентификатора проверка Get-SqlAssessmentItem возвращает соответствующий проверка, если он поддерживает входной объект.
Для тегов Get-SqlAssessmentItem возвращает проверки с любым из этих тегов.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Configuration
Указывает пути к файлам, содержащим настраиваемую конфигурацию. Файлы настройки будут применяться к конфигурации по умолчанию в указанном порядке. Область ограничен только вызовом этого командлета.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FlattenOutput
Указывает, что этот командлет создает простые объекты типа Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNoteFlat вместо Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNote.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Указывает SQL Server объект или путь к такому объекту. Командлет возвращает соответствующие проверки для этого объекта. Если этот параметр опущен, в качестве входного объекта используется текущее расположение. Если текущее расположение не является поддерживаемым объектом SQL Server, командлет сообщает об ошибке.
Type: | PSObject |
Aliases: | Target |
Position: | 10 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MinSeverity
Указывает минимальный уровень серьезности для найденных проверок. Например, проверки средних, низких или информационных уровней не будут возвращены при значении -MinSeverity High.
Type: | SeverityLevel |
Aliases: | Severity |
Accepted values: | Information, Low, Medium, High |
Position: | Named |
Default value: | Information |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
System.String[]
Microsoft.SqlServer.Management.Smo.SqlSmoObject[]
Выходные данные
Microsoft.SqlServer.Management.Assessment.ICheck