Menggunakan sihir workbench Neptune dalam notebook Anda

Workbench Neptune menyediakan sejumlah perintah yang disebut magic dalam notebook yang menghemat banyak waktu dan usaha. Perintah tersebut dibagi menjadi dua kategori: line magic dan cell magic.

Line magic adalah perintah yang didahului oleh tanda persen tunggal (%). Perintah ini hanya mengambil input baris, bukan input dari seluruh tubuh sel. Workbench Neptune menyediakan line magic berikut:

• %seed

• %load

• %load_ids

• %load_status

• %cancel_load

• %status

• %gremlin_status

• %opencypher_status, atau %oc_status

• %stream_viewer

• %sparql_status

• %graph_notebook_config

• %graph_notebook_host

• %graph_notebook_version

• %graph_notebook_vis_options

• %statistik

• %ringkasan

Cell magic didahului oleh dua tanda persen (%%) alih-alih satu, dan menggunakan konten sel sebagai input, meskipun perintah ini juga dapat mengambil konten baris sebagai input. Workbench Neptune menyediakan cell magic berikut:

• %%sparql

• %%gremlin

• %%opencypher, atau %%oc

• %%graph_notebook_config

• %%graph_notebook_vis_options

Terdapat juga dua magic, line magic dan cell magic, untuk bekerja dengan Machine learning Neptune:

• %neptune_ml

• %%neptune_ml

catatan

Saat bekerja dengan sihir Neptunus, Anda biasanya bisa mendapatkan teks bantuan menggunakan parameter atau. --help -h Dengan sihir sel, tubuh tidak bisa kosong, jadi ketika mendapatkan bantuan, masukkan teks pengisi, bahkan satu karakter, ke dalam tubuh. Sebagai contoh:

%%gremlin --help
  x

Injeksi variabel dalam sihir sel atau garis

Variabel yang didefinisikan dalam buku catatan dapat direferensikan di dalam sihir sel atau baris apa pun di buku catatan menggunakan format:. ${VAR_NAME}

Misalnya, Anda mendefinisikan variabel-variabel ini:

c = 'code'
my_edge_labels = '{"route":"dist"}'

Kemudian, kueri Gremlin ini dalam sihir sel:

%%gremlin -de $my_edge_labels
g.V().has('${c}','SAF').out('route').values('${c}')

Setara dengan ini:

%%gremlin -de {"route":"dist"}
g.V().has('code','SAF').out('route').values('code')

Argumen kueri yang berfungsi dengan semua bahasa kueri

Argumen kueri berikut bekerja dengan%%gremlin,%%opencypher, dan %%sparql sihir di meja kerja Neptunus:

Argumen kueri umum

• --store-to(atau -s) - Menentukan nama variabel di mana untuk menyimpan hasil query.

• --silent— Jika ada, tidak ada output yang ditampilkan setelah kueri selesai.

• --group-by(atau -g) - Menentukan properti yang digunakan untuk kelompok node (seperti code atauT.region). Simpul diwarnai berdasarkan grup yang ditugaskan.

• --ignore-groups— Jika ada, semua opsi pengelompokan diabaikan.

• --display-property(atau -d) - Menentukan properti yang nilainya harus ditampilkan untuk setiap simpul.

  Nilai default untuk setiap bahasa query adalah sebagai berikut:

  • Untuk Gremlin:. T.label

  • Untuk OpenCypher:. ~labels

  • Untuk SPARQL:. type

• --edge-display-property(atau -t) - Menentukan properti yang nilainya harus ditampilkan untuk setiap tepi.

  Nilai default untuk setiap bahasa query adalah sebagai berikut:

  • Untuk Gremlin:. T.label

  • Untuk OpenCypher:. ~labels

  • Untuk SPARQL:. type

• --tooltip-property(or -de) - Menentukan properti yang nilainya harus ditampilkan sebagai tooltip untuk setiap node.

  Nilai default untuk setiap bahasa query adalah sebagai berikut:

  • Untuk Gremlin:. T.label

  • Untuk OpenCypher:. ~labels

  • Untuk SPARQL:. type

