17.10 - Estado del trabajo (API RESTful) - Teradata Data Mover

Teradata® Data Mover Guía del usuario

Product
Teradata Data Mover
Release Number
17.10
Release Date
Junio de 2021
Content Type
Guía del usuario
Publication ID
B035-4101-061K-ESN
Language
Español (España)

Resumen

La API RESTful status muestra el estado de un trabajo ejecutado mediante la URL y el método siguientes:

Elemento Descripción
URL /datamover/executedJobs/executed-job-name

/datamover/executingJobs/executed-job-name

Método GET

Parámetros de solicitud

outputLevel
URL: /datamover/executingJobs/executed-job-name?outputLevel=value
URL: /datamover/executedJobs/executed-job-name?outputLevel=value
Descripción: especifica el nivel de salida del estado del trabajo. Las opciones de nivel de salida se definen en la siguiente tabla:
Nivel de salida Descripción
1 Estado general del trabajo (predeterminado)
2 Estado de cada paso del trabajo
3 Estado de cada tarea del trabajo
4 Información detallada del registro

Debe utilizar outputLevel=4 cuando el estado del trabajo es NEW para obtener información detallada del trabajo.

Si no se especifica el parámetro outputLevel, se establece el valor predeterminado output_level 1.
Obligatorio: No

Parámetros de respuesta

currentStep
Descripción: El ID de paso más actual para el trabajo, NULL si nunca se ejecuta
Tipo de datos JSON: Entero
Nivel de salida: 2
endTime
Descripción: Hora de finalización del trabajo, NULL si nunca se ejecuta
Tipo de datos JSON: Cadena
Nivel de salida: 1
estimatedJobSize
Descripción: Estimación alta del tamaño del trabajo
Tipo de datos JSON: Largo
Nivel de salida: 1
jobExecutionId
Descripción: Identificación de ejecución del trabajo
Tipo de datos JSON: Largo
Nivel de salida: 1
jobName
Descripción: Nombre del trabajo (número máximo de caracteres: 237)
Tipo de datos JSON: Cadena
Nivel de salida: 1
jobExecutionName
Descripción: Nombre de ejecución del trabajo
Tipo de datos JSON: Cadena
Nivel de salida: 1
lifeCycle
Descripción: Enumera todos los eventos durante la creación y ejecución del trabajo
Matriz JSON: Objeto (LifeCycleStatus)
Nivel de salida: 3
log
Descripción: muestra la salida de registro de utilidad.
Tipo de datos JSON: Cadena
Nivel de salida: 4
rowCount
Descripción: Resultados del recuento de filas de los objetos de origen y de destino si existen pasos de validación de recuento de filas
Matriz JSON: Objeto (RowCountStatus)
Nivel de salida: 3
startTime
Descripción: Hora de inicio del trabajo, NULL si nunca se ejecuta
Tipo de datos JSON: Cadena
Nivel de salida: 1
status
Descripción: estado del trabajo (número máximo de caracteres: 12), cuyos posibles valores figuran en la descripción de status de los parámetros de solicitud.
Tipo de datos JSON: Cadena
Nivel de salida: 1
steps
Descripción: Enumera todos los últimos pasos del trabajo, NULL si nunca se ejecuta
Matriz JSON: Objeto (StepType)
Nivel de salida: 2
streams
Descripción: enumera las secuencias, si las hay.
Matriz JSON: Objeto (StreamInfo)
Nivel de salida: 3
submitTime
Descripción: Hora en que se envió el trabajo
Tipo de datos JSON: Cadena
Nivel de salida: 1
tasks
Descripción: Enumera todas las tareas individuales de cada objeto, NULL si nunca se ejecuta
Matriz JSON: Objeto (TaskStatus)
Nivel de salida: 3

Ejemplo de respuesta

El ejemplo siguiente muestra una matriz de ejecuciones de trabajo con el estado más común. Los enlaces generados dependen del estado del trabajo.
{
  "jobName" : "job1-20200128112954",
  "jobExecutionName" : "job1-20200128112954",
  "jobExecutionId" : 25,
  "currentStep" : 3,
  "startTime" : 1580239796717,
  "endTime" : 1580239811907,
  "status" : "COMPLETED",
  "steps" : [ {
    "id" : 1,
    "status" : "COMPLETED",
    "type" : "VERIFY_JOB_OBJECTS",
    "startTime" : 1580239799361,
    "endTime" : 1580239800076
  }, {
    "id" : 2,
    "status" : "COMPLETED",
    "type" : "COMPARE_DDL",
    "startTime" : 1580239800186,
    "endTime" : 1580239802157
  }, {
    "id" : 3,
    "status" : "COMPLETED",
    "type" : "MOVE_TABLE_DATA",
    "startTime" : 1580239802203,
    "endTime" : 1580239811792
  } ],
  "tasks" : [ {
    "id" : 2570,
    "movePhase" : "VALIDATING",
    "status" : "COMPLETE",
    "timestamp" : 1580239799774
  }, {
    "id" : 2571,
    "movePhase" : "COMPARE_DDL",
    "status" : "COMPLETE",
    "agentName" : "Agent1",
    "utility" : "SQL",
    "timestamp" : 1580239801883
  }, {
    "id" : 2572,
    "movePhase" : "MOVING_DATA",
    "status" : "COMPLETE",
    "objectType" : "table",
    "agentName" : "Agent1",
    "utility" : "DSA",
    "timestamp" : 1580239804392
  } ],
  "links" : [ {
    "rel" : "self",
    "href" : "https://localhost:1443/datamover/executedJobs/job1-20200128112954?outputLevel=3"
  } ]