Neptune Loader Get-Status レスポンス - Amazon Neptune
JSON のレイアウトoverallStatus オブジェクトerrors オブジェクトerrorLogs オブジェクト

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Neptune Loader Get-Status レスポンス

Neptune Loader Get-Status レスポンスのレイアウト

ローダーステータスレスポンスの一般的なレイアウトは次のとおりです。

{
    "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 Loader Get-Status overallStatus および failedFeeds レスポンスオブジェクト

エラーの説明とともに、ローダーからの失敗したフィードごとに返される可能性のある応答は、Get-Status レスポンスの overallStatus オブジェクトの場合と同じです。

これらのフィールドは、すべてのロードの overallStatus オブジェクト、および失敗した各フィードの failedFeeds オブジェクトに表示されます。

  • fullUri - ロードされる 1 つ以上のファイルの URI。

    タイプ: 文字列

    形式: s3://bucket/key。

  • runNumber - このロードまたはフィードの実行数。これは、ロードが再開されると増加します。

    タイプ: 符号なし long。

  • retryNumber - このロードまたはフィードの再試行回数。これは、ローダーがフィードまたはロードを自動的に再試行するときに増分されます。

    タイプ: 符号なし long。

  • status - ロードあるいはフィードの返されたステータス。LOAD_COMPLETED はロードが問題なく成功したことを示します。その他のロードステータスメッセージのリストについては、Neptune ローダーのエラーおよびフィードメッセージ を参照してください。

    タイプ: 文字列。

  • totalTimeSpent - ロードまたはフィードのデータの解析や挿入に費やした時間 (秒単位)。これには、ソースファイルのリストを取得するのに費やされた時間は含まれません。

    タイプ: 符号なし long。

  • totalRecords - ロードされた、またはロードしようとした全レコード。

    タイプ: 符号なし long。

    CSV ファイルからロードする場合、レコード数はロードされた行数ではなく、その行に含まれる個々のレコードの数を指すことに注意してください。例えば、次のような小さな CSV ファイルを考えてみましょう。

    ~id,~label,name,team
'P-1','Player','Stokes','England'

    Neptune は、このファイルには次の 3 つのレコードが含まれていると見なします。

    P-1  label Player
P-1  name  Stokes
P-1  team  England

  • totalDuplicates - 発生した重複レコードの数。

    タイプ: 符号なし long。

    totalRecords カウントの場合と同様に、この値には重複行の数ではなく、CSV ファイル内の個々の重複レコードの数が含まれます。例えば、次のような小さな CSV ファイルを考えてみましょう。

    ~id,~label,name,team
P-2,Player,Kohli,India
P-2,Player,Kohli,India

    ロード後に返されるステータスは以下のようになり、合計で 6 件のレコードが報告され、そのうちの 3 件は重複しています。

    {
  "status": "200 OK",
  "payload": {
    "feedCount": [
      {
        "LOAD_COMPLETED": 1
      }
    ],
    "overallStatus": {
      "fullUri": "(the URI of the CSV file)",
      "runNumber": 1,
      "retryNumber": 0,
      "status": "LOAD_COMPLETED",
      "totalTimeSpent": 3,
      "startTime": 1662131463,
      "totalRecords": 6,
      "totalDuplicates": 3,
      "parsingErrors": 0,
      "datatypeMismatchErrors": 0,
      "insertErrors": 0
    }
  }
}

    openCypher ロードの場合、次の場合に重複がカウントされます。

    • ローダーは、ノードファイル内の行が、別の行または既存のノードに属する ID スペースのない別の ID 値と同じ ID スペースを持たないIDを持っていることを検出します。

    • ローダーは、ノードファイル内の行が、別の行にあるか、既存のノードに属する ID スペースを持つ別の ID 値と同じ ID スペースを持つ ID を持っていることを検出します。

    openCypher データのロードに関する特別な考慮事項 を参照してください。

  • parsingErrors - 発生した解析エラーの数。

    タイプ: 符号なし long。

  • datatypeMismatchErrors - 指定されたデータとデータ型が一致しないレコードの数。

    タイプ: 符号なし long。

  • insertErrors - エラーにより挿入できなかったレコード数。

    タイプ: 符号なし long。

Neptune Loader Get-Status errors レスポンスオブジェクト

エラーは以下のカテゴリに分類されます。

  • Error 400 - loadId が無効の場合、HTTP 400 無効な要求エラーが返されます。エラーを説明するメッセージ。

  • Error 500 - 処理できない有効なリクエストは、HTTP 500 内部サーバーエラーを返します。エラーを説明するメッセージ。

エラー発生時にローダーから返されるエラーおよびフィードメッセージのリストについては、Neptune ローダーのエラーおよびフィードメッセージ を参照してください。

エラーが発生すると、JSON errors オブジェクトがレスポンスの BODY に次のフィールドと共に返されます。

  • startIndex - 最初に含まれたエラーのインデックス。

    タイプ: 符号なし long。

  • endIndex - 最後に含まれたエラーのインデックス。

    タイプ: 符号なし long。

  • loadId - ロードの ID。この ID を使用すると、errors パラメータを TRUE に設定してロードのエラーを出力できます。

    タイプ: 文字列。

  • errorLogs — エラーのリスト。

    タイプ: リスト。

Neptune Loader Get-Status errorLogs レスポンスオブジェクト

ローダー Get-Status レスポンスの errors にある errorLogs オブジェクトには、次のフィールドを使用して各エラーを説明するオブジェクトが含まれています。

  • 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 - エラーを説明するメッセージ。

    これは、エラーコードに関連付けられた一般的なメッセージ、または詳細を含む特定のメッセージ (たとえば、From/To 頂点の欠落、解析エラーなど) です。

  • fileName — フィードの名前。

  • recordNum — 解析エラーの場合、これは解析できなかったレコードのファイル内のレコード番号です。レコード番号がエラーに適用されない場合、または特定できなかった場合は 0 に設定されます。

たとえば、RDF nquads ファイルで次のような障害のある行に遭遇した場合、バルクローダは解析エラーを生成します。

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

ご覧のとおり、上の 2 番目の http 行の前には | ではなく < とがあります。ステータスレスポンスの errorLogs における結果のエラーオブジェクトは次のようになります。

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