DataSpell 2025.3 ヘルプ

Jupyter ノートブックコードセルの実行とデバッグ

ノートブックツールバーのアイコン、コードセルのコンテキストメニューと構造ツールウィンドウのコマンド、およびガターの実行アイコンを使用して、さまざまな方法でノートブックセルのコードを実行できます。

コードセルを実行する

ショートカットとツールバーオプションを使用してコードセルを実行する

  • 次のスマートショートカットを使用して、コードセルをすばやく実行します。

    • Ctrl+Enter : 現在のセルを実行します。

    • Shift+Enter : 現在のセルを実行し、その下のセルを選択します。

    実行が完了すると、セルは編集モードのままになるため、必要に応じて変更したり、実験を続けることができます。

    編集モード中に、Ctrl+Home を押すとキャレットがセルの先頭に移動し、Ctrl+End を押すとキャレットがセルの末尾に移動します。

  • ノートブック内のすべてのコードセルを実行するには、ノートブックツールバーRun all をクリックします。

  • コマンドモード中に、Ctrl+Home を押すとノートブックの最初のセルにフォーカスし、Ctrl+End を押すとノートブックの最後のセルにフォーカスします。

セル実行期間

  • セルの実行期間に関する情報は、セルの左下隅に表示されます。

    この領域にマウスを置くと、セルの実行が完了した日時が表示されます。

    The information about the last cell execution

    エラーが発生した場合は、トレースバックノードを展開して、完全なエラーメッセージを表示します。

    Error traceback

サーバーを停止して サーバーまたはカーネルを変更する場合、実行結果は現在のサーバーセッションに対してのみ有効であるため、依存関係を持つすべてのセルを再度実行する必要があります。

変数を表示する

Jupyter コンソール

この機能は、ローカルカーネルとリモートカーネルの両方でデフォルトで有効になっています。リモートカーネルで無効にするには、設定 | ツール | Jupyter | Jupyter 一般カーネルに移動し、サポートライブラリをリモート Jupyter にアップロードチェックボックスをオフにしてください。

ノートブックを実行すると、Jupyter コンソール変数タブで変数をプレビューできます。

Jupyter console: the Variables tab

デフォルトでは、変数は非同期的に読み込まれます。読み込みポリシーを変更するには、「変数」タブで「 Manage the loading policy 」をクリックし、「変数ロードポリシー」を選択して、利用可能なモードのいずれかを選択します。

  • 同期 : 変数はまとめてロードされます。

  • 非同期 : 変数は別々にロードされます。

  • オンデマンド : 変数はユーザーの要求に応じてロードされます。

