Database Automatic Tuning - Update

Referentie

Service:: SQL Database

API-versie:: 2021-11-01

Automatische afstemmingseigenschappen voor doeldatabase bijwerken.

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

URI-parameters

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

Aanvraagbody

Name	Type	Description
properties.desiredState	AutomaticTuningMode	Automatische afstemming van de gewenste status.
properties.options	<string, AutomaticTuningOptions>	Definitie van opties voor automatisch afstemmen.

Antwoorden

Name	Type	Description
200 OK	DatabaseAutomaticTuning	De opgegeven instellingen voor automatisch afstemmen van de database zijn bijgewerkt.
Other Status Codes		Foutreacties: *** 400 FeatureDisabledOnSelectedEdition - 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 SystemDatabasesNotSupported - Gebruiker heeft geprobeerd automatische afstemmingsinformatie over systeemdatabases op te halen. 400 DataWarehouseNotSupported - Automatisch afstemmen wordt niet ondersteund voor SQL Data Warehouse. 400 InvalidAutomaticTuningUpsertRequest - De aanvraagtekst voor automatisch afstemmen van updates bestaat niet of heeft geen eigenschappenobject. 400 InvalidAdvisorAutoExecuteStatus - Opgegeven status voor automatisch uitvoeren voor de advisor is niet toegestaan. 404 DatabaseDoesNotExist - De aangevraagde database is niet gevonden 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 SubscriptionDoesNotHaveElasticPool - 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 - 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 DisabledBySystem - Deze optie is uitgeschakeld door het systeem 409 DefaultAdvisorStateNotAllowedInCustomDbMode - DEFAULT advisor-status is niet toegestaan in aangepaste modus 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren. 503 ServiceTemporarilyUnavailable - Functie tijdelijk niet beschikbaar. 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Name

Type

Description

200 OK

DatabaseAutomaticTuning

De opgegeven instellingen voor automatisch afstemmen van de database zijn bijgewerkt.

Other Status Codes

Foutreacties: ***

400 FeatureDisabledOnSelectedEdition - 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 SystemDatabasesNotSupported - Gebruiker heeft geprobeerd automatische afstemmingsinformatie over systeemdatabases op te halen.
400 DataWarehouseNotSupported - Automatisch afstemmen wordt niet ondersteund voor SQL Data Warehouse.
400 InvalidAutomaticTuningUpsertRequest - De aanvraagtekst voor automatisch afstemmen van updates bestaat niet of heeft geen eigenschappenobject.
400 InvalidAdvisorAutoExecuteStatus - Opgegeven status voor automatisch uitvoeren voor de advisor is niet toegestaan.
404 DatabaseDoesNotExist - De aangevraagde database is niet gevonden
404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden
404 SubscriptionDoesNotHaveElasticPool - 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 - 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 DisabledBySystem - Deze optie is uitgeschakeld door het systeem
409 DefaultAdvisorStateNotAllowedInCustomDbMode - DEFAULT advisor-status is niet toegestaan in aangepaste modus
429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.
429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.
500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren.
503 ServiceTemporarilyUnavailable - Functie tijdelijk niet beschikbaar.
503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Voorbeelden

Updates database automatic tuning settings with all properties

Updates database automatic tuning settings with minimal properties

Updates database automatic tuning settings with all properties

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=2021-11-01

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


import com.azure.resourcemanager.sql.fluent.models.DatabaseAutomaticTuningInner;
import com.azure.resourcemanager.sql.models.AutomaticTuningMode;
import com.azure.resourcemanager.sql.models.AutomaticTuningOptionModeDesired;
import com.azure.resourcemanager.sql.models.AutomaticTuningOptions;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for DatabaseAutomaticTuning Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseAutomaticTuningUpdateMax.json
     */
    /**
     * Sample code: Updates database automatic tuning settings with all properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updatesDatabaseAutomaticTuningSettingsWithAllProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseAutomaticTunings().updateWithResponse(
            "default-sql-onebox", "testsvr11", "db1",
            new DatabaseAutomaticTuningInner().withDesiredState(AutomaticTuningMode.AUTO)
                .withOptions(mapOf("createIndex",
                    new AutomaticTuningOptions().withDesiredState(AutomaticTuningOptionModeDesired.OFF), "dropIndex",
                    new AutomaticTuningOptions().withDesiredState(AutomaticTuningOptionModeDesired.ON),
                    "forceLastGoodPlan",
                    new AutomaticTuningOptions().withDesiredState(AutomaticTuningOptionModeDesired.DEFAULT))),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

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

Updates database automatic tuning settings with minimal properties

Voorbeeldaanvraag

HTTP
Java

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=2021-11-01

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


import com.azure.resourcemanager.sql.fluent.models.DatabaseAutomaticTuningInner;
import com.azure.resourcemanager.sql.models.AutomaticTuningMode;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for DatabaseAutomaticTuning Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseAutomaticTuningUpdateMin.json
     */
    /**
     * Sample code: Updates database automatic tuning settings with minimal properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updatesDatabaseAutomaticTuningSettingsWithMinimalProperties(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseAutomaticTunings().updateWithResponse(
            "default-sql-onebox", "testsvr11", "db1",
            new DatabaseAutomaticTuningInner().withDesiredState(AutomaticTuningMode.AUTO),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

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

Definities

Name	Description
AutomaticTuningDisabledReason	De beschrijving van de reden, indien gewenst, en de werkelijke status verschillen.
AutomaticTuningMode	Automatische afstemming van de gewenste status.
AutomaticTuningOptionModeActual	Automatische afstemmingsoptie werkelijke status.
AutomaticTuningOptionModeDesired	Gewenste status van optie voor automatisch afstemmen.
AutomaticTuningOptions	Automatische afstemming van eigenschappen voor individuele adviseurs.
DatabaseAutomaticTuning	Automatisch afstemmen op databaseniveau.

AutomaticTuningDisabledReason

De beschrijving van de reden, indien gewenst, en de werkelijke status verschillen.

Name	Type	Description
AutoConfigured	string
Default	string
Disabled	string
InheritedFromServer	string
NotSupported	string
QueryStoreOff	string
QueryStoreReadOnly	string

AutomaticTuningMode

Automatische afstemming van de gewenste status.

Name	Type	Description
Auto	string
Custom	string
Inherit	string
Unspecified	string

AutomaticTuningOptionModeActual

Automatische afstemmingsoptie werkelijke status.

Name	Type	Description
Off	string
On	string

AutomaticTuningOptionModeDesired

Gewenste status van optie voor automatisch afstemmen.

Name	Type	Description
Default	string
Off	string
On	string

AutomaticTuningOptions

Automatische afstemming van eigenschappen voor individuele adviseurs.

Name	Type	Description
actualState	AutomaticTuningOptionModeActual	Automatische afstemmingsoptie werkelijke status.
desiredState	AutomaticTuningOptionModeDesired	Gewenste status van optie voor automatisch afstemmen.
reasonCode	integer	De redencode, indien gewenst, en de werkelijke status verschillen.
reasonDesc	AutomaticTuningDisabledReason	De beschrijving van de reden, indien gewenst, en de werkelijke status verschillen.