Job - Get

Referencia

Servicio:: Data Lake Analytics

Versión de la API:: 2016-11-01

Obtiene la información del trabajo para el identificador de trabajo especificado.

GET https://{accountName}.{adlaJobDnsSuffix}/Jobs/{jobIdentity}?api-version=2016-11-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
accountName	path	True	string	La cuenta de Azure Data Lake Analytics para ejecutar operaciones de trabajo.
adlaJobDnsSuffix	path	True	string	Obtiene el sufijo DNS que se usa como base para todas las solicitudes del servicio de trabajo de Azure Data Lake Analytics.
jobIdentity	path	True	string (uuid)	Id. de JobInfo.
api-version	query	True	string	Versión de api de cliente.

Respuestas

Nombre	Tipo	Description
200 OK	JobInformation	Se han recuperado correctamente los detalles del trabajo especificado.

Ejemplos

Gets the job information for the specified job ID

Solicitud de ejemplo

HTTP

GET https://account123.contosopipelineservice.com/Jobs/076713da-9018-41ae-a3bd-9eab14e54d09?api-version=2016-11-01

Respuesta de muestra

status code:: 200

{
  "jobId": "076713da-9018-41ae-a3bd-9eab14e54d09",
  "name": "test_name",
  "type": "USql",
  "submitter": "test_submitter",
  "degreeOfParallelism": 1,
  "priority": 1,
  "submitTime": "2017-04-18T11:16:49.0748958-07:00",
  "startTime": "2017-04-18T11:16:49.0748958-07:00",
  "endTime": "2017-04-18T11:16:49.0748958-07:00",
  "state": "Accepted",
  "result": "Succeeded",
  "logFolder": "adl://contosoadla.azuredatalakestore.net/system/jobservice/jobs/Usql/2016/03/13/17/18/5fe51957-93bc-4de0-8ddc-c5a4753b068b/logs/",
  "logFilePatterns": [
    "test_log_file_pattern_1",
    "test_log_file_pattern_2"
  ],
  "related": {
    "pipelineId": "076713da-9018-41ae-a3bd-9eab14e54d09",
    "pipelineName": "test_pipeline_name",
    "pipelineUri": "https://account123.contosopipelineservice.com/076713da-9018-41ae-a3bd-9eab14e54d09",
    "runId": "67034c12-b250-468e-992d-39fb978bde2c",
    "recurrenceId": "67034c12-b250-468e-992d-39fb978bde2d",
    "recurrenceName": "test_recurrence_name"
  },
  "errorMessage": [
    {
      "description": "test_description",
      "details": "test_details",
      "endOffset": 1,
      "errorId": "test_error_id",
      "filePath": "adl://contosoadla.azuredatalakestore.net/system/jobservice/jobs/Usql/2016/03/13/17/18/5fe51957-93bc-4de0-8ddc-c5a4753b068b/test_file.txt",
      "helpLink": "https://azure.microsoft.com/en-us/blog/introducing-azure-data-lake/",
      "internalDiagnostics": "test_internal_diagnostics",
      "lineNumber": 1,
      "message": "test_message",
      "resolution": "test_resolution",
      "innerError": {
        "diagnosticCode": 1,
        "severity": "Warning",
        "details": "test_details",
        "component": "test_component",
        "errorId": "test_error_id",
        "helpLink": "https://azure.microsoft.com/en-us/blog/introducing-azure-data-lake/",
        "internalDiagnostics": "test_internal_diagnostics",
        "message": "test_message",
        "resolution": "test_resolution",
        "source": "SYSTEM",
        "description": "test_description"
      },
      "severity": "Warning",
      "source": "SYSTEM",
      "startOffset": 1
    }
  ],
  "stateAuditRecords": [
    {
      "newState": "test_new_state",
      "timeStamp": "2017-04-18T11:16:49.0748958-07:00",
      "requestedByUser": "test_requested_by_user",
      "details": "test_details"
    }
  ],
  "properties": {
    "runtimeVersion": "test_runtime_version",
    "script": "test_script",
    "type": "USql"
  }
}

