Database Automatic Tuning - Get

Dienst:: SQL Database

API-Version:: 2025-01-01

Ruft die automatische Optimierung einer Datenbank ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	DatabaseAutomaticTuning	Azure-Operation erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Get a database's automatic tuning settings

Beispielanforderung

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=2025-01-01

Beispiel für eine Antwort

Statuscode:: 200

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

Definitionen

Name	Beschreibung
AutomaticTuningDisabledReason	Die Beschreibung des Grundes bei Bedarf und der tatsächliche Zustand unterscheiden sich.
AutomaticTuningMode	Gewünschter Zustand der automatischen Optimierung.
AutomaticTuningOptionModeActual	Ist-Zustand der Automatischen Optimierungsoption.
AutomaticTuningOptionModeDesired	Gewünschter Zustand der automatischen Optimierungsoption.
AutomaticTuningOptions	Automatische Optimierungseigenschaften für einzelne Berater.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DatabaseAutomaticTuning	Automatische Optimierung auf Datenbankebene.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

AutomaticTuningDisabledReason

Enumeration

Die Beschreibung des Grundes bei Bedarf und der tatsächliche Zustand unterscheiden sich.

Wert	Beschreibung
Default	Vorgabe
Disabled	Deaktiviert
AutoConfigured	AutoConfigured
InheritedFromServer	InheritedFromServer
QueryStoreOff	QueryStoreOff
QueryStoreReadOnly	QueryStoreReadOnly
NotSupported	Nicht unterstützt

AutomaticTuningMode

Enumeration

Gewünschter Zustand der automatischen Optimierung.

Wert	Beschreibung
Inherit	Vererben
Custom	Kundenspezifisch
Auto	Auto
Unspecified	Nicht angegeben.

AutomaticTuningOptionModeActual

Enumeration

Ist-Zustand der Automatischen Optimierungsoption.

Wert	Beschreibung
Off	Deaktiviert
On	Ein

AutomaticTuningOptionModeDesired

Enumeration

Gewünschter Zustand der automatischen Optimierungsoption.

Wert	Beschreibung
Off	Deaktiviert
On	Ein
Default	Vorgabe

AutomaticTuningOptions

Objekt

Automatische Optimierungseigenschaften für einzelne Berater.

Name	Typ	Beschreibung
actualState	AutomaticTuningOptionModeActual	Ist-Zustand der Automatischen Optimierungsoption.
desiredState	AutomaticTuningOptionModeDesired	Gewünschter Zustand der automatischen Optimierungsoption.
reasonCode	integer (int32)	Der Grundcode ist bei Bedarf und tatsächlicher Zustand unterschiedlich.
reasonDesc	AutomaticTuningDisabledReason	Die Beschreibung des Grundes bei Bedarf und der tatsächliche Zustand unterscheiden sich.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key