Database Automatic Tuning - Update

Tjänst:: SQL Database

API-version:: 2025-01-01

Uppdatera egenskaperna för automatisk justering för måldatabasen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
databaseName	path	True	string	Namnet på databasen.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
properties.desiredState	AutomaticTuningMode	Automatiskt justera önskat tillstånd.
properties.options	<string, AutomaticTuningOptions>	Definition av automatiska justeringsalternativ.

Svar

Name	Typ	Description
200 OK	DatabaseAutomaticTuning	Azure-operationen slutfördes framgångsrikt.
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Updates database automatic tuning settings with all properties

Updates database automatic tuning settings with minimal properties

Updates database automatic tuning settings with all properties

Exempelbegäran

HTTP

PATCH 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

{
  "properties": {
    "desiredState": "Auto",
    "options": {
      "createIndex": {
        "desiredState": "Off"
      },
      "dropIndex": {
        "desiredState": "On"
      },
      "forceLastGoodPlan": {
        "desiredState": "Default"
      }
    }
  }
}

Exempelsvar

Statuskod:: 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": "Off",
        "desiredState": "Off"
      },
      "dropIndex": {
        "actualState": "On",
        "desiredState": "On"
      },
      "forceLastGoodPlan": {
        "actualState": "On",
        "desiredState": "Default",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "maintainIndex": {
        "actualState": "Off",
        "desiredState": "Default",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      }
    }
  }
}

Updates database automatic tuning settings with minimal properties

Exempelbegäran

HTTP

PATCH 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

{
  "properties": {
    "desiredState": "Auto"
  }
}

Exempelsvar

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

Definitioner

Name	Description
AutomaticTuningDisabledReason	Orsaksbeskrivning om önskat och faktiskt tillstånd skiljer sig.
AutomaticTuningMode	Automatiskt justera önskat tillstånd.
AutomaticTuningOptionModeActual	Verkligt tillstånd för automatisk justeringsalternativ.
AutomaticTuningOptionModeDesired	Önskat tillstånd för alternativ för automatisk justering.
AutomaticTuningOptions	Egenskaper för automatisk justering för enskilda rådgivare.
createdByType	Den typ av identitet som skapade resursen.
DatabaseAutomaticTuning	Automatisk justering på databasnivå.
ErrorAdditionalInfo	Resurshanteringsfelet ytterligare information.
ErrorDetail	Detaljerna om felet.
ErrorResponse	Felsvar
systemData	Metadata som rör skapande och senaste ändring av resursen.

AutomaticTuningDisabledReason

Uppräkning

Orsaksbeskrivning om önskat och faktiskt tillstånd skiljer sig.

Värde	Description
Default	Standardinställning
Disabled	Inaktiverad
AutoConfigured	AutoConfigured
InheritedFromServer	InheritedFromServer
QueryStoreOff	QueryStoreOff
QueryStoreReadOnly	QueryStoreReadOnly
NotSupported	NotSupported

AutomaticTuningMode

Uppräkning

Automatiskt justera önskat tillstånd.

Värde	Description
Inherit	Ärva
Custom	Skräddarsydd
Auto	Automatisk
Unspecified	Ospecificerad

AutomaticTuningOptionModeActual

Uppräkning

Verkligt tillstånd för automatisk justeringsalternativ.

Värde	Description
Off	Av
On	På

AutomaticTuningOptionModeDesired

Uppräkning

Önskat tillstånd för alternativ för automatisk justering.

Värde	Description
Off	Av
On	På
Default	Standardinställning

AutomaticTuningOptions

Objekt

Egenskaper för automatisk justering för enskilda rådgivare.

Name	Typ	Description
actualState	AutomaticTuningOptionModeActual	Verkligt tillstånd för automatisk justeringsalternativ.
desiredState	AutomaticTuningOptionModeDesired	Önskat tillstånd för alternativ för automatisk justering.
reasonCode	integer (int32)	Orsakskod om önskat och faktiskt tillstånd skiljer sig.
reasonDesc	AutomaticTuningDisabledReason	Orsaksbeskrivning om önskat och faktiskt tillstånd skiljer sig.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key