Database Automatic Tuning - Get

Serviço:: SQL Database

Versão da API:: 2025-01-01

Obtém o ajuste automático de um banco de dados.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
databaseName	path	True	string	O nome do banco de dados.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	DatabaseAutomaticTuning	Operação do Azure concluída com sucesso.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Get a database's automatic tuning settings

Solicitação de exemplo

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=2025-01-01

Resposta de exemplo

Código de status:: 200

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

Definições

Nome	Description
AutomaticTuningDisabledReason	Descrição do motivo, se desejado e estado real são diferentes.
AutomaticTuningMode	Ajuste automático do estado desejado.
AutomaticTuningOptionModeActual	Estado real da opção de ajuste automático.
AutomaticTuningOptionModeDesired	Estado desejado da opção de ajuste automático.
AutomaticTuningOptions	Propriedades de ajuste automático para assistentes individuais.
createdByType	O tipo de identidade que criou o recurso.
DatabaseAutomaticTuning	Ajuste automático no nível do banco de dados.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
systemData	Metadados relativos à criação e última modificação do recurso.

AutomaticTuningDisabledReason

Enumeração

Descrição do motivo, se desejado e estado real são diferentes.

Valor	Description
Default	Default
Disabled	Desactivado
AutoConfigured	AutoConfigurado
InheritedFromServer	InheritedFromServer
QueryStoreOff	QueryStoreOff
QueryStoreReadOnly	QueryStoreReadOnly
NotSupported	Não Suportado

AutomaticTuningMode

Enumeração

Ajuste automático do estado desejado.

Valor	Description
Inherit	Herdar
Custom	Personalizado
Auto	Automático
Unspecified	Unspecified

AutomaticTuningOptionModeActual

Enumeração

Estado real da opção de ajuste automático.

Valor	Description
Off	Desativado
On	Ligado

AutomaticTuningOptionModeDesired

Enumeração

Estado desejado da opção de ajuste automático.

Valor	Description
Off	Desativado
On	Ligado
Default	Default

AutomaticTuningOptions

Objeto

Propriedades de ajuste automático para assistentes individuais.

Nome	Tipo	Description
actualState	AutomaticTuningOptionModeActual	Estado real da opção de ajuste automático.
desiredState	AutomaticTuningOptionModeDesired	Estado desejado da opção de ajuste automático.
reasonCode	integer (int32)	Código de motivo se desejado e estado real são diferentes.
reasonDesc	AutomaticTuningDisabledReason	Descrição do motivo, se desejado e estado real são diferentes.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key