​

はじめに

JupyterワークスペースはJupyterLabインターフェースを使用します。JupyterLabの詳細については、 JupyterLabのドキュメント を参照してください。

• 必要な許可
• Jupyterを有効にする
• Jupyterワークスペースにアクセスする
• Jupyterワークスペースのタスク
  • ワークスペースを作成する
  • ワークスペースの共有を有効にする
  • ワークスペースを共有する
  • 共有ワークスペースでインスタンスを表示する
  • ワークスペースを実行する
  • ワークスペースを編集する
  • ワークスペースを削除する
• ファイル共有
  • ファイル共有を作成する
  • ファイル共有を使用する
  • ファイル共有を削除する
• Jupyterメモ
  • Jupyterメモを編集する
  • メモを作成する
  • メモの名前を変更する
  • メモを保存する
  • メモを削除する
  • メモをスケジュールする
  • メモの出力をダウンロードする
  • スケジュールが設定されたメモを手動で実行する
  • セル
    • セルのタイプを変更する
    • メモにセルを追加する
    • その他のセルオプション
    • セルに入力を追加する
    • セルを実行する
  • ワークフロー経由で実行する
• Jupyterの基本
  • データを読み込む
  • データを書き込む
  • Append、Upsert、Partitionを使用する
  • アカウントを使用する
  • ライブラリをインストールして使用する
  • 利用状況のモニタリング
• よくある質問

​

必要な許可

• Jupyterワークスペースを作成 — ユーザーは、自分がアクセス権を持つJupyterワークスペースを作成、編集、削除できます。
• Jupyterワークスペースを管理 （Jupyter管理者） — ユーザーは、インスタンス内のすべてのJupyterワークスペースを表示、編集、削除できます。ほかのユーザーとワークスペースを共有するには、この許可が必要です。

• Fileshareディレクトリを作成 — ユーザーは、自分がアクセス権を持つファイル共有ディレクトリを作成、編集、削除できます。
• Fileshareディレクトリを管理 — ユーザーは、このインスタンス内のすべてのファイル共有ディレクトリを表示、編集、削除できます。

​

Jupyterを有効にする

1. ナビゲーションヘッダーで、 ［その他］ > ［管理者］ に進みます。
2. ［機能］ メニューで ［Jupyter］ を選択します。
3. ［Jupyter Account Inactive］ の横にあるトグルを調整して機能を有効にします。

4. アカウントを有効にしたら、必要なアカウントプランを選択します。

• デフォルトのアカウントプランでは、すべてのユーザーがJupyterにアクセスでき、すべてのユーザーが無制限に利用できます。
• 手動のアカウントプランでは、特定のユーザーがJupyterにアクセスでき、利用制限を設定できます。

5. ［ティア制限を計算する］ を選択します。ティア制限の詳細については、Domoアカウントチームにお問い合わせください。
6. ［保存］ を選択します。

​

Jupyterワークスペースにアクセスする

左側のナビゲーションで、 ［More］ > ［Jupyterワークスペース］ を選択します。

​

このページのトップへ

​

Jupyterワークスペースのタスク

​

ワークスペースを作成する

1. ナビゲーションヘッダーで ［データ］ を選択します。
2. 左側のレールで、 ［More］ > ［Jupyterワークスペース］ を選択します。
3. ［+新しいワークスペース］ を選択します。 ［Jupyterワークスペースを作成］ モーダルが表示されます。
4. ワークスペースをカスタマイズするには、以下の設定を行います。

• ［名前］ および ［説明］ フィールドに、ワークスペース名とオプションの説明を入力します。
• ［カーネル］ 、 ［ティア制限を計算する］ 、 および ［タイムアウト］ フィールドに値を入力します。
• （オプション）入力DataSetを選択します。
• （オプション）出力DataSetを選択します。
• （オプション）アカウントを追加します。 この手順では、ワークスペースで参照するGoogleアカウントなどのサードパーティアカウントを追加できます。
• （オプション）ファイル共有を追加します。手順については、「 ファイル共有を作成する 」を参照してください。
  注記： ワークスペースをほかのユーザーと共有すると、ワークスペースで参照されているサードパーティアカウントがほかのユーザーに表示されます。ただし、ほかのユーザーがアカウントキーや値を参照することはできません。 ユーザーとアカウントを共有するには、［データ］>［アカウント］に進みます。 入力DataSetと出力DataSetは共同所有者とも共有されます。

