Server Automatic Tuning - Update

서비스:

SQL Database

API 버전:

2021-11-01

서버에서 자동 조정 옵션을 업데이트합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName	path	True	string	서버의 이름입니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
properties.desiredState	AutomaticTuningServerMode	원하는 상태를 자동으로 조정합니다.
properties.options	<string,  AutomaticTuningServerOptions>	자동 튜닝 옵션 정의입니다.

응답

Name	형식	Description
200 OK	ServerAutomaticTuning	서버 수준 자동 튜닝 옵션을 업데이트했습니다.
Other Status Codes		오류 응답: *** 400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다. 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다. 400 InvalidAutomaticTuningUpsertRequest - 업데이트 자동 튜닝 요청 본문이 없거나 속성 개체가 없습니다. 400 InvalidAdvisorAutoExecuteStatus - Advisor에 대해 지정된 자동 실행 상태 허용되지 않습니다. 404 DatabaseDoesNotExist - 요청된 데이터베이스를 찾을 수 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 SubscriptionDoesNotHaveElasticPool - 요청된 탄력적 풀을 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 404 AutomaticTuningOptionNotFound - 요청된 자동 튜닝 옵션을 찾을 수 없습니다. 405 NotSupported - 이 기능은 지원되지 않습니다. 409 충돌 - 요청의 충돌로 인해 요청을 처리할 수 없습니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 409 DefaultAdvisorStateNotAllowedInCustomServerMode - CUSTOM 모드에서 DEFAULT Advisor 상태가 허용되지 않음 409 UpdateNotAllowedIfServerAutotuningUpdateOperationInProgress - 이전 요청의 자동 튜닝 설정이 모든 사용자 데이터베이스로 전파되지 않았습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 ServiceTemporarilyUnavailable - 기능을 일시적으로 사용할 수 없습니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Updates server automatic tuning settings with all properties

Updates server automatic tuning settings with minimal properties

Updates server automatic tuning settings with all properties

샘플 요청

HTTP

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

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

Java

import com.azure.resourcemanager.sql.fluent.models.ServerAutomaticTuningInner;
import com.azure.resourcemanager.sql.models.AutomaticTuningOptionModeDesired;
import com.azure.resourcemanager.sql.models.AutomaticTuningServerMode;
import com.azure.resourcemanager.sql.models.AutomaticTuningServerOptions;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for ServerAutomaticTuning Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerAutomaticTuningUpdateMax.json
     */
    /**
     * Sample code: Updates server automatic tuning settings with all properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updatesServerAutomaticTuningSettingsWithAllProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAutomaticTunings().updateWithResponse(
            "default-sql-onebox", "testsvr11",
            new ServerAutomaticTuningInner().withDesiredState(AutomaticTuningServerMode.AUTO)
                .withOptions(mapOf("createIndex",
                    new AutomaticTuningServerOptions().withDesiredState(AutomaticTuningOptionModeDesired.OFF),
                    "dropIndex",
                    new AutomaticTuningServerOptions().withDesiredState(AutomaticTuningOptionModeDesired.ON),
                    "forceLastGoodPlan",
                    new AutomaticTuningServerOptions().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

샘플 응답

상태 코드:

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

샘플 요청

HTTP

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

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

Java

import com.azure.resourcemanager.sql.fluent.models.ServerAutomaticTuningInner;
import com.azure.resourcemanager.sql.models.AutomaticTuningServerMode;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for ServerAutomaticTuning Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerAutomaticTuningUpdateMin.json
     */
    /**
     * Sample code: Updates server automatic tuning settings with minimal properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updatesServerAutomaticTuningSettingsWithMinimalProperties(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAutomaticTunings().updateWithResponse(
            "default-sql-onebox", "testsvr11",
            new ServerAutomaticTuningInner().withDesiredState(AutomaticTuningServerMode.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

샘플 응답

상태 코드:

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

정의

Name	Description
AutomaticTuningOptionModeActual	자동 튜닝 옵션 실제 상태입니다.
AutomaticTuningOptionModeDesired	자동 튜닝 옵션 원하는 상태입니다.
AutomaticTuningServerMode	원하는 상태를 자동으로 조정합니다.
AutomaticTuningServerOptions	개별 관리자에 대한 자동 튜닝 속성입니다.
AutomaticTuningServerReason	원하는 상태와 실제 상태가 다른 경우 이유 설명입니다.
ServerAutomaticTuning	서버 수준 자동 튜닝.

AutomaticTuningOptionModeActual

자동 튜닝 옵션 실제 상태입니다.

Name	형식	Description
Off	string
On	string

AutomaticTuningOptionModeDesired

자동 튜닝 옵션 원하는 상태입니다.

Name	형식	Description
Default	string
Off	string
On	string

AutomaticTuningServerMode

원하는 상태를 자동으로 조정합니다.

Name	형식	Description
Auto	string
Custom	string
Unspecified	string

AutomaticTuningServerOptions

개별 관리자에 대한 자동 튜닝 속성입니다.

Name	형식	Description
actualState	AutomaticTuningOptionModeActual	자동 튜닝 옵션 실제 상태입니다.
desiredState	AutomaticTuningOptionModeDesired	자동 튜닝 옵션 원하는 상태입니다.
reasonCode	integer	원하는 코드와 실제 상태가 다른 경우 이유 코드입니다.
reasonDesc	AutomaticTuningServerReason	원하는 상태와 실제 상태가 다른 경우 이유 설명입니다.

AutomaticTuningServerReason

원하는 상태와 실제 상태가 다른 경우 이유 설명입니다.

Name	형식	Description
AutoConfigured	string
Default	string
Disabled	string

ServerAutomaticTuning

서버 수준 자동 튜닝.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.actualState	AutomaticTuningServerMode	자동 튜닝 실제 상태.
properties.desiredState	AutomaticTuningServerMode	원하는 상태를 자동으로 조정합니다.
properties.options	<string,  AutomaticTuningServerOptions>	자동 튜닝 옵션 정의입니다.
type	string	리소스 종류.