Database Recommended Actions - List By Database Advisor

Ottiene l'elenco delle azioni consigliate per il database.

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

Parametri dell'URI

Name In Required Type Description
advisorName
path True
  • string

Nome dell'Assistente database.

databaseName
path True
  • string

Nome del database.

resourceGroupName
path True
  • string

Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.

serverName
path True
  • string

Nome del server.

subscriptionId
path True
  • string

ID sottoscrizione che identifica una sottoscrizione di Azure.

api-version
query True
  • string

Versione dell'API da usare per la richiesta.

Risposte

Name Type Description
200 OK

È stato recuperato correttamente l'elenco delle azioni consigliate per il database.

Other Status Codes

Risposte agli errori: **

  • 400 FeatureDisabledOnSelectedEdition - Utente ha tentato di usare una funzionalità disabilitata nell'edizione del database corrente.

  • 400 InvalidIdentifier: l'identificatore contiene NULL o un carattere unicode non valido.

  • 404 DatabaseDoesNotExist - Il database richiesto non è stato trovato

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 SubscriptionDoesNotHaveElasticPool - Il pool elastico richiesto non è stato trovato

  • 404 AdvisorNotFound - Il consulente richiesto non è stato trovato.

  • 404 RecommendedActionNotFound : l'azione consigliata richiesta non è stata trovata.

  • 404 AdvisorNotFound - Il consulente richiesto non è stato trovato.

  • 404 RecommendedActionNotFound : l'azione consigliata richiesta non è stata trovata.

  • 405 NotSupported : questa funzionalità non è supportata.

  • 409 Conflitto - Impossibile elaborare la richiesta a causa del conflitto nella richiesta.

  • 503 ServiceTemporarilyUnavailable - Funzionalità temporaneamente non disponibile.

Esempio

Sample Request

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/recommendedActions?api-version=2021-02-01-preview

Sample Response

