Database Automatic Tuning - Get

Service:

SQL Database

API Version:

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 wyłączonej 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 przypadku Data Warehouse SQL. 404 DatabaseDoesNotExist — nie można odnaleźć żądanej bazy danych 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 SubscriptionDoesNotHaveElasticPool — nie znaleziono żądanej elastycznej puli 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

Sample Request

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

import com.azure.core.util.Context;

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

Sample Response

Status code:

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 w razie potrzeby i rzeczywisty stan są różne.
AutomaticTuningMode	Żądany stan automatycznego dostrajania.
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

Opis przyczyny w razie potrzeby i rzeczywisty stan są różne.

Nazwa	Typ	Opis
AutoConfigured	string
Default	string
Disabled	string
InheritedFromServer	string
NotSupported	string
QueryStoreOff	string
QueryStoreReadOnly	string

AutomaticTuningMode

Żądany stan automatycznego dostrajania.

Nazwa	Typ	Opis
Auto	string
Custom	string
Inherit	string
Unspecified	string

AutomaticTuningOptionModeActual

Stan rzeczywisty opcji automatycznego dostrajania.

Nazwa	Typ	Opis
Off	string
On	string

AutomaticTuningOptionModeDesired

Żądany stan opcji automatycznego dostrajania.

Nazwa	Typ	Opis
Default	string
Off	string
On	string

AutomaticTuningOptions

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	Kod przyczyny w razie potrzeby i rzeczywisty stan są różne.
reasonDesc	AutomaticTuningDisabledReason	Opis przyczyny w razie potrzeby i rzeczywisty stan są różne.

DatabaseAutomaticTuning

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	Żądany stan automatycznego dostrajania.
properties.options	<string,  AutomaticTuningOptions>	Definicja opcji automatycznego dostrajania.
type	string	Typ zasobu.