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 つ以上の列をキャプチャします。

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

  1. ワークスペースの右上にあるユーザー名をクリックし、ドロップダウン リストで[設定]をクリックします。

  2. [ 設定 ] サイドバーで、[ 開発者] を選択します。

  3. [ コード エディター ] セクションで、[ マルチカーソル クリックのキー修飾子 ] 設定を [ macOS の場合は Cmd ] に、Windows の場合は Ctrl に変更します。

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

ブラケットマッチング

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

対応するブラケットを表示する

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

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

コードの差分を表示する

Python エラーの強調表示

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

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

構文エラーの強調表示に関するコードアクションの例

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

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

  1. ワークスペースの右上にあるユーザー名をクリックし、ドロップダウン リストで[設定]をクリックします。

  2. [ 設定 ] サイドバーで、[ 開発者] を選択します。

  3. [コード エディター] セクションで、[SQL 構文エラーの強調表示] または [Python 構文エラー強調表示] の設定を切り替えます。

Python の書式設定の強調表示

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

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

  1. ワークスペースの右上にあるユーザー名をクリックし、ドロップダウン リストで[設定]をクリックします。

  2. [ 設定 ] サイドバーで、[ 開発者] を選択します。

  3. [試験的な機能] セクションで、Python 形式のエラーの強調表示の設定を切り替えます