Skip to content

Commit 0581b4f

Browse files
committed
DOC-467 Added more context from testing
1 parent 748c177 commit 0581b4f

File tree

1 file changed

+26
-14
lines changed

1 file changed

+26
-14
lines changed

src/connections/storage/data-lakes/lake-formation.md

Lines changed: 26 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -6,46 +6,58 @@ AWS Lake Formation is a fully managed service built on top of the AWS Glue Data
66
> note "Learn more about AWS Lake Formation features"
77
> To learn more about AWS Lake Formation features, refer to the [Amazon Web Services documentation](https://aws.amazon.com/lake-formation/features/).
88
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-->
1010

1111
## 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.
1413

1514
> 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.
1716
1817
### Configuring Lake Formation using the IAMAllowedPrincipals group
1918

2019
#### Existing databases
2120
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.
2427

2528
#### New databases
2629
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.
2932
1. Select the **Database** button.
3033
2. Name your database.
3134
3. Set the location to `s3://$datalake_bucket/segment-data/`. <br/> **Optional:** Add a description to your database.
3235
4. Select the `Use only IAM access control for new tables in this database`.
3336
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.
3645

3746
### Configuring Lake Formation using IAM policies
3847

48+
<!-- totally start this section from scratch-->
49+
3950
#### 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.
4154

4255
#### New databases
4356
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.
4558
3. Select the Databases tab. Click the **Create database** button, and create your database:
4659
1. Select the **Database** button.
4760
2. Name your database.
4861
3. Set the location to `s3://$datalake_bucket/segment-data/`. <br/> **Optional:** Add a description to your database.
4962
4. Click **Create database**.
50-
4.
51-
<!---same as note above: not sure where next step lives for either new/existing databases-->
63+
4.

0 commit comments

Comments
 (0)