[
  {
    "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex/recommendedActions/IR_[CRM]_[DataPoints]_4821CD2F9510D98184BB",
    "name": "IR_[CRM]_[DataPoints]_4821CD2F9510D98184BB",
    "type": "Microsoft.Sql/servers/databases/advisors/recommendedActions",
    "location": "East Asia",
    "kind": "",
    "properties": {
      "recommendationReason": "",
      "validSince": "2017-03-01T14:38:04Z",
      "lastRefresh": "2017-03-01T14:38:04Z",
      "state": {
        "currentValue": "Active",
        "lastModified": "2017-03-01T14:38:05Z"
      },
      "isExecutableAction": true,
      "isRevertableAction": true,
      "isArchivedAction": false,
      "score": 1,
      "implementationDetails": {
        "method": "TSql",
        "script": "CREATE NONCLUSTERED INDEX [nci_wi_DataPoints_B892614093BAC56295EF6018BD4CB51B] ON [CRM].[DataPoints] ([Name],[Money],[Power]) INCLUDE ([Hour], [System], [LastChanged]) WITH (ONLINE = ON)"
      },
      "errorDetails": {},
      "estimatedImpact": [
        {
          "dimensionName": "ActionDuration",
          "unit": "Seconds",
          "absoluteValue": 1440
        },
        {
          "dimensionName": "SpaceChange",
          "unit": "Megabytes",
          "absoluteValue": 209.3125
        }
      ],
      "observedImpact": [],
      "timeSeries": [],
      "details": {
        "indexName": "nci_wi_DataPoints_B892614093BAC56295EF6018BD4CB51B",
        "indexType": "NONCLUSTERED",
        "schema": "[CRM]",
        "table": "[DataPoints]",
        "indexColumns": "[Name],[Money],[Power]",
        "includedColumns": "[Hour], [System], [LastChanged]"
      }
    }
  },
  {
    "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex/recommendedActions/IR_[dbo]_[DataPoints]_F5D2F347AA22DB46E4CC",
    "name": "IR_[dbo]_[DataPoints]_F5D2F347AA22DB46E4CC",
    "type": "Microsoft.Sql/servers/databases/advisors/recommendedActions",
    "location": "East Asia",
    "kind": "",
    "properties": {
      "recommendationReason": "",
      "validSince": "2017-03-01T14:38:05Z",
      "lastRefresh": "2017-03-01T14:38:05Z",
      "state": {
        "currentValue": "Success",
        "actionInitiatedBy": "User",
        "lastModified": "2017-03-01T14:38:05Z"
      },
      "isExecutableAction": true,
      "isRevertableAction": true,
      "isArchivedAction": false,
      "executeActionStartTime": "2017-03-01T14:38:05Z",
      "executeActionDuration": "PT1M",
      "executeActionInitiatedBy": "User",
      "executeActionInitiatedTime": "2017-03-01T14:38:05Z",
      "score": 3,
      "implementationDetails": {
        "method": "TSql",
        "script": "DROP INDEX [nci_wi_DataPoints_609E4B7D6A3813990ED44B28B340C8FC] ON [dbo].[DataPoints]"
      },
      "errorDetails": {},
      "estimatedImpact": [
        {
          "dimensionName": "ActionDuration",
          "unit": "Seconds",
          "absoluteValue": 5040
        },
        {
          "dimensionName": "SpaceChange",
          "unit": "Megabytes",
          "absoluteValue": 120
        }
      ],
      "observedImpact": [
        {
          "dimensionName": "AffectedQueriesCpuUtilization",
          "unit": "CpuCores",
          "changeValueAbsolute": -12.7,
          "changeValueRelative": -0.9
        },
        {
          "dimensionName": "CpuUtilization",
          "unit": "CpuCores",
          "changeValueAbsolute": -12.7,
          "changeValueRelative": -0.3175
        },
        {
          "dimensionName": "QueriesWithImprovedPerformance",
          "unit": "Count",
          "absoluteValue": 12
        },
        {
          "dimensionName": "QueriesWithRegressedPerformance",
          "unit": "Count",
          "absoluteValue": 1
        },
        {
          "dimensionName": "SpaceChange",
          "unit": "Megabytes",
          "absoluteValue": 130.742187
        },
        {
          "dimensionName": "VerificationProgress",
          "unit": "Percent",
          "absoluteValue": 0
        }
      ],
      "timeSeries": [],
      "details": {
        "indexName": "nci_wi_DataPoints_609E4B7D6A3813990ED44B28B340C8FC",
        "indexType": "NONCLUSTERED",
        "schema": "[dbo]",
        "table": "[DataPoints]",
        "indexColumns": "[Name],[Money]",
        "includedColumns": "[Power],[Pineapple]",
        "indexActionStartTime": "2017-03-01T14:38:05.337",
        "indexActionDuration": "00:01:00"
      }
    }
  },
  {
    "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex/recommendedActions/IR_[dbo]_[Employees]_560E15A98D14CA09BDFB",
    "name": "IR_[dbo]_[Employees]_560E15A98D14CA09BDFB",
    "type": "Microsoft.Sql/servers/databases/advisors/recommendedActions",
    "location": "East Asia",
    "kind": "",
    "properties": {
      "recommendationReason": "",
      "validSince": "2017-03-01T14:38:05Z",
      "lastRefresh": "2017-03-01T14:38:05Z",
      "state": {
        "currentValue": "Active",
        "lastModified": "2017-03-01T14:38:05Z"
      },
      "isExecutableAction": true,
      "isRevertableAction": true,
      "isArchivedAction": false,
      "score": 3,
      "implementationDetails": {
        "method": "TSql",
        "script": "CREATE NONCLUSTERED INDEX [nci_wi_Employees_8C18C2AF4267DC77793040782641CCDE] ON [dbo].[Employees] ([City], [State]) INCLUDE ([Postal]) WITH (ONLINE = ON)"
      },
      "errorDetails": {},
      "estimatedImpact": [
        {
          "dimensionName": "ActionDuration",
          "unit": "Seconds",
          "absoluteValue": 17
        },
        {
          "dimensionName": "SpaceChange",
          "unit": "Megabytes",
          "absoluteValue": 128
        }
      ],
      "observedImpact": [],
      "timeSeries": [],
      "details": {
        "indexName": "nci_wi_Employees_8C18C2AF4267DC77793040782641CCDE",
        "indexType": "NONCLUSTERED",
        "schema": "[dbo]",
        "table": "[Employees]",
        "indexColumns": "[City], [State]",
        "includedColumns": "[Postal]"
      }
    }
  }
]

