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=2021-11-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 por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

A ID de 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

Estado desejado de ajuste automático.

properties.options

<string,  AutomaticTuningOptions>

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

Respostas

Nome Tipo Description
200 OK

DatabaseAutomaticTuning

As configurações de ajuste automático do banco de dados especificadas foram atualizadas com êxito.

Other Status Codes

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 – Não há suporte para o ajuste automático no 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 properties.

  • 400 InvalidAdvisorAutoExecuteStatus - Não é permitido executar automaticamente status especificados para o assistente.

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

  • 404 SubscriptionDoesNotHaveServer - O servidor 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 a conflitos na solicitação.

  • 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 DisabledBySystem - Essa opção está desabilitada pelo sistema

  • 409 DefaultAdvisorStateNotAllowedInCustomDbMode - O estado do assistente DEFAULT não é permitido no modo CUSTOM

  • 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 do máximo de solicitações que podem ser processadas por recursos disponíveis.

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

  • 503 ServiceTemporarilyUnavailable - Recurso temporariamente indisponível.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações 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

Sample Request

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

Sample Response

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

Sample Request

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

Sample Response

{
  "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 o estado desejado e real forem diferentes.

AutomaticTuningMode

Estado desejado de ajuste automático.

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 consultores individuais.

DatabaseAutomaticTuning

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

AutomaticTuningDisabledReason

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

Nome Tipo Description
AutoConfigured

string

Default

string

Disabled

string

InheritedFromServer

string

NotSupported

string

QueryStoreOff

string

QueryStoreReadOnly

string

AutomaticTuningMode

Estado desejado de ajuste automático.

Nome Tipo Description
Auto

string

Custom

string

Inherit

string

Unspecified

string

AutomaticTuningOptionModeActual

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

Nome Tipo Description
Off

string

On

string

AutomaticTuningOptionModeDesired

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

Nome Tipo Description
Default

string

Off

string

On

string

AutomaticTuningOptions

Propriedades de ajuste automático para consultores 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

Código de motivo se desejado e estado real forem diferentes.

reasonDesc

AutomaticTuningDisabledReason

Descrição do motivo se o estado desejado e real forem 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

Estado desejado de ajuste automático.

properties.options

<string,  AutomaticTuningOptions>

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

type

string

Tipo de recurso.