配列として表示データフレームとして表示イメージとして表示、またはシリーズとして表示をクリックすると、対応するツールウィンドウにデータが表示されます。詳細については、出力の操作を参照してください。

    Jupyter 変数ツールウィンドウ

    Jupyter 変数ツールウィンドウは、セルを実行するたびに表示されます。このウィンドウを恒久的に非表示にしたい場合は、設定 | ツール | Jupyter | Jupyter 一般に移動し、実行時に変数ツールウィンドウを表示するチェックボックスをオフにしてください。

    Jupyter Variables tool window

      データビジョン

      エディター内で変数を直接プレビューするには、設定 | ツール | Jupyter | Jupyter 一般に移動し、インライン値を表示チェックボックスが有効になっていることを確認します。

      1. ノートブックセルを実行します。変数の値は、その用途の横に表示されます。

        Inline variables in the source editor
        Inline variables in the source editor
      2. pandas DataFrame や NumPy 配列など、特定の型の値はインラインでレンダリングできません。表形式で表示するには、値にマウスポインターを合わせて下矢印をクリックします。

      3. 変数をクリックすると、ポップアップに詳細情報が表示されます。

        Preview variables in a popup in the editor

      リファレンスドキュメントのプレビュー

      DataSpell を使用すると、特定の変数、型、または引数に関するリファレンスドキュメントをいつでもすばやくプレビューできます。

      1. 特定のコードセルの要素の参照情報を表示するには、ターゲットコードセル内にキャレットを置き、? <type/variable/argument> と入力します。(この例では、plt.scatter のドキュメントをプレビューします)。コード要素はコードセル内でアクセスできる必要があります。

      2. セルを実行イントロスペクションタブが Jupyter ツールウィンドウに開きます。

      3. イントロスペクションタブでリファレンスドキュメントをプレビューします。

      Jupyter ノートブックのデバッグコード

      DataSpell は、ローカルカーネルとリモート Jupyter サーバーカーネルの両方に Jupyter Notebook デバッガーを提供します。

      1. 選択したセルにブレークポイントを設定し、セルツールバーで「 Debug Cell セルのデバッグ」をクリックします。または、セルを右クリックし、コンテキストメニューから「セルのデバッグ」を選択することもできます。

        Jupyter Notebook デバッグツールウィンドウが開きます。

        Jupyter Notebook Debugger tool window
      2. ステップツールバーボタンを使用して、次に停止する行を選択します。

        デバッグは単一のコードセル内で実行されます。ただし、コードセルがすでにデバッグされているセルから関数を呼び出す場合は、そのセルにステップインできます。関連するブレークポイントも機能します。関数を含むセルは、実行されるだけでなく、デバッグされる必要があることに注意してください。

        同様に、同じプロジェクト内にある Python ファイルから呼び出される関数にステップインすることもできます。

      3. セルの実行を完了するためのデバッグ手順に進みます。

        Debugging is complete

      ステップアクション

      項目

      ツールチップとショートカット

      説明

      デバッガーツールバーで使用可能なアクション。

      Step over

      ステップオーバー

      F8

      このボタンをクリックすると、現在のメソッドまたはファイルの次の行までプログラムが実行され、現在の実行ポイントで参照されているメソッド (存在する場合) はスキップされます。現在の行がメソッドの最後の行である場合、その行までの実行ステップはこのメソッドの直後に実行されます。

      Step into

      ステップイン

      F7

      デバッガーを現在の実行ポイントで呼び出されたメソッドにステップインさせるには、このボタンをクリックします。

      Step out

      ステップアウト

      Shift+F8

      このボタンをクリックすると、デバッガーが現在のメソッドから抜け出し、直後に実行される行に移動します。

      デバッガーツールバーの More stepping actions をクリックすると、追加のステップアクションを利用できます。

      Force Step Over

      強制ステップオーバー

      Alt+Shift+F8

      現在のコード行をステップオーバーし、ハイライトされた行にメソッド呼び出しが含まれている場合でも、次の行に移動します。呼び出されたメソッドにブレークポイントがある場合、それらは無視されます。

      Force step into

      強制ステップイン

      Alt+Shift+F7

      このメソッドをスキップする場合でも、現在の実行ポイントで呼び出されたメソッドにデバッガーをステップインさせるには、このボタンをクリックします。

      Smart Step Into

      スマートステップイン

      Shift+F7

      1 行に複数のメソッド呼び出しがあり、どのメソッドを入力するかを具体的に指定したい場合は、スマートステップインが役立ちます。この機能を使用すると、関心のあるメソッド呼び出しを選択できます。

      Run to cursor

      カーソル位置まで実行

      Alt+F9

      このボタンをクリックすると、プログラムの実行が再開され、実行ポイントがエディターの現在のキャレット位置の行に到達するまで一時停止します。ブレークポイントは必要ありません。実際には、キャレットの現在の行に一時的なブレークポイントが設定されており、プログラムの実行が一時停止されると削除されます。キャレットがすでに実行された行に配置されている場合は、以前のブレークポイントにロールバックする方法がないため、プログラムはさらに実行するために再開されます。このアクションは、メソッドシーケンスの深いところまでステップインし、一度に複数のメソッドからステップアウトする必要がある場合に特に便利です。

      指定された行に移動する前に実行する必要がある行にブレークポイントが設定されている場合、デバッガーは最初に検出されたブレークポイントで一時停止します。

      Force Run to Cursor

      カーソル位置まで強制実行

      Ctrl+Alt+F9

      キャレットの位置に達するまで実行を継続します。途中のブレークポイントはすべて無視されます。

      Show Execution Point

      実行ポイントの表示

      Alt+F10

      このボタンをクリックすると、エディターで現在の実行ポイントがハイライトされ、対応するスタックフレームがフレームペインに表示されます。

      Evaluate expression

      式の評価

      Alt+F8

      式を評価するには、このボタンをクリックします。

      2025 年 8 月 07 日

      関連ページ:

      Jupyter ノートブック

      DataSpell で利用可能な Jupyter Notebook 統合により、ノートブックのソースコードを編集、実行、デバッグし、ストリームデータ、イメージ、その他のメディアを含む実行出力を調べることができます。DataSpell での Notebook のサポートは次のとおりです。コーディング支援: エラーと構文のハイライト。コード補完。行コメントを作成する機能。、専用 Jupyter Notebook デバッガー。Jupyter ノートブックを使った基本操作のためのショートカット。.ipynb...

      Jupyter ノートブックサーバーの管理

      DataSpell では、次のサーバータイプを使用してコードセルを実行できます。管理対象サーバー – 現在のプロジェクトのために DataSpell によって自動的に起動される Jupyter サーバー。DataSpell を閉じると終了します。外部サーバー – URL とトークンを指定して接続する Jupyter サーバーであればどれでも使用できます。ローカルマシンでもリモートマシンでも実行できます。マネージド Jupyter サーバーを追加へまたは、プロジェクトディレクトリを右クリックし、コンテ...

      出力の操作

      コードセルを実行すると、その出力は以下のように表示されます。出力にはテキスト、表、イメージなどが含まれます。セル出力を展開または折りたたむセル出力の横にあるガター内のセルハンドルをクリックします。出力のクリア出力セルを右クリックします。コンテキストメニューから出力のクリアを選択します。すべての出力をクリア出力セルを右クリックします。コンテキストメニューから「

      ブレークポイントの設定

      ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、たとえば、特定のコード行に到達したときにプログラムを一時停止するなどの単純なものから、追加の条件をチェックしたり、ログに書き込んだりするなどのより複雑なロジックを含むものまであります。ブレークポイントは、一度設定すると、一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。ブレークポイントの種類:DataSp

      Jupyter ノートブックの作成と編集

      プロジェクトをセット上へするワークスペースを開きます。選択したインタープリターの jupyter パッケージをインストールします。すべてのインデックス作成プロセスが完了したら、ノートブックファイルを使用する準備が整いました。Jupyter ノートブックの作成:以下のいずれか 1 つを実行します: ワークスペースツールウィンドウでターゲットディレクトリを右クリックし、コンテキストメニューから新規を選択します。ボタン、Jupyter Notebook を選択します。開いたダイアログで、ファイル名を入力して...