Definiciones

Nombre	Description
CompileMode	el modo de compilación específico para el trabajo usado durante la ejecución. Si no se especifica durante el envío, el servidor determinará el modo de compilación óptimo.
Diagnostics	Información de diagnóstico de errores para trabajos con errores.
HiveJobProperties	Propiedades del trabajo de Hive usadas al recuperar trabajos de Hive.
JobDataPath	Un elemento de ruta de acceso de datos del trabajo de Data Lake Analytics.
JobErrorDetails	Detalles del error del trabajo de Data Lake Analytics.
JobInformation	Las propiedades extendidas de información del trabajo de Data Lake Analytics que se devuelven al recuperar un trabajo específico.
JobInnerError	Detalles del error del trabajo de Data Lake Analytics.
JobRelationshipProperties	Propiedades de información de relación del trabajo, incluida la información de canalización, la información de correlación, etc.
JobResource	Recursos de trabajo de Data Lake Analytics.
JobResourceType	el tipo de recurso de trabajo.
JobResult	el resultado de la ejecución del trabajo o el resultado actual del trabajo en ejecución.
JobState	el estado del trabajo. Cuando el trabajo está en estado Finalizado, consulte Result y ErrorMessage para obtener más información.
JobStateAuditRecord	Registros de auditoría del estado del trabajo de Data Lake Analytics para realizar el seguimiento del ciclo de vida de un trabajo.
JobStatistics	Estadísticas de ejecución del trabajo de Data Lake Analytics.
JobStatisticsVertexStage	Información de la fase de la fase de vértices de estadísticas de trabajos de Data Lake Analytics.
JobType	el tipo de trabajo del trabajo actual (Hive o USql).
SeverityTypes	gravedad del error.
USqlJobProperties	Propiedades de trabajo de U-SQL usadas al recuperar trabajos de U-SQL.

CompileMode

Enumeración

el modo de compilación específico para el trabajo usado durante la ejecución. Si no se especifica durante el envío, el servidor determinará el modo de compilación óptimo.

Valor	Description
Full
Semantic
SingleBox

Diagnostics

Object

Información de diagnóstico de errores para trabajos con errores.

Nombre	Tipo	Description
columnNumber	integer (int32)	columna donde se produjo el error.
end	integer (int32)	índice final del error.
lineNumber	integer (int32)	número de línea en el que se produjo el error.
message	string	mensaje de error.
severity	SeverityTypes	gravedad del error.
start	integer (int32)	índice inicial del error.

HiveJobProperties

Object

Propiedades del trabajo de Hive usadas al recuperar trabajos de Hive.

Nombre	Tipo	Description
executedStatementCount	integer (int32)	el número de instrucciones que se han ejecutado en función del script.
logsLocation	string	la ubicación de los registros de Hive
outputLocation	string	la ubicación de los archivos de salida del trabajo de Hive (resultados de ejecución y resultados)
runtimeVersion	string	la versión en tiempo de ejecución del motor de Data Lake Analytics que se va a usar para el tipo específico de trabajo que se está ejecutando.
script	string	el script que se va a ejecutar. Tenga en cuenta que el tamaño máximo del script es de 3 MB.
statementCount	integer (int32)	el número de instrucciones que se ejecutarán en función del script
type	string: Hive	el tipo de trabajo del trabajo actual (es decir, Hive o USql).

JobDataPath

Object

Un elemento de ruta de acceso de datos del trabajo de Data Lake Analytics.

Nombre	Tipo	Description
command	string	comando al que se relacionan estos datos de trabajo.
jobId	string (uuid)	el identificador del trabajo para el que están estos datos.
paths	string[]	la lista de rutas de acceso a todos los datos del trabajo.

JobErrorDetails

Object

Detalles del error del trabajo de Data Lake Analytics.

