Amazon
Web Services
Microsoft Azure
Google Cloud PlatformDatabricksノートブックのインターフェイスと操作
Databricks ノートブックのツールバーとメニューを使用して、ノートブックとセルの表示設定を制御する方法を学習します。
ノートブックのセル
ノートブックには、コード セルと Markdown セルの 2 種類のセルのコレクションが含まれています。 コード セルには実行可能なコードが含まれ、Markdown セルにはテキストとグラフィックスをレンダリングする Markdown コードが含まれます。 Markdown は、コードを文書化または説明するために使用できます。 ノートブックにセルを追加したり削除したりして、作業を構造化することができます。
単一のセル、セルのグループ、またはノートブック全体を一度に実行できます。 ノートブック セルには最大 10 MB を保存でき、出力は 20 MB に制限されます。
ノートブックのツールバーのアイコンとボタン
ツールバーには、ノートブックの管理と編集に使用できるメニューとアイコンが含まれています。
ノートブック名の横には、ノートブックのデフォルト言語を変更できるボタンがあります。ノートブックが 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 Assistant : セル内のコード候補の Databricks Assistant を有効または無効にします。
セルフォーカス: セルを拡大して編集しやすくします。
セルアクションメニューの表示: セルのアクションメニューを開きます。 このメニューのオプションは、コードセルとMarkdownセルで若干異なります。
セルの移動
セルを上下に移動するには、セルの左側 ![[セルの移動] アイコン](../_images/move-cell-icon.png){kind=icon}
にあるドラッグハンドルアイコンをクリックしたままにします。
また、セルのアクションメニューから「 上に移動」または「 下に移動 」を選択することもできます。
セルの切り取り、コピー、貼り付け
セルの切り取りとコピーにはいくつかのオプションがあります。 ただし、Safariブラウザを使用している場合は、キーボードショートカットのみを使用できます。
セルアクションメニューから、「 セルをカット」 または 「セルをコピー」を選択します。
キーボードショートカットを使用する：
Command-XまたはCtrl-Xで切り取り、Command-CまたはCtrl-Cでコピーします。ノートブックの上部にある「編集」メニューを使用します。「切り取り」または「コピー」を選択します。
セルを切り取ったりコピーしたりした後、そのセルをノートブック内の別の場所、別のノートブック、または別のブラウザ タブやウィンドウ内のノートブックに貼り付けることができます。 セルを貼り付けるには、キーボード ショートカットの Command-V または Ctrl-Vを使用します。 セルは現在のセルの下に貼り付けられます。
切り取りまたは貼り付けの操作を元に戻すには、キーボード ショートカットの Command-Z または Ctrl-Z、またはメニュー オプションの [編集] > [取り取りセルを元に戻す] または [編集] > [貼り付けたセルを元に戻す] を使用します。
隣接するセルを選択するには、Markdownセルをクリックし、Shift + UpまたはDownを使用して、その上または下のセルを選択します。編集メニューを使用して、選択したセルをグループとしてコピー、カット、ペースト、削除できます。すべてのセルを選択するには、「編集」>「すべてのセルを選択」を選択するか、コマンドモードのショートカットCmd+Aを使用します。
Databricks Assistantを開く
セル内にDatabricks Assistantテキストボックスを開くには、Databricks Assistantアイコンをクリックします。
セルの右上隅にあります。
コード セルでこれを使用して、コードに関するヘルプや提案を得ることができます。 ワークスペースで Databricks Assistant を有効にする必要があります。
ダッシュボードへのセルの追加
Markdown セルまたは表形式の結果を持つセルをダッシュボードに追加するには、セル アクション メニューから [ ダッシュボードに追加 ] を選択します。 詳細については、「 ノートブックのダッシュボード」を参照してください。
ノートブックの目次
自動的に生成された目次を表示するには、ノートブックの左上 (左サイドバーと一番上のセルの間) にあるアイコンをクリックします。 目次は、ノートブックで使用される Markdown 見出しから生成されます。 タイトル付きのセルは、目次にも表示されます。
セルのタイトルを追加する
セルにタイトルを追加するには、次のいずれかの操作を行います。
セルの上部の中央にあるセル番号をクリックし、タイトルを入力します。
セルの操作メニューから [ タイトルの追加 ] を選択します。
タイトルのあるセルはノートブックの目次に表示されます。
セルの内容の非表示と表示
セルの内容は、セルコードとセルの実行結果で構成されます。 セルコードまたは結果を非表示にするには、セルの右上にあるケバブメニュー 
をクリックし、「 コードを隠す」 または 「結果を隠す」を選択します。
[ セルを折りたたむ ] を選択して、セルの最初の行のみを表示することもできます。 折りたたまれたセルを展開するには、 セルの展開 を選択します。
非表示のセルを表示するには、表示アイコン 
をクリックします。
折りたたみ可能な見出し
Markdown 見出しを含むセルの後に表示されるセルは、見出しセルに折りたたむことができます。 ノートブック全体で Markdown 見出しを含むセルの後のセルを展開または折りたたむには、[表示] メニューの [すべての見出しを折りたたむ] を選択します。このセクションの残りの部分では、セルのサブセットを展開または折りたたむ方法について説明します。
セルの表示オプション
ノートブックには 3 つの表示オプションがあります。 [ 表示 ] メニューを使用して、表示オプションを変更します。
標準ビュー：結果がコードセルの直後に表示されます。
結果のみ：結果のみが表示されます。
横に並べて表示：コードと結果のセルが並べて表示されます。
アクションは、セルの余白 (セルの左右の領域) のアイコンから使用できます。 たとえば、グリップドットを使用してセルを上下に動かします。左の余白のセル アイコンを移動します 。 セルを削除するには、右側のとじしろにあるごみ箱アイコンを使用します。
編集を容易にするには、フォーカスモードアイコン 
をクリックして、セルを全幅で表示します。 フォーカスモードを終了するには、 
をクリックします 。 また、[ 表示] > [中央揃えレイアウト] をオフにして、セルの表示幅を拡大することもできます。
ノートブック内のすべてのセルを業界標準の行の長さと間隔に合わせて自動的に書式設定するには、[ノートブックの編集] > [ 書式設定] を選択します。
行番号とコマンド番号
行番号やコマンド番号の表示・非表示を切り替えるには、「表示」メニューから「行番号」または「コマンド番号」を選択します。 行番号については、キーボードショートカットの Control + Lを使用することもできます。 セルがエラー状態の場合は、選択内容に関係なく行番号が表示されます。
行番号またはコマンド番号を有効にすると、Databricksによって設定が保存され、そのブラウザでは他のすべてのノートブックでも表示されるようになります。
ラインラッピング
ノートブックのセルで行の折り返しを有効または無効にして、テキストを複数行に折り返すか、水平スクロールで 1 行に残すことができます。
任意のページの右上で、プロフィール写真をクリックし、[ 設定]をクリックします。
[開発者設定] > [明細行の折り返し] をクリックします。
ノートブックをダークモードで表示する
ノートブックをダークモードで表示することもできます。ダークモードをオンまたはオフにするには、「表示」>「テーマ」を選択し、「ライトテーマ」または「ダークテーマ」を選択します。
ブラウザーの行またはコマンド番号を入力すると、Databricks によって設定が保存され、そのブラウザーの他のノートブックに表示されます。
データを閲覧する
プレビュー
この機能はパブリックプレビュー段階です。
ノートブックで使用できるテーブルとボリュームを調べるには、
ノートブックの左側にある をクリックして、スキーマ ブラウザーを開きます。 詳細については、「 データの参照 」を参照してください。
をクリックします。