Database Advisors - Update

Actualiza un asesor de bases de datos.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
advisorName
path True

string

Nombre del Asistente para bases de datos.

databaseName
path True

string

El nombre de la base de datos.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

serverName
path True

string

El nombre del servidor.

subscriptionId
path True

string (uuid)

Identificador de la suscripción de destino. El valor debe ser un UUID.

api-version
query True

string

minLength: 1

Versión de API que se usará para esta operación.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
properties.autoExecuteStatus True

AutoExecuteStatus

Obtiene el estado de ejecución automática (si se permite que el sistema ejecute las recomendaciones) de este asesor. Los valores posibles son "Enabled" y "Disabled"

Respuestas

Nombre Tipo Description
200 OK

Advisor

Operación de Azure completada con éxito.

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

Update database advisor

Solicitud de ejemplo

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

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

Respuesta de muestra

{
  "name": "CreateIndex",
  "type": "Microsoft.Sql/servers/databases/advisors",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex",
  "properties": {
    "advisorStatus": "GA",
    "autoExecuteStatus": "Disabled",
    "lastChecked": "2017-06-20T00:24:39Z",
    "recommendationsStatus": "Ok"
  }
}

Definiciones

Nombre Description
Advisor

Database, Server o Elastic Pool Advisor.

AdvisorStatus

Obtiene el estado de disponibilidad de este asesor para los clientes. Los valores posibles son "GA", "PublicPreview", "LimitedPublicPreview" y "PrivatePreview".

AutoExecuteStatus

Obtiene el estado de ejecución automática (si se permite que el sistema ejecute las recomendaciones) de este asesor. Los valores posibles son "Enabled" y "Disabled"

AutoExecuteStatusInheritedFrom

Obtiene el recurso del que se hereda el valor actual del estado de ejecución automática. El estado de ejecución automática se puede establecer en (y heredar de) distintos niveles de la jerarquía de recursos. Los valores posibles son "Subscription", "Server", "ElasticPool", "Database" y "Default" (cuando el estado no se establece explícitamente en ningún nivel).

createdByType

Tipo de identidad que creó el recurso.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

ImplementationMethod

Obtiene el método en el que se puede implementar manualmente esta acción recomendada. Por ejemplo, TSql, AzurePowerShell.

IsRetryable

Obtiene si se puede omitir el error y se podría reintentar la acción recomendada. Los valores posibles son: Sí/No

RecommendedAction

Acción recomendada de base de datos, servidor o grupo elástico.

RecommendedActionCurrentState

Estado actual en el que se encuentra la acción recomendada. Algunos estados usados habitualmente son: Activo:> acción recomendada está activa y aún no se ha realizado ninguna acción. Pendiente:> acción recomendada se aprueba y está esperando la ejecución. Ejecución:> acción recomendada se aplica en la base de datos de usuario. Comprobación:> acción recomendada se aplicó y se comprueba su utilidad por parte del sistema. Correcto:> acción recomendada se aplicó y se encontró una mejora durante la comprobación. Reversión pendiente:> comprobación encontró poca o ninguna mejora, por lo que la acción recomendada se pone en cola para revertir o el usuario se ha revertido manualmente. Reversión:> cambios realizados mientras se aplica la acción recomendada se revierte en la base de datos de usuario. Revertida:> revierte correctamente los cambios realizados por la acción recomendada en la base de datos de usuario. Omitido:> usuario omite o descarta explícitamente la acción recomendada.

RecommendedActionErrorInfo

Contiene información de error para una acción recomendada de Azure SQL Database, Server o Elastic Pool.

RecommendedActionImpactRecord

Contiene información sobre el impacto estimado u observado en diversas métricas para una Acción Recomendada de Azure SQL Database, Server o Elastic Pool.

RecommendedActionImplementationInfo

Contiene información para la implementación manual de una acción recomendada de Azure SQL Database, Server o Elastic Pool.

RecommendedActionInitiatedBy

Obtiene si el usuario o el sistema han proporcionado la aprobación para aplicar esta acción recomendada.

RecommendedActionMetricInfo

Contiene series temporales de varias métricas afectadas para una Acción Recomendada de Azure SQL Database, Server o Elastic Pool.

RecommendedActionStateInfo

Contiene información del estado actual para una acción recomendada de Azure SQL Database, Server o Elastic Pool.

systemData

Metadatos relativos a la creación y última modificación del recurso.

Advisor

Database, Server o Elastic Pool Advisor.

Nombre Tipo Description
id

