GetSemanticJobDetail - DataWorks: Central de Documentação do Alibaba Cloud

Consulta o status do executor e a configuração de tempo de execução usando o ExecutorJobId retornado por RunSemanticJob ou ListSemanticJobRuns.

Descrição da operação

Cenários

Consulta o status detalhado e as informações de tempo de execução de uma execução de job semântico no lado do executor. Isso é usado para sondar o progresso da execução ou solucionar falhas na execução.

Procedimento

Chame RunSemanticJob ou ListSemanticJobRuns para obter o ExecutorJobId.
Use o ProjectId retornado pela definição do job como o ProjectId para esta operação.
Determine o status atual com base nos detalhes do executor em Data. Se o job ainda estiver em execução, continue sondando esta operação.

Operações relacionadas

Para recuperar logs, chame GetSemanticJobLog. Para interromper uma execução, chame KillSemanticJob.

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 do job 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 o job 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 detalhes de execução do executor. Data contém os detalhes do executor atualmente retornados para o ExecutorJobId especificado.
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	object	Os detalhes do job retornados pelo executor. Usados para determinar o status da execução e visualizar a configuração real de tempo de execução.
ExecutorJobId	string	O ID do job do executor.	exec-job-demo
FileType	integer	O código do tipo de nó do executor. Jobs semânticos usam o código de nó Shell 6.	6
ProjectId	integer	O ID do workspace do DataWorks associado ao job do executor.	100
Datasource	string	O identificador da fonte de dados usado pelo job do executor.	maxcompute
CodeParameters	string	As informações de parâmetros de código retornadas pelo executor. Usadas para solucionar problemas na configuração de tempo de execução desta execução.	--limit 100
Env	string	O identificador do ambiente de tempo de execução retornado pelo executor.	PROD
CustomerName	string	O identificador do cliente do job do executor.	meta_semantic
CurrentSqlIndex	integer	O índice do fragmento SQL que está sendo processado atualmente pelo executor.	0
ExecTypes	array	A lista de códigos de tipo de execução retornada pelo executor.
	integer	A lista de códigos de tipo de execução retornada pelo executor.	6
Statuses	array	A lista de códigos de status retornada pelo executor. Usada para determinar o status atual ou final do job.
	integer	A lista de códigos de status do job retornada pelo executor. Um status de sucesso inclui 3.	3
AdvanceSettings	object	As configurações avançadas de tempo de execução retornadas pelo executor.
ResourceUrls	array<object>	A lista de URLs de recursos associadas ao job do executor.
	object	A lista de URLs de recursos retornada pelo executor.
ResourceGroupId	string	O ID do grupo de recursos que executou efetivamente o job.	rg-demo

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": {
    "ExecutorJobId": "exec-job-demo",
    "FileType": 6,
    "ProjectId": 100,
    "Datasource": "maxcompute",
    "CodeParameters": "--limit 100",
    "Env": "PROD",
    "CustomerName": "meta_semantic",
    "CurrentSqlIndex": 0,
    "ExecTypes": [
      6
    ],
    "Statuses": [
      3
    ],
    "AdvanceSettings": {
      "test": "test",
      "test2": 1
    },
    "ResourceUrls": [
      {
        "test": "test",
        "test2": 1
      }
    ],
    "ResourceGroupId": "rg-demo"
  }
}

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.