Databricks ノートブックとファイル エディターの操作

このページでは、 Databricksダイアログボックスとファイルエディタを操作するのに役立つ機能について説明します。これには、キーボードショートカット、コードの候補表示とオートコンプリート、変数の検査、コードの折りたたみなどが含まれます。 ノートブックやファイルエディタを使用する際、Genie Code がコードの生成、説明、デバッグを支援します。詳細については、 「Genie Code のコーディング支援を受ける」をご覧ください。

エディターのテーマは複数の中から選択できます。 「表示」＞「エディターテーマ」 を選択し、メニューから選択してください。

編集モードとコマンドモード

Databricksノートブックには 2 つの対話モードがあります。

• カーソルがセル内にある場合、 編集モード が有効になります。このモードでは、セル内にコードやテキストを入力して編集できます。編集モードであることを示すために、セル内に点滅するカーソルが表示されます。セルをダブルクリックするか、 Enterを押すと、コマンドモードから編集モードに切り替わります。編集モードを終了するにはEscを押してください。
• セルが編集されていないときは、 コマンドモード が有効になります。このモードでは、細胞を単位として操作を行います。セルを選択、切り取り、コピー、貼り付け、削除、移動、並べ替えすることができます。編集モードからコマンドモードに切り替えるには、 Escを押してください。コマンドモードを終了するには、 Enterを押してください。

コマンド パレット

コマンドパレットを使用すると、ノートブック内で素早く操作を実行できます。ノートブック操作のペインを開くには、クリックします。ワークスペースの右下隅にあるアイコンをクリックするか、macOS の場合はショートカットキー Cmd + Shift + P 、Windows の場合は Ctrl + Shift + P を使用します。

セル実行ミニマップ

ノートブックの実行ステータスの概要を視覚的に把握するには、セル実行ミニマップを使用します。ミニマップは右余白に表示され、各実行可能セルのステータスバーが表示されます。

ステータスバーは、次の実行状態を示します。

• ライトグレー: セルは静的です。
• 濃い灰色: セルはスキップされるか、実行のためにキューに入れられます。
• 可動バー付きのライトグレー:セルは現在実行中です。
• 緑: セルはエラーなしで正常に実行されました。
• 赤: セルがエラーで失敗しました。

ミニマップを操作するには:

• ミニマップにカーソルを合わせると、実行可能セルのリスト、そのタイトル、および実行状態が表示されます。
• エントリをクリックすると、ノートブック内のそのセルに直接ジャンプします。
• [ 最後の実行セルに移動 ] または [ 最初に失敗したセルに移動 ] をクリックして、最後に実行されたセルまたは最初に失敗したセルに移動します。

ミニマップは、実行の進行状況を一目で追跡し、デバッグや開発中にすばやく移動するのに役立ちます。

テキストの検索と置換

ノートブック内のテキストを検索して置換するには、キーボードショートカットのCmd + F （Mac）またはCtrl + F （Windows）を使用するか、 [編集] > [検索...] をクリックして [検索] ダイアログを開きます。検索したいテキストを入力してください。現在進行中の試合はオレンジ色で、その他の試合は黄色でハイライト表示されています。組み込みブラウザ検索にアクセスするには、もう一度Cmd + F (Mac) またはCtrl + F ( Windows ) を押します。

をクリックして、[ 置換] オプションを開きます。代わりに使用するテキストを入力します。現在の一致を置き換えるには、[ 置換] をクリックします。ノートブック内のすべての一致を置き換えるには、[ すべて置換] をクリックします。

一致間を移動するには、[ ] (前の一致) または (次の一致) をクリックします。Shift + Enter と Enter を押して、それぞれ前と次の試合に移動することもできます。

検索と置換ツールを閉じるには、をクリックするか、 esc キーを押します。

変数検査

SQL または Python ノートブックで定義された変数に関する情報を表示するには、変数名の上にカーソルを置きます。 Python 変数の調査には、Databricks Runtime 12.2 LTS 以上が必要です。

変数エクスプローラーを参照してください。

定義に移動

Pythonノートブックをコンピュート リソースに接続すると、変数、関数、システム モジュール、または%runステートメントの背後にあるコードの定義にすぐに移動できます。

これを行うには、macOS では Cmd キー、Windows では Ctrl キーを押しながら、変数、関数名、またはシステム モジュールの上にマウスを置きます。定義が見つかった場合、名前はハイパーリンクに変わります。リンクをクリックすると定義にジャンプし、新しいタブで開く場合があります。右クリックして、 [定義へ移動] または [定義を プレビュー] をクリックすることもできます。

