Databricksノートブックのインターフェイスとコントロール

Databricks ノートブックのツール バーとメニューを使用して、ノートブックとセルの表示設定を制御する方法について説明します。

ノートブック セル

ノートブックには、コード セルと Markdown セルの 2 種類のセルのコレクションが含まれています。 コード セルには実行可能なコードが含まれ、Markdown セルにはテキストとグラフィックスをレンダリングする Markdown コードが含まれています。 Markdown を使用して、コードの文書化やイラスト化を行うことができます。 ノートブックにセルを追加または削除して、作業を構成できます。

1 つのセル、セルのグループを実行することも、ノートブック全体を一度に実行することもできます。 ノートブック セルには最大 10 MB を含めることができ、その出力は 20 MB に制限されています。

Notebook のツール バーのアイコンとボタン

ツール バーには、ノートブックの管理と編集に使用できるメニューとアイコンが含まれています。

ノートブック名の横には、ノートブックの既定の言語を変更できるボタンがあり、ノートブックが Databricks Git フォルダーに含まれている場合は、Git ダイアログを開きます。

以前のバージョン のノートブックを表示するには、[最終編集]をクリックします。 メッセージをメニューの右側に表示します。

ツール バーの右側のアイコンとボタンを次の表に示します：

アイコン	説明
	すべてのセルを実行するか、実行を停止します。 このボタンの名前は、ノートブックの状態によって変わります。
	コンピューティング セレクターを開きます。 ノートブックがクラスターまたは SQL クラスターに接続されている場合、このボタンにはコンピューティング リソースの名前が表示されます。
	[ジョブ スケジューラ]を開きます。
	[Delta Live Tables] を開きます。 このボタンは、ノートブックが Delta Live Tables パイプラインの一部である場合にのみ表示されます。
	[アクセス許可ダイアログ] を開きます。

右サイドバーのアクション

次の表で説明するように、ノートブックの右サイドバーからいくつかのアクションを使用できます：

アイコン	説明
	[ノートブックのコメント] を開きます。
	[MLflow ノートブックの実験] を開きます。
	ノートブックのバージョン履歴を開きます。
	変数エクスプローラーを開きます。 (Databricks Runtime 12.2 LTS 以降で Python 変数に対して使用できます。)
	Python 環境パネルを開きます。 このパネルには、ノートブック スコープのライブラリ、クラスター ライブラリ、Databricks Runtime に含まれるライブラリなど、ノートブックで使用できるすべての Python ライブラリが表示されます。 ノートブックがクラスターにアタッチされている場合にのみ使用できます。

セルを作成する

ノートブックには、コードと Markdown の 2 種類のセルがあります。 Markdown セルのコンテンツは HTML にレンダリングされます。 たとえば、このスニペットの中にあるマークアップはレベル 1 の見出しを表します。

%md ### Libraries
Import the necessary libraries.

次のようにレンダリングされます。

新しいセルを作成するには、上部または下部にあるセルにカーソルを合わせます。 [コード] または [テキスト] をクリックします。それぞれコード セルまたは Markdown セルを作成します。

セル アクション

セルの操作メニューを使用すると、セルの実行や切り取りとコピー、ノートブック内のセルの移動、コードや結果の非表示を行うことができます。

セルを実行する

コード セルを実行するには、コード セルの左上にある下矢印をクリックします。

セルが実行されると、セルの実行メニューの右側に通知が表示され、最後にセルが実行された時刻と実行時間が表示されます。 通知にカーソルを合わせると、詳細が表示されます。

既定で詳細な実行情報を表示するには、右上にある自分のプロファイル画像をクリックします。 次に、[設定]>[開発者]>[詳細なコマンド実行情報を表示する] をクリックします。

表形式で結果を出力している場合、この情報には、UI の "最終更新" セクションにマウス ポインターを置いてもアクセスできます。

セル アイコン

次のスクリーンショットは、ノートブック セルの右上に表示されるアイコンを示しています。

言語セレクター: セルの言語を選択します。

Databricks アシスタント: Databricks アシスタントのセル内のコードの提案を有効または無効にします。

セルのフォーカス: セルを拡大して編集しやすくします。

セルの操作メニューの表示: セルの操作メニューを開きます。 このメニューのオプションは、コード セルと Markdown セルで若干異なります。

