ノートブックの各部分
ノートブックは、コードまたはテキスト情報を含むセルと、コードとの対話に役立つその他のさまざまな要素で構成されます。 ノートブックが編集モードかどうかに応じて、対話型要素のリストには、メニュー バー、メイン ツール バー、アクション バー、進行状況バー、自動生成された目次、デバッガーが含まれる場合があります。
ノートブックを表示モードで開く場合、使用可能な要素はセルとアクション・バーのみです。 これを使用して、ノートブックに関する情報の実行、スケジュール、共有、ダウンロード、または表示を行うことができます。 追加オプションにアクセスするには、「編集」アイコンをクリックして編集モードに切り替えます。
編集モードでノートブックを開くと、ノートブック・エディターには以下の要素が含まれます。
- メニュー・バーおよびツールバー
- 目次
- ノートブックのアクション・バー
- コードまたはテキスト情報を含むセル
- デバッガー
- Spark ジョブ進行状況表示バー (Spark 環境で実行されるノートブックの場合)
メニュー・バーおよびツールバー
メニュー・バーおよびメイン・ツールバーから、ノートブックの機能に影響を与えるノートブック機能を選択し、ノートブック内で最もよく使用される操作を実行することができます。
目次
ノートブックの見出しに基づいて自動的に生成された目次を使用して、ノートブック内を移動できます。 目次を表示するには、ビューメニュー、選択目次。
見出し番号を追加するには、文書に見出し番号を表示するアイコン。 第1レベルの見出しの横に番号を表示するかどうかを切り替えるには（ h1）、例えば、第1レベルの見出しをノートブックのタイトルとして表示したい場合は、その他のアクションボタンをクリックし、第 1 レベルの見出し番号を表示する。
目次のセル出力の一部として生成された見出しを除外または含めるには、その他のアクションボタンをクリックし、出力見出しを表示。
ノートブックのアクション・バー
ノートブックのコラボレーションを強化する機能を選択できます。 アクション・バーから、以下のことができます。
- ノートブックを Gist として公開するか、 GitHub に公開します。
- パーマネント URL、リンクがあれば誰でもあなたのノートブックを見ることができます
- ノートブックを実行するジョブを作成する。 ノートブックのスケジューリング を参照してください。
- ノートブックのダウンロード
- プロジェクト・トークンを追加して、コードでプロジェクト・リソースにアクセスできるようにする。 プロジェクト・トークンを設定するためのコードの追加 を参照してください。
- データ資産またはノートブック・セルへの接続からデータを追加するためのコード・スニペットを生成します
- ノートブック情報を表示し、ノートブックが実行されている環境と対話します。
- ノートブックのバージョンの保存
- プロジェクトへの資産のアップロード
Jupyter ノートブックのセル
Jupyter ノートブックは、一連のセルで構成されています。 ノートブックのフローは順次です。 コードを入力セルに入力し、セルを実行すると、ノートブックがコードを実行し、計算の出力を出力セルに出力します。
必要なだけ、入力セルでコードを変更してセルを再実行できます。 このようにして、ノートブックは read-evaluate-print ループ・パラダイムに従います。
各セルには独自のミニ ツールバーがあります。
セル ツールバーから直接、次の操作を実行できます。
- セルをコピーする
- セルを上または下に移動します
- 別のセルの前後に新しいセルを追加する
- セルを削除する
セルを折りたたむには、各セルの横にある折りたたみボタン（ 
）をクリックします。 セルを拡大するには、折りたたみボタンをクリックするか、 拡大アイコン 
をクリックします。
セルの動作は、セルのタイプによって決まります。 以下のようなさまざまなタイプのセルがあります。
Jupyter コード・セル
Jupyter コード・セルでは、新規コードを編集および作成できます。
コードの横に行番号を表示するには、ビューメニュー選択行番号を表示。
コードセルと出力セルを並べて表示するには、ビューエディタメニューで並べてレンダリング。
Jupyter マークダウン・セル
Jupyter マークダウン・セルでは、計算プロセスを文書化できます。 ノートブックを階層的に構造化するための見出しを入力できます。
イメージ・ファイルを添付ファイルとしてノートブックに追加および編集することもできます。 マークダウン・コードおよびイメージは、セルが実行されるとレンダリングされます。
Jupyter ノートブックのマークダウンのチートシートを参照してください。
ロー Jupyter NBConvert セル
ロー・セルは、ノートブックによって評価されません。 未加工セルは、生成された出力のように、実行したくないコンテンツを保持する場所を探している場合に役立ちます。
デバッガー
デバッガーを使用すると、コード関連の問題をすばやく修正できます。 デバッガーをアクティブにするには:
- ノートブックツールバーの Enable Debugger アイコン
をクリックします。 - ブレークポイントを追加するには、任意のコード行の横をクリックします。
コードをデバッグするには、ビューメニュー、選択右サイドバーを選択し、デバッガーを表示。
Spark ジョブ進行状況表示バー
Spark ジョブをトリガーするコードをノートブックで実行した場合、コードが効率的に実行されていない理由を判別するのが困難になることが多くあります。
コードの実行内容を理解し、コードのデバッグを支援するために、ノートブックでコード・セルの Spark ジョブの実行をモニターすることができます。
ノートブックでセルの Spark モニターを有効にするには、以下のようにします。
- モニターするコード・セルを選択します。
- ノートブックツールバーの Enable Spark Monitoring アイコン（
）をクリックします。
表示される進行状況表示バーには、Spark クラスター上のジョブのリアルタイムの実行時の進行状況が表示されます。 各 Spark ジョブは、クラスター上で 1 つ以上のステージとして実行されます。各ステージは、並行して実行できるタスクのリストです。 Spark ジョブに多数のステージがある場合、モニター・ペインは非常に大きくなる可能性があります。
ジョブ・モニター・ペインでは、各ジョブの所要時間およびジョブ・ステージの状況も表示されます。 ステージの状況は、以下のいずれかになります。
Running: ステージはアクティブであり、開始されていますCompleted: ステージが完了しましたSkipped: このステージの結果は以前の操作からキャッシュに入れられたため、タスクを再実行する必要はありません。Pending: ステージはまだ開始されていません
セルでのモニターを無効にするには、アイコンを再度クリックします。
親トピック: Jupyter Notebook エディター