Dela via


Server Automatic Tuning - Update

Uppdatera automatiska justeringsalternativ på servern.

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

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

serverName
path True

string

Namnet på servern.

subscriptionId
path True

string

Det prenumerations-ID som identifierar en Azure-prenumeration.

api-version
query True

string

DEN API-version som ska användas för begäran.

Begärandetext

Name Typ Description
properties.desiredState

AutomaticTuningServerMode

Automatiskt justera önskat tillstånd.

properties.options

<string,  AutomaticTuningServerOptions>

Definition av automatiska justeringsalternativ.

Svar

Name Typ Description
200 OK

ServerAutomaticTuning

Automatiska justeringsalternativ på servernivå har uppdaterats.

Other Status Codes

ErrorResponse

Felsvar: ***

  • 400 FeatureDisabledOnSelectedEdition – Användaren försökte använda en funktion som är inaktiverad i den aktuella databasutgåvan.

  • 400 InvalidIdentifier – Identifieraren innehåller NULL eller ett ogiltigt unicode-tecken.

  • 400 InvalidAutomaticTuningUpsertRequest – Brödtexten för automatisk justering av uppdateringsbegäran finns inte eller har inget egenskapsobjekt.

  • 400 InvalidAdvisorAutoExecuteStatus – Angiven status för automatisk körning för rådgivaren tillåts inte.

  • 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte

  • 404 DatabaseDoesNotExist – Den begärda databasen hittades inte

  • 404 SubscriptionDoesNotHaveElasticPool – Den begärda elastiska poolen hittades inte

  • 404 OperationIdNotFound – Åtgärden med ID finns inte.

  • 404 AutomaticTuningOptionNotFound – Det begärda alternativet för automatisk justering hittades inte.

  • 405 Stöds inte – den här funktionen stöds inte.

  • 409 Konflikt – Begäran kunde inte bearbetas på grund av en konflikt i begäran.

  • 409 CannotCancelOperation – hanteringsåtgärden är i ett tillstånd som inte kan avbrytas.

  • 409 OperationCancelled – Åtgärden har avbrutits av användaren.

  • 409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs.

  • 409 DefaultAdvisorStateNotAllowedInCustomServerMode – STANDARD advisor tillstånd tillåts inte i CUSTOM-läge

  • 409 UpdateNotAllowedIfServerAutotuningUpdateOperationInProgress – Inställningar för automatisk justering från tidigare begäran har inte spridits till alla användardatabaser.

  • 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser.

  • 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök igen.

  • 503 ServiceTemporarilyUnavailable – Funktionen är inte tillgänglig för tillfället.

  • 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Updates server automatic tuning settings with all properties
Updates server automatic tuning settings with minimal properties

Updates server automatic tuning settings with all properties

Exempelbegäran

PATCH https://management.azure.com/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/automaticTuning/current?api-version=2023-08-01

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

Exempelsvar

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

Updates server automatic tuning settings with minimal properties

Exempelbegäran

PATCH https://management.azure.com/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/automaticTuning/current?api-version=2023-08-01

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

Exempelsvar

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

Definitioner

Name Description
AutomaticTuningOptionModeActual

Verkligt tillstånd för automatisk justeringsalternativ.

AutomaticTuningOptionModeDesired

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

AutomaticTuningServerMode

Automatiskt justera önskat tillstånd.

AutomaticTuningServerOptions

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

AutomaticTuningServerReason

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

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

ServerAutomaticTuning

Automatisk justering på servernivå.

AutomaticTuningOptionModeActual

Verkligt tillstånd för automatisk justeringsalternativ.

Värde Description
Off
On

AutomaticTuningOptionModeDesired

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

Värde Description
Off
On
Default

AutomaticTuningServerMode

Automatiskt justera önskat tillstånd.

Värde Description
Custom
Auto
Unspecified

AutomaticTuningServerOptions

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

AutomaticTuningServerReason

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

AutomaticTuningServerReason

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

Värde Description
Default
Disabled
AutoConfigured

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

ServerAutomaticTuning

Automatisk justering på servernivå.

Name Typ Description
id

string

Resurs-ID.

name

string

Resursnamn.

properties.actualState

AutomaticTuningServerMode

Automatisk justering av verkligt tillstånd.

properties.desiredState

AutomaticTuningServerMode

Automatiskt justera önskat tillstånd.

properties.options

<string,  AutomaticTuningServerOptions>

Definition av automatiska justeringsalternativ.

type

string

Resurstyp.