Skip to content

Commit 9d72c27

Browse files
committed
few grammatic updates. LGTM
1 parent a42f878 commit 9d72c27

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

src/connections/storage/data-lakes/data-lakes-manual-setup.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ The instructions below will guide you through the process required to configure
1111
In this step, you'll create the S3 bucket that will store both the intermediate and final data.
1212

1313
> info ""
14-
> Take note of the S3 bucket name you set in this step, as the rest of the set up flow requires it. In these instructions, `segment-data-lake` is used.
14+
> Take note of the S3 bucket name you set in this step, as the rest of the set up flow requires it. In these instructions, the name is `segment-data-lake`.
1515
1616
During the set up process, create a Lifecycle rule and set it to expire staging data after **14 days**. For more information, see Amazon's documentation, [How do I create a lifecycle?](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-lifecycle.html).
1717

@@ -25,10 +25,10 @@ Segment requires access to an EMR cluster to perform necessary data processing.
2525

2626
1. Locate and select EMR from the AWS console.
2727
2. Click **Create Cluster**, and open the **Advanced Options**.
28-
3. In the Advanced Options, on Step 1: Software and Steps, ensure the following options are selected, along with the defaults:
28+
3. In the Advanced Options, on Step 1: Software and Steps, ensure you select the following options, along with the defaults:
2929
- `Use for Hive table metadata`
3030
- `Use for Spark table metadata` ![Select to use for both Have and Spark table metadata](images/02_hive-spark-table.png)
31-
4. In the Networking setup section, select to create the cluster in either a public or private subnet. Creating the cluster in a private subnet is more secure, but requires some additional configuration. Creating a cluster in a public subnet is accessible from the internet. However, you can configure strict security groups to prevent inbound access to the cluster. See Amazon's document, [Amazon VPC Options - Amazon EMR](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-clusters-in-a-vpc.html) for more information. As a best practice, Segment recommends that you consult with your network and security before you configure your EMR cluster.
31+
4. In the Networking setup section, select to create the cluster in either a public or private subnet. Creating the cluster in a private subnet is more secure, but requires additional configuration. Creating a cluster in a public subnet is accessible from the internet. You can configure strict security groups to prevent inbound access to the cluster. See Amazon's document, [Amazon VPC Options - Amazon EMR](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-clusters-in-a-vpc.html) for more information. As a best practice, Segment recommends that you consult with your network and security before you configure your EMR cluster.
3232
5. In the Hardware Configuration section, create a cluster with the nodes listed below. This configuration uses the default **On demand** purchasing option for the instances.
3333
- **1** master node
3434
- **2** core nodes
@@ -39,23 +39,23 @@ For more information about configuring the cluster hardware and networking, see
3939

4040
### Configure logging
4141

42-
On the General Options step, configure logging to use the same S3 bucket you configured as the destination for the final data (`segment-data-lakes` in this case). Once configured, logs will be written to a new prefix, and separated from the final processed data.
42+
On the General Options step, configure logging to use the same S3 bucket you configured as the destination for the final data (`segment-data-lakes` in this case). Once configured, logs are to a new prefix, and separated from the final processed data.
4343

44-
Set value of the **vendor** tag to `segment`. This is used in the IAM policy to provide Segment access to submit jobs in the EMR cluster.
44+
Set value of the **vendor** tag to `segment`. The IAM policy uses this to provide Segment access to submit jobs in the EMR cluster.
4545

4646

4747
![Configure logging](images/05_logging.png)
4848

4949
### Secure the cluster
5050

51-
On the Security step, ensure that the following steps have been completed:
51+
On the Security step, be sure to complete the following steps:
5252
1. Create or select an **EC2 key pair**.
5353
2. Choose the appropriate roles in the **EC2 instance profile**.
5454
3. Select the appropriate security groups for the Master and Core & Task types.
5555

5656
![Secure the cluster](images/06_secure-cluster.png)
5757

58-
The image uses the default settings, however these settings can be made more restrictive, if required.
58+
The image uses the default settings. You can make these settings more restrictive, if required.
5959

6060

6161
## Step 3 - Create an Access Management role and policy
@@ -185,12 +185,12 @@ Add a policy to the role created above to give Segment access to the relevant Gl
185185
```
186186

187187
> note ""
188-
> **NOTE:** The policy above grants full access to Athena, but the individual Glue and S3 policies decide which table can be queried. Segment queries only for debugging purposes, and will notify you be for running any queries.
188+
> **NOTE:** The policy above grants full access to Athena, but the individual Glue and S3 policies decide which table is queryable. Segment queries for debugging purposes, and will notify you be for running any queries.
189189
190190
## Debugging
191191

192192
Segment requires access to the data and schema for debugging data quality issues. The modes available for debugging are:
193-
- Access the individual objects stored in S3 and the associated schema in order to understand data discrepancies
193+
- Access the individual objects stored in S3 and the associated schema to understand data discrepancies
194194
- Run an Athena query on the underlying data stored in S3
195195
- Ensure Athena uses Glue as the data catalog. Older accounts may not have this configuration, and may require some additional steps to complete the upgrade. The Glue console typically displays a warning and provides a link to instructions on how to complete the upgrade.
196196
![Debugging](images/dl_setup_glueerror.png)

0 commit comments

Comments
 (0)