セルを削除する

セルを削除するには、セルの右側にあるごみ箱アイコンをクリックします。 このアイコンは、セルにカーソルを合わせると表示されます。

セルを移動する

セルを上下に移動するには、セルの左にあるドラッグ ハンドル アイコン をクリックしたままにします。

セルの操作メニューから [上へ移動] または [下へ移動] を選択することもできます。

セルの切り取り、コピー、貼り付け

セルの切り取りとコピーには、いくつかのオプションがあります。 ただし、Safari ブラウザーを使用している場合は、使用できるのはキーボード ショートカットのみです。

• セルの操作メニューから、[セルの切り取り] または [セルのコピー] を選択します。
• キーボード ショートカットを使用します。Command-X または Ctrl-X で切り取り、Command-C または Ctrl-C でコピーします。
• ノートブックの上部にある [編集] メニューを使用します。 [切り取り] または [コピー] を選択します。

セルを切り取ったりコピーしたりした後は、ノートブック内の別の場所、別のノートブック、または別のブラウザー タブまたはウィンドウ内のノートブックに、それらのセルを貼り付けることができます。 セルを貼り付けるには、キーボード ショートカット Command-V または Ctrl-V を使用します。 セルは現在のセルの下に貼り付けられます。

切り取りまたは貼り付け操作を元に戻すには、キーボード ショートカットの Command-Z または Ctrl-Z を使用するか、メニュー オプション [編集] > [セルの切り取りを元に戻す] または [編集] > [セルの貼り付けを元に戻す] を使用します。

隣接するセルを選択するには、Markdown セルをクリックし、[Shift] + [Up] または [Down] を使用してその上または下のセルを選択します。 選択したセルをグループとしてコピー、切り取り、貼り付け、または削除するには、編集メニューを使用します。 すべてのセルを選択するには、[編集] > [すべてのセルを選択] を選択するか、コマンド モード ショートカット Cmd + A を使用します。

Databricks アシスタントを開く

セルで Databricks アシスタント テキスト ボックスを開くには、セルの右上隅にある Databricks アシスタント アイコン をクリックします。

コード セルでこれを使用して、コードのヘルプや提案を取得できます。 Databricks アシスタントはワークスペースで有効になっている必要があります。

コード コメントの追加

セル内のコードにコメントを追加するには、コードを強調表示します。 セルの右側に、コメント アイコンが表示されます。 アイコンをクリックしてコメント ボックスを開きます。

ダッシュボードにセルを追加する

Markdown セルまたは表形式の結果を含むセルをダッシュボードに追加するには、セルの操作メニューから [ダッシュボードに追加] を選択します。 詳細については、「ノートブック内のダッシュボード」を参照してください。

セルへのリンク

ノートブック内の特定のコマンドへの URL リンクを取得するには、 をクリックしてフォーカス モードを開き、ブラウザーのアドレス バーから URL をコピーします。 フォーカス モードを終了するには、 をクリックします。

Notebookの目次

自動的に生成された目次を表示するには、ノートブックの左上にあるアイコン (サイド バーと一番上のセルの間) をクリックします。 目次は、ノートブック内で使用されている Markdown 見出しから生成されます。 タイトルを含むセルも目次に表示されます。

セルのタイトルを追加する

セルにタイトルを追加するには、次のいずれかを行います。

• セルの上部の中央のセル番号をクリックし、タイトルを入力します。
• セルの操作メニューから [タイトルの追加] を選択します。

タイトルを含むセルが、ノートブックの目次に表示されます。

昇格されたセルのタイトル

UI でセル タイトルを目立たせるには、ユーザーは昇格されたセル タイトルの表示を有効にします。

1. 任意のページで、右上隅にあるプロファイルの画像をクリックし、次に[設定]をクリックします。
2. [デベロッパー] をクリック > [昇格されたセル タイトルの表示] を有効にします。

セルの内容の非表示と表示

セルの内容は、セル コードと、そのセルを実行した結果で構成されます。 セルのコードまたは結果を非表示にするには、セルの右上にあるケバブ メニュー をクリックし、[コードの非表示] または [結果の非表示] を選択します。

