You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/storage/data-lakes/lake-formation.md
+26-14Lines changed: 26 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,46 +6,58 @@ AWS Lake Formation is a fully managed service built on top of the AWS Glue Data
6
6
> note "Learn more about AWS Lake Formation features"
7
7
> To learn more about AWS Lake Formation features, refer to the [Amazon Web Services documentation](https://aws.amazon.com/lake-formation/features/).
8
8
9
-
<!---add description of how the security works, because the secure aspect is a big selling point-->
9
+
<!--add description of how the security works, because the secure aspect is a big selling point-->
10
10
11
11
## Configuring Lake Formation
12
-
You can configure Lake Formation using the [`IAMAllowedPrincipals` group](#configuring-lake-formation-using-the-iamallowedprincipals-group) or by [using IAM policies for access control](#configuring-lake-formation-using-iam-policies). With the `IAMAllowedPrincipals` group,
13
-
<!--add use case explanation, finish sentence here-->
12
+
You can configure Lake Formation using the [`IAMAllowedPrincipals` group](#configuring-lake-formation-using-the-iamallowedprincipals-group) or by [using IAM policies for access control](#configuring-lake-formation-using-iam-policies). Configuring Lake Formation using the `IAMAllowedPrincipals` group is an easier method, recommended for those exploring Lake Formation. Setting up using IAM policies for access control is a more advanced setup option, recommended for those who want additional customization options.
14
13
15
14
> info "Permissions required to configure Data Lakes"
16
-
> To configure Lake Formation, you must be logged in to AWS with data lake administrator or a database creator permissions.
15
+
> To configure Lake Formation, you must be logged in to AWS with data lake administrator or database creator permissions.
17
16
18
17
### Configuring Lake Formation using the IAMAllowedPrincipals group
19
18
20
19
#### Existing databases
21
20
1. Open the [AWS Lake Formation service](https://console.aws.amazon.com/lakeformation/).
22
-
2. Under **Data catalog**, select the settings tab. Ensure the check boxes under the **Default permissions for newly created databases and tables** are not checked.
23
-
3. Under **Permissions**, select the **Admins and database creators** section and give your EMR instance profile role (`EMR_EC2-DEFAULT` if you created your EMR cluster manually, or `segment_emr_instance_profile` if you set it up using Terraform) to the **Database creators** section.
21
+
2. Under **Data catalog**, select the **Settings** tab. Ensure the checkboxes under the **Default permissions for newly created databases and tables** are not checked.
22
+
3. Under **Permissions**, select the **Data lake permissions** section. Select the **Grant** button.
23
+
4. On the **Grant data permissions** page, select the `IAMAllowedPrincipals` group in the Principals section.
24
+
5. Under the **Database permissions** section, select the checkboxes for **Super** database permissions and **Super** grantable permissions.
25
+
6. Select the **Grant** button.
26
+
7. On the **Permissions** page, verify the `IAMAllowedPrincipals` group is listed.
24
27
25
28
#### New databases
26
29
1. Open the [AWS Lake Formation service](https://console.aws.amazon.com/lakeformation/).
27
-
2. Under **Data catalog**, select the settings tab. Ensure the check boxes under the **Default permissions for newly created databases and tables** are not checked.
28
-
3. Select the Databases tab. Click the **Create database** button, and create your database:
30
+
2. Under **Data catalog**, select the **Settings** tab. Ensure the checkboxes under the **Default permissions for newly created databases and tables** are not checked.
31
+
3. Select the Databases tab. Click the **Create database** button, and create your database.
29
32
1. Select the **Database** button.
30
33
2. Name your database.
31
34
3. Set the location to `s3://$datalake_bucket/segment-data/`. <br/> **Optional:** Add a description to your database.
32
35
4. Select the `Use only IAM access control for new tables in this database`.
33
36
5. Click **Create database**.
34
-
4.
35
-
<!---asked Udit where the next step lives for the new databases section: doc isn't super clear?-->
37
+
4. On the **Databases** page, select your database. From the **Actions** menu, select **Grant** under the Permissions section.
38
+
5. On the **Grant data permissions** page, select the `IAMAllowedPrincipals` group in the Principals section.
39
+
6. Under the **Database permissions** section, select the checkboxes for **Super** database permissions and **Super** grantable permissions.
40
+
7. Select the **Grant** button.
41
+
8. On the **Permissions** page, verify the `IAMAllowedPrincipals` group is listed.
42
+
43
+
#### Verifying your configuration
44
+
To verify that you've successfully configured Lake Formation, open the [AWS Lake Formation service](https://console.aws.amazon.com/lakeformation/), select **Data lake permissions**, and verify the `IAMAllowedPrincipals` group is listed with "All" permissions.
36
45
37
46
### Configuring Lake Formation using IAM policies
38
47
48
+
<!-- totally start this section from scratch-->
49
+
39
50
#### Existing databases
40
-
1. Open the [AWS Lake Formation service](https://console.aws.amazon.com/lakeformation/).
51
+
1. Open the [AWS Lake Formation service](https://console.aws.amazon.com/lakeformation/).
52
+
2. Under **Data catalog**, select the settings tab. Ensure the checkboxes under the **Default permissions for newly created databases and tables** are not checked.
53
+
3.
41
54
42
55
#### New databases
43
56
1. Open the [AWS Lake Formation service](https://console.aws.amazon.com/lakeformation/).
44
-
2. Under **Data catalog**, select the settings tab. Ensure the check boxes under the **Default permissions for newly created databases and tables** are not checked.
57
+
2. Under **Data catalog**, select the settings tab. Ensure the checkboxes under the **Default permissions for newly created databases and tables** are not checked.
45
58
3. Select the Databases tab. Click the **Create database** button, and create your database:
46
59
1. Select the **Database** button.
47
60
2. Name your database.
48
61
3. Set the location to `s3://$datalake_bucket/segment-data/`. <br/> **Optional:** Add a description to your database.
49
62
4. Click **Create database**.
50
-
4.
51
-
<!---same as note above: not sure where next step lives for either new/existing databases-->
0 commit comments