Pilih preferensi cookie Anda

Kami menggunakan cookie penting serta alat serupa yang diperlukan untuk menyediakan situs dan layanan. Kami menggunakan cookie performa untuk mengumpulkan statistik anonim sehingga kami dapat memahami cara pelanggan menggunakan situs dan melakukan perbaikan. Cookie penting tidak dapat dinonaktifkan, tetapi Anda dapat mengklik “Kustom” atau “Tolak” untuk menolak cookie performa.

Jika Anda setuju, AWS dan pihak ketiga yang disetujui juga akan menggunakan cookie untuk menyediakan fitur situs yang berguna, mengingat preferensi Anda, dan menampilkan konten yang relevan, termasuk iklan yang relevan. Untuk menerima atau menolak semua cookie yang tidak penting, klik “Terima” atau “Tolak”. Untuk membuat pilihan yang lebih detail, klik “Kustomisasi”.

Preferensi
Hubungi Kami
Umpan Balik
AWS Documentation
Buat Akun AWS

Contoh: Memuat Data ke Instans DB Neptune

PDF
RSS
Mode fokus
Contoh: Memuat Data ke Instans DB Neptune - Amazon Neptune
Prasyarat

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

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

Contoh ini menunjukkan cara memuat data ke Amazon Neptune. Kecuali dinyatakan lain, Anda harus mengikuti langkah-langkah ini dari instans Amazon Elastic Compute Cloud (Amazon EC2) di Amazon Virtual Private Cloud (VPC) yang sama dengan instans DB Neptunus Anda.

Prasyarat untuk Contoh Pemuatan Data

Sebelum memulai, Anda harus memiliki hal-hal berikut:

  • Instans DB Neptune.

    Untuk informasi tentang meluncurkan instans DB Neptune, lihat Membuat cluster Amazon Neptunus.

  • Bucket Amazon Simple Storage Service (Amazon S3) tempat file data akan diletakkan.

    Anda dapat menggunakan bucket yang ada. Jika Anda tidak memiliki bucket S3, lihat Buat Bucket di Panduan Memulai Amazon S3.

  • Grafik data untuk dimuat, dalam salah satu format yang didukung oleh loader Neptune:

    Jika Anda menggunakan Gremlin untuk menanyakan grafik Anda, Neptunus dapat memuat data dalam format comma-separated-values (CSV), seperti yang dijelaskan dalam. Format data muat Gremlin

    Jika Anda menggunakan OpenCypher untuk menanyakan grafik Anda, Neptunus juga dapat memuat data dalam format khusus OpenCypher, seperti yang dijelaskan dalam. CSV Muat format untuk data OpenCypher

    Jika Anda menggunakan SPARQL, Neptune dapat memuat data dalam sejumlah format RDF, seperti yang dijelaskan di Format data beban RDF.

  • IAM role untuk instans DB Neptune menganggap bahwa memiliki kebijakan IAM yang memungkinkan akses ke file data dalam bucket S3. Kebijakan harus memberikan izin Baca dan Daftar.

    Untuk informasi tentang membuat peran yang memiliki akses ke Amazon S3 dan kemudian mengaitkannya dengan klaster Neptune, lihat Prasyarat: IAM role dan Akses Amazon S3.

    catatan

    API Load Neptune membutuhkan akses baca ke file data saja. Kebijakan IAM tidak perlu mengizinkan akses tulis atau akses ke seluruh bucket.

  • VPC Endpoint Amazon S3. Untuk informasi selengkapnya, lihat bagian Membuat VPC Endpoint Amazon S3.

Membuat VPC Endpoint Amazon S3

Neptune loader membutuhkan VPC Endpoint untuk Amazon S3.

Untuk menyiapkan akses untuk Amazon S3

  1. Masuk ke AWS Management Console dan buka konsol VPC Amazon di. https://console.aws.amazon.com/vpc/

  2. Pada panel navigasi kiri, pilih Titik Akhir.

  3. Pilih Buat Titik Akhir.

  4. Pilih Nama Layanan com.amazonaws.region.s3.

    catatan

    Jika Wilayah di sini salah, pastikan bahwa Wilayah konsol sudah benar.

  5. Pilih VPC yang berisi instans DB Neptune Anda.

  6. Pilih kotak centang di samping tabel rute yang terkait dengan subnet yang terkait dengan klaster Anda. Jika Anda hanya memiliki satu tabel rute, Anda harus memilih kotak itu.

  7. Pilih Buat Titik Akhir.

