Database Recommended Actions - Update

Servizio:: SQL Database

Versione API:: 2023-08-01

Aggiorna un'azione consigliata per il database.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/advisors/{advisorName}/recommendedActions/{recommendedActionName}?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.
recommendedActionName	path	True	string	Nome dell'azione consigliata 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.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties.state	True	RecommendedActionStateInfo	Ottiene le informazioni dello stato corrente in cui si trova l'azione consigliata.

Risposte

Nome	Tipo	Descrizione
200 OK	RecommendedAction	Aggiornamento corretto dell'azione consigliata per il 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 InvalidRecommendedActionUpsertRequest: il corpo della richiesta di azione consigliata di aggiornamento non esiste o non ha proprietà o oggetti di stato. 400 InvalidRecommendedActionState - Lo stato specificato per l'azione consigliata non è valido 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. 404 RecommendedActionNotFound - Impossibile trovare l'azione consigliata richiesta. 404 AdvisorNotFound - Impossibile trovare l'advisor richiesto. 404 RecommendedActionNotFound - Impossibile trovare l'azione consigliata richiesta. 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

RecommendedAction

Aggiornamento corretto dell'azione consigliata per il 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 InvalidRecommendedActionUpsertRequest: il corpo della richiesta di azione consigliata di aggiornamento non esiste o non ha proprietà o oggetti di stato.
400 InvalidRecommendedActionState - Lo stato specificato per l'azione consigliata non è valido
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.
404 RecommendedActionNotFound - Impossibile trovare l'azione consigliata richiesta.
404 AdvisorNotFound - Impossibile trovare l'advisor richiesto.
404 RecommendedActionNotFound - Impossibile trovare l'azione consigliata richiesta.
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

Update database recommended action

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/recommendedActions/IR_[CRM]_[DataPoints]_4821CD2F9510D98184BB?api-version=2023-08-01

{
  "properties": {
    "state": {
      "currentValue": "Pending"
    }
  }
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/DatabaseRecommendedActionUpdate.json
// this example is just showing the usage of "DatabaseRecommendedActions_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this RecommendedActionResource created on azure
// for more information of creating RecommendedActionResource, please refer to the document of RecommendedActionResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "workloadinsight-demos";
string serverName = "misosisvr";
string databaseName = "IndexAdvisor_test_3";
string advisorName = "CreateIndex";
string recommendedActionName = "IR_[CRM]_[DataPoints]_4821CD2F9510D98184BB";
ResourceIdentifier recommendedActionResourceId = RecommendedActionResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName, advisorName, recommendedActionName);
RecommendedActionResource recommendedAction = client.GetRecommendedActionResource(recommendedActionResourceId);

// invoke the operation
RecommendedActionData data = new RecommendedActionData
{
    State = new RecommendedActionStateInfo(RecommendedActionCurrentState.Pending),
};
RecommendedActionResource result = await recommendedAction.UpdateAsync(data);

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
RecommendedActionData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

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/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": "Pending",
      "actionInitiatedBy": "User",
      "lastModified": "2017-06-20T15:11:15Z"
    },
    "isExecutableAction": true,
    "isRevertableAction": true,
    "isArchivedAction": false,
    "executeActionInitiatedBy": "User",
    "executeActionInitiatedTime": "2017-06-20T15:11:15Z",
    "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]"
    }
  }
}

Definizioni

Nome	Descrizione
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.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

ErrorDetail

Object

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

Object

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

Object

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

Object

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

Object

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

Object

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

Object

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

Object

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 Recommended Actions - Update

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Update database recommended action

Esempio di richiesta

Risposta di esempio

Definizioni

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ImplementationMethod

IsRetryable

RecommendedAction

RecommendedActionCurrentState

RecommendedActionErrorInfo

RecommendedActionImpactRecord

RecommendedActionImplementationInfo

RecommendedActionInitiatedBy

RecommendedActionMetricInfo

RecommendedActionStateInfo