Database Automatic Tuning - Get

Riferimento

Servizio:: SQL Database

Versione API:: 2021-11-01

Ottiene l'ottimizzazione automatica di un database.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/automaticTuning/current?api-version=2021-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
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

Nome	Tipo	Descrizione
200 OK	DatabaseAutomaticTuning	Proprietà di ottimizzazione automatica del database recuperate correttamente.
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. 400 SystemDatabasesNotSupported - Utente ha cercato di ottenere informazioni di ottimizzazione automatica sui database di sistema. 400 DataWarehouseNotSupported : l'ottimizzazione automatica non è supportata per sql Data Warehouse. 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 OperationIdNotFound: l'operazione con ID non esiste. 405 NotSupported : questa funzionalità non è supportata. 409 Conflitto - Impossibile elaborare la richiesta a causa del conflitto nella richiesta. 409 OperationCancelled: l'operazione è stata annullata dall'utente. 409 Operazione interrotta: impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. Ripetere l'operazione. 503 ServiceTemporarilyUnavailable - Funzionalità temporaneamente non disponibile. 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Nome

Tipo

Descrizione

200 OK

DatabaseAutomaticTuning

Proprietà di ottimizzazione automatica del database recuperate correttamente.

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.
400 SystemDatabasesNotSupported - Utente ha cercato di ottenere informazioni di ottimizzazione automatica sui database di sistema.
400 DataWarehouseNotSupported : l'ottimizzazione automatica non è supportata per sql Data Warehouse.
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 OperationIdNotFound: l'operazione con ID non esiste.
405 NotSupported : questa funzionalità non è supportata.
409 Conflitto - Impossibile elaborare la richiesta a causa del conflitto nella richiesta.
409 OperationCancelled: l'operazione è stata annullata dall'utente.
409 Operazione interrotta: impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa.
429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.
429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.
500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. Ripetere l'operazione.
503 ServiceTemporarilyUnavailable - Funzionalità temporaneamente non disponibile.
503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

Get a database's automatic tuning settings

GET https://management.azure.com/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/databases/db1/automaticTuning/current?api-version=2021-11-01


/**
 * Samples for DatabaseAutomaticTuning Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseAutomaticTuningGet.json
     */
    /**
     * Sample code: Get a database's automatic tuning settings.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getADatabaseSAutomaticTuningSettings(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseAutomaticTunings().getWithResponse("default-sql-onebox",
            "testsvr11", "db1", com.azure.core.util.Context.NONE);
    }
}

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/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/databases/db1/automaticTuning/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/automaticTuning",
  "properties": {
    "desiredState": "Auto",
    "actualState": "Auto",
    "options": {
      "forceLastGoodPlan": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "createIndex": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "dropIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "maintainIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      }
    }
  }
}

Definizioni

Nome	Descrizione
AutomaticTuningDisabledReason	Descrizione del motivo se lo stato desiderato e effettivo sono diversi.
AutomaticTuningMode	Stato desiderato di ottimizzazione automatica.
AutomaticTuningOptionModeActual	Opzione di ottimizzazione automatica stato effettivo.
AutomaticTuningOptionModeDesired	Opzione di ottimizzazione automatica stato desiderato.
AutomaticTuningOptions	Proprietà di ottimizzazione automatica per singoli advisor.
DatabaseAutomaticTuning	Ottimizzazione automatica a livello di database.

AutomaticTuningDisabledReason

Descrizione del motivo se lo stato desiderato e effettivo sono diversi.

Nome	Tipo	Descrizione
AutoConfigured	string
Default	string
Disabled	string
InheritedFromServer	string
NotSupported	string
QueryStoreOff	string
QueryStoreReadOnly	string

AutomaticTuningMode

Stato desiderato di ottimizzazione automatica.

Nome	Tipo	Descrizione
Auto	string
Custom	string
Inherit	string
Unspecified	string

AutomaticTuningOptionModeActual

Opzione di ottimizzazione automatica stato effettivo.

Nome	Tipo	Descrizione
Off	string
On	string

AutomaticTuningOptionModeDesired

Opzione di ottimizzazione automatica stato desiderato.

Nome	Tipo	Descrizione
Default	string
Off	string
On	string

AutomaticTuningOptions

Proprietà di ottimizzazione automatica per singoli advisor.

Nome	Tipo	Descrizione
actualState	AutomaticTuningOptionModeActual	Opzione di ottimizzazione automatica stato effettivo.
desiredState	AutomaticTuningOptionModeDesired	Opzione di ottimizzazione automatica stato desiderato.
reasonCode	integer	Il codice motivo se desiderato e lo stato effettivo sono diversi.
reasonDesc	AutomaticTuningDisabledReason	Descrizione del motivo se lo stato desiderato e effettivo sono diversi.