Job - Get

Referencia

Szolgáltatás:: Data Lake Analytics

API-verzió:: 2016-11-01

Lekéri a megadott feladatazonosító feladatadatait.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
accountName	path	True	string	Az Azure Data Lake Analytics-fiók a feladatműveletek végrehajtásához.
adlaJobDnsSuffix	path	True	string	Lekéri az Azure Data Lake Analytics-feladatszolgáltatás összes kérésének alapjaként használt DNS-utótagot.
jobIdentity	path	True	string (uuid)	JobInfo-azonosító.
api-version	query	True	string	Ügyfél API-verziója.

Válaszok

Name	Típus	Description
200 OK	JobInformation	A megadott feladat adatait sikeresen lekérte.

Példák

Gets the job information for the specified job ID

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:: 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"
  }
}

Definíciók

Name	Description
CompileMode	a végrehajtás során használt feladat adott fordítási módja. Ha ez nincs megadva a beküldés során, a kiszolgáló határozza meg az optimális fordítási módot.
Diagnostics	Hibadiagnosztikai információk a sikertelen feladatokhoz.
HiveJobProperties	Hive-feladatok lekéréséhez használt Hive-feladattulajdonságok.
JobDataPath	Egy Data Lake Analytics-feladat adatelérési útvonaleleme.
JobErrorDetails	A Data Lake Analytics-feladat hibaadatai.
JobInformation	Egy adott feladat lekérésekor visszaadott kiterjesztett Data Lake Analytics-feladatinformációs tulajdonságok.
JobInnerError	A Data Lake Analytics-feladat hibaadatai.
JobRelationshipProperties	Feladatkapcsolati információk tulajdonságai, beleértve a folyamatinformációkat, korrelációs információkat stb.
JobResource	A Data Lake Analytics-feladat erőforrásai.
JobResourceType	a feladat erőforrástípusát.
JobResult	a feladat végrehajtásának eredménye vagy a futó feladat aktuális eredménye.
JobState	a feladat állapota. Ha a feladat befejeződött állapotban van, a részletekért tekintse meg az Eredmény és az ErrorMessage lehetőséget.
JobStateAuditRecord	A Data Lake Analytics-feladat állapotnaplózási rekordjai egy feladat életciklusának nyomon követéséhez.
JobStatistics	A Data Lake Analytics-feladat végrehajtási statisztikái.
JobStatisticsVertexStage	A Data Lake Analytics-feladat statisztikája csúcsszakasz-információkat tartalmaz.
JobType	az aktuális feladat feladattípusa (Hive vagy USql).
SeverityTypes	a hiba súlyossága.
USqlJobProperties	U-SQL-feladatok lekéréséhez használt U-SQL-feladattulajdonságok.

CompileMode

Enumerálás

a végrehajtás során használt feladat adott fordítási módja. Ha ez nincs megadva a beküldés során, a kiszolgáló határozza meg az optimális fordítási módot.

Érték	Description
Full
Semantic
SingleBox

Diagnostics

Objektum

Hibadiagnosztikai információk a sikertelen feladatokhoz.

Name	Típus	Description
columnNumber	integer (int32)	az oszlop, ahol a hiba történt.
end	integer (int32)	a hiba záró indexe.
lineNumber	integer (int32)	az a sorszám, amelyen a hiba történt.
message	string	hibaüzenetet.
severity	SeverityTypes	a hiba súlyossága.
start	integer (int32)	a hiba kezdő indexe.

HiveJobProperties

Objektum

Hive-feladatok lekéréséhez használt Hive-feladattulajdonságok.

Name	Típus	Description
executedStatementCount	integer (int32)	a szkript alapján futtatott utasítások száma
logsLocation	string	a Hive-naplók helye
outputLocation	string	a Hive-feladat kimeneti fájljainak helye (mind a végrehajtási kimenet, mind az eredmények)
runtimeVersion	string	a Futtatandó feladat adott típusához használandó Data Lake Analytics-motor futtatókörnyezeti verziója.
script	string	a futtatni kívánt szkriptet. Vegye figyelembe, hogy a szkript maximális mérete 3 MB.
statementCount	integer (int32)	a szkript alapján futtatandó utasítások száma
type	string: Hive	az aktuális feladat feladattípusa (például Hive vagy USql).

JobDataPath

Objektum

Egy Data Lake Analytics-feladat adatelérési útvonaleleme.

Name	Típus	Description
command	string	a parancs, amelyhez ez a feladatadatok kapcsolódnak.
jobId	string (uuid)	annak a feladatnak az azonosítója, amelyhez ezek az adatok szolgálnak.
paths	string[]	az összes feladatadat elérési útjainak listája.