• --edge-tooltip-property(atau -te) - Menentukan properti yang nilainya harus ditampilkan sebagai tooltip untuk setiap tepi.

  Nilai default untuk setiap bahasa query adalah sebagai berikut:

  • Untuk Gremlin:. T.label

  • Untuk OpenCypher:. ~labels

  • Untuk SPARQL:. type

• --label-max-length (atau -l) - Menentukan panjang karakter maksimum dari setiap label vertex. Default ke 10.

• --edge-label-max-length (atau -le) - Menentukan panjang karakter maksimum dari setiap label tepi. Default ke 10.

  Dalam kasus OpenCypher saja, ini adalah --rel-label-max-length atau sebaliknya. -rel

• --simulation-duration(atau -sd) — Menentukan durasi maksimum simulasi fisika visualisasi. Default ke 1500 ms.

• --stop-physics(atau -sp) — Menonaktifkan fisika visualisasi setelah simulasi awal stabil.

Nilai properti untuk argumen ini dapat terdiri dari kunci properti tunggal, atau string JSON yang dapat menentukan properti yang berbeda untuk setiap jenis label. Sebuah string JSON hanya dapat ditentukan menggunakan injeksi variabel.

Line magic %seed

Sihir %seed garis adalah cara mudah untuk menambahkan data ke titik akhir Neptunus Anda yang dapat Anda gunakan untuk menjelajahi dan bereksperimen dengan kueri Gremlin, OpenCypher, atau SPARQL. Ini menyediakan formulir di mana Anda dapat memilih model data yang ingin Anda jelajahi (grafik properti atau RDF) dan kemudian memilih di antara sejumlah kumpulan data sampel berbeda yang disediakan Neptunus.

Line magic %load

Line magic %load menghasilkan formulir yang dapat Anda gunakan untuk mengirimkan permintaan pemuatan massal ke Neptune (lihat Perintah Loader Neptune). Sumbernya harus berupa jalur Amazon S3 di wilayah yang sama dengan klaster Neptune.

Line magic %load_ids

Line magic %load_ids mengambil Id pemuatan yang telah dikirimkan ke titik akhir host notebook (lihat Parameter permintaan Get-Status Loader Neptune). Permintaan tersebut mengambil bentuk ini:

GET https://your-neptune-endpoint:port/loader

Line magic %load_status

Line magic %load_status mengambil status pemuatan pekerjaan pemuatan tertentu yang telah dikirimkan ke titik akhir host notebook, ditentukan oleh input baris (lihat Parameter permintaan Get-Status Loader Neptune). Permintaan tersebut mengambil bentuk ini:

GET https://your-neptune-endpoint:port/loader?loadId=loadId

Line magic terlihat seperti ini:

%load_status load id

Line magic %cancel_load

Line magic %cancel_load membatalkan pekerjaan pemuatan tertentu (lihat Pembatalan Pekerjaan Neptune Loader ). Permintaan tersebut mengambil bentuk ini:

DELETE https://your-neptune-endpoint:port/loader?loadId=loadId

Line magic terlihat seperti ini:

%cancel_load load id

Line magic %status

Mengambil informasi status dari titik akhir host notebook (%graph_notebook_config menunjukkan titik akhir host).

Line magic %gremlin_status

Mengambil informasi status kueri Gremlin.

Sihir %opencypher_status garis (juga%oc_status)

Mengambil status kueri untuk kueri opencypher. Sihir baris ini mengambil argumen opsional berikut:

• --queryIdor -q- Menentukan ID dari query berjalan tertentu untuk menampilkan status.

• --cancel_queryatau -c— Membatalkan kueri yang sedang berjalan. Tidak mengambil nilai.

• --silentatau -s— Jika --silent disetel ke true saat membatalkan kueri, kueri yang sedang berjalan dibatalkan dengan kode respons HTTP dari. 200 Jika tidak, kode respons HTTP akan menjadi500.

• --store-to- Menentukan nama variabel di mana untuk menyimpan hasil query.

