Database Advisors - Get
Obtiene un asesor de base de datos.
GET 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 |
|---|---|---|---|---|
|
advisor
|
path | True |
string |
Nombre del Asistente para bases de datos. |
|
database
|
path | True |
string |
El nombre de la base de datos. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
|
server
|
path | True |
string |
El nombre del servidor. |
|
subscription
|
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. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
Operación de Azure completada con éxito. |
|
| Other Status Codes |
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
Get database advisor
Solicitud de ejemplo
GET 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
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. |
|
Advisor |
Obtiene el estado de disponibilidad de este asesor para los clientes. Los valores posibles son "GA", "PublicPreview", "LimitedPublicPreview" y "PrivatePreview". |
|
Auto |
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" |
|
Auto |
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). |
|
created |
Tipo de identidad que creó el recurso. |
|
Error |
Información adicional sobre el error de administración de recursos. |
|
Error |
Detalle del error. |
|
Error |
Respuesta de error |
|
Implementation |
Obtiene el método en el que se puede implementar manualmente esta acción recomendada. Por ejemplo, TSql, AzurePowerShell. |
|
Is |
Obtiene si se puede omitir el error y se podría reintentar la acción recomendada. Los valores posibles son: Sí/No |
|
Recommended |
Acción recomendada de base de datos, servidor o grupo elástico. |
|
Recommended |
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. |
|
Recommended |
Contiene información de error para una acción recomendada de Azure SQL Database, Server o Elastic Pool. |
|
Recommended |
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. |
|
Recommended |
Contiene información para la implementación manual de una acción recomendada de Azure SQL Database, Server o Elastic Pool. |
|
Recommended |
Obtiene si el usuario o el sistema han proporcionado la aprobación para aplicar esta acción recomendada. |
|
Recommended |
Contiene series temporales de varias métricas afectadas para una Acción Recomendada de Azure SQL Database, Server o Elastic Pool. |
|
Recommended |
Contiene información del estado actual para una acción recomendada de Azure SQL Database, Server o Elastic Pool. |
|
system |
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 |
Obtiene el estado de disponibilidad de este asesor para los clientes. Los valores posibles son "GA", "PublicPreview", "LimitedPublicPreview" y "PrivatePreview". |
|
| properties.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 |
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 |
Obtiene las acciones recomendadas para este asesor. |
|
| 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 |
Información adicional del error. |
|
| code |
string |
Código de error. |
| details |
Detalles del error. |
|
| message |
string |
El mensaje de error. |
| target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
| Nombre | Tipo | Description |
|---|---|---|
| error |
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 |
Obtiene los detalles del error si y por qué esta acción recomendada se coloca en estado de error. |
|
| properties.estimatedImpact |
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 |
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 |
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 |
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 |
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 |
Obtiene la información del estado actual en el que se encuentra la acción recomendada. |
|
| properties.timeSeries |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Tipo de identidad que modificó por última vez el recurso. |