翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# EMR Notebooks の使用
<a name="emr-managed-notebooks-working-with"></a>

**注記**  
EMR Notebooks は、コンソールで EMR Studio Workspace として使用できます。コンソールの **[ワークスペースの作成]** ボタンを使用すると、新しいノートブックを作成できます。EMR Notebooks ユーザーが Workspace にアクセスしたり作成したりするには、追加の IAM ロール権限が必要です。詳細については、「[Amazon EMR Notebooks are Amazon EMR Studio Workspaces in the console](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-managed-notebooks-migration.html)」および「[Amazon EMR console](https://docs.aws.amazon.com/emr/latest/ManagementGuide/whats-new-in-console.html)」を参照してください。

EMR notebooks を作成すると、ノートブックはすぐに開始されます。**[ノートブック]** リストの **[ステータス]** に、**[開始中]** と表示されます。ステータスが [**Ready (準備完了)**] のときにノートブックを開くことができます。クラスターも一緒に作成した場合は、ノートブックが [**Ready (準備完了)**] になるまでの時間が少し長くなることがあります。

**ヒント**  
ノートブックのステータスを更新するには、ブラウザを更新するか、ノートブックリストの上にある更新アイコンを選択します。

## ノートブックのステータスについて
<a name="emr-managed-notebooks-status"></a>

EMR notebooks では、**[ノートブック]** リストの **[ステータス]** に以下が表示されます。


| ステータス | 意味 | 
| --- | --- | 
| Ready | ノートブックエディタを使用してノートブックを開くことができます。ノートブックが [**Ready (準備完了)**] ステータスの間に、停止または削除できます。クラスターを変更するには、最初にノートブックを停止する必要があります。[**Ready (準備完了)**] ステータスのノートブックが長時間アイドル状態の場合、自動的に停止されます。 | 
| スタート | ノートブックが作成されていて、クラスターにアタッチされます。ノートブックを開始している間に、ノートブックエディタを開いたり、停止、削除したり、クラスターを変更することはできません。 | 
| 保留中 | ノートブックが作成され、クラスターとの統合が完了するのを待機しています。クラスターでは、リソースのプロビジョニングや他のリクエストへの応答がまだ実行中である可能性があります。*ローカルモード*のノートブックを使用してノートブックエディタを開くことができます。クラスタープロセスに依存するすべてのコードは実行されず、失敗します。 | 
| 停止中 | ノートブックがシャットダウンしているか、ノートブックがアタッチされているクラスターが終了しています。ノートブックが停止している間に、ノートブックエディタを開いたり、停止、削除したり、クラスターを変更することはできません。 | 
| 停止 | ノートブックはシャットダウンしました。クラスターが実行されている限り、同じクラスターでノートブックを起動できません。クラスターを変更して、削除することができます。 | 
| 削除 | 使用可能なクラスターのリストからクラスターが削除されています。ノートブックファイル `{{NotebookName}}.ipynb ` は Amazon S3 に残り、該当するストレージ料金が発生し続けます。 | 

## ノートブックエディタの使用
<a name="emr-managed-notebooks-editor"></a>

EMR notebooks を使用する利点は、コンソールから直接 Jupyter または JupyterLab でノートブックを起動できることです。

EMR Notebooks では、Amazon EMR コンソールからアクセスするノートブックエディタは、一般的なオープンソース Jupyter Notebook エディタまたは JupyterLab です。ノートブックエディタは Amazon EMR コンソール内で起動されるため、Amazon EMR クラスターでホストされているノートブックで起動するよりもアクセスの設定がより効率的です。SSH、セキュリティグループルール、およびプロキシ設定を通じたウェブアクセスのために、ユーザーのクライアントを設定する必要はありません。十分なアクセス許可のあるユーザーは、Amazon EMR コンソール内でノートブックエディタを簡単に開くことができます。

ただし、Amazon EMR 内から EMR notebooks を同時に開くことができるユーザーは 1 人のみです。すでに開いている EMR notebooks を別のユーザーが開こうとすると、エラーが発生します。

**重要**  
Amazon EMR では、ノートブックエディタセッションごとに一意の署名付き URL が作成されます。この URL は、短期間だけ有効です。ノートブックエディタの URL を共有しないことをお勧めします。共有すると、URL の受取人がその有効期間中にノートブックの編集とノートブックコードの実行のためのアクセス許可を持つため、セキュリティ上のリスクが生じます。他のユーザーがノートブックにアクセスする必要がある場合は、アクセス許可ポリシーを使用してユーザーにアクセス許可を付与し、EMR Notebooks のサービスロールが Amazon S3 の場所にアクセスできるようにしてください。詳細については、「[EMR Notebooks のセキュリティとアクセスコントロール](emr-managed-notebooks-security.md)」および「[EMR Notebooks のサービスロール](emr-managed-notebooks-service-role.md)」を参照してください。

**EMR notebooks のノートブックエディタを開くには**

1. **[ノートブック]** リストから、**[ステータス]** が **[準備完了]** または **[保留中]** のノートブックを選択します。

1. [**Open in JupyterLab (JupyterLab で開く)**] または [**Jupyter で開く**] を選択します。

   新しいブラウザタブで JupyterLab または Jupyter Notebook エディタが開きます。

1. [**Kernel (カーネル)**] メニューで [**Change kernel (カーネルの変更)**] を選択し、プログラミング言語のカーネルを選択します。

   ノートブック内からコードを記述して実行する準備ができました。

### ノートブックの内容の保存
<a name="emr-managed-notebooks-saving"></a>

ノートブックエディタで操作する際には、ノートブックセルと出力の内容は Amazon S3 内で定期的にノートブックファイルに自動で保存されます。前回セルが編集されたため変更がないノートブックには、エディタ内のノートブック名の横に [**(autosaved) ((自動保存))**] が表示されます。変更内容がまだ保存されていない場合、[**unsaved changes (保存されていない変更)**] が表示されます。

ノートブックを手動で保存できます。**[ファイル]** メニューで **[保存とチェックポイント]** を選択するか、Ctrl\+S キーを押します。これにより、Amazon S3 のノートブックフォルダ内の **[チェックポイント]** フォルダに `{{NotebookName}}.ipynb` という名前のファイルが作成されます。例えば、`s3://{{amzn-s3-demo-bucket}}/{{MyNotebookFolder}}/{{NotebookID}}/checkpoints/{{NotebookName}}.ipynb`。この場所には最新のチェックポイントファイルのみが保存されます。

## クラスターの変更
<a name="emr-managed-notebooks-changing-clusters"></a>

ノートブック自体の内容を変更せずに、EMR notebooks がアタッチされたクラスターを変更できます。クラスターを変更できるのは、[**Stopped (停止)**] ステータスのノートブックのみです。

**EMR notebooks のクラスターを変更するには**

1. 変更するノートブックが実行されている場合は、[**Notebooks (ノートブック)**] リストから選択して [**Stop (停止)**] を選択します。

1. ノートブックのステータスが [**Stopped (停止)**] の場合、[**Notebooks (ノートブック)**] リストからノートブックを選択して、[**View details (詳細を表示)**] を選択します。

1. [**Change cluster (クラスターの変更)**] を選択します。

1. ノートブックをアタッチする Hadoop、Spark、Livy を実行しているアクティブなクラスターがある場合、デフォルトのままにして、リストからクラスターを選択します。要件を満たすクラスターのみが表示されます。

   - または -

   [**Create a cluster (クラスターの作成)**] を選択してクラスターのオプションを選択します。詳細については、「[クラスターの要件](emr-managed-notebooks-considerations.md#considerations-limitations)」を参照してください。

1. [**Security groups (セキュリティグループ)**] のオプションを選択して、[**Change cluster and start notebook (クラスターを変更してノートブックを開始)**] を選択します。

## ノートブックとノートブックファイルの削除
<a name="emr-managed-notebooks-deleting"></a>

Amazon EMR コンソールを使用して EMR notebooks を削除すると、使用可能なノートブックのリストからノートブックが削除されます。ただし、ノートブックファイルは Amazon S3 に残り、ストレージ料金が発生し続けます。

**ノートブックを削除して関連ファイルを削除するには**

1. Amazon EMR コンソール ([https://console.aws.amazon.com/elasticmapreduce/](https://console.aws.amazon.com/elasticmapreduce/)) を開きます。

1. [**Notebooks (ノートブック)**] を選択し、リストからノートブックを選択して、[**View details (詳細を表示)**] を選択します。

1. [**Notebook location (ノートブックの場所)**] の横にあるフォルダアイコンを選択して [**URL**] をコピーします。そのパターンは `s3://{{MyNotebookLocationPath}}/{{NotebookID}}/` です。

1. **[削除]** を選択します。

   ノートブックはリストから削除され、ノートブックの詳細は表示されなくなります。

1. 「Amazon Simple Storage Service ユーザーガイド」の「[S3 バケットからフォルダを削除する方法](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-folders.html)」の手順に従います。ステップ 3 からバケットとフォルダに移動します。

   —または—

    AWS CLI がインストールされている場合は、コマンドプロンプトを開き、この段落の最後に コマンドを入力します。Amazon S3 の場所を上記でコピーした場所に置き換えます。 AWS CLI が Amazon S3 の場所を削除するアクセス許可を持つユーザーのアクセスキーで設定されていることを確認します。詳細については、「[AWS CLIユーザーガイド](https://docs.aws.amazon.com/AmazonS3/latest/userguide/cli-chap-getting-started.html)」の「*AWS Command Line Interface の設定*。」を参照してください。

   ```
   aws s3 rm s3://{{MyNotebookLocationPath}}/{{NotebookID}}
   ```

## ノートブックファイルの共有
<a name="emr-managed-notebooks-file-sharing"></a>

各 EMR notebooks は、`{{NotebookName}}.ipynb` という名前のファイルとして Amazon S3 に保存されます。ノートブックファイルが、EMR Notebooks がベースにしている Jupyter Notebook の同じバージョンと互換性がある限り、ノートブックを EMR notebooks として開くことができます。

他のユーザーがノートブックファイルを開く最も簡単な方法は、ローカルのファイルシステムに他のユーザーが \*.ipynb ファイルを保存して、Jupyter および JupyterLab エディタのアップロード機能を使用することです。

このプロセスを使用して、他のユーザーによって共有された EMR ノートブック、Jupyter コミュニティで共有されたノートブックを使用できます。また、まだノートブックファイルがあるときにコンソールから削除されたノートブックを復元することもできます。

**EMR notebooks のベースとして別のノートブックファイルを使用するには**

1. 先に進む前に、使用するすべてのノートブックのノートブックエディタを閉じて、EMR notebooks の場合はノートブックを停止します。

1. EMR notebooks を作成して名前を入力します。ノートブックに入力した名前は、置き換える必要があるファイルの名前になります。新しいファイル名は、このファイル名と正確に一致する必要があります。

1. ノートブック用に選択した Amazon S3 内の場所をメモしておきます。置き換えたファイルは、次のパターンのようなパスとファイル名を持つフォルダにあります。`s3://{{MyNotebookLocation}}/{{NotebookID}}/{{MyNotebookName}}.ipynb`

1. ノートブックを停止します。

1. まったく同じ名前を使用して、Amazon S3 の場所にある古いノートブックファイルを新しいものと置き換えます。

   Amazon S3 の次の AWS CLI コマンドは、EMR Notebook `SharedNotebook.ipynb` の という名前のローカルマシンに保存されたファイルを **MyNotebook**、ID が で`e-12A3BCDEFJHIJKLMNO45PQRST`、Amazon S3 で`amzn-s3-demo-bucket/MyNotebooksFolder`指定された で作成されたファイルに置き換えます。Amazon S3 コンソールを使用してファイルをコピーおよび置き換える方法については、「*Amazon Simple Storage Service ユーザーガイド*」の「[オブジェクトのアップロード、ダウンロード、管理](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-download-objects.html)」を参照してください。

   ```
   aws s3 cp SharedNotebook.ipynb s3://amzn-s3-demo-bucket/MyNotebooksFolder/-12A3BCDEFJHIJKLMNO45PQRST/MyNotebook.ipynb
   ```