「定義へ移動」機能は、 Databricks Runtime 12.2 LTS以上およびサーバーレス環境 1 以上で利用できます。

コードの折りたたみ

コード フォールディングを使用すると、コードの一部を一時的に非表示にすることができます。 これは、長いコードブロックを操作するときに、作業中のコードの特定のセクションに集中できるため便利です。

コードを非表示にするには、セルの左端にカーソルを置きます。 下向きの矢印は、コードの一部を非表示にできる論理ポイントに表示されます。 矢印をクリックして、コードセクションを非表示にします。 矢印をもう一度クリック (右を指しています) をクリックして、コードを表示します。

キーボード ショートカットなどの詳細については、 VS Code のドキュメントを参照してください。

マルチカーソルのサポート

ビデオに示すように、複数のカーソルを作成して、同時編集を容易にすることができます。

1つのセルに複数のカーソルを作成するには：

• macOSでは、 Option キーを押しながら各場所をクリックしてカーソルを追加します。
• Windows では、 Alt キーを押しながら各場所をクリックしてカーソルを追加します。
• ショートカットを変更するオプションもあります。 マルチカーソルと列選択のショートカットを変更するを参照してください。

macOSでは、キーボードショートカットの Option+Command+上矢印キーまたは下矢印キーを使用して、垂直方向に揃えられた複数のカーソルを作成できます。

列 (ボックス) の選択

列内の複数のアイテムを選択するには、キャプチャする領域の左上にある をクリックします。 そうしたら：

• macOS では、 Shift + Option を押しながら右下にドラッグして、1 つ以上の列をキャプチャします。
• Windows では、 Shift + Alt を押しながら右下にドラッグして、1 つ以上の列をキャプチャします。
• ショートカットを変更するオプションもあります。 マルチカーソルと列選択のショートカットを変更するを参照してください。

マルチカーソルと列選択のショートカットを変更してください

別のショートカットは、マルチカーソルと列(ボックス)の選択に使用できます。 代替選択では、ショートカットは次のように変化します。

• 1つのセルに複数のカーソルを作成するには：

  • macOSでは、 Cmd キーを押しながら各場所をクリックしてカーソルを追加します。
  • Windows では、 Ctrl キーを押しながら各場所をクリックしてカーソルを追加します。

• 列内の複数のアイテムを選択するには、キャプチャする領域の左上にある をクリックします。 そうしたら：

  • macOS では、 Option キーを押しながら右下にドラッグして、1 つ以上の列をキャプチャします。
  • Windows では、 Alt キーを押しながら右下にドラッグして、1 つ以上の列をキャプチャします。

代替ショートカットを有効にするには、次の手順を実行します。

1. ワークスペースの右上にあるユーザー名をクリックし、ドロップダウンリストから 「設定」 をクリックします。
2. 設定 サイドバーで、 開発者 を選択します。
3. コード エディター セクションで、 マルチカーソル クリックのキー修飾子 設定をmacOS の場合は Cmd に、Windows の場合は Ctrl に変更します。

代替ショートカットを有効にしても、複数のカーソルを垂直方向に揃えるためのキーボードショートカットは変更されません。

データを参照

スキーマ ブラウザーを使用して、ノートブックで使用できる Unity Catalog オブジェクトを調べます。 ノートブックの左側にあるをクリックし、スキーマブラウザを開きます。

「For you 」ボタンには、現在のセッションで使用したオブジェクト、または以前にお気に入りとしてマークしたオブジェクトのみが表示されます。

フィルター ボックスにテキストを入力すると、表示が変わり、入力したテキストを含むオブジェクトのみが表示されます。現在開いているオブジェクト、または現在のセッション中に開かれたオブジェクトのみが表示されます。 フィルタ ボックスは、ノートブックで使用可能なカタログ、スキーマ、テーブル、ボリュームを完全に検索するわけではありません。

ケバブメニューを開くには、次に示すようにオブジェクトの名前にカーソルを合わせます。

オブジェクトがテーブルの場合は、次の操作を実行できます。

• セルを自動的に作成して実行し、テーブル内のデータのプレビューを表示します。テーブルのケバブメニューから「 新しいセルでプレビュー 」を選択します。
• カタログ、スキーマ、またはテーブルをカタログ エクスプローラで表示します。 ケバブメニューから「 カタログエクスプローラーで開く 」を選択します。 新しいタブが開き、選択したオブジェクトが表示されます。
• カタログ、スキーマ、またはテーブルへのパスを取得します。 オブジェクトのケバブメニューから コピー...パス を選択します。
• テーブルをお気に入りに追加します。 テーブルのケバブメニューから お気に入りに追加 を選択します。

