Databricks 対話型デバッガーを使用する

プレビュー

この機能はパブリックプレビュー段階です。

このページでは、Databricks ノートブックの組み込み対話型デバッガーの使用方法について説明します。 デバッガーは Python でのみ使用できます。

対話型デバッガーは、ブレークポイント、ステップバイステップの実行、変数検査など、ノートブックでコードをより効率的に開発するのに役立つツールを提供します。

要件

ノートブックは、次の要件を満たすクラスターに接続する必要があります。

  • Databricks Runtimeバージョン 13.3 LTS 以降。

  • アクセス モードは、 シングル ユーザー (割り当て済み) または [ 分離共有なし] である必要があります。

デバッガを有効または無効にする

デバッガを有効または無効にするには、次の操作を行います。

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

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

  3. [実験的な機能]セクションで、 [Python ノートブック インタラクティブ デバッガー]を切り替えます。

デバッガを起動する

デバッガーを開始するには、次のステップに従います。

  1. 1 つ以上のブレークポイントを追加するには、セルの余白をクリックします。 ブレークポイントを削除するには、ブレークポイントをもう一度クリックします。

    ブレークポイントの作成と削除のビデオ
  2. 以下のいずれかを実行します。

    • [実行] > [セルのデバッグ]をクリックします。

    • キーボード ショートカット Ctrl + Shift + D を使用します。

    • セル実行メニューから、 「セルのデバッグ」を選択します。

    セル実行メニューのセル項目をデバッグする

デバッグ セッションが自動的に開始され、選択したセルが実行されます。

また、セルがエラーをトリガーした場合にデバッガを起動することもできます。 セル出力の下部で、 をクリックします [デバッグ] ボタン

デバッグ・セッションがアクティブになると、セルの上部にデバッグ・ツールバー デバッグツールバー が表示されます。

デバッガを使用する

注釈付きデバッガツールバー

デバッグセッションでは、次の操作を実行できます。

  • ブレークポイントを設定または削除します。

  • ブレークポイントで変数の値を表示します。

  • コードをステップ実行します。

  • 関数にステップインまたは関数からステップアウトします。

コードがブレークポイントに到達すると、行の実行後ではなく、実行前に停止します。

デバッガ ツールバーのボタンを使用して、コードをステップ実行します。 コードをステップ実行すると、セル内の現在の行が強調表示されます。 変数値は、右側のサイドバーの変数エクスプローラーペインで確認できます。

関数をステップ実行すると、変数ペインにローカル関数変数が表示され、 [local]とマークされます。

デバッガセッションを終了する

デバッグ セッションを終了するには、デバッガの停止ボタンセルの左上にある をクリックするか、ノートブック停止ボタンノートブックのトップにあります。

制限事項

  • デバッガは Python でのみ動作します。 Scala や R はサポートしていません。

  • デバッガーは、共有アクセス モードのクラスターでは機能しません。

  • デバッガは、外部ファイルまたはモジュールへのステップインをサポートしていません。

  • デバッグ セッションがアクティブなときは、ノートブックで他のコマンドを実行できません。