ノートブック実行の Ruby サンプル

注記

EMR Notebooks は、新しいコンソールで EMR Studio Workspace として使用できます。古いコンソールでは既存のノートブックを引き続き使用できますが、古いコンソールでは新しいノートブックを作成できません。この機能は、新しいコンソールの [ワークスペースの作成] ボタンに置き換わります。EMR Notebooks ユーザーが Workspace にアクセスしたり作成したりするには、追加の IAM ロール権限が必要です。詳細については、「Amazon EMR Notebooks are Amazon EMR Studio Workspaces in new console」および「What's new in the console?」を参照してください。

次に、ノートブック実行 API の使用方法を示す Ruby コードサンプルを示します。

# prepare an Amazon EMR client

emr = Aws::EMR::Client.new(
  region: 'us-east-1',
  access_key_id: 'AKIA...JKPKA',
  secret_access_key: 'rLMeu...vU0OLrAC1',
)

ノートブックの実行を開始し、実行 ID を取得する

この例では、Amazon S3 エディタと EMR Notebooks は s3://mybucket/notebooks/e-EA8VGAA429FEQTC8HC9ZHWISK/test.ipynb です。

Amazon EMR API NotebookExecution アクションの詳細については、「Amazon EMR API actions」を参照してください。

start_response = emr.start_notebook_execution({
    editor_id: "e-EA8VGAA429FEQTC8HC9ZHWISK",
    relative_path: "test.ipynb",
    
    execution_engine: {id: "j-3U82I95AMALGE"},
    
    service_role: "EMR_Notebooks_DefaultRole",
})


notebook_execution_id = start_resp.notebook_execution_id

ノートブックの実行を記述し、詳細を出力する

describe_resp = emr.describe_notebook_execution({
    notebook_execution_id: notebook_execution_id
})
puts describe_resp.notebook_execution

上記のコマンドの出力は以下のとおりです。

{
:notebook_execution_id=>"ex-IZX3VTVZWVWPP27KUB90BZ7V9IEDG", 
:editor_id=>"e-EA8VGAA429FEQTC8HC9ZHWISK",
:execution_engine=>{:id=>"j-3U82I95AMALGE", :type=>"EMR", :master_instance_security_group_id=>nil}, 
:notebook_execution_name=>"", 
:notebook_params=>nil, 
:status=>"STARTING", 
:start_time=>2020-07-23 15:07:07 -0700, 
:end_time=>nil, 
:arn=>"arn:aws:elasticmapreduce:us-east-1:123456789012:notebook-execution/ex-IZX3VTVZWVWPP27KUB90BZ7V9IEDG", 
:output_notebook_uri=>nil, 
:last_state_change_reason=>"Execution is starting for cluster j-3U82I95AMALGE.", :notebook_instance_security_group_id=>nil, 
:tags=>[]
}

ノートブックフィルター

"EditorId": "e-XXXX",           [Optional]
"From" : "1593400000.000",    [Optional]
"To" :

ノートブックの実行を停止する

stop_resp = emr.stop_notebook_execution({
    notebook_execution_id: notebook_execution_id
})