Menggunakan layanan Neptunus-Ekspor untuk mengekspor data Neptunus - Amazon Neptune

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

Menggunakan layanan Neptunus-Ekspor untuk mengekspor data Neptunus

Anda dapat menggunakan langkah-langkah berikut untuk mengekspor data dari klaster DB Neptune Anda ke Amazon S3 menggunakan layanan Neptune-Ekspor:

Menginstal layanan Neptunus-Ekspor

Gunakan templat AWS CloudFormation untuk membuat tumpukan.

Menginstal layanan Neptune-Ekspor
  1. Meluncurkan tumpukan AWS CloudFormation pada konsol AWS CloudFormation dengan memilih salah satu tombol Luncurkan Tumpukan dalam tabel berikut:

    wilayah Lihat Lihat di Designer Luncurkan
    US East (N. Virginia) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    AS Timur (Ohio) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    US West (N. California) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    US West (Oregon) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Kanada (Pusat) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Amerika Selatan (Sao Paulo) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Europe (Stockholm) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Eropa (Irlandia) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Eropa (London) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Europe (Paris) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Eropa (Frankfurt) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Timur Tengah (Bahrain) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Middle East (UAE) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Israel (Tel Aviv) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Afrika (Cape Town) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Asia Pasifik (Hong Kong) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Asia Pacific (Tokyo) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Asia Pasifik (Seoul) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Asia Pacific (Singapore) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Asia Pacific (Sydney) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Asia Pasifik (Mumbai) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Tiongkok (Beijing) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    Tiongkok (Ningxia) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    AWS GovCloud (AS-Barat) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
    AWS GovCloud (AS-Timur) Lihat Lihat di Desainer Orange button labeled "Launch Stack" with an arrow icon.
  2. Pada halaman Pilih Templat, pilih Selanjutnya.

  3. Pada halamanTentukan Detail, template, mengatur parameter berikut:

    • VPC   –   Cara termudah untuk mengatur layanan Neptune-Ekspor adalah dengan menginstalnya di Amazon VPC yang sama dengan database Neptune Anda. Jika Anda ingin menginstalnya di VPC terpisah Anda bisa gunakanPeering VPC untuk membangun konektivitas antara VPC klaster DB Neptune dan VPC layanan Neptune-Ekspor.

    • Subnet1   –   Layanan Neptune-Ekspor harus diinstal di subnet di VPC Anda yang menizinkan lalu lintas IPv4 HTTPS keluar dari subnet ke internet. Hal ini agar layanan Neptune-Ekspor dapat menghubungi AWS Batch API untuk membuat dan menjalankan pekerjaan ekspor.

      Jika Anda membuat cluster Neptunus menggunakan CloudFormation template pada Membuat klaster DB halaman dalam dokumentasi Neptunus, Anda dapat menggunakan PrivateSubnet2 dan output dari tumpukan PrivateSubnet1 itu untuk mengisi parameter ini dan parameter berikutnya.

    • Subnet2   –   Subnet ke dua di VPC yang mengizinkan lalu lintas HTTPS IPv4 keluar dari subnet ke internet.

    • EnableIAM   –   Atur ini ke true untuk mengamankan API Neptune-Titik akhir menggunakan (IAM) AWS Identity and Access Management. Kami sarankan Anda melakukan juga.

      Jika Anda mengaktifkan autentikasi IAM, Anda harus Sigv4 menandatangani semua permintaan HTTPS ke titik akhir. Anda dapat menggunakan alat seperti awscurl untuk menandatangani permintaan atas nama Anda.

    • VPCOnly   –   Mengatur ini ke true menyebabkan ekspor titik akhir VPC-saja, sehingga Anda hanya dapat mengaksesnya dari dalam VPC tempat layanan Neptune-ekspor diinstal. Ini membatasi API Neptune-Ekspor untuk digunakan hanya dari dalam VPC itu.

      Kami sarankan Anda mengatur VPCOnly ke true.

    • NumOfFilesULimit — Tentukan nilai antara 10.000 dan 1.000.000 untuk nofile di properti ulimits kontainer. Defaultnya adalah 10.000, dan kami sarankan untuk menjaga default kecuali grafik Anda berisi sejumlah besar label unik.

    • PrivateDnsEnabled (Boolean) - Menunjukkan apakah akan mengaitkan zona host pribadi dengan VPC yang ditentukan atau tidak. Nilai bawaannya adalah true.

      Saat titik akhir VPC dibuat dengan flag ini diaktifkan, semua lalu lintas API Gateway dirutekan melalui titik akhir VPC, dan panggilan titik akhir API Gateway publik menjadi dinonaktifkan. Jika disetel PrivateDnsEnabled kefalse, titik akhir API Gateway publik diaktifkan, tetapi layanan ekspor Neptunus tidak dapat dihubungkan melalui titik akhir DNS pribadi. Anda kemudian dapat menggunakan titik akhir DNS publik untuk titik akhir VPC untuk memanggil layanan ekspor, seperti yang dijelaskan di sini.

  4. Pilih Selanjutnya.

  5. Pada halaman Opsi, pilih Selanjutnya.

  6. Pada halaman Review, pilih kotak centang pertama untuk mengetahui bahwa AWS CloudFormation akan membuat sumber daya IAM. Pilih kotak centang kedua untuk mengetahui CAPABILITY_AUTO_EXPAND untuk tumpukan baru.

    catatan

    CAPABILITY_AUTO_EXPAND secara eksplisit mengakui bahwa macro akan diperluas saat membuat tumpukan, tanpa review sebelumnya. Pengguna sering kali membuat perubahan yang ditetapkan dari templat yang diproses, sehingga perubahan yang dibuat oleh makro bisa direview tepat sebelum membuat tumpukan. Untuk informasi selengkapnya, lihat AWS CloudFormation CreateStackAPI.

    Lalu pilih Buat.