5. ［保存］ を選択します。

​

ワークスペースの共有を有効にする

1. Jupyterワークスペースリストから、共有したいワークスペースに移動します。
2. ワークスペースの右側にマウスポインターを合わせます。 ［Manage Workspace］ メニューが表示されます。
3. ［Manage Workspace］ メニューを選択し、 ［共有を有効にする］ を選択します。

4. ［続ける］ を選択して ［確認］ を選択します。 ［確認］ を選択すると、 メモやワークスペースの共有に伴うリスク を承諾したことになります。

​

このページのトップへ

​

ワークスペースを共有する

1. Jupyterワークスペースリストから、共有したいワークスペースに移動します。
2. ワークスペースの右側にマウスポインターを合わせます。 ［Manage Workspace］ メニューが表示されます。
3. ［Manage Workspace］ メニューを選択し、 ［このワークスペースを共有する］ を選択します。

4. 受信者の名前を入力し、適切な権限を選択して、 ［追加］ を選択します。
5. ［保存］ を選択します。

​

このページのトップへ

​

共有ワークスペースでインスタンスを表示する

​

ワークスペースを実行する

1. ［Jupyterワークスペース］ リストから、実行したいワークスペースを選択します。

2. ［開始］ を選択します。

3. ワークスペースの読み込みが完了したら、ワークスペースのタイトルを選択します。

​

ワークスペースを編集する

1. ［Jupyterワークスペース］ リストから、編集したいワークスペースを見つけます。
2. ワークスペースの右側にマウスポインターを合わせます。 ［Manage Workspace］ メニューが表示されます。
3. ［Manage Workspace］ メニューを選択し、 ［編集］ を選択します。

4. ワークスペースに新しい詳細を追加し、 ［保存］ を選択します。

​

ワークスペースを削除する

1. Jupyterワークスペースリストから、削除したいワークスペースに移動します。
2. ワークスペースの右側にマウスポインターを合わせます。 ［Manage Workspace］ メニューが表示されます。
3. ［Manage Workspace］ メニューを選択し、 ［削除］ を選択します。

4. ［削除］ ボタンを選択して、ワークスペースを削除することを確認します。

​

ファイル共有

​

ファイル共有を作成する

1. Domoナビゲーションヘッダーで、 ［データ］ を選択します。
2. 左側のレールで、 ［More］ > ［ファイル共有］ を選択します。
3. ［+新しいファイルの共有］ を選択します。 ［ファイル共有を作成］ モーダルが表示されます。
   
4. ファイル共有をカスタマイズするには、以下の設定を行います。
   • ［名前］ および ［説明］ フィールドに、ファイル共有の名前とオプションの説明を入力します。
   • ［デフォルトのマウントポイント］ フィールドに、 パス を入力します。 これは何でも構いません。
5. ［保存］ を選択して、新しいファイル共有を作成します。

​

ファイル共有を使用する

1. モーダルの ［ファイル共有］ セクションで、 ［ファイル共有を追加］ を選択します。
2. 検索フィールドで、ワークスペースに追加するファイル共有を検索して特定します。
3. そのファイル共有を選択します。
4. 選択したファイル共有がモーダルに表示されます。デフォルトでは、マウントポイントはデフォルトのマウントポイントで、 ［デフォルトを使用］ チェックボックスはオンになっています。別のマウントポイントを使用するには、 ［デフォルトを使用］ チェックボックスをオフにしてリストを展開し、使用するマウントポイントを選択します。
   

   
5. ［ワークスペースを保存］ を選択します。

​

ファイル共有を削除する