Nombre	Tipo	Description
description	string	la descripción del mensaje de error
details	string	los detalles del mensaje de error.
endOffset	integer (int32)	desplazamiento final en el trabajo donde se encontró el error.
errorId	string	identificador específico del tipo de error detectado en el trabajo.
filePath	string	la ruta de acceso a cualquier archivo de error complementario, si existe.
helpLink	string	vínculo a MSDN o ayuda de Azure para este tipo de error, si existe.
innerError	JobInnerError	el error interno de este mensaje de error de trabajo específico, si existe.
internalDiagnostics	string	el seguimiento interno de la pila de diagnóstico si el usuario que solicita los detalles del error del trabajo tiene permisos suficientes, se recuperará; de lo contrario, estará vacío.
lineNumber	integer (int32)	número de línea específico del trabajo donde se produjo el error.
message	string	mensaje de error descriptivo para el error.
resolution	string	la resolución recomendada para el error, si existe.
severity	SeverityTypes	el nivel de gravedad del error.
source	string	el origen final del error (normalmente SYSTEM o USER).
startOffset	integer (int32)	desplazamiento inicial en el trabajo donde se encontró el error

JobInformation

Object

Las propiedades extendidas de información del trabajo de Data Lake Analytics que se devuelven al recuperar un trabajo específico.

Nombre	Tipo	Valor predeterminado	Description
degreeOfParallelism	integer (int32)	1	grado de paralelismo usado para este trabajo.
degreeOfParallelismPercent	number (double)		grado de paralelismo en porcentaje usado para este trabajo.
endTime	string (date-time)		la hora de finalización del trabajo.
errorMessage	JobErrorDetails[]		los detalles del mensaje de error del trabajo, si se produjo un error en el trabajo.
hierarchyQueueNode	string		el nombre del nodo de cola de jerarquía al que se asigna este trabajo, null si aún no se ha asignado el trabajo o la cuenta no tiene cola de jerarquía.
jobId	string (uuid)		el identificador único del trabajo (un GUID).
logFilePatterns	string[]		la lista de patrones de nombre de archivo de registro que se van a buscar en logFolder. '' es el único carácter coincidente permitido. Formato de ejemplo:.log de jobExecution o mylog.txt
logFolder	string		la ruta de acceso de la carpeta de registro que se usará en el formato siguiente: adl://.azuredatalakestore.net/system/jobservice/jobs/Usql/2016/03/13/17/18/5fe51957-93bc-4de0-8ddc-c5a4753b068b/logs/.
name	string		el nombre descriptivo del trabajo.
priority	integer (int32)		el valor de prioridad del trabajo actual. Los números más bajos tienen una prioridad más alta. De forma predeterminada, un trabajo tiene una prioridad de 1000. Debe ser mayor que 0.
properties	JobProperties: HiveJobProperties USqlJobProperties		propiedades específicas del trabajo.
related	JobRelationshipProperties		las propiedades periódicas de la información de la relación del trabajo.
result	JobResult		el resultado de la ejecución del trabajo o el resultado actual del trabajo en ejecución.
startTime	string (date-time)		la hora de inicio del trabajo.
state	JobState		el estado del trabajo. Cuando el trabajo está en estado Finalizado, consulte Result y ErrorMessage para obtener más información.
stateAuditRecords	JobStateAuditRecord[]		los registros de auditoría de estado del trabajo, que indican cuándo se han realizado varias operaciones en este trabajo.
submitTime	string (date-time)		la hora en que se envió el trabajo al servicio.
submitter	string		el usuario o la cuenta que envió el trabajo.
type	JobType		el tipo de trabajo del trabajo actual (Hive o USql).

JobInnerError

Object

Detalles del error del trabajo de Data Lake Analytics.

Nombre	Tipo	Description
component	string	componente que produjo un error.
description	string	la descripción del mensaje de error
details	string	los detalles del mensaje de error.
diagnosticCode	integer (int32)	el código de error de diagnóstico.
errorId	string	identificador específico del tipo de error detectado en el trabajo.
helpLink	string	vínculo a MSDN o ayuda de Azure para este tipo de error, si existe.
innerError	JobInnerError	el error interno de este mensaje de error de trabajo específico, si existe.
internalDiagnostics	string	el seguimiento interno de la pila de diagnóstico si el usuario que solicita los detalles del error del trabajo tiene permisos suficientes, se recuperará; de lo contrario, estará vacío.
message	string	mensaje de error descriptivo para el error.
resolution	string	la resolución recomendada para el error, si existe.
severity	SeverityTypes	el nivel de gravedad del error.
source	string	el origen final del error (normalmente SYSTEM o USER).

