本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS Glue Studio 中的筆記本入門
<a name="notebook-getting-started"></a>

 透過 AWS Glue Studio 啟動筆記本，所有的設定步驟都會自動完成，以便您在幾秒鐘之後探索資料並開始開發任務指令碼。

 下列各節介紹如何建立角色並授予適當許可，以在 AWS Glue Studio 中將筆記本用於 ETL 任務。

 如需 Glue AWS 定義的動作的詳細資訊，請參閱 [Glue AWS 定義的動作。 ](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsglue.html)

**Topics**
+ [授予 IAM 角色的許可](#studio-notebook-permissions)

## 授予 IAM 角色的許可
<a name="studio-notebook-permissions"></a>

 設定 AWS Glue Studio 是使用筆記本的先決條件。

若要在 AWS Glue 中使用筆記本，您的角色需要滿足下列條件：
+  與 AWS Glue 之間的信任關係，用於 `sts:AssumeRole` 動作；若您想標記，則為 `sts:TagSession` 動作。
+  IAM 政策，其中包含筆記本、AWS Glue 和互動式工作階段的所有許可。
+  傳遞角色的 IAM 政策，原因是角色需要能將自身從筆記本傳遞至互動式工作階段。

 例如，當您建立新角色時，您可以將 等標準 AWS 受管政策新增至`AWSGlueConsoleFullAccessRole`角色，然後為筆記本操作新增政策，並為 IAM PassRole 政策新增另一個政策。

### 與 AWS Glue 之間信任關係的所需操作
<a name="create-notebook-permissions-trust"></a>

 在開始筆記本工作階段時，您必須將 `sts:AssumeRole` 新增至已傳遞至筆記本的角色信任關係。如果您的工作階段包含標籤，則您也必須傳遞 `sts:TagSession` 動作。如果沒有這些動作，將無法開始筆記本工作階段。

 例如：

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "glue.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}
```

------

### 包含筆記本 IAM 許可的政策
<a name="create-notebook-permissions-operations"></a>

 下列範例政策說明筆記本所需的 AWS IAM 許可。如果您要建立新角色，請建立包含下列項目的政策：

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "glue:StartNotebook",
        "glue:TerminateNotebook",
        "glue:GlueNotebookRefreshCredentials",
        "glue:DeregisterDataPreview",
        "glue:GetNotebookInstanceStatus",
        "glue:GlueNotebookAuthorize"
      ],
      "Resource": "*"
    }
  ]
}
```

------

 您可以使用以下 IAM 政策來允許存取特定資源：
+  *AwsGlueSessionUserRestrictedNotebookServiceRole*：提供存取所有 AWS Glue 資源的完整權限 (工作階段除外)。允許使用者僅建立並使用與使用者相關聯的筆記本工作階段。此政策也包含 AWS Glue 管理其他 AWS 服務中的AWS Glue資源所需的其他許可。
+  *AwsGlueSessionUserRestrictedNotebookPolicy*：提供允許使用者僅建立和使用與該使用者相關聯的筆記本工作階段的許可。此政策也包括明確允許使用者傳遞受限制 AWS Glue 工作階段角色的許可。

### 傳遞角色的 IAM 政策
<a name="create-notebook-permissions-pass-role"></a>

 在您使用角色建立筆記本時，系統會將該角色傳遞至互動式工作階段，以便在兩個位置皆可使用同一個角色。因此，`iam:PassRole` 許可需要成為角色政策的一部分。

 使用下列範例為角色建立新政策。用您的帳號與角色名稱取代範例中的值。

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "iam:PassRole",
      "Resource": "arn:aws:iam::{{111122223333}}:role/{{<role_name}}>"
    }
  ]
}
```

------