DataSpell 2025.3 ヘルプ

Python コードを実行する

Python ファイルを作成し仮想環境を構成したら、コードを実行できます。

Python エディターツールバーを使用すると、最も人気のあるアクションにすばやくアクセスできます。

アイコン

アクション

new cell

選択したセルにコードセルを追加します。

Cut

選択したコードセルの現在の位置をクリップボードに移動します。

Copy

選択したコードセルをクリップボードにコピーします。

Paste

クリップボードの内容を、選択したコードセルの新しいコードセルに挿入します。

Move cell up

現在のセルを上に移動します。

Move cell down

現在のセルを下に移動します。

Run cell

このセルを実行し、下のセルを選択します。下にセルがない場合は、DataSpell がセルを作成します。

the Run All button

Python コンソール内の Python ファイルのコードを実行します。

Debug Python code

Python コードのデバッグを開始します。

remove the cell

現在のセルを削除します。

スクリプトは、対話型の読み取り・評価・出力ループ(REPL)Python コンソールで実行できます。また、選択したコードの一部、あるいは Python コードセルを実行することもできます。

Python コンソール

Python コンソールを使用すると、Python シェル(英語)と同様に、Python のコマンドとスクリプトを 1 行ずつ実行できます。コンソールは DataSpell ツールウィンドウの下部にあり、コード実行を開始するたびに開きます。メインメニューから Windows | ツールウィンドウ | Python コンソールを選択して開くこともできます。

Python コンソールでファイルを実行する

  • コンソールで Python スクリプトを実行するには、Python エディターツールバーの the Run button をクリックします。

    The Run button on the toolbar

実行を開始すると、Python コンソールが開き、コードの実行が表示されます。

Running file in the Python Console

デフォルトでは、各コンソールには実行されたファイルのファイル名とインデックスに対応する名前が付けられます。そのため、新しいコンソールで sample.py を実行する場合、サンプル (1) という名前のタブで実行されます。Python エディターの右上隅にあるリストから、必要なコンソールを選択してください。

Running a file in several consoles

コンソールタブの名前を変更するには、タブを右クリックし、コンソールの名前を変更を選択して、意味のある名前を入力します。

Renaming the console tab

名前を変更したコンソールは、コンソールのリストに表示されます。

Renamed console

非対話型コンソールでコードを実行する

Python スクリプトの実行方法が対話性を意味しない場合は、実行ツールウィンドウでコードを実行するのと同様に、非対話型コンソールでスクリプトを実行できます。

  • コントロールのリストから非対話型シェルを選択し、the Run All button をクリックします。

    Running a script in the non-interactive console

コードセルを実行する

Python コードを実行可能セルのセットとしてフォーマットし、それぞれを個別に実行することができます。

  1. コードをセルに分割するには、適切な場所に # %% 行を追加します。

    Splitting code into cells
  2. 各セルのガターには実行アイコン(the Run button)があります。これをクリックするとセルが実行されます。コードの依存関係と必要なインポートに注意してください。次の例では、kernel_stats 変数が最初のセルで定義されています。2 番目のセルを先に実行すると、結果は NameError になります。

    Running the second cell

選択した Python コンソールの現在のセッションで実行されたすべてのコマンドをプレビューできます。

コンソールのクエリ履歴を表示する

  1. ターゲットコンソールを選択し、コンソールツールバーの Browse Query History をクリックします。

  2. 履歴ダイアログで実行されたコマンドのリストをプレビューします。

    Query history dialog

    リスト内の任意の項目を選択し、貼り付けボタンをクリックすると、関連するコマンドがコピーされ、現在の Python コンソールに貼り付けられます。

  3. コマンドを追加したら、Enter を押して実行します。

    Execute commands from the Python console query history

Python コンソールツールバーを使用して、DataSpell が実行出力を表示する方法を設定します。

Python コンソールツールバー

項目

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

説明

Rerun console

コンソールを再実行する

Ctrl+F5

現在のプロセスを終了して新しいプロセスを起動するには、このボタンをクリックします。

the Stop button

停止

Ctrl+F2

現在のプロセスを停止するには、このボタンをクリックします。

ボタンを 1 回クリックするとソフトキルが呼び出され、アプリケーションが SIGINT イベントをキャッチして正常に終了します(Windows では、Ctrl+C イベントがエミュレートされます)。ボタンが 1 回クリックされると、the Kill Process button に置き換えられます。これは、次のクリックによってアプリケーションが強制終了されることを示します。たとえば、Unix では SIGKILL が送信されます。

