Menggunakan sihir di notebook Amazon Neptunus - Amazon Neptune

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

Menggunakan sihir di notebook Amazon Neptunus

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:

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:

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

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

    • UntukopenCypher:~labels.

    • UntukSPARQL: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

    • UntukopenCypher:~labels.

    • UntukSPARQL: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

    • UntukopenCypher:~labels.

    • UntukSPARQL: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

    • UntukopenCypher:~labels.

    • UntukSPARQL: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 -rel sebaliknya.

  • --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 JSON string yang dapat menentukan properti yang berbeda untuk setiap jenis label. Sebuah JSON string 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 openCypher Gremlin,, atau kueri. SPARQL Ini menyediakan formulir di mana Anda dapat memilih model data yang ingin Anda jelajahi (grafik properti atauRDF) 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 %reset_graph

Sihir baris %reset_graph (atau%_graph_reset) mengeksekusi ResetGraphpanggilan terhadap titik akhir Neptunus Analytics. Perintah ini menerima input baris opsional berikut:

  • -ns atau -- no-skip-snapshot - Jika ada, snapshot grafik akhir akan dibuat sebelum data grafik dihapus.

  • --silent — Jika ada, tidak ada output yang ditampilkan setelah panggilan reset dikirimkan.

  • --store-to — Digunakan untuk menentukan variabel untuk menyimpan respon. ResetGraph

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).

Untuk host Neptunus DB, informasi status akan diambil dari titik akhir status kesehatan. Untuk host Neptunus Analytics, status akan diambil melalui. GetGraph API Untuk informasi selengkapnya, lihat %get_graph.

Line magic %get_graph

Sihir %get_graph garis mengambil informasi tentang grafik melalui. GetGraph API Keajaiban ini secara fungsional identik dengan %status saat digunakan dengan Neptunus Analytics.

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.

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

  • --silent-cancelatau -s— Jika --silent disetel ke true saat membatalkan kueri, kueri yang sedang berjalan dibatalkan dengan kode HTTP respons. 200 Jika tidak, kode HTTP responsnya adalah500.

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

  • -w/--includeWaiting— Neptunus DB saja. Ketika disetel ke true dan parameter lainnya tidak ada, menyebabkan informasi status untuk permintaan menunggu dikembalikan serta untuk menjalankan kueri. Parameter ini tidak mengambil nilai.

  • --state— Neptunus Analytics saja. Menentukan apa subset dari status query untuk mengambil status.

  • -m/--maxResults— Neptunus Analytics saja. Menetapkan batas atas pada set query dikembalikan cocok dengan nilai. --state

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

Line magic %sparql_status

Mengambil informasi status SPARQL kueri.

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

Sihir baris ini menampilkan JSON objek yang berisi konfigurasi yang digunakan notebook untuk berkomunikasi dengan Neptunus. Konfigurasi ini meliputi:

  • host: Titik akhir yang menghubungkan dan mengeluarkan perintah.

  • port: Port yang digunakan saat mengeluarkan perintah ke Neptune. Default-nya adalah 8182.

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

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

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

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

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_service

Sihir %graph_notebook_service garis menetapkan input baris sebagai nama layanan yang digunakan untuk permintaan Neptunus.

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 DFE mesin (lihatMengelola statistik untuk DFE Neptunus untuk 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 satustatus,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

Sihir %%graph_notebook_config sel menggunakan JSON objek yang berisi informasi konfigurasi untuk memodifikasi pengaturan yang digunakan notebook untuk berkomunikasi dengan Neptunus, 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

Sihir %%sparql sel mengeluarkan SPARQL kueri ke titik akhir Neptunus. Perintah ini menerima input baris opsional berikut:

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

  • --path— Awalan 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, SPARQL visualisasi hanya mencakup pola tiga di mana o? adalah a uri atau a bnode (simpul 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 SPARQLvisualisasi):

%%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 Gremlin profile API, 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
  • --profile-chop- Menentukan panjang maksimum string hasil profil. Nilai default jika Anda tidak memberikan argumen ini adalah 250.

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

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

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

Sihir %%opencypher sel (juga%%oc)

Sihir %%opencypher sel (yang juga memiliki %%oc bentuk disingkat), mengeluarkan openCypher kueri 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 default-nya adalah auto.

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

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

    Contoh penggunaan --query-parameters
    1. Tentukan peta openCypher parameter 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 eksportir dapat dipanggil.

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

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

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

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

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

    • --store-to location-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 export job ID   — ID pekerjaan ekspor untuk mengambil status.

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

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

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

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

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

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

    • --store-to location-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 for this job   — (opsional) ID untuk ditetapkan ke pekerjaan ini.

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

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

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

    • --instance-type (instance type)   — (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-interval interval-to-wait   — (opsional) Mengatur waktu, dalam detik, antara pemeriksaan status pemrosesan data (Default: 60).

    • --wait-timeout timeout-seconds   — (opsional) Mengatur waktu, dalam hitungan detik, untuk menunggu pekerjaan pemrosesan data selesai sebelum mengembalikan status terbaru (Default: 3,600).

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

    Parameter
    • --job-id ID of the job   — ID pekerjaan untuk mengambil status.

    • --store-to instance type   — (opsional) Variabel untuk menyimpan hasil model-pelatihan.

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

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

    • --wait-timeout timeout-seconds   — (opsional) Mengatur waktu, dalam hitungan detik, untuk menunggu pekerjaan pemrosesan data selesai sebelum mengembalikan status terbaru (Default: 3,600).

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

    Parameter
    • --job-id ID for this job   — (opsional) ID untuk ditetapkan ke pekerjaan ini.

    • --data-processing-id dataprocessing job ID   — (opsional) ID pekerjaan pemrosesan data yang menciptakan artefak yang akan digunakan untuk pelatihan.

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

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

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

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

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

    • --wait-timeout timeout-seconds   — (opsional) Mengatur waktu, dalam hitungan detik, untuk menunggu pekerjaan 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 of the job   — ID pekerjaan untuk mengambil status.

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

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

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

    • --wait-timeout timeout-seconds   — (opsional) Mengatur waktu, dalam hitungan detik, untuk menunggu pekerjaan 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 for this job   — (opsional) ID untuk ditetapkan ke pekerjaan ini.

    • --model-job-id model-training job ID   — (opsional) ID pekerjaan pelatihan model untuk membuat titik akhir kueri.

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

    • --store-to location-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-interval interval-to-wait   — (opsional) Mengatur waktu, dalam detik, antara pemeriksaan status (Default: 60).

    • --wait-timeout timeout-seconds   — (opsional) Mengatur waktu, dalam hitungan 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 endpoint creation ID   — (opsional) ID pekerjaan pembuatan titik akhir untuk melaporkan statusnya.

    • --store-to location-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-interval interval-to-wait   — (opsional) Mengatur waktu, dalam detik, antara pemeriksaan status (Default: 60).

    • --wait-timeout timeout-seconds   — (opsional) Mengatur waktu, dalam hitungan 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, sihir %%neptune_ml export start sel dapat mengkonsumsi JSON dokumen di badan sel yang berisi semua parameter yang dijelaskan dalamParameter 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 JSON dokumen ke dalam badan%%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.