オブジェクトがカタログ、スキーマ、またはボリュームの場合は、オブジェクトのパスをコピーするか、カタログエクスプローラーで開くことができます。

テーブル名または列名をセルに直接挿入するには、以下を実行します。

1. 名前を入力したい場所のセルでカーソルをクリックします。
2. スキーマブラウザでテーブル名または列名の上にカーソルを移動します。
3. オブジェクトの名前の右側に表示される二重矢印 をクリックします。

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

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

Databricks Runtime 15.0以降では、WebターミナルのDatabricks CLIをノートブックで使用できます。要件と使用方法については 、 Databricks Webターミナルの実行 シェル コマンド を参照してください。

ノートブックのセルからはCLIを使用できません。ノートブックでは、 %sh databricks ...のようなコマンドは Databricks Runtime 15.0 以降では動作しません。

パーソナライズされたオートコンプリート

オートコンプリートは、コードセグメントを入力すると自動的に入力します。完成可能なオブジェクトには、型、クラス、オブジェクトのほか、SQL データベース、テーブル名、構造体、マップ、配列、 クエリ スニペットが含まれます。SELECT *を使用する共通テーブル式 (CTE) を参照する場合、オートコンプリートは、基になるテーブル構造に基づいて列の推奨事項を提供します。Databricks は、Unity Catalog のメタデータと使用状況を使用して、提案をパーソナライズします。

• Pythonセルの場合、オートコンプリートを機能させるにはノートブックをコンピュート リソースにアタッチする必要があり、コンプリート オブジェクトを定義するすべてのセルを実行する必要があります。
• SQLセルの場合、ノートブックがコンピュート リソースに接続されていない場合でも、オートコンプリートはキーワードと基本構文を提案します。
  • ワークスペースが Unity Catalog で有効になっている場合、オートコンプリートでは、Unity Catalog 内のテーブルのカタログ名、スキーマ名、テーブル名、および列名も提案されます。
  • ワークスペースがUnity Catalogに対して有効になっていない場合は、テーブル名または列名を提案するために、ノートブックを汎用コンピュート リソースまたはSQLウェアハウスに接続する必要があります。

オートコンプリートの候補は、セルに入力すると自動的に表示されます。 上矢印キーと下矢印キー、またはマウスを使用して候補を選択し、 タブ または Enter キーを押して選択内容をセルに挿入します。

注記

R ノートブックのサーバー オートコンプリートは、コマンドの実行中にブロックされます。

オートコンプリートはデフォルトで有効になっていますが、 ユーザー設定で無効にすることができます。

• オートコンプリートの候補をオフにするには、 入力時にオートコンプリート を切り替えます。 オートコンプリートがオフの場合、 Ctrl + Space を押すとオートコンプリートの候補を表示できます。
• Enter キーがオートコンプリート候補を挿入しないようにするには、 Enter キーでオートコンプリート候補を受け入れます を切り替えます。

ブラケットのマッチング

括弧、角括弧、または中括弧の近くをクリックすると、その文字とそれに対応する括弧がハイライト表示されます。

Python エラーの強調表示

パートナーによる AI 機能が有効になっているワークスペースでは、AI による提案のために 「アシスタントで修正」 を選択することもできます。

Databricks ノートブックでは、次のエラーの強調表示がサポートされています。

• Python構文エラーの強調表示 ：Pythonコードセル内の構文エラーは赤色で強調表示されます。可能であれば、Genie Codeは迅速な解決策を提案します。これは、 Databricks Runtime 12.1 以降を実行するコンピュート、またはサーバレス コンピュートでサポートされています。 構文エラーの強調表示は、 pyproject.tomlファイルで設定できます。Pythonの構文強調表示の設定を参照してください。
• Python 形式のエラーの強調表示 : Python コードの書式設定のエラーと警告は、重大度に応じて黄色または赤で下線が引かれます。これは、予期しないインデント、長い行の長さなどの書式設定の問題を特定するのに役立ちます。構文の警告にカーソルを合わせると、詳細情報が表示されます。これは、 Databricks Runtime 12.1 以降を実行しているコンピュート、またはサーバレス コンピュートでサポートされています。
• Python の型エラーの強調表示 : 型チェックにより、Python プロジェクトと PySpark プロジェクトのコードの品質、読みやすさ、保守性を向上させることができます。型チェッカーは、コードが実行される前に、存在しない属性、欠落している引数、および関数呼び出しの不一致に関連するエラーにフラグを立てることができます。強調表示された警告にカーソルを合わせると、詳細情報が表示されます。これは、 Databricks Runtime 16.0 以降を実行しているコンピュート、またはサーバレス環境 2 でサポートされています。