JobRelationshipProperties

Object

Propiedades de información de relación del trabajo, incluida la información de canalización, la información de correlación, etc.

Nombre	Tipo	Description
pipelineId	string (uuid)	el identificador de canalización de relación de trabajo (un GUID).
pipelineName	string maxLength: 260	el nombre descriptivo de la canalización de relación de trabajo, que no necesita ser único.
pipelineUri	string	el URI de canalización, único, vincula al servicio de origen de esta canalización.
recurrenceId	string (uuid)	el identificador de periodicidad (un GUID), único por actividad o script, independientemente de las iteraciones. Esto es algo para vincular diferentes apariciones del mismo trabajo juntos.
recurrenceName	string maxLength: 260	el nombre de periodicidad, nombre descriptivo para la correlación entre trabajos.
runId	string (uuid)	el identificador de ejecución (un GUID), el identificador único de la iteración de esta canalización.

JobResource

Object

Recursos de trabajo de Data Lake Analytics.

Nombre	Tipo	Description
name	string	el nombre del recurso.
resourcePath	string	ruta de acceso al recurso.
type	JobResourceType	el tipo de recurso de trabajo.

JobResourceType

Enumeración

el tipo de recurso de trabajo.

Valor	Description
JobManagerResource
JobManagerResourceInUserFolder
StatisticsResource
StatisticsResourceInUserFolder
VertexResource
VertexResourceInUserFolder

JobResult

Enumeración

el resultado de la ejecución del trabajo o el resultado actual del trabajo en ejecución.

Valor	Description
Cancelled
Failed
None
Succeeded

JobState

Enumeración

el estado del trabajo. Cuando el trabajo está en estado Finalizado, consulte Result y ErrorMessage para obtener más información.

Valor	Description
Accepted
Compiling
Ended
New
Paused
Queued
Running
Scheduling
Starting
WaitingForCapacity

JobStateAuditRecord

Object

Registros de auditoría del estado del trabajo de Data Lake Analytics para realizar el seguimiento del ciclo de vida de un trabajo.

Nombre	Tipo	Description
details	string	los detalles del registro de auditoría.
newState	string	el nuevo estado en el que se encuentra el trabajo.
requestedByUser	string	el usuario que solicita el cambio.
timeStamp	string (date-time)	marca de tiempo que tuvo lugar el cambio de estado.

JobStatistics

Object

Estadísticas de ejecución del trabajo de Data Lake Analytics.

Nombre	Tipo	Description
finalizingTimeUtc	string (date-time)	el trabajo finalizando la hora de inicio.
lastUpdateTimeUtc	string (date-time)	la hora de la última actualización de las estadísticas.
stages	JobStatisticsVertexStage[]	la lista de fases del trabajo.

JobStatisticsVertexStage

Object

Información de la fase de la fase de vértices de estadísticas de trabajos de Data Lake Analytics.