string (arm-id)

Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

kind

string

Tipo de recurso.

location

string

Ubicación del recurso.

name

string

Nombre del recurso

properties.advisorStatus

AdvisorStatus

Obtiene el estado de disponibilidad de este asesor para los clientes. Los valores posibles son "GA", "PublicPreview", "LimitedPublicPreview" y "PrivatePreview".

properties.autoExecuteStatus

AutoExecuteStatus

Obtiene el estado de ejecución automática (si se permite que el sistema ejecute las recomendaciones) de este asesor. Los valores posibles son "Enabled" y "Disabled"

properties.autoExecuteStatusInheritedFrom

AutoExecuteStatusInheritedFrom

Obtiene el recurso del que se hereda el valor actual del estado de ejecución automática. El estado de ejecución automática se puede establecer en (y heredar de) distintos niveles de la jerarquía de recursos. Los valores posibles son "Subscription", "Server", "ElasticPool", "Database" y "Default" (cuando el estado no se establece explícitamente en ningún nivel).

properties.lastChecked

string (date-time)

Obtiene la hora en que este asesor analizó el recurso actual para obtener recomendaciones.

properties.recommendationsStatus

string

Obtiene el estado de las recomendaciones de este asesor y el motivo de no tener ninguna recomendación. Entre los valores posibles se incluyen, entre otros, "Ok" (Recomendaciones disponibles),LowActivity (no suficiente carga de trabajo para analizar), "DbSeemsTuned" (la base de datos está funcionando bien), etc.

properties.recommendedActions

RecommendedAction[]

Obtiene las acciones recomendadas para este asesor.

systemData

systemData

Azure Resource Manager metadatos que contienen información createdBy y modifiedBy.

type

string

Tipo de recurso. Por ejemplo, "Microsoft. Compute/virtualMachines" o "Microsoft. CuentasAlmacenamiento/Almacenamiento"

AdvisorStatus

Obtiene el estado de disponibilidad de este asesor para los clientes. Los valores posibles son "GA", "PublicPreview", "LimitedPublicPreview" y "PrivatePreview".

Valor Description
GA

GA

PublicPreview

PublicPreview

LimitedPublicPreview

LimitedPublicPreview

PrivatePreview

PrivatePreview

AutoExecuteStatus

Obtiene el estado de ejecución automática (si se permite que el sistema ejecute las recomendaciones) de este asesor. Los valores posibles son "Enabled" y "Disabled"

Valor Description
Enabled

Habilitado

Disabled

Deshabilitado

Default

Predeterminado

AutoExecuteStatusInheritedFrom

Obtiene el recurso del que se hereda el valor actual del estado de ejecución automática. El estado de ejecución automática se puede establecer en (y heredar de) distintos niveles de la jerarquía de recursos. Los valores posibles son "Subscription", "Server", "ElasticPool", "Database" y "Default" (cuando el estado no se establece explícitamente en ningún nivel).

Valor Description
Default

Predeterminado

Subscription

Subscription

Server

Servidor

ElasticPool

Piscina elástica

Database

Base de datos

createdByType

Tipo de identidad que creó el recurso.

Valor Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ImplementationMethod

Obtiene el método en el que se puede implementar manualmente esta acción recomendada. Por ejemplo, TSql, AzurePowerShell.

Valor Description
TSql

TSql

AzurePowerShell

AzurePowerShell

IsRetryable

Obtiene si se puede omitir el error y se podría reintentar la acción recomendada. Los valores posibles son: Sí/No

Valor Description
Yes

Sí

No

No

RecommendedAction

Acción recomendada de base de datos, servidor o grupo elástico.

Nombre Tipo Description
id

string (arm-id)

Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

kind

string

Tipo de recurso.

location

string

Ubicación del recurso.

name

string

Nombre del recurso

properties.details

object

Obtiene detalles adicionales específicos de esta acción recomendada.

properties.errorDetails

RecommendedActionErrorInfo

Obtiene los detalles del error si y por qué esta acción recomendada se coloca en estado de error.

properties.estimatedImpact

RecommendedActionImpactRecord[]

Obtiene la información de impacto estimada para esta acción recomendada, por ejemplo, Ganancia estimada de CPU, Cambio estimado del espacio en disco.

properties.executeActionDuration

string (duration)

Obtiene el tiempo necesario para aplicar esta acción recomendada en el recurso de usuario. Por ejemplo, tiempo necesario para la creación de índices

properties.executeActionInitiatedBy

