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

Teradata® Data Mover Guía del usuario

Product
Teradata Data Mover
Release Number
16.20
Published
Noviembre de 2021
Content Type
Guía del usuario
Publication ID
B035-4101-107K-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: 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: Largo
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
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": "dmsmptodmsmp2createtest",
    "jobExecutionName": "dmsmptodmsmp2createtest-20141219094827",
    "startTime": 1419011314588,
    "status": "RUNNING",
    "links" : [
        {
            "rel": "self"
            "href": "http://server/datamover/executingJobs/dmsmptodmsmp2createtest-20141219094827"
        },
        {
            "rel": "executed_status"
            "href": "http://server/datamover/executedJobs/dmsmptodmsmp2createtest-20141219094827"
        }
    ]
}
{
    "jobName": "dmsmptodmsmp2createtest",
    "jobExecutionName": "dmsmptodmsmp2createtest-20141219094827",
    "startTime": 1419011314588,
    "status": "RUNNING",
    "steps":
    [
        {
            "id": 1,
            "type": "VERIFY_JOB_OBJECTS",
            "startTime": 1419011317674,
            "endTime": 1419011331750,
            "durationTime": 14,
            "status": "COMPLETED"
        },
        {
            "type": "MOVE_TABLE_DATA",
            "startTime": 1419011332324,
            "endTime": 1419011373457,
            "status": "COMPLETED",
            "durationTime": 41
        }
    ],
    "tasks":
    [
        {
            "id": 15,
            "parentName": "dmintegrationtestuser",
            "objectName": "test1",
            "objectType": "table",
            "movePhase": "MOVING_DATA",
            "status": "ARCHIVE",
            "totalRowsProcessed": 1002,
            "totalBytesProcessed": 32558,
            "timeStamp": 1419011343828,
            "agentName": "Agent2",
            "utility": "ARC",
            "sessionsSpecified": 2,
            "sessionsUsed": "2"
            "dataStreams": 1
        }
    ],
    "streams":
    [
        {
            "utility": "ARC",
            "operator": "Archive",
            "agentName": "Agent2",
            "taskID": 15,
            "streamID": 1,
            "bytesProcessed": 97674,
            "processSpeed": 49033,
            "timestamp": 1419011349791,
            "objectName": "dmintegrationtestuser.test3"
        }
    ],
    "log": "Step 1 is complete",
    "links" : [
        {
            "rel": "self"
            "href": "http://server/datamover/executingJobs/dmsmptodmsmp2createtest-20141219094827"
        },
        {
            "rel": "executed_status"
            "href": "http://server/datamover/executedJobs/dmsmptodmsmp2createtest-20141219094827"
        }
    ]
}