Databricks ノートブックとファイルエディターを使用する

このページでは、コードの提案とオートコンプリート、変数の検査、コードの折りたたみ、サイドバイサイドの差分など、Databricks ノートブックとファイルエディターで使用できるいくつかの機能について説明します。ノートブックまたはファイルエディターを使用する場合、コードの生成、説明、デバッグに役立つ Databricks Assistant を利用できます。詳細については、「Databricks Assistant の使用」を参照してください。

エディターのテーマから選択できます。 [ View > Editor theme (エディタのテーマを表示 )] を選択し、メニューから選択します。

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

オートコンプリートは、コードセグメントを入力すると自動的に補完されます。補完可能なオブジェクトには、型、クラス、オブジェクト、および SQL データベース名とテーブル名が含まれます。 Databricks は、Unity Catalog のメタデータと使用状況を使用して、提案をパーソナライズします。

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

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

注

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

注意すべきユーザー設定には、次の 2 つがあります。

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

変数の調査

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

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

定義へ移動

Python ノートブックがクラスターに接続されている場合、変数、関数、または%runステートメントの背後にあるコードの定義にすぐに移動できます。これを行うには、変数名または関数名を右クリックし、[ 定義へ移動 ] または [ 定義をここに表示] をクリックします。

macOS ではCmdキー、Windows ではCtrlキーを押しながら、変数名または関数名の上にマウスを置きます。定義が見つかった場合、その名前はハイパーリンクに変わります。

「定義へ移動」機能は、Databricks Runtime 12.2 LTS 以降で利用できます。

コードの折りたたみ

コードの折りたたみを使用すると、コードのセクションを一時的に非表示にすることができます。これは、作業中のコードの特定のセクションに集中できるため、長いコードブロックを操作する場合に役立ちます。

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

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

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

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

セル内に複数のカーソルを作成するには:

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

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

列 (ボックス) の選択

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

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

マルチカーソルと列選択のショートカットを変更する

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

セル内に複数のカーソルを作成するには:
- macOS では、 Cmd キーを押しながら各場所をクリックしてカーソルを追加します。
- Windows では、 Ctrl キーを押しながら各場所をクリックしてカーソルを追加します。
列内の複数の項目を選択するには、キャプチャする領域の左上をクリックします。そうしたら：
- macOS では、 Option キーを押しながら右下にドラッグして、1 つ以上の列をキャプチャします。
- Windows では、 Alt キーを押しながら右下にドラッグして、1 つ以上の列をキャプチャします。

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

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

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

ブラケットマッチング

括弧、角括弧、または中括弧の近くをクリックすると、エディタはその文字とそれに一致する括弧を強調表示します。

バージョン履歴のサイドバイサイド差分

以前のバージョンのノートブックを表示すると、エディターには色の強調表示付きの差分が並べて表示されます。

Python エラーの強調表示

ノートブックがクラスターに接続されている場合、構文エラーには赤の下線が引かれます。 Python の場合、クラスターは Databricks Runtime 12.2 LTS 以降を実行している必要があります。

構文の警告にカーソルを合わせ、可能なアクションの [クイック修正 ] を選択します。

Databricks Assistant が有効になっているワークスペースでは、AI 支援による提案のために[アシスタントで修正]を選択することもできます。

構文エラーの強調表示を有効または無効にするには、次の手順を実行します。

ワークスペースの右上にあるユーザー名をクリックし、ドロップダウンリストで[設定]をクリックします。
[ 設定 ] サイドバーで、[ 開発者] を選択します。
[コードエディター] セクションで、[SQL 構文エラーの強調表示] または [Python 構文エラーの強調表示] の設定を切り替えます。

Python の書式設定の強調表示

Python コードの書式設定エラーと警告は、黄色で下線が引かれています。構文の警告にカーソルを合わせると、詳細情報が表示されます。クラスターは、Databricks Runtime 12.1 LTS 以降を実行している必要があります。

フォーマットのエラーと警告を有効にするには:

ワークスペースの右上にあるユーザー名をクリックし、ドロップダウンリストで[設定]をクリックします。
[ 設定 ] サイドバーで、[ 開発者] を選択します。
[試験的な機能] セクションで、Python 形式のエラーの強調表示の設定を切り替えます

Databricks ノートブックとファイル エディターを使用する