JobErrorDetails

Objektum

A Data Lake Analytics-feladat hibaadatai.

Name	Típus	Description
description	string	a hibaüzenet leírása
details	string	a hibaüzenet részletei.
endOffset	integer (int32)	a hiba helyét eredményező feladat vég eltolása.
errorId	string	a feladatban észlelt hibatípus konkrét azonosítója.
filePath	string	a kiegészítő hibafájlok elérési útja, ha van ilyen.
helpLink	string	ha van ilyen hiba, az MSDN-hez vagy az Azure-beli súgóhoz mutató hivatkozás.
innerError	JobInnerError	az adott feladat belső hibaüzenete, ha van ilyen.
internalDiagnostics	string	a belső diagnosztikai verem nyomkövetése, ha a feladat hibaadatait kérő felhasználó megfelelő engedélyekkel rendelkezik a lekéréséhez, ellenkező esetben üres lesz.
lineNumber	integer (int32)	annak a feladatnak a megadott sorszáma, ahol a hiba történt.
message	string	a hiba felhasználóbarát hibaüzenete.
resolution	string	a hiba javasolt feloldása, ha van ilyen.
severity	SeverityTypes	a hiba súlyossági szintje.
source	string	a hiba végső forrása (általában RENDSZER vagy FELHASZNÁLÓ).
startOffset	integer (int32)	a hiba helyét jelző feladat kezdő eltolása

JobInformation

Objektum

Egy adott feladat lekérésekor visszaadott kiterjesztett Data Lake Analytics-feladatinformációs tulajdonságok.

Name	Típus	Alapértelmezett érték	Description
degreeOfParallelism	integer (int32)	1	a feladathoz használt párhuzamosság mértéke.
degreeOfParallelismPercent	number (double)		a feladathoz használt százalékos párhuzamosság mértéke.
endTime	string (date-time)		a feladat befejezési ideje.
errorMessage	JobErrorDetails[]		a feladat hibaüzenetének részletei, ha a feladat meghiúsult.
hierarchyQueueNode	string		annak a hierarchiasorcsomópontnak a neve, amelyhez a feladat hozzá van rendelve, null értékű, ha a feladat még nincs hozzárendelve, vagy ha a fiók nem rendelkezik hierarchia-üzenetsorokkal.
jobId	string (uuid)		a feladat egyedi azonosítója (GUID).
logFilePatterns	string[]		a logFolderben keresendő naplófájlnévminták listája. '' az egyetlen egyező karakter engedélyezett. Példaformátum: jobExecution.log vagy mylog.txt
logFolder	string		a következő formátumban használandó naplómappa elérési útja: adl://.azuredatalakestore.net/system/jobservice/jobs/Usql/2016/03/13/17/18/5fe51957-93bc-4de0-8ddc-c5a4753b068b/logs/.
name	string		a feladat rövid neve.
priority	integer (int32)		az aktuális feladat prioritási értéke. Az alacsonyabb számok nagyobb prioritást élveznek. Alapértelmezés szerint egy feladat prioritása 1000. Ennek 0-nál nagyobbnak kell lennie.
properties	JobProperties: HiveJobProperties USqlJobProperties		a feladatspecifikus tulajdonságok.
related	JobRelationshipProperties		az ismétlődő feladatkapcsolat adatainak tulajdonságai.
result	JobResult		a feladat végrehajtásának eredménye vagy a futó feladat aktuális eredménye.
startTime	string (date-time)		a feladat kezdési időpontja.
state	JobState		a feladat állapota. Ha a feladat befejeződött állapotban van, a részletekért tekintse meg az Eredmény és az ErrorMessage lehetőséget.
stateAuditRecords	JobStateAuditRecord[]		a feladat állapotának naplózási rekordjai, amelyek jelzik, hogy mikor végeztek különböző műveleteket ezen a feladaton.
submitTime	string (date-time)		a feladat szolgáltatásba való elküldésekor.
submitter	string		a feladatot beküldő felhasználó vagy fiók.
type	JobType		az aktuális feladat feladattípusa (Hive vagy USql).

JobInnerError

Objektum

A Data Lake Analytics-feladat hibaadatai.

