Todos os produtos
Search
Central de documentação

DataWorks:GetSemanticJobLog

Última atualização: Sep 03, 2026

Consulta logs de execução usando o ExecutorJobId retornado por RunSemanticJob ou ListSemanticJobRuns. O contrato POP atual expõe apenas os identificadores da tarefa e do workspace e retorna segmentos de log padrão.

Descrição da operação

Cenários

Lê os logs de execução de uma execução de tarefa semântica para observar o processo de execução e identificar causas de falha.

Procedimento

  1. Especifique a execução usando RunSemanticJob.Data.ExecutorJobId ou ListSemanticJobRuns[].ExecutorJobId.

  2. Chame esta operação com o ProjectId da tarefa correspondente.

  3. Analise os segmentos de log em Data juntamente com o status da execução retornado por GetSemanticJobDetail.

Antes de começar

Os logs são usados para diagnóstico e não representam os arquivos de resultado final. Obtenha os artefatos de resultado chamando DownloadSemanticResults.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ExecutorJobId

string

Sim

O ID da tarefa do executor. Use o Data.ExecutorJobId da resposta de RunSemanticJob ou o ExecutorJobId de um registro de ListSemanticJobRuns.

exec-job-demo

ProjectId

integer

Sim

O ID do workspace do DataWorks ao qual a tarefa pertence. Use o ProjectId da resposta de CreateSemanticJob ou de um item da lista de ListSemanticJobs.

100

Construa os parâmetros da solicitação com base na descrição de cada campo de solicitação.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta padrão para consulta de logs de execução. Data contém a lista de segmentos de log retornados pelo executor.

RequestId

string

O ID da solicitação. Usado para localizar logs e solucionar problemas.

676271D6-53B4-57BE-89FA-72F7AE1418DF

Success

boolean

Indica se a solicitação foi bem-sucedida.

Data

array<object>

A lista de segmentos de log retornados pelo executor. O contrato POP atual não expõe sqlIndex ou offset externamente. Os segmentos de log são retornados com base no comportamento padrão da operação.

object

Um segmento de log.

LogEnd

boolean

Indica se o segmento de log atual foi lido até o fim. Um valor true indica que não há mais conteúdo após este segmento.

LogContent

string

O texto de log bruto retornado nesta resposta.

tarefa semântica iniciada

Para o significado dos campos de resposta e suas relações com chamadas subsequentes, consulte a descrição de cada campo.

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": false,
  "Data": [
    {
      "LogEnd": false,
      "LogContent": "semantic job started"
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.