[セルを折りたたむ] を選択して、セルの最初の行のみを表示することもできます。 折りたたんだセルを展開するには、[セルの展開] を選択します。

非表示のセルを表示するには、表示アイコン をクリックします。

折りたたみ可能な見出し

セルの中に Markdown 見出しがある場合に、その後に表示されるセルを折りたたんで見出しセルに入れることができます。 Markdown 見出しが含まれているセルに続くセルの展開または折りたたみをノートブック全体で同時に行うには、[表示] メニューで [すべての見出しを展開] を選択します。 このセクションの残りの部分では、セルのサブセットを展開または折りたたむ方法について説明します。

見出しの展開と折りたたみ

次の図は、レベル 2 の見出し MLflow setup と、その中に折りたたまれた次の 2 つのセルを示しています。

見出しを展開または折りたたむには、Markdown セルにカーソルを合わせます。 セルの左側に表示される矢印をクリックします。

セルの表示オプション

ノートブックの表示方法は 3 つあります。 [表示] メニューを使用して、表示オプションを変更します。

• 標準ビュー: 結果はコード セルの直後に表示されます。
• 結果のみ: 結果だけが表示されます。
• 並べて表示: コードのセルが左、結果のセルが右となるように並べて表示されます

セルの余白 (セルの左右の領域) のアイコンから操作を実行できます。 たとえば、グリップ ドットを使用して左の余白でセルを上下に移動 します。 セルを削除するには、右側の余白にあるごみ箱アイコンを使用します。

簡単に編集するには、フォーカス モード アイコン をクリックして、セルを全幅で表示します。 フォーカス モードを終了するには、 をクリックします。 また、[表示] > [中央揃えのレイアウト] をオフにして、セルの表示幅拡大することもできます。

ノートブック内のすべてのセルを業界標準の行の長さと間隔に自動的に書式設定するには、[編集] > [ノートブックを書式設定する] を選択します。

セル余白の削除

ノートブック メニューで [表示] > [ノートブック レイアウト] をクリックすると、余白を拡大または最小化できます。

行番号とコマンド番号

行番号またはコマンド番号を表示または非表示にするには、[表示] メニューから [行番号] または [コマンド番号] を選択します。 行番号を表示するには、キーボード ショートカット Control + L を使用することもできます。 セルがエラー状態の場合、選択内容に関係なく行番号が表示されます。

行番号やコマンド番号を有効にすると、その設定が Databricks に保存され、そのブラウザーの他のすべてのノートブックでも表示されるようになります。

行の折り返し

ノートブックのセルで行の折り返しを有効または無効にでき、テキストを折り返して複数の行にするか、水平スクロール付きの 1 行のままにすることができます。

1. 任意のページで、右上隅にあるプロファイルの画像をクリックし、次に[設定]をクリックします。
2. [開発者設定]>[行を折り返す] をクリックします。

ノートブックをダーク モードで表示する

ノートブックをダーク モードで表示することもできます。 ダーク モードのオンとオフを切り替えるには、[表示] > [テーマ] を選択し、[ライト テーマ] または [ダーク テーマ] を選択します。

行番号やコマンド番号を有効にすると、その設定が Databricks に保存され、そのブラウザーの他のノートブックでも表示されるようになります。

データを参照する

重要

この機能はパブリック プレビュー段階にあります。

ノートブックで使用できるテーブルとボリュームを調べるには、ノートブックの左側にある をクリックして、スキーマ ブラウザーを開きます。 詳しくは、「データを参照する」をご覧ください。

Web ターミナルと Databricks CLI を使用する

ノートブックで Web ターミナルを開くには、右側のサイドバーの下部にある [] をクリックします。

Web ターミナルで Databricks CLI を使用する

Databricks Runtime 15.0 以降では、ノートブックの Web ターミナルから Databricks CLI を使用できます。

要件

• ノートブックは、シングル ユーザーまたは非分離共有アクセス モードでクラスターに接続する必要があります。
• CLI は、Private Link に対して有効になっているワークスペースでは使用できません。

インストールされている CLI は常に最新バージョンです。 認証は現在のユーザーに基づいています。

ノートブック セルから CLI を使用することはできません。 ノートブックでは、%sh databricks ... などのコマンドは、Databricks Runtime 15.0 以降では機能しません。