Server Automatic Tuning - Update

Is deze pagina nuttig?

Nog meer feedback?

Feedback wordt verzonden naar Microsoft: als u de knop Verzenden kiest, wordt uw feedback gebruikt om Microsoft-producten en -services te verbeteren. Privacybeleid.

Service:

SQL Database

API Version:

2021-02-01-preview

Automatische afstemmingsopties op de server bijwerken.

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

URI-parameters

Name	In	Required	Type	Description
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via Azure Resource Manager API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id die een Azure-abonnement identificeert.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Type	Description
properties.desiredState	AutomaticTuningServerMode	Automatisch afstemmen van de gewenste status.
properties.options	<string,  AutomaticTuningServerOptions>	Definitie van opties voor automatisch afstemmen.

Antwoorden

Name	Type	Description
200 OK	ServerAutomaticTuning	De opties voor automatisch afstemmen op serverniveau zijn bijgewerkt.
Other Status Codes		Foutreacties: *** 400 FeatureDisabledOnSelectedEdition: de gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld in de huidige database-editie. 400 InvalidIdentifier: de id bevat NULL of een ongeldig unicode-teken. 400 InvalidAutomaticTuningUpsertRequest: de aanvraag voor automatische afstemming van de update bestaat niet of heeft geen eigenschappenobject. 400 Invalid AdvisorAutoExecuteStatus: de opgegeven status voor automatisch uitvoeren voor de advisor is niet toegestaan. 404 DatabaseDoesNotExist - De aangevraagde database is niet gevonden 404 SubscriptionDoesNotHostServer - De aangevraagde server is niet gevonden 404 SubscriptionDoesNotAsticPool - De aangevraagde elastische pool is niet gevonden 404 OperationIdNotFound: de bewerking met Id bestaat niet. 404 AutomaticTuningOptionNotFound: de aangevraagde optie voor automatisch afstemmen is niet gevonden. 405 Niet ondersteund: deze functionaliteit wordt niet ondersteund. 409 Conflict: de aanvraag kan niet worden verwerkt vanwege een conflict in de aanvraag. 409 OperationCancelled: de bewerking is geannuleerd door de gebruiker. 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource. 409 Default AdvisorStateNotAllowedInCustomServerMode - STANDAARD advisor status niet toegestaan in aangepaste modus 409 UpdateNotAllowedIfServerAutotuningUpdateOperationInProgress: instellingen voor automatisch afstemmen uit een vorige aanvraag zijn niet doorgegeven aan alle gebruikersdatabases. 500 OperationTimedOut: er is een time-out voor de bewerking en deze wordt automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren. 503 ServiceTijdgeschikt Niet beschikbaar: functie tijdelijk niet beschikbaar.

Voorbeelden

Updates server automatic tuning settings with all properties

Updates server automatic tuning settings with minimal properties

Updates server automatic tuning settings with all properties

Sample Request

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

Request Body

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

Sample Response

Status code:

200

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

Sample Request

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

Request Body

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

Sample Response

Status code:

200

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

Definities

AutomaticTuningOptionModeActual	Werkelijke status van automatische afstemmingsoptie.
AutomaticTuningOptionModeDesired	Automatische afstemming optie gewenste status.
AutomaticTuningServerMode	Automatisch afstemmen van de gewenste status.
AutomaticTuningServerOptions	Eigenschappen automatisch afstemmen voor afzonderlijke adviseurs.
AutomaticTuningServerReason	Beschrijving van de reden, indien gewenst, en de werkelijke status is anders.
ServerAutomaticTuning	Automatisch afstemmen op serverniveau.

AutomaticTuningOptionModeActual

Werkelijke status van automatische afstemmingsoptie.

Name	Type	Description
Off	string
On	string

AutomaticTuningOptionModeDesired

Automatische afstemming optie gewenste status.

Name	Type	Description
Default	string
Off	string
On	string

AutomaticTuningServerMode

Automatisch afstemmen van de gewenste status.

Name	Type	Description
Auto	string
Custom	string
Unspecified	string

AutomaticTuningServerOptions

Eigenschappen automatisch afstemmen voor afzonderlijke adviseurs.

Name	Type	Description
actualState	AutomaticTuningOptionModeActual	Werkelijke status van automatische afstemmingsoptie.
desiredState	AutomaticTuningOptionModeDesired	Automatische afstemming optie gewenste status.
reasonCode	integer	Redencode indien gewenst en de werkelijke status verschillen.
reasonDesc	AutomaticTuningServerReason	Beschrijving van de reden, indien gewenst, en de werkelijke status is anders.

AutomaticTuningServerReason

Beschrijving van de reden, indien gewenst, en de werkelijke status is anders.

Name	Type	Description
AutoConfigured	string
Default	string
Disabled	string

ServerAutomaticTuning

Automatisch afstemmen op serverniveau.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.actualState	AutomaticTuningServerMode	Automatische afstemming van de werkelijke status.
properties.desiredState	AutomaticTuningServerMode	Automatisch afstemmen van de gewenste status.
properties.options	<string,  AutomaticTuningServerOptions>	Definitie van opties voor automatisch afstemmen.
type	string	Resourcetype.