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: + [%seed](#notebooks-line-magics-seed) + [%load](#notebooks-line-magics-load) + [%load\$1ids](#notebooks-line-magics-load-ids) + [%load\$1status](#notebooks-line-magics-load-status) + [%cancel\$1load](#notebooks-line-magics-cancel-load) + [%status](#notebooks-line-magics-status) + [%gremlin\$1status](#notebooks-line-magics-gremlin-status) + [%opencypher\$1status, atau %oc\$1status](#notebooks-line-magics-opencypher-status) + [`%stream_viewer`](#notebooks-line-magics-stream-viewer) + [%sparql\$1status](#notebooks-line-magics-sparql-status) + [%graph\$1notebook\$1config](#notebooks-line-magics-graph-notebook-config) + [%graph\$1notebook\$1host](#notebooks-line-magics-graph-notebook-host) + [%graph\$1notebook\$1version](#notebooks-line-magics-graph-notebook-version) + [%graph\$1notebook\$1service](#notebooks-line-magics-graph-notebook-service) + [%graph\$1notebook\$1vis\$1options](#notebooks-line-magics-graph-notebook-vis-options) + [%statistik](#notebooks-line-magics-statistics) + [%ringkasan](#notebooks-line-magics-summary) + [%reset\$1graph](#notebooks-line-magics-reset-graph) + [%get\$1graph](#notebooks-line-magics-get-graph) + [%DegreeDistribusi](#notebooks-line-magics-degreeDistribution) *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](#notebooks-cell-magics-sparql) + [%%gremlin](#notebooks-cell-magics-gremlin) + [%%opencypher, atau %%oc](#notebooks-cell-magics-opencypher) + [%%graph\$1notebook\$1config](#notebooks-cell-magics-graph-notebook-config) + [%%graph\$1notebook\$1vis\$1options](#notebooks-cell-magics-graph-notebook-vis-options) Terdapat juga dua magic, line magic dan cell magic, untuk bekerja dengan [Machine learning Neptune](machine-learning.md): + [%neptune\$1ml](#notebooks-line-magics-neptune_ml) + [%%neptune\$1ml](#notebooks-cell-magics-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. 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` atau`T.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](#notebook-magics-variable-injection). ## 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](load-api-reference-load.md)). 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 Neptune Loader Get-Status](load-api-reference-status-requests.md#load-api-reference-status-parameters)). 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 Neptune Loader Get-Status](load-api-reference-status-requests.md#load-api-reference-status-parameters)). 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](load-api-reference-cancel.md)). 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](access-graph-status.md) dari titik akhir host notebook ([%graph\$1notebook\$1config](#notebooks-line-magics-graph-notebook-config) menunjukkan titik akhir host). [Untuk host Neptunus DB, informasi status akan diambil dari titik akhir status kesehatan.](https://docs.aws.amazon.com//neptune/latest/userguide/access-graph-status.html) [Untuk host Neptune Analytics, status akan diambil melalui API. GetGraph ](https://docs.aws.amazon.com//neptune-analytics/latest/apiref/API_GetGraph.html) Untuk informasi selengkapnya, lihat [%get\$1graph](#notebooks-line-magics-get-graph). ## Line magic `%gremlin_status` Mengambil [informasi status kueri Gremlin](gremlin-api-status.md). ## Sihir `%opencypher_status` garis (juga`%oc_status`) Mengambil status kueri untuk kueri opencypher. Sihir baris ini mengambil argumen opsional berikut: + **`--queryId`**or **`-q`**- Menentukan ID dari query berjalan tertentu untuk menampilkan status. + **`--cancelQuery`**atau **`-c`**— Membatalkan kueri yang sedang berjalan. Tidak mengambil nilai. + **`--silent-cancel`**atau **`-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 menjadi`500`. + **`--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 kueri 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 `%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` atau`sparql`. Defaultnya, jika Anda tidak memberikan argumen ini, adalah`gremlin`. + **`--limit`**- Menentukan jumlah maksimum entri aliran untuk ditampilkan per halaman. Nilai default, jika Anda tidak memberikan argumen ini, adalah`10`. **catatan** Sihir `%stream_viewer` garis sepenuhnya didukung hanya pada versi mesin 1.0.5.1 dan sebelumnya. ## Line magic `%sparql_status` Mengambil [informasi status kueri SPARQL](sparql-api-status.md). ## 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\$1notebook\$1config](#notebooks-cell-magics-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](https://visjs.github.io/vis-network/docs/network/#options). 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 (lihat[Mengelola statistik untuk Neptune DFE yang akan digunakan](neptune-dfe-statistics.md)). Sihir ini juga dapat digunakan untuk mengambil [ringkasan grafik](neptune-graph-summary.md). Ini menerima parameter berikut: + **`--language`**— Bahasa kueri dari titik akhir statistik: baik atau `propertygraph` (atau`pg`) atau`rdf`. Jika tidak disediakan, defaultnya adalah`propertygraph`. + **`--mode`**(atau **`-m`**) - Menentukan jenis permintaan atau tindakan untuk mengirimkan: salah satu dari`status`,,`disableAutoCompute`,`enableAutoCompute`,`refresh`, `delete``detailed`, atau`basic`). Jika tidak disediakan, defaultnya `--summary` adalah `status` kecuali ditentukan, dalam hal ini defaultnya`basic`. + **`--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](neptune-graph-summary.md). 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` (atau`pg`) atau`rdf`. Jika tidak disediakan, defaultnya adalah`propertygraph`. + **`--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. ## Line magic `%reset_graph` Sihir baris `%reset_graph` (atau`%_graph_reset`) mengeksekusi [ResetGraph](https://docs.aws.amazon.com//neptune-analytics/latest/apiref/API_ResetGraph.html)panggilan 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 `%get_graph` Sihir `%get_graph` garis mengambil informasi tentang grafik melalui [GetGraph API](https://docs.aws.amazon.com//neptune-analytics/latest/apiref/API_GetGraph.html). Keajaiban ini secara fungsional identik dengan [%status](#notebooks-line-magics-status) saat digunakan dengan Neptunus Analytics. ## Line magic `%degreeDistribution` Sihir `%degreeDistribution` garis menciptakan histogram interaktif yang memvisualisasikan distribusi derajat simpul dalam grafik. Histogram menampilkan jumlah simpul (sumbu y) yang memiliki derajat tertentu (sumbu x). Ini hanya tersedia dengan Neptune Analytics. Ini menerima parameter berikut, yang juga dapat dipilih di menu tarik-turun: + **`--traversalDirection`**— Menentukan tingkat mana yang akan dianalisis. Harus salah satu dari: `"both"` (default),`"inbound"`, atau`"outbound"`. + **`--vertexLabels`**— Filter simpul dengan label yang disediakan (misalnya,`airport country`). Defaultnya adalah daftar kosong. + **`--edgeLabels`**— Filter tepi dengan label yang disediakan (misalnya,`route`). Defaultnya adalah daftar kosong. ## 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 untuk menyimpan hasil query. Contoh kueri `explain`: ``` %%sparql explain SELECT * WHERE {?s ?p ?o} LIMIT 10 ``` Contoh kueri visualisasi dengan parameter petunjuk visualisasi `--expand-all` (lihat [Visualisasi SPARQL](notebooks-visualization.md#notebooks-visualization-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](gremlin-explain.md) atau [API `profile` Gremlin](gremlin-profile-api.md), dan input petunjuk visualisasi opsional terpisah untuk mengubah perilaku output visualisasi (lihat [Visualisasi Gremlin](notebooks-visualization.md#notebooks-visualization-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 nilai enum tipe MIME atau TinkerPop driver “Serializers” yang valid. Nilai default jika Anda tidak memberikan argumen ini adalah`application.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 kueri OpenCypher ke titik akhir Neptunus. Ia menerima argumen input baris opsional berikut: + **`--mode`**— Mode kueri: salah satu `query` atau`bolt`. Nilai default jika Anda tidak memberikan argumen ini adalah`query`. + **`--group-by`**or **`-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-property`**or **`-d`**- Menentukan properti yang nilainya harus ditampilkan untuk setiap simpul. Nilai default jika Anda tidak memberikan argumen ini adalah`~labels`. + **`--edge-display-property`**atau **`-de`**- Menentukan properti yang nilainya harus ditampilkan untuk setiap tepi. Nilai default jika Anda tidak memberikan argumen ini adalah`~labels`. + **`--explain-type`**— Digunakan untuk menentukan mode jelaskan yang akan digunakan (salah satu dari: dinamis, statis, debug, atau detail). + **`--label-max-length`**or **`-l`**- Menentukan jumlah maksimum karakter dari label simpul untuk ditampilkan. Nilai default jika Anda tidak memberikan argumen ini adalah`10`. + **`--store-to`**atau **`-s`**- Menentukan nama variabel di mana untuk menyimpan hasil query. + **`--plan-cache`**atau **`-pc`**- Menentukan modus rencana cache untuk digunakan. Nilai default-nya adalah `auto`. + **`--query-timeout`**atau **`-qt`**- Menentukan batas waktu kueri maksimum dalam milidetik. Nilai default-nya adalah `1800000`. + **`--query-parameters`**atau **`qp`**— [Definisi parameter](opencypher-parameterized-queries.md) 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, }''' ``` 1. Masukkan parameter ke `--query-parameters` dalam sel lain dengan`%%oc`. ``` %%oc --query-parameters params MATCH (n {name: $name, age: $age}) RETURN n ``` ## 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\$1notebook\$1config](#notebooks-line-magics-graph-notebook-config). 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 `%%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](https://visjs.github.io/vis-network/docs/network/#options). 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\$1ml](#notebooks-cell-magics-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 SSL tidak boleh digunakan saat menghubungkan ke exporter. + **`--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 SSL tidak boleh digunakan saat menghubungkan ke exporter. + **`--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 instans 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, 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 Neptunus](export-parameters.md). Di notebook [Neptune-ML-01-Introduction-to-Node-Classification-Gremlin](https://github.com/aws/graph-notebook/blob/main/src/graph_notebook/notebooks/04-Machine-Learning/Neptune-ML-01-Introduction-to-Node-Classification-Gremlin.ipynb), 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.