RecommendedActionInitiatedBy

Obtiene si el usuario o el sistema han proporcionado la aprobación para aplicar esta acción recomendada.

properties.executeActionInitiatedTime

string (date-time)

Obtiene la hora en que se aprobó esta acción recomendada para su ejecución.

properties.executeActionStartTime

string (date-time)

Obtiene la hora en que el sistema comenzó a aplicar esta acción recomendada en el recurso de usuario. Por ejemplo, hora de inicio de creación de índices

properties.implementationDetails

RecommendedActionImplementationInfo

Obtiene los detalles de implementación de esta acción recomendada para que el usuario la aplique manualmente.

properties.isArchivedAction

boolean

Obtiene si esta acción recomendada se sugirió hace algún tiempo, pero el usuario eligió omitir esto y el sistema agregó una nueva acción recomendada de nuevo.

properties.isExecutableAction

boolean

Obtiene si el usuario puede realizar esta acción recomendada

properties.isRevertableAction

boolean

Obtiene si el usuario puede revertir los cambios aplicados por esta acción recomendada.

properties.lastRefresh

string (date-time)

Obtiene la hora en que esta acción recomendada se actualizó por última vez.

properties.linkedObjects

string[]

Obtiene los objetos vinculados, si los hay.

properties.observedImpact

RecommendedActionImpactRecord[]

Obtiene la información de impacto real o observada para esta acción recomendada, por ejemplo, ganancia de CPU real, cambio de espacio en disco real

properties.recommendationReason

string

Obtiene el motivo para recomendar esta acción. Por ejemplo, DuplicateIndex

properties.revertActionDuration

string (duration)

Obtiene el tiempo necesario para revertir los cambios de esta acción recomendada en el recurso de usuario. Por ejemplo, tiempo necesario para quitar el índice creado.

properties.revertActionInitiatedBy

RecommendedActionInitiatedBy

Obtiene si el usuario o el sistema proporcionan la aprobación para revertir esta acción recomendada.

properties.revertActionInitiatedTime

string (date-time)

Obtiene la hora en que se aprobó esta acción recomendada para revertir.

properties.revertActionStartTime

string (date-time)

Obtiene la hora en que el sistema comenzó a revertir los cambios de esta acción recomendada en el recurso de usuario. Por ejemplo, la hora en que se ejecuta la eliminación de índices.

properties.score

integer (int32)

Obtiene el impacto de esta acción recomendada. Los valores posibles son 1 - Bajo impacto, 2 - Impacto medio y 3 - Alto impacto

properties.state

RecommendedActionStateInfo

Obtiene la información del estado actual en el que se encuentra la acción recomendada.

properties.timeSeries

RecommendedActionMetricInfo[]

Obtiene la información de serie temporal de métricas para esta acción recomendada, por ejemplo, series temporales de consumo de CPU.

properties.validSince

string (date-time)

Obtiene la hora desde que esta acción recomendada es válida.

systemData

systemData

Azure Resource Manager metadatos que contienen información createdBy y modifiedBy.

type

string

Tipo de recurso. Por ejemplo, "Microsoft. Compute/virtualMachines" o "Microsoft. CuentasAlmacenamiento/Almacenamiento"

RecommendedActionCurrentState

Estado actual en el que se encuentra la acción recomendada. Algunos estados usados habitualmente son: Activo:> acción recomendada está activa y aún no se ha realizado ninguna acción. Pendiente:> acción recomendada se aprueba y está esperando la ejecución. Ejecución:> acción recomendada se aplica en la base de datos de usuario. Comprobación:> acción recomendada se aplicó y se comprueba su utilidad por parte del sistema. Correcto:> acción recomendada se aplicó y se encontró una mejora durante la comprobación. Reversión pendiente:> comprobación encontró poca o ninguna mejora, por lo que la acción recomendada se pone en cola para revertir o el usuario se ha revertido manualmente. Reversión:> cambios realizados mientras se aplica la acción recomendada se revierte en la base de datos de usuario. Revertida:> revierte correctamente los cambios realizados por la acción recomendada en la base de datos de usuario. Omitido:> usuario omite o descarta explícitamente la acción recomendada.

Valor Description
Active

Activo

Pending

Pending

Executing

Ejecutar

Verifying

Verificación

PendingRevert

PendingRevert

RevertCancelled

RevertCancelled

Reverting

Revertiendo

Reverted

Revertido

Ignored

Ignored

Expired

Caducado

Monitoring

Supervisión

Resolved

