Neptune 加载程序获取状态响应 - Amazon Neptune
JSON 布局整体状态对象错误对象错误日志对象
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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 值相同，无论是在另一行中还是属于现有节点。

    请参阅 加载 OpenPher 数据的特殊注意事项。

  • 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 中遇到错误行，如下所示，它将生成解析错误nquadsfile:

<http://base#subject> |http://base#predicate> <http://base#true> .

正如你所看到的那样，第二个http在上面一行中应该先加上<而不是|. 下生成的错误对象errorLogs在状态响应中将如下所示：

{
    "errorCode" : "PARSING_ERROR",
    "errorMessage" : "Expected '<', found: |",
    "fileName" : "s3://bucket/key",
    "recordNum" : 12345
},