Name	Típus	Description
component	string	az összetevő, amely nem sikerült.
description	string	a hibaüzenet leírása
details	string	a hibaüzenet részletei.
diagnosticCode	integer (int32)	a diagnosztikai hibakód.
errorId	string	a feladatban észlelt hibatípus konkrét azonosítója.
helpLink	string	ha van ilyen hiba, az MSDN-hez vagy az Azure-beli súgóhoz mutató hivatkozás.
innerError	JobInnerError	az adott feladat belső hibaüzenete, ha van ilyen.
internalDiagnostics	string	a belső diagnosztikai verem nyomkövetése, ha a feladat hibaadatait kérő felhasználó megfelelő engedélyekkel rendelkezik a lekéréséhez, ellenkező esetben üres lesz.
message	string	a hiba felhasználóbarát hibaüzenete.
resolution	string	a hiba javasolt feloldása, ha van ilyen.
severity	SeverityTypes	a hiba súlyossági szintje.
source	string	a hiba végső forrása (általában RENDSZER vagy FELHASZNÁLÓ).

JobRelationshipProperties

Objektum

Feladatkapcsolati információk tulajdonságai, beleértve a folyamatinformációkat, korrelációs információkat stb.

Name	Típus	Description
pipelineId	string (uuid)	a feladatkapcsolati folyamat azonosítója (GUID).
pipelineName	string maxLength: 260	a feladatkapcsolati folyamat rövid neve, amelynek nem kell egyedinek lennie.
pipelineUri	string	a folyamat URI-ja, egyedi, a folyamat forrásszolgáltatására mutató hivatkozások.
recurrenceId	string (uuid)	az ismétlődési azonosító (GUID), tevékenységenként/szkriptenként egyedi, az iterációktól függetlenül. Ez a feladat különböző előfordulásainak összekapcsolásához szükséges.
recurrenceName	string maxLength: 260	az ismétlődés neve, a feladatok közötti korreláció felhasználóbarát neve.
runId	string (uuid)	a folyamat iterációjának egyedi azonosítója (GUID).

JobResource

Objektum

A Data Lake Analytics-feladat erőforrásai.

Name	Típus	Description
name	string	az erőforrás neve.
resourcePath	string	az erőforrás elérési útja.
type	JobResourceType	a feladat erőforrástípusát.

JobResourceType

Enumerálás

a feladat erőforrástípusát.

Érték	Description
JobManagerResource
JobManagerResourceInUserFolder
StatisticsResource
StatisticsResourceInUserFolder
VertexResource
VertexResourceInUserFolder

JobResult

Enumerálás

a feladat végrehajtásának eredménye vagy a futó feladat aktuális eredménye.

Érték	Description
Cancelled
Failed
None
Succeeded

JobState

Enumerálás

a feladat állapota. Ha a feladat befejeződött állapotban van, a részletekért tekintse meg az Eredmény és az ErrorMessage lehetőséget.

Érték	Description
Accepted
Compiling
Ended
New
Paused
Queued
Running
Scheduling
Starting
WaitingForCapacity

JobStateAuditRecord

Objektum

A Data Lake Analytics-feladat állapotnaplózási rekordjai egy feladat életciklusának nyomon követéséhez.

Name	Típus	Description
details	string	az auditnapló részletei.
newState	string	az új állapot, amelyben a feladat szerepel.
requestedByUser	string	a módosítást kérő felhasználó.
timeStamp	string (date-time)	az állapotváltozás időbélyege.

JobStatistics

Objektum

A Data Lake Analytics-feladat végrehajtási statisztikái.

Name	Típus	Description
finalizingTimeUtc	string (date-time)	a feladat a kezdési időpontot véglegesíti.
lastUpdateTimeUtc	string (date-time)	a statisztikák utolsó frissítési ideje.
stages	JobStatisticsVertexStage[]	a feladat szakaszainak listája.

JobStatisticsVertexStage

Objektum

A Data Lake Analytics-feladat statisztikája csúcsszakasz-információkat tartalmaz.

