Server Advisors - Update

Ссылка

Служба:: SQL Database

Версия API:: 2021-11-01

Обновления помощника по серверу.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/advisors/{advisorName}?api-version=2021-11-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
advisorName	path	True	string	Имя помощника по серверу.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
serverName	path	True	string	Имя сервера.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.

Текст запроса

Имя	Обязательно	Тип	Описание
properties.autoExecuteStatus	True	AutoExecuteStatus	Возвращает состояние автоматического выполнения (следует ли разрешить системе выполнять рекомендации) этого помощника. Возможные значения: Enabled и Disabled.

Ответы

Имя	Тип	Описание
200 OK	Advisor	Указанный помощник сервера успешно обновлен.
Other Status Codes		Ответы на ошибки: *** 400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных. 400 InvalidIdentifier — идентификатор содержит значение NULL или недопустимый символ Юникода. 400 DataWarehouseNotSupported — автоматическая настройка не поддерживается для Data Warehouse SQL. 400 InvalidAdvisorUpsertRequest — текст запроса помощника по обновлению не существует или не имеет объекта свойств. 400 InvalidAdvisorAutoExecuteStatus — указанное состояние автоматического выполнения для помощника не разрешено. 404 DatabaseDoesNotExist — запрошенная база данных не найдена 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 SubscriptionDoesNotHaveElasticPool — запрошенный эластичный пул не найден 404 AdvisorNotFound — запрошенный помощник не найден. 404 AutomaticTuningOptionNotFound — запрошенный параметр автоматической настройки не найден. 405 NotSupported — эта функция не поддерживается. 409 Conflict — не удалось обработать запрос из-за конфликта в запросе. 409 DefaultAdvisorStateNotAllowedInCustomServerMode — состояние помощника DEFAULT не разрешено в пользовательском режиме 409 UpdateNotAllowedIfServerAutotuningUpdateOperationInProgress — параметры автоматической настройки из предыдущего запроса не распространяются на все пользовательские базы данных. 503 ServiceTemporarilyUnavailable — функция временно недоступна.

Имя

Тип

Описание

200 OK

Advisor

Указанный помощник сервера успешно обновлен.

Other Status Codes

Ответы на ошибки: ***

400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных.
400 InvalidIdentifier — идентификатор содержит значение NULL или недопустимый символ Юникода.
400 DataWarehouseNotSupported — автоматическая настройка не поддерживается для Data Warehouse SQL.
400 InvalidAdvisorUpsertRequest — текст запроса помощника по обновлению не существует или не имеет объекта свойств.
400 InvalidAdvisorAutoExecuteStatus — указанное состояние автоматического выполнения для помощника не разрешено.
404 DatabaseDoesNotExist — запрошенная база данных не найдена
404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден
404 SubscriptionDoesNotHaveElasticPool — запрошенный эластичный пул не найден
404 AdvisorNotFound — запрошенный помощник не найден.
404 AutomaticTuningOptionNotFound — запрошенный параметр автоматической настройки не найден.
405 NotSupported — эта функция не поддерживается.
409 Conflict — не удалось обработать запрос из-за конфликта в запросе.
409 DefaultAdvisorStateNotAllowedInCustomServerMode — состояние помощника DEFAULT не разрешено в пользовательском режиме
409 UpdateNotAllowedIfServerAutotuningUpdateOperationInProgress — параметры автоматической настройки из предыдущего запроса не распространяются на все пользовательские базы данных.
503 ServiceTemporarilyUnavailable — функция временно недоступна.

Примеры

Update server advisor

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/advisors/CreateIndex?api-version=2021-11-01

{
  "properties": {
    "autoExecuteStatus": "Disabled"
  }
}


import com.azure.resourcemanager.sql.fluent.models.AdvisorInner;
import com.azure.resourcemanager.sql.models.AutoExecuteStatus;

