Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Neptunus Loader API Get-Status Mendapat status pekerjaan `loader`. Untuk mendapatkan status pemuatan, Anda harus mengirim permintaan `GET` HTTP ke titik akhir `https://your-neptune-endpoint:port/loader`. Untuk mendapatkan status permintaan pemuatan tertentu, Anda harus menyertakan `loadId` sebagai parameter URL, atau menambahkan `loadId` ke jalur URL. Neptune hanya melacak 1.024 pekerjaan pemuatan massal terbaru, dan hanya menyimpan 10.000 rincian kesalahan terakhir per pekerjaan. Lihat [Pesan Kesalahan dan Umpan Neptune Loader](loader-message.md) untuk daftar pesan kesalahan dan umpan yang dikembalikan oleh loader jika terjadi kesalahan. **Contents** + [Permintaan Neptune Loader Get-Status](load-api-reference-status-requests.md) + [Sintaks Get-Status permintaan loader](load-api-reference-status-requests.md#load-api-reference-status-request-syntax) + [Parameter permintaan Neptune Loader Get-Status](load-api-reference-status-requests.md#load-api-reference-status-parameters) + [Tanggapan Neptunus Loader Get-Status](load-api-reference-status-response.md) + [Tata letak JSON Respons Pemuat Neptunus Get-Status](load-api-reference-status-response.md#load-api-reference-status-response-layout) + [Neptunus Loader Get-Status `overallStatus` dan objek respons `failedFeeds`](load-api-reference-status-response.md#load-api-reference-status-response-objects) + [Objek respons Get-Status `errors` Neptunus Loader](load-api-reference-status-response.md#load-api-reference-status-errors) + [Objek respons Get-Status `errorLogs` Neptunus Loader](load-api-reference-status-response.md#load-api-reference-error-logs) + [Contoh Pemuat Get-Status Neptunus](load-api-reference-status-examples.md) + [Contoh permintaan untuk status pemuatan](load-api-reference-status-examples.md#load-api-reference-status-examples-status-request) + [Contoh permintaan untuk loadIds](load-api-reference-status-examples.md#load-api-reference-status-examples-loadId-request) + [Contoh permintaan untuk status terperinci](load-api-reference-status-examples.md#load-api-reference-status-examples-details-request) + [Contoh Neptunus Loader Get-Status `errorLogs`](load-api-reference-error-logs-examples.md) + [Contoh respons status rinci ketika terjadi kesalahan](load-api-reference-error-logs-examples.md#load-api-reference-status-examples-details-request-errors) + [Contoh kesalahan `Data prefetch task interrupted`](load-api-reference-error-logs-examples.md#load-api-reference-status-examples-task-interrupted) # Permintaan Neptune Loader Get-Status ## Sintaks Get-Status permintaan loader ``` GET https://your-neptune-endpoint:port/loader?loadId=loadId ``` ``` GET https://your-neptune-endpoint:port/loader/loadId ``` ``` GET https://your-neptune-endpoint:port/loader ``` ## Parameter permintaan Neptune Loader Get-Status + **`loadId`**— ID tugas pemuatan. Jika Anda tidak menentukan`loadId`, daftar beban IDs dikembalikan. + **`details`**— Sertakan detail di luar status keseluruhan. *Nilai yang diizinkan*: `TRUE`, `FALSE`. *Nilai default*:`FALSE`. + **`errors`**— Sertakan daftar kesalahan. *Nilai yang diizinkan*: `TRUE`, `FALSE`. *Nilai default*:`FALSE`. Daftar kesalahan dipecah dalam beberapa bagian. Parameter `page` dan `errorsPerPage` memungkinkan Anda untuk melalui semua kesalahan dalam beberapa bagian. + **`page`**— Nomor halaman kesalahan. Hanya berlaku dengan parameter `errors` diatur ke `TRUE`. *Nilai yang diizinkan*: Bilangan bulat positif. *Nilai default*: 1. + **`errorsPerPage`**— Jumlah kesalahan per setiap halaman. Hanya berlaku dengan parameter `errors` diatur ke `TRUE`. *Nilai yang diizinkan*: Bilangan bulat positif. *Nilai default*: 10. + **`limit`**— Jumlah id pemuatan untuk dicantumkan. Hanya berlaku saat meminta daftar pemuatan IDs dengan mengirimkan `GET` permintaan tanpa `loadId` ditentukan. *Nilai yang diizinkan*: Bilangan bulat positif dari 1 hingga 100. *Nilai default*: 100. + **`includeQueuedLoads`**- Parameter opsional yang dapat digunakan untuk mengecualikan beban IDs permintaan beban antrian ketika daftar beban IDs diminta. Secara default, beban IDs semua pekerjaan pemuatan dengan status `LOAD_IN_QUEUE` termasuk dalam daftar seperti itu. Mereka muncul sebelum beban IDs pekerjaan lain, diurutkan berdasarkan waktu mereka ditambahkan ke antrian dari yang terbaru hingga yang paling awal. *Nilai yang diizinkan*: `TRUE`, `FALSE`. *Nilai default*:`TRUE`. # Tanggapan Neptunus Loader Get-Status Contoh respons berikut dari Get-Status Neptunus API menjelaskan keseluruhan struktur respons, menjelaskan berbagai bidang dan tipe datanya, serta penanganan kesalahan dan detail log kesalahan. ## Tata letak JSON Respons Pemuat Neptunus Get-Status Tata letak umum respon status loader adalah sebagai berikut: ``` { "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" : [ ] } } } ``` ## Neptunus Loader Get-Status `overallStatus` dan objek respons `failedFeeds` Respons yang mungkin dikembalikan untuk setiap umpan gagal, termasuk deskripsi kesalahan, adalah sama seperti untuk objek `overallStatus` dalam respons `Get-Status`. Bidang berikut ini muncul di objek `overallStatus` untuk semua pemuatan, dan objek `failedFeeds` untuk setiap umpan gagal: + **`fullUri` **— URI dari file atau file-file yang akan dimuat. *Jenis:* *string* *Format*:`s3://bucket/key`. + **`runNumber`**— Jumlah run dari pemuatan atau umpan ini. Ini bertambah ketika pemuatan dimulai ulang. *Jenis:* *panjang yang tidak diberi tanda*. + **`retryNumber`**— Jumlah retry dari pemuatan atau umpan ini. Ini bertambah ketika loader secara otomatis mencoba ulang umpan atau pemuatan. *Jenis:* *panjang yang tidak diberi tanda*. + **`status`**— Status yang dikembalikan dari pemuatan atau umpan. `LOAD_COMPLETED` menunjukkan pemuatan yang berhasil tanpa masalah. Untuk daftar pesan status beban lainnya, lihat. [Pesan Kesalahan dan Umpan Neptune Loader](loader-message.md) *Jenis:* *string*. + **`totalTimeSpent`**— Waktu, dalam hitungan detik, yang dihabiskan untuk mengurai dan memasukkan data untuk pemuatan atau umpan. Ini tidak termasuk waktu yang dihabiskan untuk mengambil daftar file sumber. *Jenis:* *panjang yang tidak diberi tanda*. + **`totalRecords`**— Jumlah catatan yang dimuat atau dicoba untuk dimuat. *Jenis:* *panjang yang tidak diberi tanda*. Perhatikan bahwa saat memuat dari file CSV, jumlah catatan tidak mengacu pada jumlah baris yang dimuat, melainkan jumlah catatan individual di baris tersebut. Misalnya, ambil file CSV kecil seperti ini: ``` ~id,~label,name,team 'P-1','Player','Stokes','England' ``` Neptunus akan menganggap file ini berisi 3 catatan, yaitu: ``` P-1 label Player P-1 name Stokes P-1 team England ``` + **`totalDuplicates`**— Jumlah catatan duplikat yang ditemui. *Jenis:* *panjang yang tidak diberi tanda*. Seperti dalam kasus `totalRecords` penghitungan, nilai ini berisi jumlah catatan duplikat individu dalam file CSV, bukan jumlah baris duplikat. Ambil file CSV kecil ini, misalnya: ``` ~id,~label,name,team P-2,Player,Kohli,India P-2,Player,Kohli,India ``` Status yang dikembalikan setelah memuatnya akan terlihat seperti ini, melaporkan 6 total catatan, 3 di antaranya adalah duplikat: ``` { "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 } } } ``` Untuk pemuatan OpenCypher, duplikat dihitung ketika: + Loader mendeteksi bahwa baris dalam file node memiliki ID tanpa ruang ID yang sama dengan nilai ID lain tanpa ruang ID, baik di baris lain atau milik node yang ada. + Loader mendeteksi bahwa baris dalam file node memiliki ID dengan ruang ID yang sama dengan nilai ID lain dengan ruang ID, baik di baris lain atau milik node yang ada. Lihat [Pertimbangan khusus untuk memuat data OpenCypher](load-api-reference-load.md#load-api-reference-load-parameters-opencypher). + **`parsingErrors`**— Jumlah kesalahan penguraian yang ditemui. *Jenis:* *panjang yang tidak diberi tanda*. + **`datatypeMismatchErrors`**— Jumlah catatan dengan tipe data yang tidak cocok dengan data yang diberikan. *Jenis:* *panjang yang tidak diberi tanda*. + **`insertErrors`**— Jumlah catatan yang tidak dapat dimasukkan karena kesalahan. *Jenis:* *panjang yang tidak diberi tanda*. ## Objek respons Get-Status `errors` Neptunus Loader Kesalahan termasuk ke dalam kategori berikut: + **`Error 400`**   –   `loadId` yang tidak valid mengembalikan kesalahan permintaan buruk `400` HTTP. Pesan ini menjelaskan kesalahan. + **`Error 500`** — Permintaan valid yang tidak dapat diproses mengembalikan HTTP `500` kesalahan server internal. Pesan ini menjelaskan kesalahan. Lihat [Pesan Kesalahan dan Umpan Neptune Loader](loader-message.md) untuk daftar pesan kesalahan dan umpan yang dikembalikan oleh loader jika terjadi kesalahan. Ketika terjadi kesalahan, sebuah objek `errors` JSON dikembalikan dalam `BODY` respons, dengan kolom berikut: + **`startIndex`** — Indeks kesalahan pertama yang disertakan. *Jenis:* *panjang yang tidak diberi tanda*. + **`endIndex`** — Indeks kesalahan terakhir yang disertakan. *Jenis:* *panjang yang tidak diberi tanda*. + **`loadId`** — ID pemuatan. Anda dapat menggunakan ID ini untuk mencetak kesalahan untuk pemuatan dengan menetapkan parameter `errors` ke `TRUE`. *Jenis:* *string*. + **`errorLogs`** — Daftar kesalahan. *Jenis:* *daftar*. ## Objek respons Get-Status `errorLogs` Neptunus Loader Objek `errorLogs` di bawah `errors` dalam respons Get-Status loader berisi objek yang menggambarkan setiap kesalahan menggunakan bidang berikut: + **`errorCode`** — Mengidentifikasi sifat kesalahan. Status ini dapat berupa salah satu dari nilai berikut: + `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` (dikembalikan ketika loader massal tidak dapat menentukan jenis kesalahan). + **`errorMessage`** — Sebuah pesan yang menjelaskan kesalahan. Ini bisa berupa pesan umum yang terkait dengan kode kesalahan atau pesan tertentu yang berisi detail, misalnya tentang from/to simpul yang hilang atau tentang kesalahan penguraian. + **`fileName`** — Nama umpan. + **`recordNum`** — Dalam kasus kesalahan penguraian, ini adalah nomor catatan dalam file catatan yang tidak dapat diurai. Hal ini diatur ke nol jika nomor catatan tidak berlaku untuk kesalahan, atau jika tidak dapat ditentukan. Sebagai contoh, loader massal akan menghasilkan kesalahan penguraian jika mengalami baris rusak seperti berikut dalam file `nquads` RDF: ``` |http://base#predicate> . ``` Seperti yang Anda lihat, `http` yang kedua pada baris di atas harus didahului oleh `<` ketimbang `|`. Objek kesalahan yang dihasilkan di bawah `errorLogs` dalam respon status akan terlihat seperti ini: ``` { "errorCode" : "PARSING_ERROR", "errorMessage" : "Expected '<', found: |", "fileName" : "s3://bucket/key", "recordNum" : 12345 }, ``` # Contoh Pemuat Get-Status Neptunus Contoh berikut menampilkan penggunaan API Get-status loader Neptunus, yang memungkinkan Anda mengambil informasi tentang status pemuatan data Anda ke dalam database grafik Amazon Neptunus. Contoh-contoh ini mencakup tiga skenario utama: mengambil status beban tertentu, mencantumkan beban yang tersedia IDs, dan meminta informasi status terperinci untuk beban tertentu. ## Contoh permintaan untuk status pemuatan Berikut ini adalah permintaan yang dikirim melalui HTTP `GET` menggunakan perintah `curl`. ``` curl -X GET 'https://your-neptune-endpoint:port/loader/loadId (a UUID)' ``` **Example Respons** ``` { "status" : "200 OK", "payload" : { "feedCount" : [ { "LOAD_FAILED" : 1 } ], "overallStatus" : { "datatypeMismatchErrors" : 0, "fullUri" : "s3://bucket/key", "insertErrors" : 0, "parsingErrors" : 5, "retryNumber" : 0, "runNumber" : 1, "status" : "LOAD_FAILED", "totalDuplicates" : 0, "totalRecords" : 5, "totalTimeSpent" : 3.0 } } } ``` ## Contoh permintaan untuk loadIds Berikut ini adalah permintaan yang dikirim melalui HTTP `GET` menggunakan perintah `curl`. ``` curl -X GET 'https://your-neptune-endpoint:port/loader?limit=3' ``` **Example Respons** ``` { "status" : "200 OK", "payload" : { "loadIds" : [ "a2c0ce44-a44b-4517-8cd4-1dc144a8e5b5", "09683a01-6f37-4774-bb1b-5620d87f1931", "58085eb8-ceb4-4029-a3dc-3840969826b9" ] } } ``` ## Contoh permintaan untuk status terperinci Berikut ini adalah permintaan yang dikirim melalui HTTP `GET` menggunakan perintah `curl`. ``` curl -X GET 'https://your-neptune-endpoint:port/loader/loadId (a UUID)?details=true' ``` **Example Respons** ``` { "status" : "200 OK", "payload" : { "failedFeeds" : [ { "datatypeMismatchErrors" : 0, "fullUri" : "s3://bucket/key", "insertErrors" : 0, "parsingErrors" : 5, "retryNumber" : 0, "runNumber" : 1, "status" : "LOAD_FAILED", "totalDuplicates" : 0, "totalRecords" : 5, "totalTimeSpent" : 3.0 } ], "feedCount" : [ { "LOAD_FAILED" : 1 } ], "overallStatus" : { "datatypeMismatchErrors" : 0, "fullUri" : "s3://bucket/key", "insertErrors" : 0, "parsingErrors" : 5, "retryNumber" : 0, "runNumber" : 1, "status" : "LOAD_FAILED", "totalDuplicates" : 0, "totalRecords" : 5, "totalTimeSpent" : 3.0 } } } ``` # Contoh Neptunus Loader Get-Status `errorLogs` Contoh berikut menampilkan respons status terperinci dari pemuat Neptunus saat terjadi kesalahan selama proses pemuatan data. Contoh menggambarkan struktur respons, termasuk informasi tentang feed yang gagal, status keseluruhan, dan log kesalahan terperinci. ## Contoh respons status rinci ketika terjadi kesalahan Ini adalah permintaan yang dikirim melalui HTTP `GET` menggunakan `curl`: ``` curl -X GET 'https://your-neptune-endpoint:port/loader/0a237328-afd5-4574-a0bc-c29ce5f54802?details=true&errors=true&page=1&errorsPerPage=3' ``` **Example dari respons terperinci ketika terjadi kesalahan** Ini adalah contoh dari respon yang mungkin Anda dapatkan dari kueri di atas, dengan objek `errorLogs` yang mencantumkan kesalahan pemuatan yang ditemui: ``` { "status" : "200 OK", "payload" : { "failedFeeds" : [ { "datatypeMismatchErrors" : 0, "fullUri" : "s3://bucket/key", "insertErrors" : 0, "parsingErrors" : 5, "retryNumber" : 0, "runNumber" : 1, "status" : "LOAD_FAILED", "totalDuplicates" : 0, "totalRecords" : 5, "totalTimeSpent" : 3.0 } ], "feedCount" : [ { "LOAD_FAILED" : 1 } ], "overallStatus" : { "datatypeMismatchErrors" : 0, "fullUri" : "s3://bucket/key", "insertErrors" : 0, "parsingErrors" : 5, "retryNumber" : 0, "runNumber" : 1, "status" : "LOAD_FAILED", "totalDuplicates" : 0, "totalRecords" : 5, "totalTimeSpent" : 3.0 }, "errors" : { "endIndex" : 3, "errorLogs" : [ { "errorCode" : "PARSING_ERROR", "errorMessage" : "Expected '<', found: |", "fileName" : "s3://bucket/key", "recordNum" : 1 }, { "errorCode" : "PARSING_ERROR", "errorMessage" : "Expected '<', found: |", "fileName" : "s3://bucket/key", "recordNum" : 2 }, { "errorCode" : "PARSING_ERROR", "errorMessage" : "Expected '<', found: |", "fileName" : "s3://bucket/key", "recordNum" : 3 } ], "loadId" : "0a237328-afd5-4574-a0bc-c29ce5f54802", "startIndex" : 1 } } } ``` ## Contoh kesalahan `Data prefetch task interrupted` Kadang-kadang ketika Anda mendapatkan status `LOAD_FAILED` dan kemudian meminta informasi lebih rinci, kesalahan yang dikembalikan mungkin berupa `PARSING_ERROR` dengan pesan `Data prefetch task interrupted`, seperti ini: ``` "errorLogs" : [ { "errorCode" : "PARSING_ERROR", "errorMessage" : "Data prefetch task interrupted: Data prefetch task for 11467 failed", "fileName" : "s3://amzn-s3-demo-bucket/some-source-file", "recordNum" : 0 } ] ``` Kesalahan ini terjadi ketika ada gangguan sementara dalam proses pemuatan data yang biasanya tidak disebabkan oleh permintaan atau data Anda. Biasanya dapat diselesaikan hanya dengan menjalankan permintaan upload massal lagi. Jika Anda menggunakan pengaturan default, yaitu `"mode":"AUTO"`, dan `"failOnError":"TRUE"`, loader melewatkan file yang sudah berhasil dimuat dan melanjutkan pemuatan file yang belum dimuat saat terjadi gangguan.