Nombre	Tipo	Description
dataRead	integer (int64)	la cantidad de datos leídos, en bytes.
dataReadCrossPod	integer (int64)	la cantidad de datos leídos en varios pods, en bytes.
dataReadIntraPod	integer (int64)	la cantidad de datos leídos en un pod, en bytes.
dataToRead	integer (int64)	la cantidad de datos restantes que se van a leer, en bytes.
dataWritten	integer (int64)	la cantidad de datos escritos, en bytes.
duplicateDiscardCount	integer (int32)	el número de duplicados que se descartaron.
failedCount	integer (int32)	el número de errores que se produjeron en esta fase.
maxVertexDataRead	integer (int64)	la cantidad máxima de datos leídos en un solo vértice, en bytes.
minVertexDataRead	integer (int64)	la cantidad mínima de datos leídos en un solo vértice, en bytes.
readFailureCount	integer (int32)	número de errores de lectura en esta fase.
revocationCount	integer (int32)	número de vértices revocados durante esta fase.
runningCount	integer (int32)	número de vértices que se están ejecutando actualmente en esta fase.
scheduledCount	integer (int32)	el número de vértices programados actualmente en esta fase
stageName	string	el nombre de esta fase en la ejecución del trabajo.
succeededCount	integer (int32)	número de vértices que se realizaron correctamente en esta fase.
tempDataWritten	integer (int64)	la cantidad de datos temporales escritos, en bytes.
totalCount	integer (int32)	recuento total de vértices para esta fase.
totalFailedTime	string (duration)	la cantidad de tiempo que los vértices con errores se tomaron en esta fase.
totalProgress	integer (int32)	progreso actual de esta fase, como porcentaje.
totalSucceededTime	string (duration)	la cantidad de tiempo que todos los vértices correctos tomaron en esta fase.

JobType

Enumeración

el tipo de trabajo del trabajo actual (Hive o USql).

Valor	Description
Hive
USql

SeverityTypes

Enumeración

gravedad del error.

Valor	Description
Deprecated
Error
Info
SevereWarning
UserWarning
Warning

USqlJobProperties

Object

Propiedades de trabajo de U-SQL usadas al recuperar trabajos de U-SQL.

Nombre	Tipo	Description
algebraFilePath	string	ruta de acceso del archivo de álgebra una vez completado el trabajo
compileMode	CompileMode	el modo de compilación específico para el trabajo usado durante la ejecución. Si no se especifica durante el envío, el servidor determinará el modo de compilación óptimo.
debugData	JobDataPath	las ubicaciones de datos de depuración específicas del trabajo.
diagnostics	Diagnostics[]	el diagnóstico del trabajo.
resources	JobResource[]	la lista de recursos necesarios para el trabajo
rootProcessNodeId	string	el identificador usado para identificar al administrador de trabajos que coordina la ejecución del trabajo. El usuario no debe establecer este valor y se omitirá si es así.
runtimeVersion	string	la versión en tiempo de ejecución del motor de Data Lake Analytics que se va a usar para el tipo específico de trabajo que se está ejecutando.
script	string	el script que se va a ejecutar. Tenga en cuenta que el tamaño máximo del script es de 3 MB.
statistics	JobStatistics	estadísticas específicas del trabajo.
totalCompilationTime	string (duration)	el tiempo total que ha dedicado a compilar este trabajo. El usuario no debe establecer este valor y se omitirá si es así.
totalPauseTime	string (duration)	el tiempo total que ha dedicado este trabajo en pausa. El usuario no debe establecer este valor y se omitirá si es así.
totalQueuedTime	string (duration)	el tiempo total que pasó en cola este trabajo. El usuario no debe establecer este valor y se omitirá si es así.
totalRunningTime	string (duration)	el tiempo total que este trabajo ha dedicado a ejecutar. El usuario no debe establecer este valor y se omitirá si es así.
type	string: USql	el tipo de trabajo del trabajo actual (es decir, Hive o USql).
yarnApplicationId	string	identificador que se usa para identificar la aplicación de yarn que ejecuta el trabajo. El usuario no debe establecer este valor y se omitirá si es así.
yarnApplicationTimeStamp	integer (int64)	marca de tiempo (en tics) para la aplicación de yarn que ejecuta el trabajo. El usuario no debe establecer este valor y se omitirá si es así.

Compartir a través de

Job - Get

Parámetros de identificador URI

Respuestas

Ejemplos

Gets the job information for the specified job ID

Solicitud de ejemplo

Respuesta de muestra

Definiciones

CompileMode

Diagnostics

HiveJobProperties

JobDataPath

JobErrorDetails

JobInformation

JobInnerError

JobRelationshipProperties

JobResource

JobResourceType

JobResult

JobState

JobStateAuditRecord

JobStatistics

JobStatisticsVertexStage

JobType

SeverityTypes

USqlJobProperties