GetSqlOptimizeAdvice - Database Autonomy Service: Central de Documentação do Alibaba Cloud

Consulta sugestões de otimização geradas pelo recurso de diagnóstico de SQL do Database Autonomy Service (DAS).

Descrição da operação

O recurso de diagnóstico de SQL fornece sugestões de otimização para instâncias com base nos resultados dos diagnósticos. Você pode usar as sugestões de otimização para otimizar os índices das instâncias. Para obter mais informações, consulte Otimização automática de SQL.

Nota

Retorna apenas sugestões de otimização que o recurso de diagnóstico de SQL gera automaticamente.

Antes de chamar esta operação, observe os seguintes itens:

Esta operação é aplicável a instâncias do ApsaraDB RDS for MySQL e clusters do PolarDB for MySQL.
Se você usar um SDK do Alibaba Cloud ou SDK do DAS para chamar esta operação, recomendamos que use a versão mais recente do SDK.
Se você usar um SDK para chamar operações do DAS, deverá definir o ID da região como cn-shanghai.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

hdm:GetSqlOptimizeAdvice

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ConsoleContext	string	Não	O parâmetro reservado.	None
Engine	string	Não	O mecanismo de banco de dados. Valores válidos: MySQL: ApsaraDB RDS for MySQL. PolarDBMySQL: PolarDB for MySQL.	MySQL
InstanceIds	string	Não	O ID da instância. Nota Você deve especificar o ID da instância apenas se a sua instância de banco de dados for uma instância do ApsaraDB RDS for MySQL ou um cluster do PolarDB for MySQL.	rm-2ze1jdv45i7l6****
StartDt	string	Não	A data de início do intervalo de tempo a ser consultado. Especifique a data no formato yyyyMMdd. O horário deve estar em UTC. O valor padrão deste parâmetro é um dia antes do dia atual. O valor deve ser anterior ao dia atual.	20210916
EndDt	string	Não	A data de término do intervalo de tempo a ser consultado. Especifique a data no formato yyyyMMdd. O horário deve estar em UTC. O valor padrão deste parâmetro é um dia antes do dia atual. O valor deve ser anterior ao dia atual. O intervalo entre a data de início e a data de término não pode exceder 30 dias.	20210917
Region	string	Não	A região na qual a instância reside. Valores válidos: cn-china: China continental. cn-hongkong: China (Hong Kong). ap-southeast-1: Singapura. Este parâmetro entra em vigor apenas se InstanceIds for deixado vazio. Se você deixar InstanceIds vazio, o sistema obtém dados da região especificada por Region. Por padrão, Region é definido como cn-china. Se você especificar InstanceIds, Region não entra em vigor e o sistema obtém dados da região na qual a primeira instância especificada reside.** Nota Se suas instâncias residirem nas regiões dentro da China continental, defina este parâmetro como cn-china**.	cn-china

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	The response parameters.
Code	string	O código de status HTTP retornado.	200
Message	string	A mensagem retornada. Nota Se a solicitação for bem-sucedida, Successful é retornado. Se a solicitação falhar, uma mensagem de erro, como um código de erro, é retornada.	Successful
Data	object	As informações detalhadas, incluindo os códigos de erro e o número de entradas retornadas.
Status	string	O status da tarefa. Valores válidos: INIT: A tarefa está sendo inicializada. RUNNING: A tarefa está em execução. FINISH: A tarefa foi concluída. FAILED: A tarefa falhou.	FINISH
StatusCode	string	O código de status da tarefa. Valores válidos: NO_DATA: Nenhum dado é retornado. INTERNAL_ERROR: Ocorreu um erro interno. SUCCESS: A tarefa foi bem-sucedida.	SUCCESS
DownloadUrl	string	A URL usada para baixar o arquivo.	https://das-sql-optimize.oss-cn-shanghai.aliyuncs.com/adb/oss_sql_optimize_advice/1083*******
CreateTime	string	O horário em que a tarefa foi criada. O valor é um carimbo de data/hora UNIX que representa o número de milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC.	1632303861000
ExpireTime	string	O horário em que o arquivo expira. O valor é um carimbo de data/hora UNIX que representa o número de milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC. Nota O arquivo expira três dias após a criação da tarefa.	1632563061000
TaskId	string	O ID da tarefa.	2021091710461519216****
RequestId	string	O ID da solicitação.	B6D17591-B48B-4D31-9CD6-9B9796B2****
Success	string	Indica se a solicitação foi bem-sucedida. Valores válidos: true false	true

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "Successful",
  "Data": {
    "Status": "FINISH",
    "StatusCode": "SUCCESS",
    "DownloadUrl": "https://das-sql-optimize.oss-cn-shanghai.aliyuncs.com/adb/oss_sql_optimize_advice/1083*******",
    "CreateTime": "1632303861000",
    "ExpireTime": "1632563061000",
    "TaskId": "2021091710461519216****"
  },
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParams	The request parameters are invalid.
403	NoPermission	You are not authorized to do this action.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.