Run command

現在のステートメントを実行する

Enter .

このボタンをクリックすると、コンソールの入力ペインに入力されたコマンドがキャレットで実行されます。

Debug

デバッガーのアタッチ

デバッガープロセスをコンソールに接続します。

Settings

設定

Python コンソールの以下の設定を指定できます。

  • 簡略化された変数ビュー : 特殊変数グループに次の名前を含めるには、このオプションを選択します。

    • すべての変数はダンダーの名前を持つ。

    • functionclassobjmodule のすべてのインスタンス。

    • IPython を持つデバッグコンソールが起動されていれば、すべての IPython 内部変数。

  • 変数ロードポリシー。以下のいずれかのポリシーを選択できます。

    • 同期 : このオプションが有効な場合、表示されるメッセージは Collecting data で、その後デバッガーは変数の値を表示します。

    • 非同期 : このオプションが有効な場合、デバッガー内の変数は個別に (非同期的に) ロードされます。この場合、変数のロードに時間がかかると、デバッガーは ...Loading Value メッセージを表示し、その後、変数の値が表示されるか、変数が遅すぎる場合は Loading timed out メッセージが表示されます。オンデマンドモードに切り替えることを提案する警告メッセージに注意してください。

    • オンデマンド : このオプションが有効な場合、デバッガーは Show Value メッセージを表示します。クリックして読み込みを有効にします。

    ロードポリシーの変更は、デバッグプロセスを再実行した後に有効になることに注意してください。

Add a new console

新規コンソール

このボタンをクリックすると、新しいコンソールセッションが開始されます。

the Soft-Wrap button

ソフトラップを使用

このボタンをクリックすると、出力のソフトラップモードが切り替わります。

Scroll to the end

最後までスクロールする

このボタンをクリックすると、スタックトレースの一番下に移動し、キャレットがソースコード内の対応する場所に移動します。

the Print button

印刷

コンソールテキストをデフォルトプリンタに送信するには、このボタンをクリックします。

Debugger watches

変数の表示

このボタンをクリックすると、コンソールで宣言されている変数が別のペインに表示されます。このペインで変数を右クリックすると、コンテキストメニューが表示されます。

Show Command Queue

コマンドキューを表示

このボタンをクリックして、コマンド実行キューをプレビューします。

the Browse Query History button

クエリ履歴の参照

Ctrl+Alt+E

対応するデータソースに対して実行したすべてのステートメントを表示するダイアログを開きます。

クエリ履歴を使用するダイアログも参照してください。

2025 年 4 月 03 日

関連ページ:

Python ファイルの追加

DataSpell は、Python ファイルを追加するためのいくつかの代替方法を提案します。任意の拡張子を持つ以下のいずれか 1 つを実行します: ワークスペースツールウィンドウ () で、新しいファイルを作成するディレクトリを選択し、メインメニューからを選択します。ディレクトリを右クリックし、コンテキストメニューから新規を選択します。ディレクトリを選択し、を押します。、Python ファイルファイルを選択します。開いたダイアログで、対応するフィールドにファイルの名前を入力します。ファイル名拡...

ワークスペースを管理する

ワークスペースにディレクトリとプロジェクトを追加する:既存のディレクトリまたはプロジェクトを追加する以下のいずれか 1 つを実行します: ワークスペースツールウィンドウで新規または既存のディレクトリを添付リンクをクリックします。メインメニューからを選択します。ワークスペースツールウィンドウのツールバーでクリックします。、ファイルシステム内で目的のディレクトリを見つけます。プロジェクトを追加するには、プロジェクトディレクトリを選択します。新しいディレクトリを追加する以下のいずれか 1 つを実行し...

クエリを実行する

データベースツールと SQL プラグインを有効にするこの機能は、DataSpell にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。クエリは、ショートカット、ツールバーボタン、コンテキストメニュ...

型ヒント

DataSpell は、スクリプト内のオブジェクトのタイプのインスペクションとチェックを支援するさまざまな手段を提供します。DataSpell は、モジュールと PEP 484 で定義された形式を使用して、関数アノテーションと型コメントで型ヒントをサポートします。型ヒントを追加する:DataSpell は PEP 484 でサポートされている型の追加方法をすべてサポートしていますが、インテンションアクションを通じて型ヒントを使用するのが最も便利です。使用するインタープリターに応じて、型はアノテーション...

ブレークポイントの設定

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