Todos os produtos
Search

Este produto

    Database Autonomy Service:CreateSqlLogTask

    Central de documentação

    Database Autonomy Service:CreateSqlLogTask

    Última atualização: Jun 28, 2026

    Cria uma tarefa offline para o Database Autonomy Service (DAS) Enterprise Edition.

    Descrição da operação

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

    • 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.

    • Você pode criar uma tarefa offline apenas para instâncias de banco de dados nas quais o DAS Enterprise Edition V2 ou V3 esteja ativado. Para obter mais informações sobre os bancos de dados e regiões compatíveis com as várias versões do DAS Enterprise Edition, consulte Edições e recursos compatíveis.

    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

    *All Resource

    *

    		 Nenhuma 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 está disponível apenas para instâncias executadas em uma arquitetura de cluster. Você pode especificar este parâmetro para consultar as tarefas offline de um nó específico. Por padrão, se este parâmetro não for especificado, as informações sobre as tarefas offline do nó primário serão retornadas.

    pi-uf6k5f6g3912i****
    Type

    string

    Não

    O tipo da tarefa. Valores válidos:

    • Export

    • Query

    • Insight

    Export
    Name

    string

    Não

    O nome da tarefa.

    SQL audit export 1
    Filters

    array<object>

    Não

    As condições de filtro.

    object

    Não

    Key

    string

    Não

    O nome do parâmetro de filtro.

    Nota

    Para obter mais informações sobre os parâmetros de filtro compatíveis e seus valores válidos, consulte o seguinte suplemento sobre o parâmetro Key.

    KeyWords
    Value

    string

    Não

    O valor do parâmetro de filtro.

    select
    StartTime

    integer

    Não

    O início do intervalo de tempo a ser consultado. Especifique a hora no formato de carimbo de data/hora UNIX. Unidade: milissegundos.

    1596177993000

    EndTime

    integer

    Não

    O fim do intervalo de tempo a ser consultado. Especifique a hora no formato de carimbo de data/hora UNIX. Unidade: milissegundos.

    1608888296000

    Role

    string

    Não

    A função do nó da instância de banco de dados PolarDB-X 2.0. Valores válidos:

    • polarx_cn: nó de computação

    • polarx_dn: nó de dados

    polarx_cn

    A lista a seguir descreve os parâmetros de filtro que podem ser usados como Key e seus valores válidos:

    • KeyWords: as palavras-chave. Você pode especificar várias palavras-chave separadas por espaços.

    • LogicalOperator: a operação lógica entre palavras-chave. Valores válidos: and e or.

    • AccountName: o nome de usuário.

    • DBName: o nome do banco de dados.

    • HostAddress: o endereço IP do cliente.

    • MaxConsume: a quantidade máxima de tempo consumida. Unidade: milissegundos.

    • MinConsume: a quantidade mínima de tempo consumida. Unidade: milissegundos.

    • MaxScanRows: o número máximo de linhas verificadas.

    • MinScanRows: o número mínimo de linhas verificadas.

    • SqlType: o tipo da instrução SQL. Valores válidos: select, update, insert e delete.

    • State: o resultado da execução. Valores válidos: 0 e 1. O valor 0 indica que a execução da instrução SQL foi bem-sucedida. O valor 1 indica que a execução da instrução SQL falhou.

    • ThreadId: o ID do thread.

    • SortKey: o nome da coluna usada para classificação. Valores válidos: ScanRows, UpdateRows, Consume, ExecuteTime, ReturnRows, LockTime, Frows, Scnt, CpuTime e PhysicalRead. O valor ScanRows indica o número de linhas verificadas. O valor UpdateRows indica o número de linhas atualizadas. O valor Consume indica a duração da consulta. O valor ExecuteTime indica a hora em que a consulta foi realizada. O valor ReturnRows indica o número de linhas retornadas. O valor LockTime indica a duração da espera de bloqueio. O valor Frows indica o número de linhas extraídas pelos nós de computação da instância de banco de dados PolarDB-X 2.0. O valor Scnt indica o número de solicitações enviadas aos nós de dados pelos nós de computação da instância de banco de dados PolarDB-X 2.0. O valor CpuTime indica a duração da execução da CPU. O valor PhysicalRead indica o número de leituras físicas.

    • SortMethod: a ordem em que os logs consultados são classificados. Valores válidos: DESC e ASC. O valor DESC indica a ordem decrescente. O valor ASC indica a ordem crescente. Valor padrão: DESC.

    • TraceId: o ID de rastreamento da instância de banco de dados 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 enviadas aos nós de dados pelos nós de computação da instância de banco de dados PolarDB-X 2.0.

    • MaxScnt: o número máximo de solicitações enviadas aos nós de dados pelos nós de computação da instância de banco de dados PolarDB-X 2.0.

    • TrxId: o ID da transação.

    • Fail: o código de erro.

    • sqlId: o ID da instrução SQL.

    • JobId: o ID da tarefa assíncrona. Este parâmetro é necessário para consultar o resultado retornado se o DAS Enterprise Edition V0 ou V1 estiver ativado para sua instância de banco de dados.

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Os parâmetros de resposta.

    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, informações de erro, como um código de erro, serão retornadas.

    Successful
    RequestId

    string

    O ID da solicitação.

    83D9D59B-057A-54A9-BFF9-CF2B42F05645
    Success

    string

    Indica se a solicitação foi bem-sucedida. Valores válidos:

    • true

    • false

    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

    O início do intervalo de tempo a ser consultado. Este 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.

    1596177993000
    End

    integer

    O fim do intervalo de tempo a ser consultado. Este 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.

    1608888296000

    Status

    string

    O estado da tarefa. Valores válidos:

    • INIT: A tarefa está aguardando agendamento.

    • RUNNING: A tarefa está em execução.

    • FAILED: A tarefa falhou.

    • CANCELED: A tarefa foi cancelada.

    • COMPLETED: A tarefa foi concluída.

    Nota

    Você pode visualizar o resultado de uma tarefa que está no estado COMPLETED.

    COMPLETED
    CreateTime

    integer

    A hora em que a tarefa foi criada. Este valor é um carimbo de data/hora 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.
    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.