翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Neptune Loader Get-Status レスポンス
Neptune Get-Status API からの次のレスポンス例では、レスポンスの全体的な構造、さまざまなフィールドとそのデータ型、エラー処理、エラーログの詳細について説明します。
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
が無効の場合、HTTP400
無効な要求エラーが返されます。エラーを説明するメッセージ。Error 500
- 処理できない有効なリクエストは、HTTP500
内部サーバーエラーを返します。エラーを説明するメッセージ。
エラー発生時にローダーから返されるエラーおよびフィードメッセージのリストについては、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
},