Database Automatic Tuning - Get

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

Pobiera automatyczne dostrajanie bazy danych.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
databaseName	path	True	string	Nazwa bazy danych.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DatabaseAutomaticTuning	Pomyślnie pobrano właściwości automatycznego dostrajania bazy danych.
Other Status Codes		Odpowiedzi na błędy: *** 400 FeatureDisabledOnSelectedEdition — użytkownik próbował użyć funkcji, która jest wyłączona w bieżącej wersji bazy danych. 400 InvalidIdentifier — identyfikator zawiera wartość NULL lub nieprawidłowy znak Unicode. 400 SystemDatabasesNotSupported — użytkownik próbował uzyskać informacje o automatycznym dostrajaniu w systemowych bazach danych. 400 DataWarehouseNotSupported — automatyczne dostrajanie nie jest obsługiwane w usłudze SQL Data Warehouse. 404 DatabaseDoesNotExist — żądana baza danych nie została znaleziona 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 SubscriptionDoesNotHaveElasticPool — żądana pula elastyczna nie została znaleziona 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 405 NotSupported — ta funkcja nie jest obsługiwana. 409 Konflikt — nie można przetworzyć żądania z powodu konfliktu w żądaniu. 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji. 503 ServiceTemporarilyUnavailable — funkcja jest tymczasowo niedostępna. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

Get a database's automatic tuning settings

Przykładowe żądanie

HTTP

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

Java

/**
 * 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

Przykładowa odpowiedź

Kod stanu:

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"
      }
    }
  }
}

Definicje

Nazwa	Opis
AutomaticTuningDisabledReason	Opis przyczyny, jeśli jest to wymagane, a rzeczywisty stan jest inny.
AutomaticTuningMode	Automatyczne dostrajanie żądanego stanu.
AutomaticTuningOptionModeActual	Stan rzeczywisty opcji automatycznego dostrajania.
AutomaticTuningOptionModeDesired	Żądany stan opcji automatycznego dostrajania.
AutomaticTuningOptions	Właściwości automatycznego dostrajania dla poszczególnych doradców.
DatabaseAutomaticTuning	Automatyczne dostrajanie na poziomie bazy danych.

AutomaticTuningDisabledReason

Wyliczanie

Opis przyczyny, jeśli jest to wymagane, a rzeczywisty stan jest inny.

Wartość	Opis
AutoConfigured
Default
Disabled
InheritedFromServer
NotSupported
QueryStoreOff
QueryStoreReadOnly

AutomaticTuningMode

Wyliczanie

Automatyczne dostrajanie żądanego stanu.

Wartość	Opis
Auto
Custom
Inherit
Unspecified

AutomaticTuningOptionModeActual

Wyliczanie

Stan rzeczywisty opcji automatycznego dostrajania.

Wartość	Opis
Off
On

AutomaticTuningOptionModeDesired

Wyliczanie

Żądany stan opcji automatycznego dostrajania.

Wartość	Opis
Default
Off
On

AutomaticTuningOptions

Objekt

Właściwości automatycznego dostrajania dla poszczególnych doradców.

Nazwa	Typ	Opis
actualState	AutomaticTuningOptionModeActual	Stan rzeczywisty opcji automatycznego dostrajania.
desiredState	AutomaticTuningOptionModeDesired	Żądany stan opcji automatycznego dostrajania.
reasonCode	integer (int32)	Kod przyczyny, jeśli jest to wymagane, a rzeczywisty stan jest inny.
reasonDesc	AutomaticTuningDisabledReason	Opis przyczyny, jeśli jest to wymagane, a rzeczywisty stan jest inny.

DatabaseAutomaticTuning

Objekt

Automatyczne dostrajanie na poziomie bazy danych.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.actualState	AutomaticTuningMode	Automatyczne dostrajanie stanu rzeczywistego.
properties.desiredState	AutomaticTuningMode	Automatyczne dostrajanie żądanego stanu.
properties.options	<string,  AutomaticTuningOptions>	Definicja opcji automatycznego dostrajania.
type	string	Typ zasobu.