Line magic %sparql_status

Mengambil informasi status kueri SPARQL.

Line magic %stream_viewer

Sihir %stream_viewer garis menampilkan antarmuka yang memungkinkan untuk menjelajahi entri yang dicatat secara interaktif di aliran Neptunus, jika aliran diaktifkan di cluster Neptunus. Ia menerima argumen opsional berikut:

• language— Bahasa kueri dari data aliran: salah satu gremlin atausparql. Defaultnya, jika Anda tidak memberikan argumen ini, adalahgremlin.

• --limit- Menentukan jumlah maksimum entri aliran untuk ditampilkan per halaman. Nilai default, jika Anda tidak memberikan argumen ini, adalah10.

catatan

Sihir %stream_viewer garis sepenuhnya didukung hanya pada versi mesin 1.0.5.1 dan sebelumnya.

Line magic %graph_notebook_config

Line magic ini menampilkan objek JSON yang berisi konfigurasi yang notebook gunakan untuk berkomunikasi dengan Neptune. Konfigurasi ini meliputi:

• host: Titik akhir yang menghubungkan dan mengeluarkan perintah.

• port: Port yang digunakan saat mengeluarkan perintah ke Neptune. Nilai default-nya 8182.

• auth_mode: Mode autentikasi yang digunakan saat mengeluarkan perintah ke Neptune. Harus IAM jika menghubungkan ke cluster yang memiliki otentikasi IAM diaktifkan, atau sebaliknya. DEFAULT

• load_from_s3_arn: Menentukan ARN Amazon S3 untuk digunakan magic %load. Jika nilai ini kosong, ARN harus ditentukan dalam perintah %load.

• ssl: Nilai Boolean yang menunjukkan apakah terhubung atau tidak ke Neptune menggunakan TLS. Nilai default-nya adalah true.

• aws_region: Wilayah tempat notebook ini di-deploy. Informasi ini digunakan untuk autentikasi IAM dan untuk permintaan %load.

Anda dapat mengubah konfigurasi ini dengan menyalin output %graph_notebook_config ke sel baru dan membuat perubahan di sana. Kemudian jika Anda menjalankan cell magic %%graph_notebook_config pada sel baru, konfigurasi akan berubah sewajarnya.

Line magic %graph_notebook_host

Menetapkan input baris sebagai host notebook.

Line magic %graph_notebook_version

Line magic %graph_notebook_version mengembalikan nomor rilis notebook workbench Neptune. Sebagai contoh, visualisasi grafik diperkenalkan dalam versi 1.27.

Line magic %graph_notebook_vis_options

Line magic %graph_notebook_vis_options menampilkan pengaturan visualisasi saat ini yang digunakan notebook. Opsi ini dijelaskan dalam dokumentasi vis.js.

Anda dapat mengubah pengaturan ini dengan menyalin output ke sel baru, membuat perubahan yang Anda inginkan, dan kemudian menjalankan cell magic %%graph_notebook_vis_options di sel tersebut.

Untuk memulihkan pengaturan visualisasi ke nilai defaultnya, Anda dapat menjalankan line magic %graph_notebook_vis_options dengan parameter reset. Ini mengatur ulang semua pengaturan visualisasi:

%graph_notebook_vis_options reset

Line magic %statistics

Sihir %statistics garis digunakan untuk mengambil atau mengelola statistik mesin DFE (lihatMengelola statistik untuk Neptune DFE yang akan digunakan). Sihir ini juga dapat digunakan untuk mengambil ringkasan grafik.

Ini menerima parameter berikut:

• --language— Bahasa kueri dari titik akhir statistik: baik atau propertygraph (ataupg) ataurdf.

  Jika tidak disediakan, defaultnya adalahpropertygraph.

• --mode(atau -m) - Menentukan jenis permintaan atau tindakan untuk mengirimkan: salah satu daristatus,,disableAutoCompute,enableAutoCompute,refresh, deletedetailed, ataubasic).

  Jika tidak disediakan, defaultnya --summary adalah status kecuali ditentukan, dalam hal ini defaultnyabasic.