Definizioni

ImplementationMethod

Ottiene il metodo in cui è possibile implementare manualmente questa azione consigliata. Ad esempio, TSql, AzurePowerShell.

IsRetryable

Ottiene se l'errore potrebbe essere ignorato e l'azione consigliata potrebbe essere riprovata. I valori possibili sono: Sì/No

RecommendedAction

Azione consigliata database, server o pool elastico.

RecommendedActionCurrentState

Lo stato corrente in cui si trova l'azione consigliata. Alcuni stati comunemente usati sono: l'azione attiva-> consigliata è attiva e non è ancora stata eseguita alcuna azione. In sospeso:> l'azione consigliata è approvata per ed è in attesa dell'esecuzione. Esecuzione:> l'azione consigliata viene applicata nel database utente. Verifica:> l'azione consigliata è stata applicata e viene verificata la relativa utilità dal sistema. Esito positivo:> l'azione consigliata è stata applicata e migliorata durante la verifica. Ripristino in sospeso:> la verifica ha trovato un minimo o nessun miglioramento in modo che l'azione consigliata venga accodata per ripristinare o che l'utente abbia ripristinato manualmente. Ripristino:> le modifiche apportate durante l'applicazione dell'azione consigliata vengono ripristinate nel database utente. Ripristinato:> è stato ripristinato correttamente le modifiche apportate dall'azione consigliata nel database utente. Ignorato:> l'utente ha ignorato/ignorato in modo esplicito l'azione consigliata.

RecommendedActionErrorInfo

Contiene informazioni sugli errori per un'azione consigliata database SQL di Azure, server o pool elastico.

RecommendedActionImpactRecord

Contiene informazioni sull'impatto stimato o osservato su varie metriche per un'azione consigliata database SQL di Azure, server o pool elastico.

RecommendedActionImplementationInfo

Contiene informazioni per l'implementazione manuale per un'azione consigliata database SQL di Azure, server o pool elastico.

RecommendedActionInitiatedBy

Ottiene chi ha avviato l'esecuzione di questa azione consigliata. Il valore possibile è: utente -> Quando il sistema di notifica esplicito dell'utente deve applicare l'azione consigliata. Sistema:> quando lo stato di esecuzione automatica di questo advisor è stato impostato su "Abilitato", nel qual caso il sistema l'ha applicata.

RecommendedActionMetricInfo

Contiene serie temporali di diverse metriche interessate per un'azione consigliata database SQL di Azure, server o pool elastico.

RecommendedActionStateInfo

Contiene informazioni sullo stato corrente per un'azione consigliata database SQL di Azure, server o pool elastico.

ImplementationMethod

Ottiene il metodo in cui è possibile implementare manualmente questa azione consigliata. Ad esempio, TSql, AzurePowerShell.

Name Type Description
AzurePowerShell
  • string
TSql
  • string

IsRetryable

Ottiene se l'errore potrebbe essere ignorato e l'azione consigliata potrebbe essere riprovata. I valori possibili sono: Sì/No

Name Type Description
No
  • string
Yes
  • string

RecommendedAction

Azione consigliata database, server o pool elastico.

Name Type Description
id
  • string

ID risorsa.

kind
  • string

Tipo di risorsa.

location
  • string

Percorso della risorsa.

name
  • string

Nome risorsa.

properties.details
  • object

Ottiene dettagli aggiuntivi specifici di questa azione consigliata.

properties.errorDetails

Ottiene i dettagli dell'errore se e perché questa azione consigliata viene inserita nello stato di errore.

properties.estimatedImpact

Ottiene le informazioni di impatto stimate per questa azione consigliata, ad esempio, aumento stimato della CPU, modifica dello spazio su disco stimato

properties.executeActionDuration
  • string

Ottiene il tempo necessario per applicare questa azione consigliata nella risorsa utente. Ad esempio, tempo impiegato per la creazione dell'indice

properties.executeActionInitiatedBy

Ottiene se l'approvazione per l'applicazione di questa azione consigliata è stata fornita dall'utente/sistema.

properties.executeActionInitiatedTime
  • string

Ottiene l'ora in cui questa azione consigliata è stata approvata per l'esecuzione.