1. ［Jupyterワークスペースを作成］ または ［Jupyterワークスペースを編集］ モーダルにアクセスします。 これらのモーダルにアクセスする方法については、「 ワークスペースを作成する 」および「 ワークスペースを編集する 」を参照してください。
2. モーダルの ［ファイル共有］ セクションで、削除するファイル共有を特定し、 三点メニューを選択します。
3. ［削除］ を選択します。
   

​

Jupyterメモ

​

Jupyterメモを編集する

​

メモを作成する

1. Jupyterワークスペースで、 ［ファイル］ > ［新規］ > ［メモ］ を選択します。 ［カーネルを選択］ モーダルが表示されます。
   
2. ［選択］ を選択します。 メインの作業領域に、 Untitled.ipynb という名前のメモが開きます。無題のメモは、ワークスペースのサイドパネルにある ファイルブラウザー にも表示されます。
   

​

メモの名前を変更する

• メモが開いている場合 — メインの作業領域でメモのタイトルを右クリックしてメモのオプションを表示し、 ［Rename Notebook］ を選択します。 ［Rename File］ ダイアログが表示されます。メモの新しい名前を入力し、 ［名前を変更］ を選択します。
  
• メモが閉じている場合 — ファイルブラウザー で名前を変更するメモのタイトルを右クリックしてファイルオプションを表示し、 ［名前を変更］ を選択します。メモの新しい名前を入力します。
  

​

メモを保存する

​

メモを削除する

• メモが開いている場合 — メインの作業領域でメモのタイトルを右クリックしてメモのオプションを表示し、 ［Delete Notebook］ を選択します。ダイアログが表示されます。 ［削除］ を選択します。
  
• メモが閉じている場合 — メインの作業領域でメモのタイトルを右クリックしてメモのオプションを表示し、 ［削除］ を選択します。ダイアログが表示されます。 ［削除］ を選択します。
  

​

メモをスケジュール設定する

• 設定した時刻で1日1回
• 設定した時刻で1日に複数回
• 毎日
• 特定の曜日
• 月の特定の日
• 毎月
• 特定の月の間

1. スケジュールを設定するメモを開きます。ツールバーで、 ［Schedule Notebook］ を選択します。 ［DataFlowを作成］ モーダルが表示されます。
   
2. モーダルで、 ［名前］ と ［説明］ （オプション）のフィールドを入力します。
3. ［ティアを計算する］ を選択します。
4. ［このDataFlowをどのタイミングで実行しますか？］ メニューで、 ［スケジュールに従う］ を選択します。
5. メモのスケジュールを設定します。
6. ［保存］ を選択します。
   

DataFlowが、Data Centerの ［DataFlow］ セクションに表示されるようになります。表示するには、ナビゲーションヘッダーで ［データ］ を選択し、Data Centerのサイドバーで ［DataFlow］ を選択します。Jupyter DataFlowを選択すると、詳細ビューが表示されます。

​

メモの出力をダウンロードする

1. DataFlowの詳細ビューの ［履歴］ タブに移動 します。
   
2. ログで、出力情報を出力する実行を表す行を特定します。
3. その行の アクションメニューを選択します。
4. アクションメニューで ［詳細を表示］ を選択します。 ダイアログが表示され、ダウンロードする出力のファイル形式を、IPYNB、HTML、PDFから選択できます。
   

​

スケジュールが設定されたメモを手動で実行する

1. Data Centerの ［DataFlow］ セクションで、スケジュールが設定されているJupyterメモのJupyter DataFlowを見つけます。
2. Jupyter DataFlowの行で、 DataFlowのオプション を選択します。オプションのリストで、 ［実行］ を選択します。

​

セル

• コードセル — コードの記述および編集ができます。コードの記述に使用するプログラミング言語は、Jupyterワークスペースを作成する際に選択したカーネルのタイプ（PythonまたはR）によって異なります。コードセルを実行すると、コードセルのすぐ下にコードの出力が表示されます。出力には、テキスト、図、表、画像などの様々な形式を使用できます。
• マークダウンセル — テキストを書き込むことができます。また、マークダウン言語を使用して、斜体や太字、リストの指定、見出しの作成など、テキストのマークアップや書式設定を行うこともできます。マークダウンセルを実行すると、入力したテキストの書式はリッチテキストになります。基本的なマークダウン構文については、 こちら を参照してください。
• 未加工セル — 出力を直接書き込んだり、実行したくないコードを保存したりすることができます。

