Database Advisors - Get

Servizio:: SQL Database

Versione API:: 2023-08-01

Ottiene un advisor del database.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
advisorName	path	True	string	Nome di Database Advisor.
databaseName	path	True	string	Nome del database.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager 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

Nome	Tipo	Descrizione
200 OK	Advisor	Sono stati recuperati i dettagli di Advisor database specificato.
Other Status Codes	ErrorResponse	Risposte di errore: 400 FeatureDisabledOnSelectedEdition : l'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. 400 DataWarehouseNotSupported : l'ottimizzazione automatica non è supportata per SQL Data Warehouse. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 DatabaseDoesNotExist - Impossibile trovare il database richiesto 404 SubscriptionDoesNotHaveElasticPool - Il pool elastico richiesto non è stato trovato 404 AdvisorNotFound - Impossibile trovare l'advisor richiesto. 405 NotSupported : questa funzionalità non è supportata. 409 Conflitto - Impossibile elaborare la richiesta a causa di un conflitto nella richiesta. 503 ServiceTemporarilyUnavailable - Funzionalità temporaneamente non disponibile.

Nome

Tipo

Descrizione

200 OK

Advisor

Sono stati recuperati i dettagli di Advisor database specificato.

Other Status Codes

ErrorResponse

Risposte di errore:

400 FeatureDisabledOnSelectedEdition : l'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.
400 DataWarehouseNotSupported : l'ottimizzazione automatica non è supportata per SQL Data Warehouse.
404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato
404 DatabaseDoesNotExist - Impossibile trovare il database richiesto
404 SubscriptionDoesNotHaveElasticPool - Il pool elastico richiesto non è stato trovato
404 AdvisorNotFound - Impossibile trovare l'advisor richiesto.
405 NotSupported : questa funzionalità non è supportata.
409 Conflitto - Impossibile elaborare la richiesta a causa di un conflitto nella richiesta.
503 ServiceTemporarilyUnavailable - Funzionalità temporaneamente non disponibile.

Esempio

Get database advisor

Esempio di richiesta

HTTP

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=2023-08-01

Risposta di esempio

Codice di stato:: 200

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

Definizioni

Nome	Descrizione
Advisor	Database, Server o Advisor pool elastico.
AdvisorStatus	Ottiene lo stato della disponibilità di questo advisor per i clienti. I valori possibili sono 'GA', 'PublicPreview', 'LimitedPublicPreview' e 'PrivatePreview'.
AutoExecuteStatus	Ottiene lo stato di esecuzione automatica (se consentire al sistema di eseguire le raccomandazioni) di questo advisor. I valori possibili sono 'Enabled' e 'Disabled'
AutoExecuteStatusInheritedFrom	Ottiene la risorsa da cui viene ereditato il valore corrente dello stato di esecuzione automatica. Lo stato di esecuzione automatica può essere impostato su (e ereditato da) livelli diversi nella gerarchia delle risorse. I valori possibili sono 'Subscription', 'Server', 'ElasticPool', 'Database' e 'Default' (quando lo stato non è impostato in modo esplicito su alcun livello).
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ImplementationMethod	Ottiene il metodo in cui questa azione consigliata può essere implementata manualmente. ad esempio TSql, AzurePowerShell.
IsRetryable	Ottiene un valore che indica se l'errore può essere ignorato e l'azione consigliata può essere ritentata. I valori possibili sono: Sì/No
RecommendedAction	Azione consigliata per database, server o pool elastico.
RecommendedActionCurrentState	Stato corrente in cui si trova l'azione consigliata. Alcuni stati di uso comune sono: Attivo ->'azione consigliata è attiva e non è stata ancora eseguita alcuna azione. In sospeso:>'azione consigliata viene approvata per ed è in attesa di esecuzione. Esecuzione:>'azione consigliata viene applicata al database utente. Verifica:>'azione consigliata è stata applicata e ne viene verificata l'utilità dal sistema. Esito positivo:>'azione consigliata è stata applicata e il miglioramento rilevati durante la verifica. Ripristino in sospeso:> verifica ha trovato poco o nessun miglioramento, quindi l'azione consigliata viene accodata per il ripristino o l'utente ha ripristinato manualmente. Ripristino:> modifiche apportate durante l'applicazione dell'azione consigliata vengono ripristinate nel database utente. Ripristino:> ripristinato correttamente le modifiche apportate dall'azione consigliata nel database utente. Ignorato:>'utente ha ignorato/ignorato in modo esplicito l'azione consigliata.
RecommendedActionErrorInfo	Contiene informazioni sugli errori per un'azione consigliata per un database SQL di Azure, un server o un pool elastico.
RecommendedActionImpactRecord	Contiene informazioni sull'impatto stimato o osservato su varie metriche per un'azione consigliata per un database SQL di Azure, un server o un pool elastico.
RecommendedActionImplementationInfo	Contiene informazioni per l'implementazione manuale di un'azione consigliata per un database SQL di Azure, un server o un pool elastico.
RecommendedActionInitiatedBy	Ottiene chi ha avviato l'esecuzione di questa azione consigliata. Il valore possibile è: User -> When user explicity notified system to apply the recommended action ( Utente -> Quando l'utente riceve una notifica esplicita per applicare l'azione consigliata. Sistema :> Quando lo stato di esecuzione automatica di questo advisor è stato impostato su "Abilitato", nel qual caso il sistema lo ha applicato.
RecommendedActionMetricInfo	Contiene serie temporali di varie metriche interessate per un'azione consigliata per un database SQL di Azure, un server o un pool elastico.
RecommendedActionStateInfo	Contiene informazioni sullo stato corrente per un'azione consigliata per un database SQL di Azure, un server o un pool elastico.