properties.executeActionStartTime
  • string

Ottiene l'ora in cui il sistema ha avviato l'applicazione di questa azione consigliata nella risorsa utente. Ad esempio, ora di inizio della creazione dell'indice

properties.implementationDetails

Ottiene i dettagli dell'implementazione di questa azione consigliata per l'applicazione manuale dell'utente.

properties.isArchivedAction
  • boolean

Ottiene se questa azione consigliata è stata suggerita qualche tempo fa, ma l'utente ha scelto di ignorare questo e il sistema ha aggiunto di nuovo una nuova azione consigliata.

properties.isExecutableAction
  • boolean

Ottiene se questa azione consigliata è utilizzabile dall'utente

properties.isRevertableAction
  • boolean

Ottiene se le modifiche applicate da questa azione consigliata possono essere ripristinate dall'utente

properties.lastRefresh
  • string

Ottiene l'ora dell'ultimo aggiornamento dell'azione consigliata.

properties.linkedObjects
  • string[]

Ottiene gli oggetti collegati, se presenti.

properties.observedImpact

Ottiene le informazioni sull'impatto osservato/effettivo per questa azione consigliata, ad esempio il guadagno effettivo della CPU, la modifica dello spazio su disco effettivo

properties.recommendationReason
  • string

Ottiene il motivo per la raccomandazione di questa azione. Ad esempio, DuplicateIndex

properties.revertActionDuration
  • string

Ottiene il tempo necessario per ripristinare le modifiche di questa azione consigliata nella risorsa utente. Ad esempio, tempo impiegato per eliminare l'indice creato.

properties.revertActionInitiatedBy

Ottiene se l'approvazione per ripristinare questa azione consigliata è stata fornita dall'utente/sistema.

properties.revertActionInitiatedTime
  • string

Ottiene l'ora in cui questa azione consigliata è stata approvata per il ripristino.

properties.revertActionStartTime
  • string

Ottiene l'ora in cui il sistema ha iniziato a ripristinare le modifiche di questa azione consigliata nella risorsa utente. Ad esempio, ora in cui viene eseguita l'eliminazione dell'indice.

properties.score
  • integer

Ottiene l'impatto di questa azione consigliata. I valori possibili sono 1 - Impatto basso, 2 - Impatto medio e 3 - Impatto elevato

properties.state

Ottiene le informazioni dello stato corrente in cui si trova l'azione consigliata.

properties.timeSeries

Ottiene le informazioni sulle serie temporali delle metriche per questa azione consigliata, ad esempio, serie di tempo di utilizzo della CPU

properties.validSince
  • string

Ottiene il tempo da quando questa azione consigliata è valida.

type
  • string

Tipo di risorsa.

RecommendedActionCurrentState

Lo stato corrente in cui si trova l'azione consigliata. Alcuni stati comunemente usati sono: l'azione attiva-> consigliata è attiva e non è ancora stata eseguita alcuna azione. In sospeso:> l'azione consigliata è approvata per ed è in attesa dell'esecuzione. Esecuzione:> l'azione consigliata viene applicata nel database utente. Verifica:> l'azione consigliata è stata applicata e viene verificata la relativa utilità dal sistema. Esito positivo:> l'azione consigliata è stata applicata e migliorata durante la verifica. Ripristino in sospeso:> la verifica ha trovato un minimo o nessun miglioramento in modo che l'azione consigliata venga accodata per ripristinare o che l'utente abbia ripristinato manualmente. Ripristino:> le modifiche apportate durante l'applicazione dell'azione consigliata vengono ripristinate nel database utente. Ripristinato:> è stato ripristinato correttamente le modifiche apportate dall'azione consigliata nel database utente. Ignorato:> l'utente ha ignorato/ignorato in modo esplicito l'azione consigliata.

Name Type Description
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

Contiene informazioni sugli errori per un'azione consigliata database SQL di Azure, server o pool elastico.

Name Type Description
errorCode
  • string

Ottiene il motivo per cui l'azione consigliata è stata inserita nello stato di errore. Ad esempio, DatabaseHasQdsOff, IndexAlreadyExists

isRetryable