​

セルのタイプを変更する

​

このページのトップへ

​

メモにセルを追加する

• 追加 — ツールバーで 追加 を選択します。メモの最後にセルが追加されます。
• セルを挿入 — 現在選択されているセルの上または下にセルを追加するには、 セルを上に追加 または セルを下に追加 を選択します。
  注記： デフォルトでは、新しいセルはすべてコードセルです。セルのタイプに関する詳細については「 セル 」を、セルのタイプの変更に関する詳細については「 セルのタイプを変更する 」を参照してください。

​

その他のセルオプション

​

セルに入力を追加する

​

セルを実行する

個々のセルを実行するには、セルを選択して、ツールバーの 再生 をクリックします。

1. キーボードの Esc キーを押します。
2. Shift
   • 上/下矢印 キーで、実行するセルを選択します。
3. ツールバーの 再生 をクリックします。
   

​

— | —

​

ワークフロー経由で実行する

conda install -c https://domo-conda-prod.s3.amazonaws.com/domo domojupyter=1.1.32

import domojupyter.execution as domo_execution import json payload = domo_execution.get_payload() new_payload = {'newProperty': payload['test'] + 'NEW!'} # write_response - is required to get the output domo_execution.write_response(new_payload)

​

Jupyterの基本

​

データを読み込む

1. Jupyterワークスペースで、リストからワークスペースを見つけます。所有者別に検索とフィルターができます。
2. ワークスペースにマウスポインターを合わせます。 ［Manage Workspace］ メニューが表示されます。
3. ［Manage Workspace］ メニューを選択し、 ［編集］ を選択します。

4. ［Jupyterワークスペースを編集］ ビューで、 ［入力DataSetを追加］ を選択し、Jupyterメモに読み込むデータソースを選択します。
5. DataSetを選んだ後、 ［ワークスペースを保存］ を選択します。

6. domo.read_dataframe コマンドを使用して、DomoデータソースからデータをJupyterメモに読み込み、さらに処理と分析を行います。

​

データを書き込む

1. Jupyterワークスペースで、リストからワークスペースを見つけます。所有者別に検索とフィルターができます。
2. ワークスペースにマウスポインターを合わせます。 ［Manage Workspace］ メニューが表示されます。
3. ［Manage Workspace］ メニューを選択し、 ［編集］ を選択します。

4. ［Jupyterワークスペースを編集］ ビューで、 ［出力DataSetを追加］ を選択し、Jupyterメモに書き込むデータソースを選択します。
5. DataSetを選んだ後、 ［ワークスペースを保存］ を選択します。

6. domo.write_dataframe コマンドを使って、Jupyterワークスペースに設定されているDomoデータソースに結果を書き戻します。

​

Append、Upsert、Partitionを使用する

• domo.write_dataframe(df, output_dataset)
• domo.write_dataframe(df, output_dataset, update_method=“REPLACE”)
• domo.write_dataframe(df, output_dataset, update_method=“APPEND”)
• domo.write_dataframe(df, output_dataset, update_method=“UPSERT”, update_key=column_name)
• domo.write_dataframe(df, output_dataset, update_method=“PARTITION”, partition_name=’Example Name’)

​

アカウントを使用する

1. Jupyterワークスペースで、リストからワークスペースを見つけます。所有者別に検索とフィルターができます。
2. ワークスペースにマウスポインターを合わせます。 ［Manage Workspace］ メニューが表示されます。
3. ［Manage Workspace］ メニューを選択し、 ［編集］ を選択します。

4. ［Jupyterワークスペースを編集］ ビューで、 ［アカウント］ > ［アカウントを追加］ を選択し、サードパーティアカウントを選択します。
5. 選択したら、 ［ワークスペースを保存］ を選択します。