• --summary— Mengambil ringkasan grafik dari titik akhir ringkasan statistik dari bahasa yang dipilih.

• --silent— Jika ada, tidak ada output yang ditampilkan setelah kueri selesai.

• --store-to— Digunakan untuk menentukan variabel untuk menyimpan hasil query.

Line magic %summary

Sihir %summary garis digunakan untuk mengambil informasi ringkasan grafik. Ini tersedia mulai dengan versi mesin Neptunus. 1.2.1.0

Ini menerima parameter berikut:

• --language— Bahasa kueri dari titik akhir statistik: baik atau propertygraph (ataupg) ataurdf.

  Jika tidak disediakan, defaultnya adalahpropertygraph.

• --detailed— Mengaktifkan atau menonaktifkan tampilan bidang struktur dalam output.

  Jika tidak disediakan, defaultnya adalah mode tampilan basic ringkasan.

• --silent— Jika ada, tidak ada output yang ditampilkan setelah kueri selesai.

• --store-to— Digunakan untuk menentukan variabel untuk menyimpan hasil query.

Cell magic %%graph_notebook_config

Cell magic %%graph_notebook_config menggunakan objek JSON yang berisi informasi konfigurasi untuk memodifikasi pengaturan yang notebook gunakan untuk berkomunikasi dengan Neptune, jika memungkinkan. Konfigurasi ini mengambil bentuk yang sama yang dikembalikan oleh line magic %graph_notebook_config.

Sebagai contoh:

%%graph_notebook_config
{
  "host": "my-new-cluster-endpoint.amazon.com",
  "port": 8182,
  "auth_mode": "DEFAULT",
  "load_from_s3_arn": "",
  "ssl": true,
  "aws_region": "us-east-1"
}

Cell magic %%sparql

Cell magic %%sparql mengeluarkan kueri SPARQL ke titik akhir Neptune. Perintah ini menerima input baris opsional berikut:

• -h atau --help — Mengembalikan teks bantuan tentang parameter ini.

• --path — Memberi prefiks pada jalur ke titik akhir SPARQL. Misalnya, jika Anda menentukan --path "abc/def" maka titik akhir yang dipanggil yaitu host:port/abc/def.

• --expand-all — Ini adalah petunjuk visualisasi kueri yang memberi tahu visualizer untuk menyertakan semua hasil ?s ?p ?o dalam diagram grafik terlepas dari jenis mengikatnya.

  Secara default, visualisasi SPARQL hanya mencakup pola triple saat o? adalah uri atau bnode (node kosong). Semua jenis mengikat ?o lainnya seperti string literal atau bilangan bulat diperlakukan sebagai properti dari node ?s yang dapat dilihat menggunakan panel Detail di tab Grafik.

  Gunakan petunjuk kueri --expand-all ketika Anda mungkin ingin memasukkan nilai-nilai literal seperti vertex dalam visualisasi sebagai gantinya.

  Jangan gabungkan petunjuk visualisasi ini dengan parameter explain, karena kueri explain tidak divisualisasikan.

• --explain-type — Digunakan untuk menentukan mode explain yang akan digunakan (salah satu dari: dynamic, static, atau details).

• --explain-format — Digunakan untuk menentukan format respons untuk kueri explain (salah satu dari text/csv atau text/html).

• --store-to — Digunakan untuk menentukan variabel yang akan menyimpan hasil kueri.

Contoh kueri explain:

%%sparql explain

SELECT * WHERE {?s ?p ?o} LIMIT 10

Contoh kueri visualisasi dengan parameter petunjuk visualisasi --expand-all (lihat Visualisasi SPARQL):

%%sparql --expand-all

SELECT * WHERE {?s ?p ?o} LIMIT 10

Cell magic %%gremlin

Sihir %%gremlin sel mengeluarkan kueri Gremlin ke titik akhir Neptunus menggunakan. WebSocket Perintah ini menerima input baris opsional untuk beralih ke mode /> explain Gremlin atau API profile Gremlin, dan input petunjuk visualisasi opsional terpisah untuk mengubah perilaku output visualisasi (lihat Visualisasi Gremlin).