Aktifkan akses ke Neptune dari Neptune-Ekspor

Setelah instalasi Neptune-Ekspor selesai, perbarui Grup keamanan VPC Neptune Anda untuk mengizinkan akses dari Neptune-Ekspor. Saat Neptune-Ekspor tumpukan AWS CloudFormation telah dibuat, tab Output termasuk ID NeptuneExportSecurityGroup. Perbarui grup keamanan Neptune VPC Anda untuk mengizinkan akses dari grup keamanan Neptune-Ekspor ini.

Mengaktifkan akses ke titik akhir Neptune-Ekspor dari instans VPC-based EC2

Jika Anda membuat titik akhir Neptune-Ekspor VPC saja, Anda hanya dapat mengaksesnya dari dalam VPC tempat layanan Neptune-Ekspor diinstal. Untuk memungkinkan konektivitas dari instans Amazon EC2 di VPC di tempat Anda dapat membuat panggilan API Neptune-Ekspor, lampirkan NeptuneExportSecurityGroupyang dibuat oleh tumpukan AWS CloudFormation ke instans Amazon EC2 itu.

Jalankan tugas Neptune-Ekspor menggunakan API Neptune-Ekspor

Tab Output dari tumpukan AWS CloudFormation juga mencakup NeptuneExportApiUri. Gunakan URI ini setiap kali Anda mengirim permintaan ke titik akhir Neptune-Ekspor.

Menjalankan tugas ekspor
  • Pastikan bahwa pengguna atau peran di mana ekspor berjalan telah diberikan Izin execute-api:Invoke.

  • Jika Anda mengatur parameter EnableIAM ke true di tumpukan AWS CloudFormation ketika Anda menginstal Neptune-Ekspor, Anda harus Sigv4 tandatangani semua permintaan ke API Neptune-Ekspor. Kami menyarankan penggunaan awscurl untuk membuat permintaan ke API. Semua contoh di sini menganggap bahwa otentikasi IAM diaktifkan.

  • Jika Anda mengatur parameter VPCOnly ke truedi tumpukan AWS CloudFormation ketika Anda menginstal Neptune-Ekspor, Anda harus memanggil API Neptune-Ekspor dari dalam VPC, biasanya dari instans Amazon EC2 yang terletak di VPC.

Untuk mulai mengekspor data, kirim permintaan ke NeptuneExportApiUri titik akhir dengan parameter outputS3Path permintaan command dan parameter endpoint ekspor.

Berikut ini adalah contoh permintaan yang mengekspor data grafik properti dari Neptunus dan menerbitkannya ke Amazon S3:

curl \ (your NeptuneExportApiUri) \ -X POST \ -H 'Content-Type: application/json' \ -d '{ "command": "export-pg", "outputS3Path": "s3://(your Amazon S3 bucket)/neptune-export", "params": { "endpoint": "(your Neptune endpoint DNS name)" } }'

Demikian pula, berikut adalah contoh permintaan yang mengekspor data RDF dari Neptunus ke Amazon S3:

curl \ (your NeptuneExportApiUri) \ -X POST \ -H 'Content-Type: application/json' \ -d '{ "command": "export-rdf", "outputS3Path": "s3://(your Amazon S3 bucket)/neptune-export", "params": { "endpoint": "(your Neptune endpoint DNS name)" } }'

Jika Anda menghilangkan parameter command permintaan, secara default Neptunus-Ekspor mencoba mengekspor data grafik properti dari Neptunus.

Jika perintah sebelumnya berhasil, output akan terlihat seperti ini:

{ "jobName": "neptune-export-abc12345-1589808577790", "jobId": "c86258f7-a9c9-4f8c-8f4c-bbfe76d51c8f" }

Pantau tugas ekspor yang baru saja Anda mulai

Untuk memantau tugas yang sedang berjalan, tambahkan JobID ke NeptuneExportApiUri Anda, sesuatu seperti ini:

curl \ (your NeptuneExportApiUri)(the job ID)

Jika layanan belum memulai tugas ekspor, responnya akan terlihat seperti ini:

{ "jobId": "c86258f7-a9c9-4f8c-8f4c-bbfe76d51c8f", "status": "pending" }

Ketika Anda mengulangi perintah setelah tugas ekspor dimulai, responnya akan terlihat seperti ini:

{ "jobId": "c86258f7-a9c9-4f8c-8f4c-bbfe76d51c8f", "status": "running", "logs": "https://us-east-1.console.aws.amazon.com/cloudwatch/home?..." }

Jika Anda membuka CloudWatch log di Log menggunakan URI yang disediakan oleh panggilan status, Anda kemudian dapat memantau kemajuan ekspor secara detail:

Screenshot dari tampilan CloudWatch Log.

Membatalkan pekerjaan ekspor yang sedang berjalan

Untuk membatalkan pekerjaan ekspor yang sedang berjalan menggunakan AWS Management Console
  1. Buka konsol AWS Batch di https://console.aws.amazon.com/batch/.

  2. Pilih Pekerjaan.

  3. Temukan pekerjaan yang sedang berjalan yang ingin Anda batalkan, berdasarkan tugasnyajobID.

  4. Pilih Batalkan pekerjaan.

Untuk membatalkan pekerjaan ekspor yang sedang berjalan menggunakan API ekspor Neptunus:

Kirim HTTP DELETE permintaan ke NeptuneExportApiUri dengan yang jobID ditambahkan, seperti ini:

curl -X DELETE \ (your NeptuneExportApiUri) (the job ID)