翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ノートブックで Neptune ワークベンチマジックを使う
Neptune ワークベンチは、いわゆるノートブックのマジックコマンドをいくつか提供し、これを使用すると、時間と労力を大幅に節約できます。これらは、ラインマジックとセルマジックの 2 つに分類されます。
ラインマジックは、コマンドの前にパーセント記号 (%
) が 1 つ付いています。行入力のみを取得し、セル本体の残りの部分からの入力は取得しません。Neptune ワークベンチは、次のラインマジックを提供します。
セルマジックは、コマンドの前にパーセント記号 (%%
) が 1 つではなく、2 つ付いています。セルの内容を入力として取得しますが、行の内容を入力として取得することもできます。Neptune ワークベンチは、次のセルマジックを提供します。
また、ラインマジックとセルマジックの 2 つのマジックは、Neptune の機械学習 と一緒に使用できます。
注記
Neptune のマジックを使って作業する場合、通常、ヘルプテキストは --help
または -h
パラメータを使用しています。セルマジックでは、本文を空にすることはできません。そのため、ヘルプを得るときは、フィラーテキスト、つまり 1 文字でも本文に入れてください。例:
%%gremlin --help x
セルマジックまたはラインマジックでのバリアブルインジェクション
ノートブックで定義されている変数は、ノートブック内のどのセルまたはラインマジック内でも次の形式で参照できます${VAR_NAME}
。
例えば、次の変数を定義するとします。
c = 'code' my_edge_labels = '{"route":"dist"}'
次に、セルマジックでのこのグレムリンクエリ:
%%gremlin -de $my_edge_labels g.V().has('${c}','SAF').out('route').values('${c}')
これと同等です。
%%gremlin -de {"route":"dist"} g.V().has('code','SAF').out('route').values('code')
すべてのクエリ言語で動作するクエリ引数
次のクエリ引数は%%gremlin
%%opencypher
、Neptune ワークベンチの、、%%sparql
およびマジックと連動します。
一般的なクエリ引数
-
--store-to
(または-s
) — クエリ結果を保存する変数の名前を指定します。 -
--silent
— 存在する場合、クエリが完了しても出力は表示されません。 -
--group-by
(or-g
) — ノードをグループ化するために使用するプロパティを指定します (code
またはなどT.region
)。頂点は、割り当てられたグループに基づいて色付けされます。 -
--ignore-groups
- 存在する場合、すべてのグループ化オプションは無視されます。 -
--display-property
(または-d
) — 各頂点に値を表示するプロパティを指定します。各クエリ言語のデフォルト値は次のとおりです。
グレムリンの場合:
T.label
.オープンサイファーの場合:
~labels
.SPARQL の場合:
type
.
-
--edge-display-property
(または-t
) — 各エッジに値を表示するプロパティを指定します。各クエリ言語のデフォルト値は次のとおりです。
グレムリンの場合:
T.label
.オープンサイファーの場合:
~labels
.SPARQL の場合:
type
.
-
--tooltip-property
(または-de
) — 各ノードのツールチップとして値を表示するプロパティを指定します。各クエリ言語のデフォルト値は次のとおりです。
グレムリンの場合:
T.label
.オープンサイファーの場合:
~labels
.SPARQL の場合:
type
.
-
--edge-tooltip-property
(または-te
) — 各エッジのツールチップとして値を表示するプロパティを指定します。各クエリ言語のデフォルト値は次のとおりです。
グレムリンの場合:
T.label
.オープンサイファーの場合:
~labels
.SPARQL の場合:
type
.
-
--label-max-length
(または-l
) — 任意の頂点ラベルの最大文字長を指定します。デフォルトは 10 です。 -
--edge-label-max-length
(または-le
) — エッジラベルの最大文字長を指定します。デフォルトは 10 です。OpenCypher のみの場合は、
-rel
代わりに--rel-label-max-length
OR が使われます。 -
--simulation-duration
(or-sd
) — 可視化物理シミュレーションの最大時間を指定します。デフォルトは 1500 ミリ秒です。 -
--stop-physics
(または-sp
) — 初期シミュレーションが安定した後、可視化物理を無効にします。
これらの引数のプロパティ値は、単一のプロパティキー、またはラベルタイプごとに異なるプロパティを指定できる JSON 文字列のいずれかで構成できます。JSON 文字列は、変数インジェクションを使用してのみ指定できます。
%seed
ラインマジック
%seed
ラインマジックは、Gremlin、openCypher、または SPARQL クエリを探索して実験するために使用できる Neptune エンドポイントにデータを追加する便利な方法です。探索するデータモデル (プロパティグラフまたは RDF)を選択し、Neptune が提供する多数の異なるサンプルデータセットから選択できるフォームを提供します。
%load
ラインマジック
%load
ラインマジックは Neptune に一括ロードリクエストを送信するために使用できるフォームを生成します (Neptune ローダーコマンド を参照 )。ソースは、Neptune クラスターと同じリージョンにある Amazon S3 パスである必要があります。
%load_ids
ラインマジック
%load_ids
ラインマジックは、ノートブックのホストエンドポイントに送信されたロード ID を取得します (Neptune Loader Get-Status リクエストパラメータ を参照 )。リクエストは以下のような形式です。
GET https://
your-neptune-endpoint
:port
/loader
%load_status
ラインマジック
%load_status
ラインマジックは、ノートブックのホストエンドポイントに送信された特定のロードジョブのロードステータスを取得します。これは、行入力によって指定されます (Neptune Loader Get-Status リクエストパラメータ を参照 )。リクエストは以下のような形式です。
GET https://
your-neptune-endpoint
:port
/loader?loadId=loadId
ラインマジックは次のようになります。
%load_status
load id
%cancel_load
ラインマジック
%cancel_load
ラインマジックは特定のロードジョブをキャンセルします (Neptune Loader Cancel Job を参照 )。リクエストは以下のような形式です。
DELETE https://
your-neptune-endpoint
:port
/loader?loadId=loadId
ラインマジックは次のようになります。
%cancel_load
load id
%status
ラインマジック
ノートブックのホストエンドポイントからステータス情報を取得します (%graph_notebook_config はホストエンドポイントを表示します)。
%gremlin_status
ラインマジック
Gremlin クエリステータス情報を取得します。
%opencypher_status
ラインマジック (%oc_status
)
opencypher クエリのクエリステータスを取得します。コマンドは次のオプションの引数を取得します。
-
--queryId
または-q
- ステータスを表示する特定の実行中のクエリの ID を指定します。 -
--cancel_query
または-c
- 実行中のクエリをキャンセルします。値を取得しません。 -
--silent
または-s
- クエリをキャンセルする際に--silent
がtrue
に設定される場合、実行中のクエリは、HTTP レスポンスコード200
でキャンセルされます。それ以外の場合、HTTP レスポンスコードは500
になります。 -
--store-to
- クエリ結果を保存する変数の名前を指定します。
%sparql_status
ラインマジック
SPARQL クエリのステータス情報を取得します。
%stream_viewer
ラインマジック
%stream_viewer
ラインマジックは、Neptune クラスターでストリームが有効になっている場合に、Neptune ストリームに記録されたエントリをインタラクティブに調べることができるインターフェイスを表示します。次のオプションの引数を受け付けます。
-
language
— ストリームデータのクエリ言語:gremlin
またはsparql
。この引数を使用しない場合、デフォルトは、ですgremlin
。 -
--limit
-ページごとに表示するストリームエントリの最大数を指定します。この引数を使用しない場合、デフォルト値は、です10
。
注記
%stream_viewer
コマンドは、エンジンのバージョン 1.0.5.1、1.0.5.1、1.0.5.1、1.5.1、1.5.1、それ以前のバージョンのみです。
%graph_notebook_config
ラインマジック
このラインマジックは、ノートブックが Neptune との通信に使用している設定を含む JSON オブジェクトを表示します。以下の設定ファイルがあります。
host
: コマンドを接続して発行するエンドポイント。port
: Neptune にコマンドを発行するときに使用するポート。デフォルト値は8182
です。auth_mode
: Neptune にコマンドを発行するときに使用する認証のモード。IAM 認証が有効になっているクラスターに接続する場合か、IAM
それ以外の場合に必要ですDEFAULT
。load_from_s3_arn
: 使用する%load
マジックに対して Amazon S3 ARN を指定します。この値が空の場合、ARN は%load
コマンドで指定する必要があります。ssl
: TLS を使用して Neptune に接続するかどうかを示すブール値。デフォルト値はtrue
です。aws_region
: このノートブックが展開されているリージョン。この情報は IAM 認証と、%load
リクエストに関して使用されます。
設定を変更するには、新しいセルに %graph_notebook_config
出力をコピーし、そこに変更を加えます。次に、新しいセルで %%graph_notebook_config セルマジックを実行する場合、それに応じて設定が変更されます。
%graph_notebook_host
ラインマジック
行入力をノートブックのホストとして設定します。
%graph_notebook_version
ラインマジック
%graph_notebook_version
ラインマジックは Neptune ワークベンチノートブックのリリース番号を返します。例えば、グラフのビジュアライゼーションがバージョン 1.27
で導入されました。
%graph_notebook_vis_options
ラインマジック
%graph_notebook_vis_options
ラインマジックは、ノートブックが使用している現在のビジュアライゼーション設定を表示します。これらのオプションについては、vis.js
これらの設定を変更するには、出力を新しいセルにコピーし、必要な変更を行い、そのセル上で %%graph_notebook_vis_options
セルマジックを実行します。
ビジュアライゼーション設定をデフォルト値に戻すには、%graph_notebook_vis_options
ラインマジックを reset
パラメータとともに実行します。これにより、すべてのビジュアライゼーション設定がリセットされます。
%graph_notebook_vis_options reset
%statistics
ラインマジック
%statistics
ラインマジックは、DFE エンジンの統計情報を取得または管理するために使用されます (を参照Neptune DFE が使用する統計情報の管理)。このマジックは、グラフの概要を取得するためにも使用できます。
次のパラメーターを受け付けます。
-
--language
— 統計エンドポイントのクエリ言語:またはpropertygraph
(またはpg
) またはrdf
。指定しない場合は、デフォルトは、です
propertygraph
。 -
--mode
(または-m
) — 送信するリクエストまたはアクションのタイプ (status
、、、disableAutoCompute
、enableAutoCompute
、refresh
delete
detailed
、またはbasic
) を指定します。指定しない場合、
--summary
デフォルトはstatus
unless で、指定されている場合はがデフォルトですbasic
。 -
--summary
— 選択した言語の統計サマリーエンドポイントからグラフサマリーを取得します。 -
--silent
— 存在する場合、クエリが完了しても出力は表示されません。 -
--store-to
-クエリ結果の保存先となる変数を指定するために使用します。
%summary
ラインマジック
%summary
ラインマジックは、グラフの要約情報を取得するために使用されます。Neptune エンジンバージョン以降で使用できます1.2.1.0
。
次のパラメーターを受け付けます。
-
--language
— 統計エンドポイントのクエリ言語:またはpropertygraph
(またはpg
) またはrdf
。指定しない場合は、デフォルトは、です
propertygraph
。 -
--detailed
— 出力の構造フィールド表示のオン/オフを切り替えます。指定しない場合は、デフォルトは、
basic
要約表示モードです。 -
--silent
— 存在する場合、クエリが完了しても出力は表示されません。 -
--store-to
-クエリ結果の保存先となる変数を指定するために使用します。
%%graph_notebook_config
セルマジック
%%graph_notebook_config
セルマジックは、可能であれば、ノートブックが Neptune との通信に使用している設定を変更するために、構成情報を含む JSON オブジェクトを使用します。構成は %graph_notebook_config ラインマジックによって返される形式と同じ形式になります。
例:
%%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" }
%%sparql
セルマジック
%%sparql
セルマジックは、Neptune エンドポイントに SPARQL クエリを発行します。次のオプションの行入力を受け付けます。
-
-h
または--help
- これらのパラメータに関するヘルプテキストを返します。 -
--path
- SPARQL エンドポイントへのパスをプレフィックスします。例えば、--path "abc/def"
と指定した場合、呼び出されるエンドポイントは
になります。host
:port
/abc/def -
--expand-all
- これは、バインドの種類に関係なく、グラフダイアグラムに?s ?p ?o
結果のすべてを含めるようにビジュアライザに指示するクエリビジュアライゼーションのヒントです。デフォルトでは、SPARQL の視覚化には、
o?
はuri
またはbnode
(空白ノード) であるトリプルパターンのみを含みます。その他のリテラル文字列や整数などの?o
バインディング型は、すべてグラフタブ内の詳細ペインを使用して表示できる?s
ノードのプロパティとして処理されます。ビジュアライゼーションに頂点などのリテラル値を含める必要がある場合の、代わりに
--expand-all
クエリヒントを使用します。explain クエリは視覚化されないため、このビジュアライゼーションヒントを explain パラメータと組み合わせないでください。
-
--explain-type
- 使用する explain モードを指定するために使用します (dynamic
、static
、またはdetails
のいずれか)。 -
--explain-format
- explain クエリ (text/csv
またはtext/html
のいずれか 1 つ) の応答形式を指定するために使用します。 -
--store-to - クエリ結果の保存先となる変数を指定するために使用します。
explain
クエリの例は次のとおりです。
%%sparql explain SELECT * WHERE {?s ?p ?o} LIMIT 10
--expand-all
ビジュアライゼーションヒントパラメータを使用するビジュアライゼーションクエリの例 (SPARQL の視覚化 を参照)。
%%sparql --expand-all SELECT * WHERE {?s ?p ?o} LIMIT 10
%%gremlin
セルマジック
%%gremlin
セルマジックは、Neptune エンドポイントに Gremlin クエリを発行します WebSocket。これは、Gremlin inexplain /> モードまたは Gremlin profile API へトグルするオプションの行入力を受け入れます。また、ビジュアライゼーションの出力動作を変更するための個別のオプションのビジュアライゼーションヒント入力を受け入れます (Gremlin の視覚化 を参照)。
explain
クエリの例は次のとおりです。
%%gremlin explain g.V().limit(10)
profile
クエリの例は次のとおりです。
%%gremlin profile g.V().limit(10)
ビジュアライゼーションクエリヒントを使用するビジュアライゼーションクエリの例。
%%gremlin -p v,outv g.V().out().limit(10)
%%gremlin profile
クエリのオプションパラメータ
-
--chop
— プロファイル結果文字列の最大長を指定します。この引数を使用しない場合、デフォルト値は、250 です。 -
--serializer
— 結果に使用するシリアライザーを指定します。指定できる値は、有効な MIME TinkerPop タイプまたはドライバーの「Serializers」列挙値のいずれかです。この引数を使用しない場合、デフォルト値は、application.json
です。 -
--no-results
— 結果カウントのみを表示します。使用しない場合、デフォルトですべてのクエリ結果がプロファイルレポートに表示されます。 -
--indexOps
— すべてのインデックス操作の詳細なレポートを表示します。
%%opencypher
セルマジック (%%oc
)
%%opencypher
セルマジック (%%oc
フォームという略称あり) は、Neptune エンドポイントに openCypher クエリを発行します。次のオプションの行入力引かずを受け付けます。
-
mode -
query
またはbolt
いずれかのクエリモード。この引数を使用しない場合、デフォルト値は、query
です。 -
--group-by
または-g
- ノードのグループ化に使用するプロパティを指定します。例えば、code, ~id
です。この引数を使用しない場合、デフォルト値は、~labels
です。 -
--ignore-groups
- 存在する場合、すべてのグループ化オプションは無視されます。 -
--display-propery
または-d
- 各頂点の値を表示するプロパティを指定します。この引数を使用しない場合、デフォルト値は、~labels
です。 -
--edge-display-propery
または-de
– 各エッジの値を表示するプロパティを指定します。この引数を使用しない場合、デフォルト値は、~labels
です。 -
--label-max-length
または-l
- 表示する頂点ラベルの最大文字数を指定します。この引数を使用しない場合、デフォルト値は、10
です。 -
--store-to
または-s
– クエリ結果を格納する変数の名前を指定します。
%%graph_notebook_vis_options
セルマジック
%%graph_notebook_vis_options
セルマジックでは、ノートブックのビジュアライゼーションオプションを設定できます。%graph-notebook-vis-options
ラインマジックによって返された設定をコピーして新しいセルに並べ、それらに変更を加えて、%%graph_notebook_vis_options
セルマジックで新しい値を設定します。
これらのオプションについては、vis.js
ビジュアライゼーション設定をデフォルト値に戻すには、%graph_notebook_vis_options
ラインマジックを reset
パラメータとともに実行します。これにより、すべてのビジュアライゼーション設定がリセットされます。
%graph_notebook_vis_options reset
%neptune_ml
ラインマジック
%neptune_ml
ラインマジックで Neptune MLのさまざまな操作を開始および管理します。
注記
%%neptune_ml セルマジックでも Neptune MLのさまざまな操作を開始および管理できます。
-
%neptune_ml export start
- 新しいエクスポートジョブを開始します。パラメータ
-
--export-url
exporter-endpoint
- (オプション) エクスポータを呼び出すことができる Amazon API Gateway エンドポイント。 -
--export-iam
- (オプション) エクスポート URL へのリクエストに SigV4 を使用して署名する必要があることを示すフラグ。 -
--export-no-ssl
- (オプション) エクスポータに接続するときに SSL を使用しないことを示すフラグ。 -
--wait
- (オプション) エクスポートが完了するまで操作を待機する必要があることを示すフラグ。 -
--wait-interval
interval-to-wait
—(オプション)エクスポートステータスチェックの間隔を秒単位で設定します(デフォルト:60)。 -
--wait-timeout
timeout-seconds
- (オプション) 最新のステータスを返す前に、エクスポートジョブの完了を待機する時間 (秒単位) を設定します (デフォルト値: 3,600)。 -
--store-to
location-to-store-result
— (オプション) エクスポート結果を保存する変数。--wait
を指定した場合、最終ステータスがそこに保存されます。
-
-
%neptune_ml export status
- エクスポートジョブのステータスを取得します。パラメータ
-
--job-id
export job ID
- ステータスを取得するエクスポートジョブの ID。 -
--export-url
exporter-endpoint
- (オプション) エクスポータを呼び出すことができる Amazon API Gateway エンドポイント。 -
--export-iam
- (オプション) エクスポート URL へのリクエストに SigV4 を使用して署名する必要があることを示すフラグ。 -
--export-no-ssl
- (オプション) エクスポータに接続するときに SSL を使用しないことを示すフラグ。 -
--wait
- (オプション) エクスポートが完了するまで操作を待機する必要があることを示すフラグ。 -
--wait-interval
interval-to-wait
—(オプション)エクスポートステータスチェックの間隔を秒単位で設定します(デフォルト:60)。 -
--wait-timeout
timeout-seconds
- (オプション) 最新のステータスを返す前に、エクスポートジョブの完了を待機する時間 (秒単位) を設定します (デフォルト値: 3,600)。 -
--store-to
location-to-store-result
— (オプション) エクスポート結果を保存する変数。--wait
を指定した場合、最終ステータスがそこに保存されます。
-
-
%neptune_ml dataprocessing start
- Neptune ML データ処理ステップを開始します。パラメータ
-
--job-id
ID for this job
- (オプション) このジョブに割り当てる ID。 -
--s3-input-uri
S3 URI
- (オプション) このデータ処理ジョブの入力を検索する S3 URI。 -
--config-file-name
file name
- (オプション) このデータ処理ジョブの構成ファイルの名前。 -
--store-to
location-to-store-result
— (オプション) データ処理結果を保存する変数。 -
--instance-type
(インスタンスタイプ)
— (オプション) このデータ処理ジョブに使用するインスタンスサイズ。 -
--wait
– (オプショナル) データ処理が完了するまで操作を待機する必要があることを示すフラグ。 -
--wait-interval
interval-to-wait
—(オプション)データ処理ステータスチェックの間隔を秒単位で設定します(デフォルト:60)。 -
--wait-timeout
timeout-seconds
– (オプショナル) 最新のステータスを返す前に、データ処理ジョブの完了を待機する時間 (秒単位) を設定します (デフォルト値: 3,600)。
-
-
%neptune_ml dataprocessing status
- データ処理ジョブのステータスを取得します。パラメータ
-
--job-id
ID of the job
– ステータスを取得するジョブの ID。 -
--store-to
instance type
- (オプション) モデルトレーニング結果を保存する変数。 -
--wait
– (オプショナル) モデルトレーニングが完了するまで操作を待機する必要があることを示すフラグ。 -
--wait-interval
interval-to-wait
—(オプション)モデルトレーニングステータスチェックの間隔を秒単位で設定します(デフォルト:60)。 -
--wait-timeout
timeout-seconds
- (オプション) 最新のステータスを返す前に、データ処理ジョブの完了を待機する時間 (秒単位) を設定します (デフォルト値: 3,600)。
-
-
%neptune_ml training start
- Neptune ML モデルトレーニングプロセスを開始します。パラメータ
-
--job-id
ID for this job
- (オプション) このジョブに割り当てる ID。 -
--data-processing-id
dataprocessing job ID
- (オプション) トレーニングに使用するアーティファクトを作成したデータ処理ジョブの ID。 -
--s3-output-uri
S3 URI
- (オプション) このモデルトレーニングジョブからの出力を保存する S3 URI。 -
--instance-type
(インスタンスタイプ)
— (オプション) このモデルトレーニングジョブに使用するインスタンスサイズ。 -
--store-to
location-to-store-result
— (オプション) モデルトレーニングの結果を保存する変数。 -
--wait
– (オプショナル) モデルトレーニングが完了するまで操作を待機する必要があることを示すフラグ。 -
--wait-interval
interval-to-wait
—(オプション)モデルトレーニングステータスチェックの間隔を秒単位で設定します(デフォルト:60)。 -
--wait-timeout
timeout-seconds
- (オプション) 最新のステータスを返す前に、モデルトレーニングジョブの完了を待機する時間 (秒単位) を設定します。デフォルト値: 3,600)。
-
-
%neptune_ml training status
- Neptune ML モデルトレーニングジョブのステータスを取得します。パラメータ
-
--job-id
ID of the job
- ステータスを取得するジョブの ID。 -
--store-to
instance type
- (オプション) ステータス結果を保存する変数。 -
--wait
- (オプション) モデルトレーニングが完了するまで操作を待機する必要があることを示すフラグ。 -
--wait-interval
interval-to-wait
—(オプション)モデルトレーニングステータスチェックの間隔を秒単位で設定します(デフォルト:60)。 -
--wait-timeout
timeout-seconds
- (オプション) 最新のステータスを返す前に、データ処理ジョブの完了を待機する時間 (秒単位) を設定します (デフォルト値: 3,600)。
-
-
%neptune_ml endpoint create
- Neptune ML モデルのクエリエンドポイントを作成します。パラメータ
-
--job-id
ID for this job
- (オプション) このジョブに割り当てる ID。 -
--model-job-id
model-training job ID
- (オプション) クエリエンドポイントを作成するモデルトレーニングジョブの ID。 -
--instance-type
(インスタンスタイプ)
— (オプション) クエリエンドポイントに使用するインスタンスサイズ。 -
--store-to
location-to-store-result
— (オプション) エンドポイントの作成結果を格納する変数。 -
--wait
– (オプショナル) エンドポイント作成が完了するまで操作を待機する必要があることを示すフラグ。 -
--wait-interval
interval-to-wait
—(オプション)ステータスチェックの間隔を秒単位で設定します(デフォルト:60)。 -
--wait-timeout
timeout-seconds
– (オプショナル) 最新のステータスを返す前に、エンドポイント作成ジョブの完了を待機する時間 (秒単位) を設定します (デフォルト値: 3,600)。
-
-
%neptune_ml endpoint status
- Neptune ML クエリエンドポイントのステータスを取得します。パラメータ
-
--job-id
endpoint creation ID
- (オプション) ステータスをレポートするエンドポイント作成ジョブの ID。 -
--store-to
location-to-store-result
— (オプション) ステータス結果を保存する変数。 -
--wait
– (オプショナル) エンドポイント作成が完了するまで操作を待機する必要があることを示すフラグ。 -
--wait-interval
interval-to-wait
—(オプション)ステータスチェックの間隔を秒単位で設定します(デフォルト:60)。 -
--wait-timeout
timeout-seconds
- (オプション) 最新のステータスを返す前に、エンドポイント作成ジョブの完了を待機する時間 (秒単位) を設定します (デフォルト値: 3,600)。
-
%%neptune_ml
セルマジック
%%neptune_ml
セルマジックは、--job-id
または --export-url
のような行入力を無視します。代わりに、これらの入力とセル本文内の他の入力を指定できます。
このような入力を Jupyter 変数に割り当てた別のセルに保存し、その変数を使用してセル本文に挿入することもできます。そうすれば、毎回再入力しなくても、この入力内容を何度も使用できます。
これは、注入変数がセルの唯一の内容である場合にのみ機能します。1 つのセルに複数の変数を使用したり、テキストと変数の組み合わせを使用したりすることはできません。
例えば、%%neptune_ml export start
セルマジックは、Neptune エクスポートプロセスを制御するために使用されるパラメーター で説明されているすべてのパラメータを含む JSON ドキュメントをセル本文で消費できます。
Export the data and model configuration (データとモデルの設定をエクスポートする) セクションの機能の設定の下にある Neptune-ML-01-Introduction-to-Node-Classification-Gremlinexport-params
という名前の Jupyter 変数に割り当てられたドキュメント内のエクスポートパラメータをどのように保持しているかが説明されています。
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"}
このセルを実行すると、Jupyter はその名前でパラメータドキュメントを保存します。次に ${export_params}
を使用して、次のように JSON ドキュメントを %%neptune_ml export start cell
の本文に挿入できます。
%%neptune_ml export start --export-url {neptune_ml.get_export_service_host()} --export-iam --wait --store-to export_results ${export_params}
利用可能な %%neptune_ml
セルマジックの形式
%%neptune_ml
セルマジックは以下のような形式で使用できます。
-
%%neptune_ml export start
- Neptune ML エクスポートプロセスを開始します。 -
%%neptune_ml dataprocessing start
- Neptune ML データ処理ジョブを開始します。 -
%%neptune_ml training start
- Neptune ML モデルトレーニングジョブを開始します。 -
%%neptune_ml endpoint create
- Neptune ML モデルのクエリエンドポイントを作成します。