Advisor

Oggetto

Database, Server o Advisor pool elastico.

Nome	Tipo	Descrizione
id	string	ID risorsa.
kind	string	Tipo di risorsa.
location	string	Percorso della risorsa.
name	string	Nome risorsa.
properties.advisorStatus	AdvisorStatus	Ottiene lo stato della disponibilità di questo advisor per i clienti. I valori possibili sono 'GA', 'PublicPreview', 'LimitedPublicPreview' e 'PrivatePreview'.
properties.autoExecuteStatus	AutoExecuteStatus	Ottiene lo stato di esecuzione automatica (se consentire al sistema di eseguire le raccomandazioni) di questo advisor. I valori possibili sono 'Enabled' e 'Disabled'
properties.autoExecuteStatusInheritedFrom	AutoExecuteStatusInheritedFrom	Ottiene la risorsa da cui viene ereditato il valore corrente dello stato di esecuzione automatica. Lo stato di esecuzione automatica può essere impostato su (e ereditato da) livelli diversi nella gerarchia delle risorse. I valori possibili sono 'Subscription', 'Server', 'ElasticPool', 'Database' e 'Default' (quando lo stato non è impostato in modo esplicito su alcun livello).
properties.lastChecked	string (date-time)	Ottiene l'ora in cui la risorsa corrente è stata analizzata per ottenere raccomandazioni da questo advisor.
properties.recommendationsStatus	string	Ottiene lo stato delle raccomandazioni per questo advisor e il motivo per cui non sono presenti raccomandazioni. I valori possibili includono, ma non sono limitati a, "Ok" (raccomandazioni disponibili), LowActivity (carico di lavoro insufficiente da analizzare), "DbSeemsTuned" (il database funziona bene) e così via.
properties.recommendedActions	RecommendedAction[]	Ottiene le azioni consigliate per questo advisor.
type	string	Tipo di risorsa.

AdvisorStatus

Enumerazione

Ottiene lo stato della disponibilità di questo advisor per i clienti. I valori possibili sono 'GA', 'PublicPreview', 'LimitedPublicPreview' e 'PrivatePreview'.

Valore	Descrizione
GA
PublicPreview
LimitedPublicPreview
PrivatePreview

AutoExecuteStatus

Enumerazione

Ottiene lo stato di esecuzione automatica (se consentire al sistema di eseguire le raccomandazioni) di questo advisor. I valori possibili sono 'Enabled' e 'Disabled'

Valore	Descrizione
Enabled
Disabled
Default

AutoExecuteStatusInheritedFrom

Enumerazione

Ottiene la risorsa da cui viene ereditato il valore corrente dello stato di esecuzione automatica. Lo stato di esecuzione automatica può essere impostato su (e ereditato da) livelli diversi nella gerarchia delle risorse. I valori possibili sono 'Subscription', 'Server', 'ElasticPool', 'Database' e 'Default' (quando lo stato non è impostato in modo esplicito su alcun livello).

Valore	Descrizione
Default
Subscription
Server
ElasticPool
Database

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ImplementationMethod

Enumerazione

Ottiene il metodo in cui questa azione consigliata può essere implementata manualmente. ad esempio TSql, AzurePowerShell.

Valore	Descrizione
TSql
AzurePowerShell

IsRetryable

Enumerazione

Ottiene un valore che indica se l'errore può essere ignorato e l'azione consigliata può essere ritentata. I valori possibili sono: Sì/No