Python エラーの強調表示を有効にする

エラー表示をオンまたはオフにするには、次の手順を実行します。

1. ワークスペースの右上にあるユーザー名をクリックし、ドロップダウンリストから 「設定」 をクリックします。
2. 設定 サイドバーで、 開発者 を選択します。
3. Python 構文エラーの強調表示 ( コード エディター の下)、 Python 形式のエラーの強調表示 ( 実験的な機能 の下)、 Python タイプのエラーの強調表示 ( 実験的な機能 の下) の設定を切り替えます。

Python 構文の強調表示を構成する

ノートブックがDatabricks Runtime 16.4 以降またはサーバレス環境バージョン 3 以降を実行しているコンピュートに接続されている場合、 pyproject.tomlファイルを作成することで構文の強調表示の動作をカスタマイズできます。 特定のノートブックに対して、ワークスペースファイルシステム内のその直接の祖先パスにある最も近いpyproject.tomlファイルが使用されます。祖先パスでファイルが見つからない場合は、現在のユーザーのホームプラン内のpyproject.tomlファイルが使用されます。

例えば、パスがa/b/c/d/notebook.pyのノートブックがあり、 a/b/pyproject.tomlとa/b/c/pyproject.tomlにpyproject.tomlファイルがある場合、2番目のファイルの方が近いため、そちらが使用されます。/a/b/c/e/pyproject.tomlにあるpyproject.tomlファイルは、 直接の 祖先パスにないため考慮されません。

Databricks では、 pyproject.toml ファイルに標準構文を使用します。たとえば、 Ruff のドキュメント を参照して、 pyproject.toml ファイルを使用して Ruff linter を構成する方法を確認できます。

現在、Databricks は、pyproject.tomlによるリンティングの ruff、 pylint、 pyright 、 flake8 の構成のみをサポートしています。

リンターを有効にするには、 pyproject.tomlファイルに[tool.<name-of-linter>]ブロックが必要です。

リンターを明示的に無効にするには、次のブロックを追加します。

Toml

[tool.<name-of-linter>]
disabled=true

Databricks で記述された構文強調表示ルールを、次のようなブロックで無効にすることもできます。

Toml

[tool.databricks]
disabled_rules = ['DB01', 'DB03']

Flake8 は異なる形式の設定を期待しているため、Flake8 の設定を文字列として渡す必要があります。

Toml

[tool.flake8]
config = """ \
[flake8] \
extend_ignore = E303 \
"""

SQLフォーマットのカスタマイズ

新しいSQLエディタとノートブックエディタでは、SQLの書式設定をカスタマイズできます。 「表示」＞「開発者向け設定」 をクリックします。 SQLフォーマット までスクロールダウンして、設定を指定してください。

キーボードショートカットを使用する

キーボードショートカットを表示するには、 「ヘルプ」>「キーボードショートカット」 を選択します。使用できるキーボードショートカットは、カーソルがコードセルにあるか（編集モード）、そうでないか（コマンドモード）によって異なります。

以下の表は、使用可能なキーボードショートカットを示しています。

編集モードのショートカット

