環境管理¶
このページでは、ノートブック環境を設定して開始する方法の概要を説明します。
ノートブック環境の管理¶
コードを作成して実行する前に、環境アイコンをクリックしてノートブックの環境を設定します。 環境イメージは、ノートブック内で使用されるコーディング言語、依存関係、およびオープンソースライブラリを決定します。 DataRobot Notebooksのデフォルトイメージは、事前に構築済みのPythonイメージです。 デフォルトイメージで利用可能なすべてのパッケージのリストを表示するには、環境タブでそのイメージにカーソルを合わせます。
次のスクリーンショットと表は、ノートブック環境で使用可能な設定オプションの概要を示しています。
要素 | 説明 | |
---|---|---|
1 | 開始環境のトグル | ノートブック環境のカーネルを開始または停止し、これによりノートブックのコードセルを実行できます。 |
2 | リソースタイプ | マシンプリセットを表すもので、環境のカーネルを実行するマシン上にあるCPUとRAMを指定します。 |
3 | 環境 | ノートブックで使用するコーディング言語とそれに関連するライブラリを決定します。 |
4 | ランタイム | アクティブなセッション中のノートブック環境のCPU使用率、RAM使用量、および経過したランタイムを示します。 |
5 | セッションタイムアウト | 環境の実行が停止し、ベースとなるマシンがシャットダウンするまでの非アクティブ時間を制限します。 非アクティブ時のデフォルトのタイムアウトは60分で、設定可能な最大タイムアウトは180分です。 |
ノートブックセッションを開始して、そこでコードを作成して実行するには、ツールバーで環境をオンにして起動します。
環境が初期化されるまで少し待ってから、開始ステータスが表示されたら、編集を開始できます。
セッション中に、ノートブック環境の既存パッケージのいずれかをアップグレードし、アップグレードされたバージョンを認識したい場合は、カーネルを再起動する必要があります。 そのためには、ツールバーの丸い矢印アイコンをクリックします。
カーネルの再起動は、以下のように、環境セッションの再起動とは異なることに注意してください。環境セッションを停止(セッショントグルを使用)すると、ノートブックが実行中のコンテナが停止します。 次回セッションを開始すると、新規コンテナがスピンアップするため、ノートブックの状態と実行時にインストールされたパッケージは失われます。
非アクティブ状態でタイムアウトに達すると、自動的にシャットダウンされることに注意してください。 ノートブックに実行中のセルがなく、セッションタイムアウト値によって設定された時間内にノートブックの内容が変更されていない場合、セッションは非アクティブと見なされます。
カスタム環境のイメージ¶
DataRobot NotebooksはDataRobotのカスタム環境と連携しており、ノートブックセッションを実行するための再利用可能なカスタムDockerイメージを定義できます。 ノートブックセッションで使用するカスタム環境を作成することで、環境を完全に制御したり、ビルトインイメージで利用可能なもの以外にも再現可能な依存関係を活用したりすることができます。
本機能の提供について
ノートブックのカスタム環境は、デフォルトではオフになっています。 この機能を有効にする方法については、DataRobotの担当者または管理者にお問い合わせください。
機能フラグ:Notebooksでカスタム環境を有効にする
カスタム環境の作成¶
カスタム環境を作成する場合、DataRobot NotebooksではPythonとRのカスタム環境のみがサポートされていることに注意してください。 さらに、環境タイプフィールドでNotebooksオプションを選択して、DataRobot Notebooksでその環境が使用されるようにします。
DataRobotでは、 ノートブック組み込み環境テンプレートにアクセスして、DataRobot Notebooksの実行と互換性のあるDockerコンテキストの作成に必要な要件を参照することを強くお勧めします。
カスタム環境を作成した後、現在のノートブックタブをクリックすると、ノートブックのコンテナイメージとしてカスタム環境のバージョンを使用するように設定されているDataRobotのノートブックのリストを表示できます。
ノートブックセッションにカスタム環境を使用する¶
ノートブックコンテナセッションで実行するイメージとしてカスタム環境を使用するには、使用するノートブックを開き、ノートブックサイドバーの環境タブ()に移動します。
環境フィールドのドロップダウンには、DataRobot Notebooksと互換性のある、アクセス可能なすべてのカスタム環境が表示されます。 使用したいカスタム環境を選択します。 バージョンフィールドでは、使用する環境のバージョンを選択できます。 デフォルトでは、最新バージョンの環境が選択されます。 環境を選択したら、ノートブックセッションを開始できます。
組み込み環境のイメージ¶
DataRobotでは、特定のノートブックのコンテナイメージとして選択できる組み込みのDockerイメージのセットが維持されます。
DataRobotは以下のイメージを提供します。
-
Python 3.9のイメージ:Pythonバージョン3.9、 DataRobot Pythonクライアント、および一般的なデータサイエンスライブラリのスイートが含まれています。
-
Python 3.8のイメージ:Pythonバージョン3.8、DataRobot Pythonクライアント、および一般的なデータサイエンスライブラリのスイートが含まれています。 これまでは、一部の付属ライブラリSnowflake Python ConnectorおよびSnowparkがPython 3.8を必要としていたため、このイメージはSnowflakeを使用する上で必要でした。これらのライブラリは新しいバージョンのPythonに対応するようになったため、このイメージは使用非推奨とされています。
-
R 4.3のイメージ:Rバージョン4.3、 DataRobot Rクライアント、および一般的なデータサイエンスライブラリのスイートが含まれています。
環境変数¶
機微情報である文字列をノートブック内にプレーンテキストで保存せずに、ノートブック内で参照する必要がある場合は、環境変数を使用して値を安全に保存できます。 これらの値はDataRobotによって暗号化されて保存されます。 環境変数は、ノートブック内の外部データソースに接続するための資格情報を指定する必要がある場合などに便利です。
ノートブックセッションを開始するたびに、DataRobotはコンテナ環境でノートブックの関連する環境変数を設定するため、次のコードを使用してノートブックコードから参照できます。
import os
KEY = os.environ['KEY'] # KEY variable now references your VALUE
KEY = Sys.getenv("KEY")
環境変数にアクセスするには、サイドバーのロックアイコンをクリックします。
新しいエントリーを作成をクリックします。
ダイアログボックスで、1つのエントリーにキーと値を入力し、オプションの説明を入力します。
複数の変数を追加する場合は、一括インポートを選択します。 フィールドの各行で次の形式を使用します。
KEY=VALUE # DESCRIPTION
備考
同じキーを持つ既存の環境変数の値は、指定した新しい値によって上書きされます。
環境変数の追加が完了したら、保存をクリックします。
既存の変数の編集¶
環境変数パネルからノートブックの関連する環境変数を編集および削除することもできます。
- 変数の鉛筆アイコンをクリックして、変数を編集します。
- 目のアイコンを選択すると、非表示の値が表示されます。
- ゴミ箱アイコンをクリックすると変数が削除されます。
- すべて挿入をクリックして、ノートブックのすべての環境変数を取得してノートブックに含めるコードスニペットを挿入します。