Valore	Descrizione
Yes
No

RecommendedAction

Oggetto

Azione consigliata per database, server o pool elastico.

Nome	Tipo	Descrizione
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	RecommendedActionErrorInfo	Ottiene i dettagli dell'errore se e perché questa azione consigliata viene inserita nello stato di errore.
properties.estimatedImpact	RecommendedActionImpactRecord[]	Ottiene le informazioni sull'impatto stimato per questa azione consigliata, ad esempio il guadagno stimato della CPU, la modifica dello spazio su disco stimato
properties.executeActionDuration	string (duration)	Ottiene il tempo impiegato per applicare questa azione consigliata alla risorsa utente. ad esempio, tempo impiegato per la creazione dell'indice
properties.executeActionInitiatedBy	RecommendedActionInitiatedBy	Ottiene se l'approvazione per l'applicazione di questa azione consigliata è stata assegnata dall'utente/sistema.
properties.executeActionInitiatedTime	string (date-time)	Ottiene l'ora in cui questa azione consigliata è stata approvata per l'esecuzione.
properties.executeActionStartTime	string (date-time)	Ottiene l'ora in cui il sistema ha iniziato ad applicare questa azione consigliata alla risorsa utente. ad esempio, ora di inizio della creazione dell'indice
properties.implementationDetails	RecommendedActionImplementationInfo	Ottiene i dettagli di implementazione di questa azione consigliata per l'applicazione manuale da parte 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 può essere eseguita dall'utente
properties.isRevertableAction	boolean	Ottiene se le modifiche applicate da questa azione consigliata possono essere ripristinate dall'utente
properties.lastRefresh	string (date-time)	Ottiene l'ora dell'ultimo aggiornamento dell'azione consigliata.
properties.linkedObjects	string[]	Ottiene gli oggetti collegati, se presenti.
properties.observedImpact	RecommendedActionImpactRecord[]	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 della raccomandazione di questa azione. ad esempio DuplicateIndex
properties.revertActionDuration	string (duration)	Ottiene il tempo impiegato per ripristinare le modifiche di questa azione consigliata sulla risorsa utente. Ad esempio, tempo impiegato per eliminare l'indice creato.
properties.revertActionInitiatedBy	RecommendedActionInitiatedBy	Ottiene se l'approvazione per il ripristino di questa azione consigliata è stata assegnata dall'utente/sistema.
properties.revertActionInitiatedTime	string (date-time)	Ottiene l'ora in cui questa azione consigliata è stata approvata per il ripristino.
properties.revertActionStartTime	string (date-time)	Ottiene l'ora in cui il sistema ha iniziato a ripristinare le modifiche di questa azione consigliata sulla risorsa utente. ad esempio l'ora in cui viene eseguita l'eliminazione dell'indice.
properties.score	integer (int32)	Ottiene l'impatto di questa azione consigliata. I valori possibili sono 1 - Impatto basso, 2 - Impatto medio e 3 - Impatto elevato
properties.state	RecommendedActionStateInfo	Ottiene le informazioni dello stato corrente in cui si trova l'azione consigliata.
properties.timeSeries	RecommendedActionMetricInfo[]	Ottiene le informazioni sulle serie temporali delle metriche per questa azione consigliata, ad esempio le serie temporali di utilizzo della CPU
properties.validSince	string (date-time)	Ottiene l'ora da quando questa azione consigliata è valida.
type	string	Tipo di risorsa.

RecommendedActionCurrentState

Enumerazione

Stato corrente in cui si trova l'azione consigliata. Alcuni stati di uso comune sono: Attivo ->'azione consigliata è attiva e non è stata ancora eseguita alcuna azione. In sospeso:>'azione consigliata viene approvata per ed è in attesa di esecuzione. Esecuzione:>'azione consigliata viene applicata al database utente. Verifica:>'azione consigliata è stata applicata e ne viene verificata l'utilità dal sistema. Esito positivo:>'azione consigliata è stata applicata e il miglioramento rilevati durante la verifica. Ripristino in sospeso:> verifica ha trovato poco o nessun miglioramento, quindi l'azione consigliata viene accodata per il ripristino o l'utente ha ripristinato manualmente. Ripristino:> modifiche apportate durante l'applicazione dell'azione consigliata vengono ripristinate nel database utente. Ripristino:> ripristinato correttamente le modifiche apportate dall'azione consigliata nel database utente. Ignorato:>'utente ha ignorato/ignorato in modo esplicito l'azione consigliata.