関数	MacOSショートカット	Windows ショートカット
[コマンド] モードに切り替え	Esc	Esc
コマンドを実行して新規セルを下に挿入	Option + Enter	Alt + Enter
上にセルを挿入	Ctrl + Option + P	Ctrl + Alt + P
下にセルを挿入	Ctrl + Option + N	Ctrl + Alt + N
前/次のセルに移動	Option + Up/Down	Alt + Up/Down
カーソル位置でセルを分割	Ctrl + Option + -	Ctrl + Alt + -
現在の行を削除	⌘ + Shift + K	Ctrl + Shift + K
現在のセルを削除	Ctrl + Option + D	Ctrl + Alt + D
上または前のセルに移動	Up	Up
下または次のセルに移動	Down	Down
オートコンプリート	Ctrl + Space	Ctrl + Space
自動アシスタントによるオートコンプリート	Ctrl + Shift + Space	Ctrl + Shift + Space
インラインアシスタント	⌘ + I	Ctrl + I
パラメーターのヒント	⌘ + Shift + Space	Ctrl + Shift + Space
Docstring	⌘ + (K, I)	Ctrl + (K, I)
複数のカーソル	Option + Click	Alt + Click
列 (ボックス) 選択	Option + Shift + Drag	Alt + Shift + Drag
インデント/インデント解除の選択	⌘ + ]/[	Ctrl + ]/[
入力を取り消し	⌘ + Z	Ctrl + Z
変更を取り消し	⌘ + Shift + Z	Ctrl + Shift + Z
行コメントの切り替え	⌘ + /	Ctrl + /
行コメントを追加	⌘ + (K, C)	Ctrl + (K, C)
行コメントを削除	⌘ + (K, U)	Ctrl + (K, U)
マルチカーソル編集	⌘ + Option + Up/Down	Ctrl + Option + Up/Down
フォントサイズを拡大	Option + +	Alt + +
フォントサイズを縮小	Option + -	Alt + -

コマンドモードのショートカット

関数	Mac OS のショートカット	Windows ショートカット
[編集] モードに切り替え	Enter	Enter
選択したセルの実行をキャンセル	I, I	I, I
実行をキャンセル (プロンプトは省略)	Shift + (I, I)	Shift + (I, I)
現在のセルを削除	D, D	D, D
現在のセルを削除 (プロンプトは省略)	Shift + (D, D)	Shift + (D, D)
最初のセルに移動	G, G	G, G
最後のセルに移動	Shift + G	Shift + G
セルの切り取り/削除を元に戻す	⌘ + Z/Z	Ctrl + Z/Z
現在のセルをコピー	⌘ + C	Ctrl + C
現在のセルを切り取り	⌘ + X	Ctrl + X
セルを貼り付け	⌘ + V	Ctrl + V
上にセルを挿入	A	A
下にセルを挿入	B	B
セルの出力を切り替え	O	O
セルのタイトルの切り替え	T	T
下にスクロール	Space	Space
上にスクロール	Shift + Space	Shift + Space
キーボードショートカットメニューを切り替える	H	H
下のセルとマージ	Shift + M	Shift + M
前のセルに移動	Up/P/K	Up/P/K
次のセルに移動	Down/N/J	Down/N/J
隣接セルを選択範囲に追加	Shift + Up/Down	Shift + Up/Down
すべてのセルを選択	⌘ + A	Ctrl + A
複数セルを選択	⌘ + Click	Ctrl + Click
行番号の切り替え	L	L
セル見出しを展開/折りたたむ	Right/Left	Right/Left

共有ショートカット

関数	MacOSショートカット	Windows ショートカット
コマンドパレットを切り替える	⌘ + Shift + P	Ctrl + Shift + P
検索	⌘ + F	Ctrl + F
以下の通り置き換えます。	Ctrl + Option + F	Ctrl + Alt + F
コードをフォーマット	⌘ + Shift + F	Ctrl + Shift + F
コマンドを実行して次のセルに移動	Shift + Enter	Shift + Enter
選択済みコマンドを実行する	⌘ + Enter	Ctrl + Enter
セルをデバッグ	Option + Shift + D	Alt + Shift + D
デバッガー：続行	F7	F7
デバッガー：次の行	F8	F8
デバッガー：ステップイン	F9	F9
デバッガー：ステップアウト	Shift + F9	Shift + F9
すべてのコマンドを実行する	Option + Shift + Enter	Alt + Shift + Enter
上のコマンドをすべて実行（このセルは含まない）	Option + Shift + Up	Alt + Shift + Up
以下のすべてのコマンドを実行	Option + Shift + Down	Alt + Shift + Down
状態と出力をクリア	0, 0	0, 0
選択したテキストまたはアクティブなステートメントを実行する	Ctrl + Shift + Enter	Ctrl + Shift + Enter
アクティブなSQLステートメントを実行	⌘ + Shift + Enter	Ctrl + Shift + Enter
上にセルを移動	Ctrl + Option + Up	Ctrl + Alt + Up
下にセルを移動	Ctrl + Option + Down	Ctrl + Alt + Down
コメントパネルを切り替え/コメントを追加	Ctrl + Option + M	Ctrl + Alt + M
ワークスペースパネルを切り替え	Ctrl + Option + E	Ctrl + Alt + E
カタログパネルを切り替え	Ctrl + Option + C	Ctrl + Alt + C
アシスタントパネルを切り替え	Ctrl + Option + A	Ctrl + Alt + A
フォーカスモードを切り替え	Ctrl + Option + O	Ctrl + Alt + O
現在のタブを閉じる	Ctrl + Option + W	Ctrl + Alt + W
新しいタブを作成	Ctrl + Option + T	Ctrl + Alt + T
左のタブに切り替え	Ctrl + Option + Left	Ctrl + Alt + Left
右のタブに切り替え	Ctrl + Option + Right	Ctrl + Alt + Right
すべてのタブを閉じる	Ctrl + Option + Shift + A	Ctrl + Alt + Shift + A