Resuelto

Success

Success

Error

Error

RecommendedActionErrorInfo

Contiene información de error para una acción recomendada de Azure SQL Database, Server o Elastic Pool.

Nombre Tipo Description
errorCode

string

Obtiene el motivo por el que la acción recomendada se puso en estado de error. Por ejemplo, DatabaseHasQdsOff, IndexAlreadyExists

isRetryable

IsRetryable

Obtiene si se puede omitir el error y se podría reintentar la acción recomendada. Los valores posibles son: Sí/No

RecommendedActionImpactRecord

Contiene información sobre el impacto estimado u observado en diversas métricas para una Acción Recomendada de Azure SQL Database, Server o Elastic Pool.

Nombre Tipo Description
absoluteValue

number (double)

Obtiene el valor absoluto de esta dimensión si procede. Por ejemplo, número de consultas afectadas

changeValueAbsolute

number (double)

Obtiene el cambio absoluto en el valor de esta dimensión. Por ejemplo, cambio de espacio en disco absoluto en Megabytes

changeValueRelative

number (double)

Obtiene el cambio relativo en el valor de esta dimensión. Por ejemplo, cambio de espacio en disco relativo en porcentaje

dimensionName

string

Obtiene el nombre de la dimensión de impacto. Por ejemplo, CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

unit

string

Obtiene el nombre de la dimensión de impacto. Por ejemplo, CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

RecommendedActionImplementationInfo

Contiene información para la implementación manual de una acción recomendada de Azure SQL Database, Server o Elastic Pool.

Nombre Tipo Description
method

ImplementationMethod

Obtiene el método en el que se puede implementar manualmente esta acción recomendada. Por ejemplo, TSql, AzurePowerShell.

script

string

Obtiene el script de implementación manual. Por ejemplo, script de T-SQL que se podría ejecutar en la base de datos.

RecommendedActionInitiatedBy

Obtiene si el usuario o el sistema han proporcionado la aprobación para aplicar esta acción recomendada.

Valor Description
User

Usuario

System

Sistema

RecommendedActionMetricInfo

Contiene series temporales de varias métricas afectadas para una Acción Recomendada de Azure SQL Database, Server o Elastic Pool.

Nombre Tipo Description
metricName

string

Obtiene el nombre de la métrica. Por ejemplo, CPU, número de consultas.

startTime

string (date-time)

Obtiene la hora de inicio del intervalo de tiempo proporcionado por este MetricInfo.

timeGrain

string

Obtiene la duración del intervalo de tiempo para el valor proporcionado por este MetricInfo. Por ejemplo, PT1H (1 hora)

unit

string

Obtiene la unidad en la que se mide la métrica. Por ejemplo, DTU, Frecuencia

value

number (double)

Obtiene el valor de la métrica en el intervalo de tiempo proporcionado por este MetricInfo.

RecommendedActionStateInfo

Contiene información del estado actual para una acción recomendada de Azure SQL Database, Server o Elastic Pool.

Nombre Tipo Description
actionInitiatedBy

RecommendedActionInitiatedBy

Obtiene quién inició la ejecución de esta acción recomendada. El valor posible es: Usuario:> Cuando el sistema notificado explícitamente por el usuario aplica la acción recomendada. Sistema:> Cuando el estado de ejecución automática de este asesor se estableció en "Habilitado", en cuyo caso el sistema lo aplicó.

currentValue

RecommendedActionCurrentState

Estado actual en el que se encuentra la acción recomendada. Algunos estados usados habitualmente son: Activo:> acción recomendada está activa y aún no se ha realizado ninguna acción. Pendiente:> acción recomendada se aprueba y está esperando la ejecución. Ejecución:> acción recomendada se aplica en la base de datos de usuario. Comprobación:> acción recomendada se aplicó y se comprueba su utilidad por parte del sistema. Correcto:> acción recomendada se aplicó y se encontró una mejora durante la comprobación. Reversión pendiente:> comprobación encontró poca o ninguna mejora, por lo que la acción recomendada se pone en cola para revertir o el usuario se ha revertido manualmente. Reversión:> cambios realizados mientras se aplica la acción recomendada se revierte en la base de datos de usuario. Revertida:> revierte correctamente los cambios realizados por la acción recomendada en la base de datos de usuario. Omitido:> usuario omite o descarta explícitamente la acción recomendada.

lastModified

string (date-time)

Obtiene la hora en que se modificó por última vez el estado.

systemData

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string (date-time)

La marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.