Compartilhar via


Database Automatic Tuning - Update

Atualize as propriedades de ajuste automático para o banco de dados de destino.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/automaticTuning/current?api-version=2023-08-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

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor na API do Azure Resource Manager ou no portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

A ID da assinatura que identifica uma assinatura do Azure.

api-version
query True

string

A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome Tipo Description
properties.desiredState

AutomaticTuningMode

Ajuste automático do estado desejado.

properties.options

<string,  AutomaticTuningOptions>

Definição de opções de ajuste automático.

Respostas

Nome Tipo Description
200 OK

DatabaseAutomaticTuning

Atualizou com êxito as configurações de ajuste automático do banco de dados especificado.

Other Status Codes

ErrorResponse

Respostas de erro: ***

  • 400 FeatureDisabledOnSelectedEdition – O usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados.

  • 400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido.

  • 400 SystemDatabasesNotSupported – O usuário tentou obter informações de ajuste automático em bancos de dados do sistema.

  • 400 DataWarehouseNotSupported – O ajuste automático não tem suporte para o SQL Data Warehouse.

  • 400 InvalidAutomaticTuningUpsertRequest - O corpo da solicitação de ajuste automático de atualização não existe ou não tem nenhum objeto de propriedades.

  • 400 InvalidAdvisorAutoExecuteStatus – O status de execução automática especificado para o orientador não é permitido.

  • 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado

  • 404 DatabaseDoesNotExist – O banco de dados solicitado não foi encontrado

  • 404 SubscriptionDoesNotHaveElasticPool – O pool elástico solicitado não foi encontrado

  • 404 OperationIdNotFound – A operação com id não existe.

  • 404 AutomaticTuningOptionNotFound – A opção de ajuste automático solicitada não foi encontrada.

  • 405 NotSupported – Não há suporte para essa funcionalidade.

  • Conflito 409 – A solicitação não pôde ser processada devido ao conflito na solicitação.

  • 409 CannotCancelOperation – A operação de gerenciamento está em um estado que não pode ser cancelado.

  • 409 OperationCancelled – A operação foi cancelada pelo usuário.

  • 409 OperationInterrupted – A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.

  • 409 DefaultAdvisorStateNotAllowedInCustomDbMode – O estado do assistente PADRÃO não é permitido no modo CUSTOM

  • 409 DisabledBySystem – Essa opção está desabilitada pelo sistema

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 500 OperationTimedOut – A operação atingiu o tempo limite e foi revertida automaticamente. Tente novamente a operação.

  • 503 ServiceTemporarilyUnavailable – Recurso temporariamente indisponível.

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

Exemplos

Updates database automatic tuning settings with all properties
Updates database automatic tuning settings with minimal properties

Updates database automatic tuning settings with all properties

Solicitação de exemplo

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=2023-08-01

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

Resposta de exemplo

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

Solicitação de exemplo

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=2023-08-01

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

Resposta de exemplo

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

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.

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

AutomaticTuningDisabledReason

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

Valor Description
Default
Disabled
AutoConfigured
InheritedFromServer
QueryStoreOff
QueryStoreReadOnly
NotSupported

AutomaticTuningMode

Ajuste automático do estado desejado.

Valor Description
Inherit
Custom
Auto
Unspecified

AutomaticTuningOptionModeActual

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

Valor Description
Off
On

AutomaticTuningOptionModeDesired

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

Valor Description
Off
On
Default

AutomaticTuningOptions

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.

DatabaseAutomaticTuning

Ajuste automático no nível do banco de dados.

Nome Tipo Description
id

string

ID do recurso.

name

string

Nome do recurso.

properties.actualState

AutomaticTuningMode

Ajuste automático do estado real.

properties.desiredState

AutomaticTuningMode

Ajuste automático do estado desejado.

properties.options

<string,  AutomaticTuningOptions>

Definição de opções de ajuste automático.

type

string

Tipo de recurso.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.