Contoh kueri explain:

%%gremlin explain

g.V().limit(10)

Contoh kueri profile:

%%gremlin profile

g.V().limit(10)

Contoh kueri visualisasi dengan petunjuk kueri visualisasi:

%%gremlin -p v,outv

g.V().out().limit(10)

Parameter opsional untuk %%gremlin profile kueri

• --chop- Menentukan panjang maksimum string hasil profil. Nilai default jika Anda tidak memberikan argumen ini adalah 250.

• --serializer- Menentukan serializer untuk digunakan untuk hasil. Nilai yang diizinkan adalah salah satu nilai enum tipe MIME atau TinkerPop driver “Serializers” yang valid. Nilai default jika Anda tidak memberikan argumen ini adalahapplication.json.

• --no-results— Hanya menampilkan jumlah hasil. Jika tidak digunakan, semua hasil kueri ditampilkan dalam laporan profil secara default.

• --indexOps— Menampilkan laporan rinci dari semua operasi indeks.

Sihir %%opencypher sel (juga%%oc)

Sihir %%opencypher sel (yang juga memiliki %%oc bentuk disingkat), mengeluarkan kueri OpenCypher ke titik akhir Neptunus. Ia menerima argumen input baris opsional berikut:

• mode — Mode kueri: salah satu query ataubolt. Nilai default jika Anda tidak memberikan argumen ini adalahquery.

• --group-byor -g- Menentukan properti yang digunakan untuk kelompok node. Misalnya, code, ~id. Nilai default jika Anda tidak memberikan argumen ini adalah~labels.

• --ignore-groups— Jika ada, semua opsi pengelompokan diabaikan.

• --display-properyor -d- Menentukan properti yang nilainya harus ditampilkan untuk setiap simpul. Nilai default jika Anda tidak memberikan argumen ini adalah~labels.

• --edge-display-properyatau -de- Menentukan properti yang nilainya harus ditampilkan untuk setiap tepi. Nilai default jika Anda tidak memberikan argumen ini adalah~labels.

• --label-max-lengthor -l- Menentukan jumlah maksimum karakter dari label simpul untuk ditampilkan. Nilai default jika Anda tidak memberikan argumen ini adalah10.

• --store-toatau -s- Menentukan nama variabel di mana untuk menyimpan hasil query.

• --plan-cacheatau -pc- Menentukan modus rencana cache untuk digunakan. Nilai defaultnya adalahauto. (*plan-cache hanya tersedia untuk Neptunus Analytics)

• --query-timeoutatau -qt- Menentukan batas waktu kueri maksimum dalam milidetik. Nilai default-nya adalah 1800000.

• --query-parametersatau qp— Definisi parameter untuk diterapkan pada kueri. Opsi ini dapat menerima nama variabel tunggal, atau representasi string dari peta.

  Contoh penggunaan --query-parameters

  1. Tentukan peta parameter OpenCypher dalam satu sel notebook.

     params = '''{
      "name":"john",
      "age": 20,
     }'''

  2. Masukkan parameter ke --query-parameters dalam sel lain dengan%%oc.

     %%oc --query-parameters params
     
     MATCH (n {name: $name, age: $age}) 
     RETURN n

• --explain-type - Digunakan untuk menentukan mode jelaskan yang akan digunakan (salah satu dari: dinamis, statis, atau detail).

Cell magic %%graph_notebook_vis_options

Cell magic %%graph_notebook_vis_options memungkinkan Anda mengatur opsi visualisasi untuk notebook. Anda dapat menyalin pengaturan yang dikembalikan oleh line magic %graph-notebook-vis-options ke dalam sel baru, membuat perubahan pada sel tersebut, dan menggunakan cell magic %%graph_notebook_vis_options untuk menetapkan nilai baru.

Opsi ini dijelaskan dalam dokumentasi vis.js.