Untuk informasi selengkapnya tentang membuat titik akhir, lihat VPC Endpoint dalam Panduan Pengguna Amazon VPC. Untuk informasi tentang keterbatasan VPC Endpoint, lihat VPC Endpoint untuk Amazon S3.

Untuk memuat data ke dalam instans DB Neptune

  1. Salin file data ke bucket Amazon S3. Bucket S3 harus berada di AWS Region yang sama dengan cluster yang memuat data.

    Anda dapat menggunakan AWS CLI perintah berikut untuk menyalin file ke ember.

    catatan

    Perintah ini tidak perlu dijalankan dari EC2 instance Amazon.

    aws s3 cp data-file-name s3://bucket-name/object-key-name
    catatan

    Di Amazon S3, sebuah nama kunci objek adalah seluruh jalur file, termasuk nama file.

    Contoh: Dalam perintah aws s3 cp datafile.txt s3://examplebucket/mydirectory/datafile.txt, nama kunci objeknya adalah mydirectory/datafile.txt.

    Atau, Anda dapat menggunakan file AWS Management Console untuk mengunggah file ke bucket S3. Buka konsol Amazon S3 di https://console.aws.amazon.com/s3/, dan pilih ember. Di sudut kiri atas, pilih Unggah untuk mengunggah file.

  2. Dari jendela baris perintah, masukkan yang berikut ini untuk menjalankan pemuat Neptunus, menggunakan nilai yang benar untuk titik akhir, jalur Amazon S3, format, dan peran IAM ARN.

    formatParameter dapat berupa salah satu dari nilai berikut: csv untuk Gremlin, opencypher untuk OpenCypher, atauntriples,,, dan untuk RDF. nquads turtle rdfxml Untuk informasi tentang parameter lain, lihat Perintah Loader Neptune.

    Untuk informasi tentang menemukan nama host instans DB Neptune Anda, lihat bagian Menghubungkan ke Titik Akhir Amazon Neptune..

    Parameter Wilayah harus sesuai dengan Wilayah klaster dan bucket S3.

    Amazon Neptunus tersedia di Wilayah berikut: AWS

    • US East (N. Virginia):   us-east-1

    • AS Timur (Ohio): us-east-2

    • US West (N. California):   us-west-1

    • US West (Oregon):   us-west-2

    • Canada (Central):   ca-central-1

    • South America (São Paulo):   sa-east-1

    • Eropa (Stockholm): eu-north-1

    • Eropa (Spanyol): eu-south-2

    • Eropa (Irlandia): eu-west-1

    • Eropa (London): eu-west-2

    • Eropa (Paris): eu-west-3

    • Eropa (Frankfurt): eu-central-1

    • Timur Tengah (Bahrain): me-south-1

    • Timur Tengah (UEA): me-central-1

    • Israel (Tel Aviv): il-central-1

    • Afrika (Cape Town): af-south-1

    • Asia Pasifik (Hong Kong): ap-east-1

    • Asia Pacific (Tokyo):   ap-northeast-1

    • Asia Pasifik (Seoul): ap-northeast-2

    • Asia Pasifik (Osaka): ap-northeast-3

    • Asia Pacific (Singapore):   ap-southeast-1

    • Asia Pacific (Sydney):   ap-southeast-2

    • Asia Pasifik (Jakarta): ap-southeast-3

    • Asia Pasifik (Malaysia): ap-southeast-5

    • Asia Pasifik (Mumbai): ap-south-1

    • Tiongkok (Beijing): cn-north-1

    • Tiongkok (Ningxia): cn-northwest-1

    • AWS GovCloud (AS-Barat): us-gov-west-1

    • AWS GovCloud (AS-Timur): us-gov-east-1

    curl -X POST \
    -H 'Content-Type: application/json' \
    https://your-neptune-endpoint:port/loader -d '
    {
      "source" : "s3://bucket-name/object-key-name",
      "format" : "format",
      "iamRoleArn" : "arn:aws:iam::account-id:role/role-name",
      "region" : "region",
      "failOnError" : "FALSE",
      "parallelism" : "MEDIUM",
      "updateSingleCardinalityProperties" : "FALSE",
      "queueRequest" : "TRUE",
      "dependencies" : ["load_A_id", "load_B_id"]
    }'

    Untuk informasi tentang membuat dan mengaitkan IAM role dengan klaster Neptune, lihat Prasyarat: IAM role dan Akses Amazon S3.

    catatan

    Lihat Parameter Permintaan Loader Neptune) untuk informasi detail tentang parameter permintaan pemuatan. Singkatnya:

    Parameter source menerima URI Amazon S3 yang menunjuk ke satu file atau folder. Jika Anda menentukan folder, Neptune memuat setiap file data dalam folder.

    Folder dapat berisi beberapa file vertex dan beberapa file edge.

    URI dapat berupa format berikut.

    • s3://bucket_name/object-key-name

    • https://s3.amazonaws.com/bucket_name/object-key-name

    • https://s3-us-east-1.amazonaws.com/bucket_name/object-key-name

    Parameter format dapat berupa salah satu dari hal berikut:

    • Format CSV Gremlin (csv) untuk grafik properti Gremlin

    • OpenCypher CSV format (opencypher) untuk grafik properti OpenCypher

    • Format N -Triple (ntriples) untuk RDF/SPARQL

    • Format N-Quad (nquads) untuk RDF/SPARQL

    • Format RDF/XML (rdfxml) untuk RDF/SPARQL

    • Format Turtle (turtle) untuk RDF/SPARQL

    Parameter parallelism opsional memungkinkan Anda membatasi jumlah utas yang digunakan dalam proses pemuatan massal. Anda dapat mengaturnya ke LOW, MEDIUM, HIGH, atau OVERSUBSCRIBE.

    Saat updateSingleCardinalityProperties diatur ke "FALSE", loader mengembalikan kesalahan jika lebih dari satu nilai disediakan dalam file sumber yang dimuat untuk edge atau properti single-cardinality vertex.

    Mengatur queueRequest ke "TRUE" menyebabkan permintaan pemuatan ditempatkan dalam antrean jika sudah ada pekerjaan pemuatan yang berjalan.

    Parameter dependencies membuat eksekusi permintaan pemuatan dapat berubah pada penyelesaian satu pekerjaa pemuatan atau lebih yang berhasil yang telah ditempatkan dalam antrean.

  3. Neptune loader mengembalikan pekerjaan id yang memungkinkan Anda untuk memeriksa status atau membatalkan proses pemuatan; misalnya:

    {
    "status" : "200 OK",
    "payload" : {
        "loadId" : "ef478d76-d9da-4d94-8ff1-08d9d4863aa5"
    }
}

  4. Masukkan hal berikut ini untuk mendapatkan status pemuatan dengan loadId dari Langkah 3:

    curl -G 'https://your-neptune-endpoint:port/loader/ef478d76-d9da-4d94-8ff1-08d9d4863aa5'

    Jika status pemuatan mencantumkan kesalahan, Anda dapat meminta status yang lebih rinci dan daftar kesalahan. Untuk informasi selengkapnya dan contoh tambahan, lihat Neptunus Loader API Get-Status .

  5. (Opsional) Membatalkan pekerjaan Load.

    Masukkan hal berikut untuk Delete pekerjaan loader dengan pekerjaan id dari Langkah 3:

    curl -X DELETE 'https://your-neptune-endpoint:port/loader/ef478d76-d9da-4d94-8ff1-08d9d4863aa5'

    Perintah DELETE mengembalikan kode HTTP 200 OK setelah pembatalan berhasil.

    Data dari file dari pekerjaan pemuatan yang telah selesai melakukan pemuatan tidak di-rollback. Data tetap ada dalam instans DB Neptune.

Di halaman ini

PrivasiSyarat situsPreferensi cookie
© 2025, Amazon Web Services, Inc. atau afiliasinya. Semua hak dilindungi undang-undang.