Database Automatic Tuning - Get

Service:

SQL Database

API Version:

2021-11-01

데이터베이스의 자동 조정을 가져옵니다.

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

URI 매개 변수

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

응답

Name	형식	Description
200 OK	DatabaseAutomaticTuning	데이터베이스 자동 튜닝 속성을 검색했습니다.
Other Status Codes		오류 응답: *** 400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다. 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다. 400 SystemDatabasesNotSupported - 사용자가 시스템 데이터베이스에 대한 자동 조정 정보를 얻으려고 했습니다. 400 DataWarehouseNotSupported - SQL Data Warehouse 대해 자동 조정이 지원되지 않습니다. 404 DatabaseDoesNotExist - 요청된 데이터베이스를 찾을 수 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 SubscriptionDoesNotHaveElasticPool - 요청된 탄력적 풀을 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 405 지원되지 않음 - 이 기능은 지원되지 않습니다. 409 충돌 - 요청의 충돌로 인해 요청을 처리할 수 없습니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 ServiceTemporarilyUnavailable - 기능을 일시적으로 사용할 수 없습니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Get a database's automatic tuning settings

Sample Request

HTTP

GET 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

Java

import com.azure.core.util.Context;

/** Samples for DatabaseAutomaticTuning Get. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseAutomaticTuningGet.json
     */
    /**
     * Sample code: Get a database's automatic tuning settings.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getADatabaseSAutomaticTuningSettings(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseAutomaticTunings().getWithResponse("default-sql-onebox",
            "testsvr11", "db1", Context.NONE);
    }
}

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

Sample Response

Status code:

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

정의

Name	Description
AutomaticTuningDisabledReason	원하는 상태와 실제 상태가 다른 경우 이유 설명입니다.
AutomaticTuningMode	원하는 상태를 자동으로 조정합니다.
AutomaticTuningOptionModeActual	자동 튜닝 옵션 실제 상태입니다.
AutomaticTuningOptionModeDesired	자동 조정 옵션 원하는 상태입니다.
AutomaticTuningOptions	개별 어드바이저에 대한 자동 조정 속성입니다.
DatabaseAutomaticTuning	데이터베이스 수준 자동 튜닝.

AutomaticTuningDisabledReason

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

Name	형식	Description
AutoConfigured	string
Default	string
Disabled	string
InheritedFromServer	string
NotSupported	string
QueryStoreOff	string
QueryStoreReadOnly	string

AutomaticTuningMode

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

Name	형식	Description
Auto	string
Custom	string
Inherit	string
Unspecified	string

AutomaticTuningOptionModeActual

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

Name	형식	Description
Off	string
On	string

AutomaticTuningOptionModeDesired

자동 조정 옵션 원하는 상태입니다.

Name	형식	Description
Default	string
Off	string
On	string

AutomaticTuningOptions

개별 어드바이저에 대한 자동 조정 속성입니다.

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

DatabaseAutomaticTuning

데이터베이스 수준 자동 튜닝.

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