Untuk memulihkan pengaturan visualisasi ke nilai defaultnya, Anda dapat menjalankan line magic %graph_notebook_vis_options dengan parameter reset. Ini mengatur ulang semua pengaturan visualisasi:

%graph_notebook_vis_options reset

Line magic %neptune_ml

Anda dapat menggunakan line magic %neptune_ml untuk menginisiasi dan mengelola berbagai operasi Neptune ML.

catatan

Anda juga dapat menggunakan cell magic %%neptune_ml untuk menginisiasi dan mengelola beberapa operasi Neptune ML.

• %neptune_ml export start — Memulai pekerjaan ekspor baru.

  Parameter

  • --export-url exporter-endpoint — (opsional) Titik akhir Amazon API Gateway tempat exporter bisa dipanggil.

  • --export-iam — (opsional) Bendera yang menunjukkan bahwa permintaan ke url ekspor harus ditandatangani menggunakan SIGv4.

  • --export-no-ssl — (opsional) Bendera yang menunjukkan bahwa SSL tidak boleh digunakan saat menghubungkan ke exporter.

  • --wait — (opsional) Bendera yang menunjukkan bahwa operasi harus menunggu sampai ekspor selesai.

  • --wait-intervalinterval-to-wait— (opsional) Mengatur waktu, dalam detik, antara pemeriksaan status ekspor (Default: 60).

  • --wait-timeout timeout-seconds — (opsional) Mengatur waktu, dalam detik, untuk menunggu pekerjaan ekspor selesai sebelum mengembalikan status terbaru (Default: 3.600).

  • --store-tolocation-to-store-result— (opsional) Variabel di mana untuk menyimpan hasil ekspor. Jika --wait ditentukan, status akhir akan disimpan di sana.

• %neptune_ml export status — Mengambil status pekerjaan ekspor.

  Parameter

  • --job-id ID tugas ekspor— ID dari tugas ekspor yang akan diambil statusnya.

  • --export-url exporter-endpoint — (opsional) Titik akhir Amazon API Gateway tempat exporter bisa dipanggil.

  • --export-iam — (opsional) Bendera yang menunjukkan bahwa permintaan ke url ekspor harus ditandatangani menggunakan SIGv4.

  • --export-no-ssl — (opsional) Bendera yang menunjukkan bahwa SSL tidak boleh digunakan saat menghubungkan ke exporter.

  • --wait — (opsional) Bendera yang menunjukkan bahwa operasi harus menunggu sampai ekspor selesai.

  • --wait-intervalinterval-to-wait— (opsional) Mengatur waktu, dalam detik, antara pemeriksaan status ekspor (Default: 60).

  • --wait-timeout timeout-seconds — (opsional) Mengatur waktu, dalam detik, untuk menunggu pekerjaan ekspor selesai sebelum mengembalikan status terbaru (Default: 3.600).

  • --store-tolocation-to-store-result— (opsional) Variabel di mana untuk menyimpan hasil ekspor. Jika --wait ditentukan, status akhir akan disimpan di sana.

• %neptune_ml dataprocessing start — Memulai langkah pemrosesan data Neptune ML.

  Parameter

  • --job-id ID untuk tugas ini — (opsional) ID yang akan ditetapkan ke tugas ini.

  • --s3-input-uri URI S3 — (opsional) URI S3 tempat menemukan input untuk tugas pemrosesan data ini.

  • --config-file-name Nama file — (opsional) Nama file konfigurasi untuk tugas pemrosesan data ini.

  • --store-tolocation-to-store-result— (opsional) Variabel di mana untuk menyimpan hasil pemrosesan data.

  • --instance-type(tipe instance) — (opsional) Ukuran instance yang akan digunakan untuk pekerjaan pemrosesan data ini.

  • --wait — (opsional) Bendera yang menunjukkan bahwa operasi harus menunggu sampai pemrosesan data selesai.

  • --wait-intervalinterval-to-wait— (opsional) Mengatur waktu, dalam detik, antara pemeriksaan status pemrosesan data (Default: 60).

  • --wait-timeout timeout-seconds — (opsional) Menetapkan waktu, dalam detik, untuk menunggu tugas pemrosesan data selesai sebelum mengembalikan status terbaru (Default: 3.600).