Name	Típus	Description
dataRead	integer (int64)	a beolvasott adatok mennyisége bájtban.
dataReadCrossPod	integer (int64)	a több podon át beolvasott adatok mennyisége bájtban.
dataReadIntraPod	integer (int64)	az egy podban beolvasott adatok mennyisége bájtban.
dataToRead	integer (int64)	az olvasandó adatok mennyisége bájtban.
dataWritten	integer (int64)	a megírt adatok mennyisége bájtban.
duplicateDiscardCount	integer (int32)	az elvetett duplikációk száma.
failedCount	integer (int32)	az ebben a szakaszban bekövetkezett hibák száma.
maxVertexDataRead	integer (int64)	az egyetlen csúcspontban beolvasott adatok maximális mennyisége bájtban.
minVertexDataRead	integer (int64)	az egyetlen csúcspontban beolvasott adatok minimális mennyisége bájtban.
readFailureCount	integer (int32)	az olvasási hibák száma ebben a szakaszban.
revocationCount	integer (int32)	az ebben a szakaszban visszavont csúcspontok száma.
runningCount	integer (int32)	az aktuálisan futó csúcspontok száma ebben a szakaszban.
scheduledCount	integer (int32)	az aktuálisan ütemezett csúcspontok száma ebben a szakaszban
stageName	string	a feladat végrehajtásának ezen szakaszának neve.
succeededCount	integer (int32)	az ebben a szakaszban sikeres csúcspontok száma.
tempDataWritten	integer (int64)	az ideiglenesen megírt adatok mennyisége bájtban.
totalCount	integer (int32)	a szakasz teljes csúcsszáma.
totalFailedTime	string (duration)	a sikertelen csúcspontok ennyi időt vettek igénybe ebben a szakaszban.
totalProgress	integer (int32)	a szakasz jelenlegi előrehaladása százalékban.
totalSucceededTime	string (duration)	az összes sikeres csúcspont ennyi időt vett igénybe ebben a szakaszban.

JobType

Enumerálás

az aktuális feladat feladattípusa (Hive vagy USql).

Érték	Description
Hive
USql

SeverityTypes

Enumerálás

a hiba súlyossága.

Érték	Description
Deprecated
Error
Info
SevereWarning
UserWarning
Warning

USqlJobProperties

Objektum

U-SQL-feladatok lekéréséhez használt U-SQL-feladattulajdonságok.

Name	Típus	Description
algebraFilePath	string	az algebra fájl elérési útja a feladat befejezése után
compileMode	CompileMode	a végrehajtás során használt feladat adott fordítási módja. Ha ez nincs megadva a beküldés során, a kiszolgáló határozza meg az optimális fordítási módot.
debugData	JobDataPath	a feladatspecifikus hibakeresési adathelyek.
diagnostics	Diagnostics[]	a feladat diagnosztikái.
resources	JobResource[]	a feladat által igényelt erőforrások listája
rootProcessNodeId	string	a feladat végrehajtását koordináló feladatkezelő azonosításához használt azonosító. Ezt az értéket a felhasználó nem állíthatja be, és ha igen, figyelmen kívül hagyja.
runtimeVersion	string	a Futtatandó feladat adott típusához használandó Data Lake Analytics-motor futtatókörnyezeti verziója.
script	string	a futtatni kívánt szkriptet. Vegye figyelembe, hogy a szkript maximális mérete 3 MB.
statistics	JobStatistics	a feladatspecifikus statisztikákat.
totalCompilationTime	string (duration)	a feladat összeállítással töltött teljes ideje. Ezt az értéket a felhasználó nem állíthatja be, és ha igen, figyelmen kívül hagyja.
totalPauseTime	string (duration)	a feladat szüneteltetve töltött teljes ideje. Ezt az értéket a felhasználó nem állíthatja be, és ha igen, figyelmen kívül hagyja.
totalQueuedTime	string (duration)	a feladat várólistára helyezésének teljes időtartama. Ezt az értéket a felhasználó nem állíthatja be, és ha igen, figyelmen kívül hagyja.
totalRunningTime	string (duration)	a feladat végrehajtásával töltött teljes idő. Ezt az értéket a felhasználó nem állíthatja be, és ha igen, figyelmen kívül hagyja.
type	string: USql	az aktuális feladat feladattípusa (például Hive vagy USql).
yarnApplicationId	string	a feladatot végrehajtó yarn-alkalmazás azonosítására használt azonosító. Ezt az értéket a felhasználó nem állíthatja be, és ha igen, figyelmen kívül hagyja.
yarnApplicationTimeStamp	integer (int64)	a feladatot végrehajtó fonalalkalmazás időbélyege (kullancsokban). Ezt az értéket a felhasználó nem állíthatja be, és ha igen, figyelmen kívül hagyja.

Megosztás a következőn keresztül:

Job - Get

URI-paraméterek

Válaszok

Példák

Gets the job information for the specified job ID

Mintakérelem

Mintaválasz

Definíciók

CompileMode

Diagnostics

HiveJobProperties

JobDataPath

JobErrorDetails

JobInformation

JobInnerError

JobRelationshipProperties

JobResource

JobResourceType

JobResult

JobState

JobStateAuditRecord

JobStatistics

JobStatisticsVertexStage

JobType

SeverityTypes

USqlJobProperties