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

Cria uma tarefa assíncrona para dados detalhados.

Descrição da operação

Antes de começar:

Use a versão mais recente do SDK do Alibaba Cloud ou do DAS.
Ao chamar operações do DAS usando o SDK, defina a região como cn-shanghai.
Apenas instâncias de banco de dados com a Edição Empresarial do DAS ativada suportam a criação de tarefas em lote. Para obter informações sobre os bancos de dados e regiões suportados por cada versão da Edição Empresarial do DAS, consulte Edições do DAS e recursos suportados.

Limite de taxa:

O número máximo de tarefas simultâneas é 10.

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:CreateSqlLogTask

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Não	O ID da instância de banco de dados.	pc-2ze8g2am97624****
NodeId	string	Não	O ID do nó. Nota Este parâmetro é aplicável apenas a instâncias de cluster. Você pode especificar este parâmetro para consultar a tarefa em lote de um nó específico. Se você não especificar este parâmetro, a tarefa em lote do nó primário será retornada por padrão.	pi-uf6k5f6g3912i****
Type	string	Não	O tipo de tarefa. Export: tarefa de exportação. Nota Para os parâmetros de filtro e valores suportados por Export, consulte Descrição dos parâmetros de solicitação. Query: tarefa de consulta.	Export
Name	string	Não	O nome da tarefa.	SQL audit export 1
Filters	array<object>	Não	A lista de condições de filtro.
	object	Não	A condição de filtro.
Key	string	Não	O nome do parâmetro de filtro. Nota Para os parâmetros de filtro e valores suportados, consulte Descrição dos parâmetros de solicitação.	KeyWords
Value	string	Não	O valor do parâmetro de filtro.	select
StartTime	integer	Não	A hora de início da tarefa. Especifique o valor como um timestamp UNIX. Unidade: milissegundos.	1596177993000
EndTime	integer	Não	A hora de término da tarefa. Especifique o valor como um timestamp UNIX. Unidade: milissegundos.	1608888296000
Role	string	Não	As informações do nó da instância de banco de dados PolarDB-X 2.0. polarx_cn: nó de computação. polarx_dn: nó de dados.	polarx_cn

Parâmetros e valores suportados para Key:

KeyWords: palavras-chave. Separe várias palavras-chave com espaços.
LogicalOperator: o operador lógico entre palavras-chave. Valores válidos: and ou or.
AccountName: o nome de usuário. Você pode especificar vários nomes de usuário separados por vírgulas. Máximo: 5.
DbName: o nome do banco de dados. Você pode especificar vários nomes de banco de dados separados por vírgulas. Máximo: 5.
HostAddress: o endereço IP do cliente. Você pode especificar vários endereços IP separados por vírgulas. Máximo: 5.
MaxConsume: a duração máxima de execução. Unidade: us.
MinConsume: a duração mínima de execução. Unidade: us.
MaxScanRows: o número máximo de linhas verificadas.
MinScanRows: o número mínimo de linhas verificadas.
SqlType: o tipo de SQL. Valores válidos: select, update, insert ou delete.
State: o resultado da execução. Valores válidos: 0 (bem-sucedido) ou 1 (falha).
ThreadId: o ID do thread.
SortKey: o nome da coluna de ordenação. Valores válidos: ScanRows (linhas verificadas), UpdateRows (linhas atualizadas), Consume (duração da execução), ExecuteTime (tempo de execução), ReturnRows (linhas retornadas), LockTime (tempo de espera de bloqueio), Frows (linhas buscadas pelos nós de computação do PolarDB-X 2.0), Scnt (solicitações DN dos nós de computação do PolarDB-X 2.0), CpuTime (tempo de execução da CPU) ou PhysicalRead (leituras físicas).
SortMethod: o método de ordenação. Valores válidos: DESC (decrescente) ou ASC (crescente). Valor padrão: DESC.
TraceId: o ID de rastreamento da instância PolarDB-X 2.0.
MinRows: o número mínimo de linhas atualizadas.
MaxRows: o número máximo de linhas atualizadas.
MinScnt: o número mínimo de solicitações DN dos nós de computação (CN) do PolarDB-X 2.0.
MaxScnt: o número máximo de solicitações DN dos nós de computação (CN) do PolarDB-X 2.0.
TrxId: o ID da transação.
Fail: o código de erro.
SqlId: o ID do SQL.
JobId: o ID da tarefa assíncrona usado para consultar posteriormente os resultados retornados.
Delimiter: o delimitador. Valores suportados: | , $ #.
Columns: quando Type = Export (o tipo de tarefa é tarefa de exportação), especifique as colunas de exportação separadas por espaços. Valores válidos:
- columnDBName: banco de dados
- columnThreadId: ID do thread
- columnAccountName: usuário
- columnHostAddress: IP do cliente
- columnSqlType: tipo de SQL
- columnState: status
- columnConsume: duração da execução (us)
- columnUpdateRows: linhas atualizadas
- columnScanRows: linhas verificadas
- columnReturnRows: linhas retornadas
- columnLockTime: tempo de espera de bloqueio
- columnLogicRead: leituras lógicas
- columnPhysicSyncRead: leituras síncronas físicas
- columnPhysicASyncRead: leituras assíncronas físicas
- columnOriginTime: tempo de execução (us)
- columnExecuteTime: tempo de execução (por exemplo, 2024-07-30 11:00:00)

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	string	O código de resposta.	200
Message	string	A mensagem retornada. Nota Se a solicitação for bem-sucedida, Successful será retornado. Se a solicitação falhar, uma mensagem de erro, como um código de erro, será retornada.	Successful
RequestId	string	O ID da solicitação.	83D9D59B-057A-54A9-BFF9-CF2B42F05645
Success	string	Indica se a solicitação foi bem-sucedida. true: bem-sucedida. false: falhou.	true
Data	object	Os dados retornados.
TaskId	string	O ID da tarefa.	54f8041743ca3a9ac5cb9342d050527c
InstanceId	string	O ID da instância de banco de dados.	pc-2ze8g2am97624****
Name	string	O nome da tarefa.	Export_test
Start	integer	A hora de início. Especifique o valor como um timestamp UNIX. Unidade: milissegundos.	1596177993000
End	integer	A hora de término. Especifique o valor como um timestamp UNIX. Unidade: milissegundos.	1608888296000
Status	string	O status da tarefa. INIT: agendamento pendente. RUNNING: em execução. FAILED: falhou. CANCELED: cancelada. COMPLETED: concluída. Nota Quando a tarefa estiver no estado COMPLETED, você poderá visualizar os resultados da tarefa.	COMPLETED
CreateTime	integer	A hora de criação da tarefa. Especifique o valor como um timestamp UNIX. Unidade: milissegundos.	1681363254423

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "83D9D59B-057A-54A9-BFF9-CF2B42F05645",
  "Success": "true",
  "Data": {
    "TaskId": "54f8041743ca3a9ac5cb9342d050527c",
    "InstanceId": "pc-2ze8g2am97624****",
    "Name": "Export_test",
    "Start": 1596177993000,
    "End": 1608888296000,
    "Status": "COMPLETED",
    "CreateTime": 1681363254423
  }
}

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.	Os parâmetros da solicitação são inválidos.
403	NoPermission	You are not authorized to do this action.	Você não tem as permissões para realizar esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.