本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Neptune 加载程序获取状态响应
Neptune 加载程序获取状态响应 JSON 布局
加载器状态响应的一般布局如下:
{ "status" : "200 OK", "payload" : { "feedCount" : [ { "LOAD_FAILED" :
number
} ], "overallStatus" : { "fullUri" : "s3://bucket
/key
", "runNumber" :number
, "retryNumber" :number
, "status" : "string
", "totalTimeSpent" :number
, "startTime" :number
, "totalRecords" :number
, "totalDuplicates" :number
, "parsingErrors" :number
, "datatypeMismatchErrors" :number
, "insertErrors" :number
, }, "failedFeeds" : [ { "fullUri" : "s3://bucket
/key
", "runNumber" :number
, "retryNumber" :number
, "status" : "string
", "totalTimeSpent" :number
, "startTime" :number
, "totalRecords" :number
, "totalDuplicates" :number
, "parsingErrors" :number
, "datatypeMismatchErrors" :number
, "insertErrors" :number
, } ], "errors" : { "startIndex" :number
, "endIndex" :number
, "loadId" : "string
, "errorLogs" : [ ] } } }
Neptune 加载程序获取状态overallStatus
和failedFeeds
响应对象
对每个失败的馈送返回的可能响应(包括错误描述)和overallStatus
中的对象Get-Status
响应如下。
以下字段显示在overallStatus
对象用于所有负载,以及failedFeeds
每个失败的 Feed 的对象:
-
fullUri
-要加载的文件的 URI。类型:字符串
格式:
s3://
。bucket
/key
-
runNumber
此加载或馈送的运行编号。此编号将在加载重新启动时增加。类型:无符号整数
-
retryNumber
— 此加载或馈送的重试编号。此编号将在加载程序自动重试馈送或加载时递增。类型:无符号整数
-
status
— 返回的加载状态或馈送状态。LOAD_COMPLETED
指示加载成功,无问题。有关其他加载状态消息的列表,请参阅Neptune 加载程序错误和源消息.类型:字符串。
-
totalTimeSpent
— 解析并插入以进行加载或馈送的数据所耗费时间(秒)。这不包括提取源文件列表所耗费时间。类型:无符号整数
-
totalRecords
— 已加载或尝试加载的记录总数。类型:无符号整数
-
totalDuplicates
— 遇到的重复记录的数量。类型:无符号整数
对于 OpenPher 加载,在以下情况下会计入重复数据:
加载程序检测到节点文件中的某行的 ID 没有 ID 空间,该 ID 空间与另一个没有 ID 空间的 ID 值相同,无论是在另一行中还是属于现有节点。
加载程序检测到节点文件中的一行具有 ID 空间与 ID 空间的另一个 ID 值相同,无论是在另一行中还是属于现有节点。
-
parsingErrors
— 遇到的解析错误的数量。类型:无符号整数
-
datatypeMismatchErrors
— 数据类型与指定数据不匹配的记录的数量。类型:无符号整数
-
insertErrors
— 由于错误而无法插入的记录的数量。类型:无符号整数
Neptune 加载程序获取状态errors
响应对象
错误分为以下类别:
Error 400
— 无效loadId
返回 HTTP400
错误请求错误。此消息描述错误。Error 500
— 无法处理的有效请求返回 HTTP500
内部服务器错误。此消息描述错误。
请参阅Neptune 加载程序错误和源消息以获取加载器在出错时返回的错误和 Feed 消息的列表。
当出错时,一个 JSONerrors
对象在BODY
的答复,包含以下字段:
-
startIndex
— 包含的第一个错误的索引。类型:无符号整数
-
endIndex
— 包含的最后一个错误的索引。类型:无符号整数
-
loadId
— 加载的 ID。可通过将errors
参数设置为TRUE
来使用此 ID 打印错误。类型:字符串。
-
errorLogs
— 错误列表。类型:列表
Neptune 加载程序获取状态errorLogs
响应对象
这些区域有:errorLogs
下面的对象errors
在加载器中 Get-Status 响应中包含一个对象,使用以下字段描述每个错误:
-
errorCode
— 确定错误的性质。它可能需要以下值之一:
PARSING_ERROR
S3_ACCESS_DENIED_ERROR
FROM_OR_TO_VERTEX_ARE_MISSING
ID_ASSIGNED_TO_MULTIPLE_EDGES
SINGLE_CARDINALITY_VIOLATION
FILE_MODIFICATION_OR_DELETION_ERROR
OUT_OF_MEMORY_ERROR
INTERNAL_ERROR
(当批量加载器无法确定错误类型时返回)。
-
errorMessage
— 描述错误的消息。这可以是与错误代码关联的通用消息,也可以是包含详细信息的特定消息,例如关于缺少从/到点或解析错误的消息。
-
fileName
— 源的名称。 -
recordNum
— 在解析错误的情况下,这是记录文件中无法解析的记录编号。如果记录编号不适用于错误,或者无法确定,则将其设置为零。
例如,如果批量加载器在 RDF 中遇到错误行,如下所示,它将生成解析错误nquads
file:
<http://base#subject> |http://base#predicate> <http://base#true> .
正如你所看到的那样,第二个http
在上面一行中应该先加上<
而不是|
. 下生成的错误对象errorLogs
在状态响应中将如下所示:
{ "errorCode" : "PARSING_ERROR", "errorMessage" : "Expected '<', found: |", "fileName" : "
s3://bucket/key
", "recordNum" :12345
},