• %neptune_ml dataprocessing status — Mengambil status tugas pemrosesan data.

  Parameter

  • --job-id ID tugas — ID dari tugas yang akan diambil statusnya.

  • --store-to tipe instans— (opsional) Variabel untuk menyimpan hasil pelatihan model.

  • --wait — (opsional) Bendera yang menunjukkan bahwa operasi harus menunggu sampai pelatihan model selesai.

  • --wait-intervalinterval-to-wait— (opsional) Mengatur waktu, dalam detik, antara pemeriksaan status pelatihan model (Default: 60).

  • --wait-timeout timeout-seconds — (opsional) Menetapkan waktu, dalam detik, untuk menunggu tugas pemrosesan data selesai sebelum mengembalikan status terbaru (Default: 3.600).

• %neptune_ml training start — Memulai proses pelatihan model Neptune ML.

  Parameter

  • --job-id ID untuk tugas ini — (opsional) ID yang akan ditetapkan ke tugas ini.

  • --data-processing-id ID tugas pemrosesan data— (opsional) ID dari tugas pemrosesan data yang menciptakan artefak untuk digunakan untuk pelatihan.

  • --s3-output-uri URI S3 — (opsional) URI S3 tempat menyimpan output dari tugas pelatihan model ini.

  • --instance-type(tipe instance) — (opsional) Ukuran instans yang akan digunakan untuk pekerjaan pelatihan model ini.

  • --store-tolocation-to-store-result— (opsional) Variabel untuk menyimpan hasil model-pelatihan.

  • --wait — (opsional) Bendera yang menunjukkan bahwa operasi harus menunggu sampai pelatihan model selesai.

  • --wait-intervalinterval-to-wait— (opsional) Mengatur waktu, dalam detik, antara pemeriksaan status pelatihan model (Default: 60).

  • --wait-timeout timeout-seconds — (opsional) Mengatur waktu, dalam detik, untuk menunggu tugas pelatihan model selesai sebelum mengembalikan status terbaru (Default: 3.600).

• %neptune_ml training status — Mengambil status tugas pelatihan model Neptune ML.

  Parameter

  • --job-id ID tugas — ID dari tugas yang akan diambil statusnya.

  • --store-to tipe instans— (opsional) Variabel untuk menyimpan hasil status.

  • --wait — (opsional) Bendera yang menunjukkan bahwa operasi harus menunggu sampai pelatihan model selesai.

  • --wait-intervalinterval-to-wait— (opsional) Mengatur waktu, dalam detik, antara pemeriksaan status pelatihan model (Default: 60).

  • --wait-timeout timeout-seconds — (opsional) Menetapkan waktu, dalam detik, untuk menunggu tugas pemrosesan data selesai sebelum mengembalikan status terbaru (Default: 3.600).

• %neptune_ml endpoint create — Menciptakan titik akhir kueri untuk model Neptune ML.

  Parameter

  • --job-id ID untuk tugas ini — (opsional) ID yang akan ditetapkan ke tugas ini.

  • --model-job-id ID tugas pelatihan model — (opsional) ID tugas pelatihan model yang digunakan untuk membuat titik akhir kueri.

  • --instance-type(tipe instance) — (opsional) Ukuran instance yang akan digunakan untuk titik akhir kueri..

  • --store-tolocation-to-store-result— (opsional) Variabel di mana untuk menyimpan hasil pembuatan endpoint.

  • --wait — (opsional) Bendera yang menunjukkan bahwa operasi harus menunggu sampai pembuatan titik akhir selesai.

  • --wait-intervalinterval-to-wait— (opsional) Mengatur waktu, dalam detik, antara pemeriksaan status (Default: 60).

  • --wait-timeout timeout-seconds — (opsional) Mengatur waktu, dalam detik, untuk menunggu pekerjaan pembuatan titik akhir selesai sebelum mengembalikan status terbaru (Default: 3.600).