6. アカウント情報の取得には以下のコマンドを使用できます。

• domo.get_account_property_value('account') は、各自のアカウントのプロパティに割り当てられた特定の値を返します。
• domo.get_account_property_value('account',account_properties[0]) は、アカウントに存在するすべてのプロパティを返します。

​

ライブラリをインストールして使用する

​

利用状況のモニタリング

1. デフォルトの管理者権限などの既存の権限を複製します。
2. 複製した権限から、課金管理者には不要な許可を削除します。
3. この権限に、「使用状況メトリクスを表示」および「Jupyterワークスペースを管理」の許可を追加します。

1. ナビゲーションヘッダーで、 ［その他］ > ［管理者］ に進みます。
2. ［カンパニー設定］ メニューの ［管理者］ 画面で、 ［利用状況］ を選択します。
3. ［Jupyterの計算］ タブに進みます。
   

​

よくある質問

プラグインをインストールできますか？

プラグインは現在サポートされていません。

この機能を試すことはできますか？

Jupyterのトライアルに関する最新情報は、カスタマーサクセスマネージャー（CSM）あるいはアカウントエグゼクティブ（AE）にお問い合わせください。

Domoはデータサイエンスサービスを提供していますか？

はい、お客様の必要に応じて経験豊富なデータサイエンスチームがサービスを提供しています。詳細については、アカウントエグゼクティブ（AE）にお問い合わせください。

カーネルの変更はどのようにすればよいですか？

まずワークスペースを停止してください。Domoワークスペース編集ビューでカーネルを変更することができます。

カーネルをリセットできますか？

はい。ワークスペースにマウスポインターを合わせると、 ［Manage Workspace］ メニューが表示されます。オプションから ［カーネルのデフォルトを復元］ を選択します。この操作を実行するには、すべてのインスタンスを停止する必要があります。

Jupyterメモを使用するには、PythonやRといったプログラミング言語でコーディングできる知識が必要ですか？

何らかのデータ探索や分析（DataSetの読み込み、データサイエンスモデルや機械学習パイプラインの開発、カスタムデータ表や図の作成、変換されたデータのDomoへの書き込みなど）をメモで行う場合は、RまたはPythonの経験が必要です。

サードパーティのライブラリの統合に問題が発生しています。

DomoのJupyter統合により、サードパーティのライブラリをインストールすることができます。ただし、Domoはすべてのサードパーティのライブラリをネイティブにサポートしていません。一部のサードパーティのライブラリでは、お客様自身でインストール、設定、トラブルシューティングを行う必要があります。

JupyterワークスペースとGitHubを統合できますか？

Domoは、Jupyterワークスペースのインターフェース内でgitリポジトリの統合と維持をサポートしています。統合が完了すると、標準のGit操作を使用して、Jupyterワークスペースから選択したGitHubリポジトリに、更新（更新されたJupyterメモファイルを含む）を繰り返しプッシュできるようになります。詳細については、「 GitHubでJupyterワークスペースを使用する 」を参照してください。

Pythonの最小バージョンは3.9です。サポートされているバージョンに関するDomoの廃止ポリシーはどのようになっていますか？

現時点では、Pythonのどのバージョンにも廃止予定はありません。

ワークスペースに4つのカテゴリーがあり、それぞれに同じ4つのCPUがあります。実稼働環境の各カテゴリーの設定はどのようになりますか？

現在、トライアルのJupyterをご利用のお客様は、4つのティアにしかアクセスできません。コンサンプション契約のお客様の場合は、それぞれ異なるCPU割り当てを持つ9つのJupyterティアがあります。

APIとして継続的に実行されるサービスをホストするにはどうすればよいですか？

Jupyterには、継続実行機能がありません。

Domoにコードコパイロット/アシスタントはありますか？

現時点では、コパイロットはサポートされていません。現在、その実現可能性とDomoのロードマップのどこに適合するかを判断するために調査中です。何か問題は発生していませんか？「 Jupyterのトラブルシューティングガイド 」を参照するか、 support@domo.com までお問い合わせください。このページのトップへ日本語