ノートブックで Neptune ワークベンチマジックを使う

Neptune ワークベンチは、いわゆるノートブックのマジックコマンドをいくつか提供し、これを使用すると、時間と労力を大幅に節約できます。これらは、ラインマジックとセルマジックの 2 つに分類されます。

ラインマジックは、コマンドの前にパーセント記号 (%) が 1 つ付いています。行入力のみを取得し、セル本体の残りの部分からの入力は取得しません。Neptune ワークベンチは、次のラインマジックを提供します。

• %seed

• %load

• %load_ids

• %load_status

• %cancel_load

• %status

• %gremlin_status

• %opencypher_status、または %opencypher_status、または %opencypher_status

• %stream_viewer

• Sparql

• %graph_notebook_config

• %graph_notebook_host

• %graph_notebook_version

• %graph_notebook_vis_options

• %統計

• %概要

セルマジックは、コマンドの前にパーセント記号 (%%) が 1 つではなく、2 つ付いています。セルの内容を入力として取得しますが、行の内容を入力として取得することもできます。Neptune ワークベンチは、次のセルマジックを提供します。

• %%sparql

• %%gremlin

• %%opencypher、または %%oc

• %%graph_notebook_config

• %%graph_notebook_vis_options

また、ラインマジックとセルマジックの 2 つのマジックは、Neptune の機械学習 と一緒に使用できます。

• %neptune_ml

• %%neptune_ml

注記

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、refreshdeletedetailed、または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-intervalinterval-to-wait—（オプション）エクスポートステータスチェックの間隔を秒単位で設定します（デフォルト：60）。

  • --wait-timeout timeout-seconds - (オプション) 最新のステータスを返す前に、エクスポートジョブの完了を待機する時間 (秒単位) を設定します (デフォルト値: 3,600)。

  • --store-tolocation-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-intervalinterval-to-wait—（オプション）エクスポートステータスチェックの間隔を秒単位で設定します（デフォルト：60）。

  • --wait-timeout timeout-seconds - (オプション) 最新のステータスを返す前に、エクスポートジョブの完了を待機する時間 (秒単位) を設定します (デフォルト値: 3,600)。

  • --store-tolocation-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-tolocation-to-store-result— (オプション) データ処理結果を保存する変数。

  • --instance-type(インスタンスタイプ) — (オプション) このデータ処理ジョブに使用するインスタンスサイズ。

  • --wait   –   (オプショナル) データ処理が完了するまで操作を待機する必要があることを示すフラグ。

  • --wait-intervalinterval-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-intervalinterval-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-tolocation-to-store-result— (オプション) モデルトレーニングの結果を保存する変数。

  • --wait   –   (オプショナル) モデルトレーニングが完了するまで操作を待機する必要があることを示すフラグ。

  • --wait-intervalinterval-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-intervalinterval-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-tolocation-to-store-result— (オプション) エンドポイントの作成結果を格納する変数。

  • --wait   –   (オプショナル) エンドポイント作成が完了するまで操作を待機する必要があることを示すフラグ。

  • --wait-intervalinterval-to-wait—（オプション）ステータスチェックの間隔を秒単位で設定します（デフォルト：60）。

  • --wait-timeout timeout-seconds   –   (オプショナル) 最新のステータスを返す前に、エンドポイント作成ジョブの完了を待機する時間 (秒単位) を設定します (デフォルト値: 3,600)。

• %neptune_ml endpoint status - Neptune ML クエリエンドポイントのステータスを取得します。

  パラメータ

  • --job-id endpoint creation ID - (オプション) ステータスをレポートするエンドポイント作成ジョブの ID。

  • --store-tolocation-to-store-result— (オプション) ステータス結果を保存する変数。

  • --wait   –   (オプショナル) エンドポイント作成が完了するまで操作を待機する必要があることを示すフラグ。

  • --wait-intervalinterval-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-Gremlin ノートブックでは、次のセルが、export-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 モデルのクエリエンドポイントを作成します。