Valore	Descrizione
Active
Pending
Executing
Verifying
PendingRevert
RevertCancelled
Reverting
Reverted
Ignored
Expired
Monitoring
Resolved
Success
Error

RecommendedActionErrorInfo

Oggetto

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

Nome	Tipo	Descrizione
errorCode	string	Ottiene il motivo per cui l'azione consigliata è stata inserita nello stato di errore. ad esempio DatabaseHasQdsOff, IndexAlreadyExists
isRetryable	IsRetryable	Ottiene un valore che indica se l'errore può essere ignorato e l'azione consigliata può essere ritentata. I valori possibili sono: Sì/No

RecommendedActionImpactRecord

Oggetto

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

Nome	Tipo	Descrizione
absoluteValue	number (double)	Ottiene il valore assoluto di questa dimensione, se applicabile. Ad esempio, numero di query interessate
changeValueAbsolute	number (double)	Ottiene la modifica assoluta nel valore di questa dimensione. ad esempio, modifica dello spazio su disco assoluto in megabyte
changeValueRelative	number (double)	Ottiene la modifica relativa nel valore di questa dimensione. Ad esempio, variazione dello spazio relativo su disco 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

Oggetto

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

Nome	Tipo	Descrizione
method	ImplementationMethod	Ottiene il metodo in cui questa azione consigliata può essere implementata manualmente. ad esempio TSql, AzurePowerShell.
script	string	Ottiene lo script di implementazione manuale. Ad esempio, lo script T-SQL che può essere eseguito nel database.

RecommendedActionInitiatedBy

Enumerazione

Ottiene chi ha avviato l'esecuzione di questa azione consigliata. Il valore possibile è: User -> When user explicity notified system to apply the recommended action ( Utente -> Quando l'utente riceve una notifica esplicita per applicare l'azione consigliata. Sistema :> Quando lo stato di esecuzione automatica di questo advisor è stato impostato su "Abilitato", nel qual caso il sistema lo ha applicato.

Valore	Descrizione
User
System

RecommendedActionMetricInfo

Oggetto

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

Nome	Tipo	Descrizione
metricName	string	Ottiene il nome della metrica. ad esempio CPU, Numero di query.
startTime	string (date-time)	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 (double)	Ottiene il valore della metrica nell'intervallo di tempo specificato da metricinfo.

RecommendedActionStateInfo

Oggetto

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

Nome	Tipo	Descrizione
actionInitiatedBy	RecommendedActionInitiatedBy	Ottiene chi ha avviato l'esecuzione di questa azione consigliata. Il valore possibile è: User -> When user explicity notified system to apply the recommended action ( Utente -> Quando l'utente riceve una notifica esplicita per applicare l'azione consigliata. Sistema :> Quando lo stato di esecuzione automatica di questo advisor è stato impostato su "Abilitato", nel qual caso il sistema lo ha applicato.
currentValue	RecommendedActionCurrentState	Stato corrente in cui si trova l'azione consigliata. Alcuni stati di uso comune sono: Attivo ->'azione consigliata è attiva e non è stata ancora eseguita alcuna azione. In sospeso:>'azione consigliata viene approvata per ed è in attesa di esecuzione. Esecuzione:>'azione consigliata viene applicata al database utente. Verifica:>'azione consigliata è stata applicata e ne viene verificata l'utilità dal sistema. Esito positivo:>'azione consigliata è stata applicata e il miglioramento rilevati durante la verifica. Ripristino in sospeso:> verifica ha trovato poco o nessun miglioramento, quindi l'azione consigliata viene accodata per il ripristino o l'utente ha ripristinato manualmente. Ripristino:> modifiche apportate durante l'applicazione dell'azione consigliata vengono ripristinate nel database utente. Ripristino:> ripristinato correttamente le modifiche apportate dall'azione consigliata nel database utente. Ignorato:>'utente ha ignorato/ignorato in modo esplicito l'azione consigliata.
lastModified	string (date-time)	Ottiene l'ora dell'ultima modifica dello stato

Condividi tramite

Database Advisors - Get

Parametri dell'URI

Risposte

Esempio

Get database advisor

Esempio di richiesta

Risposta di esempio

Definizioni

Advisor

AdvisorStatus

AutoExecuteStatus

AutoExecuteStatusInheritedFrom

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ImplementationMethod

IsRetryable

RecommendedAction

RecommendedActionCurrentState

RecommendedActionErrorInfo

RecommendedActionImpactRecord

RecommendedActionImplementationInfo

RecommendedActionInitiatedBy

RecommendedActionMetricInfo

RecommendedActionStateInfo