View a markdown version of this page

neptune.read () - Amazon Neptune
Praktik terbaik untuk neptune.read ()

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

neptune.read ()

Neptune mendukung CALL prosedur neptune.read untuk membaca data dari Amazon S3 dan kemudian menjalankan kueri OpenCypher (baca, sisipkan, memperbarui) menggunakan data. Prosedur menghasilkan setiap baris dalam file sebagai baris variabel hasil yang dideklarasikan. Ini menggunakan kredenSIAL IAM dari pemanggil untuk mengakses data di Amazon S3. Lihat Mengelola izin untuk neptune.read () untuk mengatur izin. Wil AWS ayah bucket Amazon S3 harus berada di wilayah yang sama tempat instance berada. Saat ini, pembacaan lintas wilayah tidak didukung.

Sintaksis 

CALL neptune.read(
  {
    source: "string",
    format: "parquet/csv",
    concurrency: 10
  }
)
YIELD row
...
Masukan

  • sumber (wajib) - URI Amazon S3 ke satu objek. Awalan Amazon S3 untuk beberapa objek tidak didukung.

  • format (wajib) - parquet dan csv didukung.

  • konkurensi (opsional) - Jenis: 0 atau bilangan bulat yang lebih besar. Standar: 0. Menentukan jumlah thread yang akan digunakan untuk membaca file. Jika nilainya 0, jumlah utas maksimum yang diizinkan oleh sumber daya akan digunakan. Untuk Parket, disarankan untuk diatur ke sejumlah kelompok baris.

Output

Neptune.read mengembalikan:

  • baris - Tipe:peta

    • Setiap baris dalam file, di mana kunci adalah kolom dan nilainya adalah data yang ditemukan di setiap kolom.

    • Anda dapat mengakses data setiap kolom seperti akses properti (row.col).

Praktik terbaik untuk neptune.read ()

Operasi baca Neptune S3 dapat memakan banyak memori. Gunakan tipe instans yang cocok untuk beban kerja produksi seperti yang diuraikan dalam Memilih jenis instans untuk Amazon Neptune.

Penggunaan memori dan kinerja neptune.read() permintaan dipengaruhi oleh berbagai faktor seperti ukuran file, jumlah kolom, jumlah baris, dan format file. Bergantung pada struktur, file kecil (misalnya, file CSV 100MB atau lebih rendah, file Parquet 20MB atau lebih rendah) dapat bekerja dengan andal pada sebagian besar jenis instans yang sesuai dengan produksi, sedangkan file yang lebih besar mungkin memerlukan memori besar yang tidak dapat disediakan oleh jenis instans yang lebih kecil.

Saat menguji fitur ini, disarankan untuk memulai dengan file kecil dan menskalakan secara bertahap untuk memastikan beban kerja baca Anda dapat diakomodasi oleh ukuran instans Anda. Jika Anda melihat neptune.read() permintaan yang menyebabkan pengecualian kehabisan memori atau restart instans, pertimbangkan untuk membagi file menjadi potongan-potongan yang lebih kecil, mengurangi kompleksitas file, atau meningkatkan ke jenis instans yang lebih besar.