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

  • [アーティクル]

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

選りすぐりのエディター テーマの中から選択することができます。 [表示] > [エディター テーマ] の順に選択し、メニューから選んでください。

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

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

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

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

注意

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

知っておくべきユーザー設定が 2 つあります。

  • オートコンプリート候補をオフにするには、[Autocomplete as you type] (入力時のオートコンプリート) を切り替えます。 オートコンプリートがオフの場合は、Ctrl + Space キーを押すとオートコンプリート候補を表示できます。
  • Enter キーによってオートコンプリート候補が挿入されないようにするには、[Enter key accepts autocomplete suggestions] (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. [設定] サイドバーで、[Developer] を選択します。
  3. [コード エディター] セクションで、[マルチカーソル クリックのキー修飾子] 設定を macOS の場合は [Cmd] に、Windows の場合は [Ctrl] に変更します。

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

角かっこの一致

かっこ、角かっこ、または中かっこの近くをクリックすると、エディターによって、その文字と、それに対応する角かっこが強調表示されます。

対応するかっこを表示する

バージョン履歴で差分を横に並べて表示

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

コードの差分を表示する

Python エラーの強調表示

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

構文警告の上にマウス ポインターを置き、実行可能なアクションとして [クイック修正] を選択します。

構文エラーでのコード アクションの例

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

構文エラーの強調表示を有効または無効にするには、以下の操作を行います。

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

Python の書式設定の強調表示

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

書式設定エラーと警告を有効にするには:

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