Ottiene se l'errore potrebbe essere ignorato e l'azione consigliata potrebbe essere riprovata. I valori possibili sono: Sì/No

RecommendedActionImpactRecord

Contiene informazioni sull'impatto stimato o osservato su varie metriche per un'azione consigliata database SQL di Azure, server o pool elastico.

Name Type Description
absoluteValue
  • number

Ottiene il valore assoluto di questa dimensione, se applicabile. Ad esempio, numero di query interessate

changeValueAbsolute
  • number

Ottiene la modifica assoluta del valore di questa dimensione. Ad esempio, la modifica dello spazio su disco assoluto in Megabyte

changeValueRelative
  • number

Ottiene la modifica relativa nel valore di questa dimensione. Ad esempio, la modifica dello spazio su disco relativo in Percentuale

dimensionName
  • string

Ottiene il nome della dimensione di impatto. Ad esempio, CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

unit
  • string

Ottiene il nome della dimensione di impatto. Ad esempio, CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

RecommendedActionImplementationInfo

Contiene informazioni per l'implementazione manuale per un'azione consigliata database SQL di Azure, server o pool elastico.

Name Type Description
method

Ottiene il metodo in cui è possibile implementare manualmente questa azione consigliata. Ad esempio, TSql, AzurePowerShell.

script
  • string

Ottiene lo script di implementazione manuale. Ad esempio, lo script T-SQL che potrebbe essere eseguito nel database.

RecommendedActionInitiatedBy

Ottiene chi ha avviato l'esecuzione di questa azione consigliata. Il valore possibile è: utente -> Quando il sistema di notifica esplicito dell'utente deve applicare l'azione consigliata. Sistema:> quando lo stato di esecuzione automatica di questo advisor è stato impostato su "Abilitato", nel qual caso il sistema l'ha applicata.

Name Type Description
System
  • string
User
  • string

RecommendedActionMetricInfo

Contiene serie temporali di diverse metriche interessate per un'azione consigliata database SQL di Azure, server o pool elastico.

Name Type Description
metricName
  • string

Ottiene il nome della metrica. Ad esempio, CPU, Numero di query.

startTime
  • string

Ottiene l'ora di inizio dell'intervallo di tempo specificato da metricInfo.

timeGrain
  • string

Ottiene la durata dell'intervallo di tempo per il valore specificato da metricInfo. ad esempio PT1H (1 ora)

unit
  • string

Ottiene l'unità in cui viene misurata la metrica. Ad esempio, DTU, Frequenza

value
  • number

Ottiene il valore della metrica nell'intervallo di tempo specificato da MetricInfo.

RecommendedActionStateInfo

Contiene informazioni sullo stato corrente per un'azione consigliata database SQL di Azure, server o pool elastico.

Name Type Description
actionInitiatedBy

Ottiene chi ha avviato l'esecuzione di questa azione consigliata. Il valore possibile è: utente -> Quando il sistema di notifica esplicito dell'utente deve applicare l'azione consigliata. Sistema:> quando lo stato di esecuzione automatica di questo advisor è stato impostato su "Abilitato", nel qual caso il sistema l'ha applicata.

currentValue

Lo stato corrente in cui si trova l'azione consigliata. Alcuni stati comunemente usati sono: l'azione attiva-> consigliata è attiva e non è ancora stata eseguita alcuna azione. In sospeso:> l'azione consigliata è approvata per ed è in attesa dell'esecuzione. Esecuzione:> l'azione consigliata viene applicata nel database utente. Verifica:> l'azione consigliata è stata applicata e viene verificata la relativa utilità dal sistema. Esito positivo:> l'azione consigliata è stata applicata e migliorata durante la verifica. Ripristino in sospeso:> la verifica ha trovato un minimo o nessun miglioramento in modo che l'azione consigliata venga accodata per ripristinare o che l'utente abbia ripristinato manualmente. Ripristino:> le modifiche apportate durante l'applicazione dell'azione consigliata vengono ripristinate nel database utente. Ripristinato:> è stato ripristinato correttamente le modifiche apportate dall'azione consigliata nel database utente. Ignorato:> l'utente ha ignorato/ignorato in modo esplicito l'azione consigliata.

lastModified
  • string

Ottiene l'ora dell'ultima modifica dello stato