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

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

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

オートコンプリート

オートコンプリートは、入力時にコードセグメントを自動的に補完します。 コンプリート可能なオブジェクトには、型、クラス、オブジェクト、および SQL データベース名とテーブル名が含まれます。

  • Python セルの場合、オートコンプリートを機能させるにはノートブックを クラスターにアタッチ し、補完可能なオブジェクトを定義する すべてのセルを実行する 必要があります。

  • SQL セルの場合、ノートブックがコンピュート リソースにアタッチされていない場合でも、オートコンプリートによってキーワードと基本的な構文が提案されます。

    • ワークスペースで Unity Catalogが有効になっている場合、オートコンプリートでは、 Unity Catalog内のテーブルのカタログ名、スキーマ名、テーブル名、および列名も提案されます。

    • ワークスペースでUnity Catalogが有効になっていない場合は、テーブル名または列名を提案するために、ノートブックをクラスターまたはSQL ウェアハウスにアタッチする必要があります。

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

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

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

  • オートコンプリート候補をオフにするには、 入力時にオートコンプリートを切り替えます。 オートコンプリートがオフの場合、 Ctrl + スペースを押すと、オートコンプリートの候補を表示できます。

  • Enter キー がオートコンプリート候補を挿入しないようにするには、 Enter キーを切り替えてオートコンプリート候補を受け入れます

可変検査

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

変数を検査する方法

定義 へ移動

Databricks Runtime 12.2 LTS 以降では、Python ノートブックがクラスターにアタッチされている場合、そのノートブックで定義されている変数または関数の定義に自動的に移動できます。これを行うには、macOS では Cmd キー、Windows では Ctrl キーを押しながら、変数または関数の名前の上にカーソルを置きます。 名前がハイパーリンクに変わり、定義が見つかると下線付きの青いテキストに変わります。 リンクをクリックすると、変数または関数を定義するコードにカーソルが移動します。

macOS では Cmd+ F12、Windows では Ctrl+F12 のキーボード ショートカットを使用することもできます。

コードの折りたたみ

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

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

コードを折りたたむ方法

キーボード ショートカットなどの詳細については、 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 の場合、クラスターは Databricks Runtime 12.2 LTS 以上を実行している必要があります。

構文エラーの強調表示の例

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

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

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

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

構文エラーと警告に対して可能なアクション

構文エラーが表示された場合は、その上にカーソルを合わせて [クイック修正 ] を選択し、可能なアクションを確認できます。

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

この機能はDatabricks Assistantを使用します。 アクションが表示されない場合は、管理者が最初に Databricks Assistant を有効にする必要があることを意味します。