/**
 * Samples for ServerAdvisors Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerAdvisorUpdate.json
     */
    /**
     * Sample code: Update server advisor.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateServerAdvisor(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAdvisors().updateWithResponse("workloadinsight-demos",
            "misosisvr", "CreateIndex", new AdvisorInner().withAutoExecuteStatus(AutoExecuteStatus.DISABLED),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Пример ответа

Код состояния:: 200

{
  "kind": "",
  "properties": {
    "advisorStatus": "GA",
    "autoExecuteStatus": "Disabled",
    "autoExecuteStatusInheritedFrom": "Server"
  },
  "location": "East Asia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/advisors/CreateIndex",
  "name": "CreateIndex",
  "type": "Microsoft.Sql/servers/advisors"
}

Определения

Имя	Описание
Advisor	Помощник по базам данных, серверам или эластичным пулам.
AdvisorStatus	Возвращает состояние доступности этого помощника для клиентов. Возможные значения: GA, PublicPreview, LimitedPublicPreview и PrivatePreview.
AutoExecuteStatus	Возвращает состояние автоматического выполнения (следует ли разрешить системе выполнять рекомендации) этого помощника. Возможные значения: Enabled и Disabled.
AutoExecuteStatusInheritedFrom	Возвращает ресурс, от которого наследуется текущее значение состояния автоматического выполнения. Состояние автоматического выполнения можно задать на разных уровнях иерархии ресурсов (и наследовать от нее). Возможные значения: Subscription, Server, ElasticPool, Database и Default (если состояние не задано явным образом на любом уровне).
ImplementationMethod	Возвращает метод, в котором это рекомендуемое действие можно реализовать вручную. Например, TSql, AzurePowerShell.
IsRetryable	Возвращает значение, указывающее, можно ли игнорировать ошибку и можно ли повторно выполнить рекомендуемое действие. Возможные значения: Да/Нет
RecommendedAction	Рекомендуемое действие базы данных, сервера или эластичного пула.
RecommendedActionCurrentState	Текущее состояние, в которое находится рекомендуемое действие. Некоторые часто используемые состояния: Активный —> рекомендуемое действие активно и действие еще не выполнено. Ожидание —> рекомендуемое действие утверждено для и ожидает выполнения. Выполнение —> рекомендуемое действие применяется к пользовательской базе данных. Проверка —> рекомендуемое действие было применено и проверяется системой на его полезность. Успешно —> было применено рекомендуемое действие, а во время проверки обнаружено улучшение. Ожидание возврата —> проверка не обнаружила практически никаких улучшений, поэтому рекомендуемое действие помещается в очередь для отменить изменения или пользователь был возвращен вручную. Возврат —> изменения, внесенные при применении рекомендуемого действия, отменяются в пользовательской базе данных. Возвращено —> успешно отменены изменения, внесенные рекомендуемым действием для пользовательской базы данных. Игнорируется —> пользователь явно проигнорировал или отбросил рекомендуемое действие.
RecommendedActionErrorInfo	Содержит сведения об ошибке для рекомендуемого действия базы данных Azure SQL, сервера или эластичного пула.
RecommendedActionImpactRecord	Содержит сведения о предполагаемом или наблюдаемом влиянии на различные метрики для рекомендуемого действия базы данных Azure SQL, сервера или эластичного пула.
RecommendedActionImplementationInfo	Содержит сведения о реализации вручную для рекомендуемого действия базы данных Azure SQL, сервера или эластичного пула.
RecommendedActionInitiatedBy	Возвращает , кто инициировал выполнение этого рекомендуемого действия. Возможные значения: Пользователь —> когда пользователь явно уведомил систему о применении рекомендуемого действия. Система —> состояние автоматического выполнения этого помощника было установлено как "Включено", и в этом случае система применила его.
RecommendedActionMetricInfo	Содержит временные ряды различных затронутых метрик для рекомендуемого действия Azure SQL базы данных, сервера или эластичного пула.
RecommendedActionStateInfo	Содержит сведения о текущем состоянии для рекомендуемого действия базы данных Azure SQL, сервера или эластичного пула.

Advisor

Помощник по базам данных, серверам или эластичным пулам.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
kind	string	Тип ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.advisorStatus	AdvisorStatus	Возвращает состояние доступности этого помощника для клиентов. Возможные значения: GA, PublicPreview, LimitedPublicPreview и PrivatePreview.
properties.autoExecuteStatus	AutoExecuteStatus	Возвращает состояние автоматического выполнения (указывает, следует ли разрешить системе выполнять рекомендации) этого помощника. Возможные значения: Enabled и Disabled.
properties.autoExecuteStatusInheritedFrom	AutoExecuteStatusInheritedFrom	Возвращает ресурс, от которого наследуется текущее значение состояния автоматического выполнения. Состояние автоматического выполнения можно задать на разных уровнях иерархии ресурсов и наследовать от нее. Возможные значения: Subscription, Server, ElasticPool, Database и Default (если состояние не задано явным образом ни на одном уровне).
properties.lastChecked	string	Возвращает время, когда текущий ресурс был проанализирован для получения рекомендаций этим помощником.
properties.recommendationsStatus	string	Возвращает состояние рекомендаций для этого помощника и причину, по которой рекомендации отсутствуют. Возможные значения: "ОК" (доступные рекомендации), LowActivity (недостаточно рабочей нагрузки для анализа), DbSeemsTuned (база данных работает хорошо) и т. д.
properties.recommendedActions	RecommendedAction[]	Возвращает рекомендуемые действия для этого помощника.
type	string	Тип ресурса.

AdvisorStatus

Возвращает состояние доступности этого помощника для клиентов. Возможные значения: GA, PublicPreview, LimitedPublicPreview и PrivatePreview.

Имя	Тип	Описание
GA	string
LimitedPublicPreview	string
PrivatePreview	string
PublicPreview	string

AutoExecuteStatus

Возвращает состояние автоматического выполнения (следует ли разрешить системе выполнять рекомендации) этого помощника. Возможные значения: Enabled и Disabled.

Имя	Тип	Описание
Default	string
Disabled	string
Enabled	string

AutoExecuteStatusInheritedFrom

Возвращает ресурс, от которого наследуется текущее значение состояния автоматического выполнения. Состояние автоматического выполнения можно задать на разных уровнях иерархии ресурсов (и наследовать от нее). Возможные значения: Subscription, Server, ElasticPool, Database и Default (если состояние не задано явным образом на любом уровне).

Имя	Тип	Описание
Database	string
Default	string
ElasticPool	string
Server	string
Subscription	string

ImplementationMethod

Возвращает метод, в котором это рекомендуемое действие можно реализовать вручную. Например, TSql, AzurePowerShell.

Имя	Тип	Описание
AzurePowerShell	string
TSql	string

IsRetryable

Возвращает значение, указывающее, можно ли игнорировать ошибку и можно ли повторно выполнить рекомендуемое действие. Возможные значения: Да/Нет

Имя	Тип	Описание
No	string
Yes	string

RecommendedAction

Рекомендуемое действие базы данных, сервера или эластичного пула.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
kind	string	Тип ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.details	object	Возвращает дополнительные сведения, относящиеся к этому рекомендуемом действию.
properties.errorDetails	RecommendedActionErrorInfo	Возвращает сведения об ошибке, если и почему это рекомендуемое действие переводится в состояние ошибки.
properties.estimatedImpact	RecommendedActionImpactRecord[]	Возвращает сведения о предполагаемом влиянии для этого рекомендуемого действия, например предполагаемое увеличение загрузки ЦП, предполагаемое изменение места на диске.
properties.executeActionDuration	string	Возвращает время, затраченное на применение этого рекомендуемого действия к ресурсу пользователя. Например, время, затраченного на создание индекса
properties.executeActionInitiatedBy	RecommendedActionInitiatedBy	Возвращает значение , если пользователь или система предоставили разрешение на применение этого рекомендуемого действия.
properties.executeActionInitiatedTime	string	Возвращает время, когда это рекомендуемое действие было утверждено для выполнения.
properties.executeActionStartTime	string	Возвращает время, когда система начала применять это рекомендуемое действие к ресурсу пользователя. Например, время начала создания индекса
properties.implementationDetails	RecommendedActionImplementationInfo	Возвращает сведения о реализации этого рекомендуемого действия, чтобы пользователь применил его вручную.
properties.isArchivedAction	boolean	Возвращает значение , если это рекомендуемое действие было предложено некоторое время назад, но пользователь решил проигнорировать это действие и система снова добавила новое рекомендуемое действие.
properties.isExecutableAction	boolean	Возвращает значение, если это рекомендуемое действие является допустимым для пользователя.
properties.isRevertableAction	boolean	Возвращает значение , если изменения, примененные этим рекомендуемым действием, могут быть отменены пользователем.
properties.lastRefresh	string	Возвращает время последнего обновления рекомендуемого действия.
properties.linkedObjects	string[]	Возвращает связанные объекты , если таковые есть.
properties.observedImpact	RecommendedActionImpactRecord[]	Возвращает сведения о наблюдаемом или фактическом влиянии для этого рекомендуемого действия, например фактическое увеличение загрузки ЦП, фактическое изменение места на диске.
properties.recommendationReason	string	Возвращает причину для рекомендации этого действия. Например, DuplicateIndex
properties.revertActionDuration	string	Возвращает время, затраченное на отмену изменений этого рекомендуемого действия в ресурсе пользователя. Например, время, затраченного на удаление созданного индекса.
properties.revertActionInitiatedBy	RecommendedActionInitiatedBy	Возвращает значение , если утверждение для отмены этого рекомендуемого действия было дано пользователем или системой.
properties.revertActionInitiatedTime	string	Возвращает время, когда это рекомендуемое действие было утверждено для отменить изменения.
properties.revertActionStartTime	string	Возвращает время, когда система начала отменять изменения этого рекомендуемого действия в пользовательском ресурсе. Например, время, когда выполняется удаление индекса.
properties.score	integer	Возвращает влияние этого рекомендуемого действия. Возможные значения: 1 — низкое влияние, 2 — среднее воздействие и 3 — высокое влияние.
properties.state	RecommendedActionStateInfo	Возвращает сведения о текущем состоянии рекомендуемого действия.
properties.timeSeries	RecommendedActionMetricInfo[]	Возвращает сведения о временных рядах метрик для этого рекомендуемого действия, например временных рядов потребления ЦП.
properties.validSince	string	Возвращает время с момента, когда это рекомендуемое действие является допустимым.
type	string	Тип ресурса.

RecommendedActionCurrentState

Текущее состояние, в которое находится рекомендуемое действие. Некоторые часто используемые состояния: Активный —> рекомендуемое действие активно и действие еще не выполнено. Ожидание —> рекомендуемое действие утверждено для и ожидает выполнения. Выполнение —> рекомендуемое действие применяется к пользовательской базе данных. Проверка —> рекомендуемое действие было применено и проверяется системой на его полезность. Успешно —> было применено рекомендуемое действие, а во время проверки обнаружено улучшение. Ожидание возврата —> проверка не обнаружила практически никаких улучшений, поэтому рекомендуемое действие помещается в очередь для отменить изменения или пользователь был возвращен вручную. Возврат —> изменения, внесенные при применении рекомендуемого действия, отменяются в пользовательской базе данных. Возвращено —> успешно отменены изменения, внесенные рекомендуемым действием для пользовательской базы данных. Игнорируется —> пользователь явно проигнорировал или отбросил рекомендуемое действие.

Имя	Тип	Описание
Active	string
Error	string
Executing	string
Expired	string
Ignored	string
Monitoring	string
Pending	string
PendingRevert	string
Resolved	string
RevertCancelled	string
Reverted	string
Reverting	string
Success	string
Verifying	string

RecommendedActionErrorInfo

Содержит сведения об ошибке для рекомендуемого действия базы данных Azure SQL, сервера или эластичного пула.

Имя	Тип	Описание
errorCode	string	Возвращает причину, по которой рекомендуемое действие было помещено в состояние ошибки. Например, DatabaseHasQdsOff, IndexAlreadyExists
isRetryable	IsRetryable	Возвращает значение, указывающее, можно ли игнорировать ошибку и можно ли повторить рекомендуемое действие. Возможные значения: Да или Нет.

RecommendedActionImpactRecord

Содержит сведения о предполагаемом или наблюдаемом влиянии на различные метрики для рекомендуемого действия базы данных Azure SQL, сервера или эластичного пула.

Имя	Тип	Описание
absoluteValue	number	Возвращает абсолютное значение этого измерения, если применимо. Например, число затронутых запросов
changeValueAbsolute	number	Возвращает абсолютное изменение значения этого измерения. Например, абсолютное изменение места на диске в мегабайтах
changeValueRelative	number	Возвращает относительное изменение значения этого измерения. Например, изменение относительного места на диске в процентах
dimensionName	string	Возвращает имя измерения влияния. Например, CPUChange, DiskSpaceChange, NumberOfQueriesAffected.
unit	string	Возвращает имя измерения влияния. Например, CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

RecommendedActionImplementationInfo

Содержит сведения о реализации вручную для рекомендуемого действия базы данных Azure SQL, сервера или эластичного пула.

Имя	Тип	Описание
method	ImplementationMethod	Возвращает метод, в котором это рекомендуемое действие можно реализовать вручную. Например, TSql, AzurePowerShell.
script	string	Возвращает скрипт реализации вручную. Например, скрипт T-SQL, который может выполняться в базе данных.

RecommendedActionInitiatedBy

Возвращает , кто инициировал выполнение этого рекомендуемого действия. Возможные значения: Пользователь —> когда пользователь явно уведомил систему о применении рекомендуемого действия. Система —> состояние автоматического выполнения этого помощника было установлено как "Включено", и в этом случае система применила его.

Имя	Тип	Описание
System	string
User	string

RecommendedActionMetricInfo

Содержит временные ряды различных затронутых метрик для рекомендуемого действия Azure SQL базы данных, сервера или эластичного пула.

Имя	Тип	Описание
metricName	string	Возвращает имя метрики. Например, ЦП, количество запросов.
startTime	string	Возвращает время начала интервала времени, заданного данным MetricInfo.
timeGrain	string	Возвращает длительность интервала времени для значения, заданного данным MetricInfo. Например, PT1H (1 час)
unit	string	Возвращает единицу измерения метрики. Например, DTU, Frequency
value	number	Возвращает значение метрики в интервале времени, заданном этой MetricInfo.

RecommendedActionStateInfo

Содержит сведения о текущем состоянии для рекомендуемого действия базы данных Azure SQL, сервера или эластичного пула.

Имя	Тип	Описание
actionInitiatedBy	RecommendedActionInitiatedBy	Возвращает , кто инициировал выполнение этого рекомендуемого действия. Возможные значения: Пользователь —> когда пользователь явно уведомил систему о применении рекомендуемого действия. Система —> состояние автоматического выполнения этого помощника было установлено как "Включено", и в этом случае система применила его.
currentValue	RecommendedActionCurrentState	Текущее состояние рекомендуемого действия. Некоторые часто используемые состояния: Активный —> рекомендуемое действие активно и еще не выполнено никаких действий. Ожидание —> рекомендуемое действие утверждено для и ожидает выполнения. Выполнение —> к пользовательской базе данных применяется рекомендуемое действие. Проверка —> было применено рекомендуемое действие, и система проверяет его полезность. Успешно —> во время проверки было применено рекомендуемое действие, а во время проверки обнаружено улучшение. Ожидание отмены —> проверка не нашла никаких улучшений, поэтому рекомендуемое действие помещается в очередь для отменить изменения или пользователь был отменен вручную. Восстановление — изменения,> внесенные при применении рекомендуемого действия, восстанавливаются в пользовательской базе данных. Reverted —> успешно отменены изменения, внесенные рекомендуемым действием в пользовательской базе данных. Игнорируется —> пользователь явно игнорирует или отменяет рекомендуемое действие.
lastModified	string	Возвращает время последнего изменения состояния.

Поделиться через

Server Advisors - Update

Параметры URI

Текст запроса

Ответы

Примеры

Update server advisor

Образец запроса

Пример ответа

Определения

Advisor

AdvisorStatus

AutoExecuteStatus

AutoExecuteStatusInheritedFrom

ImplementationMethod

IsRetryable

RecommendedAction

RecommendedActionCurrentState

RecommendedActionErrorInfo

RecommendedActionImpactRecord

RecommendedActionImplementationInfo

RecommendedActionInitiatedBy

RecommendedActionMetricInfo

RecommendedActionStateInfo

Дополнительные ресурсы