• %neptune_ml endpoint status — Mengambil status dari titik akhir kueri Neptune ML.

  Parameter

  • --job-id ID pembuatan titik akhir — (opsional) ID dari tugas pembuatan titik akhir yang digunakan untuk melaporkan status.

  • --store-tolocation-to-store-result— (opsional) Variabel di mana untuk menyimpan hasil status.

  • --wait — (opsional) Bendera yang menunjukkan bahwa operasi harus menunggu sampai pembuatan titik akhir selesai.

  • --wait-intervalinterval-to-wait— (opsional) Mengatur waktu, dalam detik, antara pemeriksaan status (Default: 60).

  • --wait-timeout timeout-seconds — (opsional) Mengatur waktu, dalam detik, untuk menunggu pekerjaan pembuatan titik akhir selesai sebelum mengembalikan status terbaru (Default: 3.600).

Cell magic %%neptune_ml

Cell magic %%neptune_ml mengabaikan input baris seperti --job-id atau --export-url. Sebaliknya, ini memungkinkan Anda memberikan input tersebut dan lainnya dalam tubuh sel.

Anda juga dapat menyimpan input tersebut di sel lain, ditugaskan ke variabel Jupyter, dan kemudian menyuntikkan mereka ke dalam tubuh sel menggunakan variabel itu. Dengan cara itu, Anda dapat menggunakan input tersebut berulang-ulang tanpa harus memasukkan kembali semua input tersebut setiap kalinya.

Ini hanya bekerja jika variabel suntik adalah satu-satunya konten dari sel. Anda tidak dapat menggunakan beberapa variabel dalam satu sel, atau kombinasi teks dan variabel.

Misalnya, cell magic %%neptune_ml export start dapat mengonsumsi dokumen JSON dalam tubuh sel yang berisi semua parameter yang dijelaskan dalam Parameter yang digunakan untuk mengontrol proses ekspor Neptune.

Di notebook Neptune-ML-01-Introduction-to-Node-Classification-Gremlin, di bawah Mengkonfigurasi Fitur di bagian Ekspor data dan konfigurasi model, Anda dapat melihat bagaimana sel berikut memegang parameter ekspor dalam dokumen yang ditugaskan untuk variabel Jupyter bernama export-params:

export_params = {
  "command": "export-pg",
  "params": {
    "endpoint": neptune_ml.get_host(),
    "profile": "neptune_ml",
    "useIamAuth": neptune_ml.get_iam(),
    "cloneCluster": False
   },
  "outputS3Path": f'{s3_bucket_uri}/neptune-export',
  "additionalParams": {
    "neptune_ml": {
      "targets": [
        {
          "node": "movie",
          "property": "genre"
        }
      ],
      "features": [
        {
          "node": "movie",
          "property": "title",
          "type": "word2vec"
        },
        {
          "node": "user",
          "property": "age",
          "type": "bucket_numerical",
          "range" : [1, 100],
          "num_buckets": 10
        }
      ]
    }
  },
  "jobSize": "medium"}

Ketika Anda menjalankan sel ini, Jupyter menyimpan dokumen parameter dengan nama itu. Kemudian, Anda dapat menggunakan ${export_params} untuk menyuntikkan dokumen JSON ke dalam tubuh %%neptune_ml export start cell, seperti ini:

%%neptune_ml export start --export-url {neptune_ml.get_export_service_host()} --export-iam --wait --store-to export_results

${export_params}

Bentuk-bentuk yang tersedia dari cell magic %%neptune_ml

Cell magic %%neptune_ml dapat digunakan dalam bentuk berikut:

• %%neptune_ml export start — Memulai proses ekspor Neptune ML.

• %%neptune_ml dataprocessing start — Memulai tugas pemrosesan data Neptune ML.

• %%neptune_ml training start — Memulai tugas pelatihan model Neptune ML.

• %%neptune_ml endpoint create — Menciptakan titik akhir kueri Neptune ML untuk sebuah model.