Skip to content

Commit aacc0a8

Browse files
committed
Making changes requested in code review [DOC-504]
1 parent 88695ee commit aacc0a8

File tree

1 file changed

+22
-29
lines changed
  • src/connections/storage/catalog/postgres

1 file changed

+22
-29
lines changed

src/connections/storage/catalog/postgres/index.md

Lines changed: 22 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ This guide explains how to set up a Postgres database with Heroku. Heroku is a c
7171

7272
You can set up a Postgres database with Amazon Relational Database Service (RDS). RDS simplifies the process of setting up and administering a Postgres database.
7373

74-
Create a new PostgreSQL database in RDS by following the steps in Amazon's documentation, [Creating a PostgreSQL DB instance and connecting to a database on a PostgreSQL DB instance](http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html). For best performance, create your database in the `US West` region.
74+
Follow the steps in Amazon's documentation [Creating a PostgreSQL DB instance and connecting to a database on a PostgreSQL DB instance](http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html) to create a new PostgreSQL database in RDS. For best performance, create your database in the `US West` region.
7575

7676
> warning "Ensure your database is publicly accessible"
7777
> When you create your database, ensure that the **Public access** setting is set to **Yes**. Segment requires your database to be publicly accessible in order to connect to your database.
@@ -274,48 +274,41 @@ Yes! You can add indexes to your tables without blocking Segment syncs. However,
274274
275275
## Troubleshooting
276276
277-
<table>
278-
<tr>
279-
<td>Permission denied for database</td>
280-
<td>The syncs are failing due to a permissions issue. The user you configured does not have permission to connect to the appropriate database. To resolve these errors: connect to your warehouse using the owner account, or grant permissions to the account you use to connect to Segment. You can correct these permissions by running the following SQL statement, replacing `<user>` with the account you use to connect to Segment:
277+
### Permission denied for database
278+
The syncs are failing due to a permissions issue. The user you configured does not have permission to connect to the appropriate database. To resolve these errors: connect to your warehouse using the owner account, or grant permissions to the account you use to connect to Segment. You can correct these permissions by running the following SQL statement, replacing `<user>` with the account you use to connect to Segment:
281279
282-
`GRANT CONNECT ON DATABASE <database_name> TO <user>`</td>
283-
</tr>
284-
<tr>
285-
<td>Permission denied for schema</td>
286-
<td>The syncs for the source, `<source_name>`, are failing because of a permissions issue. In most cases, the user connected to Segment does not have permission to view the necessary schemas in the warehouse.
280+
`GRANT CONNECT ON DATABASE <database_name> TO <user>`
281+
282+
283+
### Permission denied for schema
284+
The syncs for the source, `<source_name>`, are failing because of a permissions issue. In most cases, the user connected to Segment does not have permission to view the necessary schemas in the warehouse.
287285
288286
To resolve these errors, connect your warehouse using the owner account, or grant permissions to the user you use to connect to Segment. You can correct these permissions by running the following SQL statement - Replace `user` with the user you use to connect to Segment, and run this statement for each schema in the warehouse.
289287
290-
`GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA <schema_name> TO <user>`</td>
291-
</tr>
292-
<tr>
293-
<td>Dial TCP: no such host</td>
294-
<td>We are unable to connect to the warehouse host, which is causing the syncs to fail. This error is usually due to an invalid host address, a warehouse hosted on a private IP, or a credentials issue.
288+
`GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA <schema_name> TO <user>`
289+
290+
### Dial TCP: no such host
291+
Segment is unable to connect to the warehouse host, which is causing the syncs to fail. This error is usually due to an invalid host address, a warehouse hosted on a private IP, or a credentials issue.
295292
296293
In order to resolve the error, check the following settings:
297294
298295
- The host address listed in your Segment warehouse settings is correct
299296
- The host is configured with a _publicly_ accessible IP address
300-
- The username and password you use to connect to your Segment workspace matches the username and password on the Warehouse directly</td>
301-
</tr>
302-
<tr>
303-
<td>Dial TCP: i/o timeout</td>
304-
<td>The warehouse syncs are failing due to a connection issue:
297+
- The username and password you use to connect to your Segment workspace matches the username and password on the Warehouse directly
298+
299+
### Dial TCP: i/o timeout
300+
The warehouse syncs are failing due to a connection issue:
305301
306302
`dial tcp XX.XXX.XXX.XXX:XXXX: i/o timeout`
307303
308304
This error can be caused for a few reasons:
309305
310-
- Your Warehouse went offline.
311-
- There's a setting needed for Segment to connect which hasn't been correctly configured. Refer to the [Warehouse documentation](/docs/connections/storage/warehouses/) to ensure all steps outlined there have been followed.</td>
312-
</tr>
313-
<tr>
314-
<td>Schema <schema_name> does not exist</td>
315-
<td>The syncs are failing due to a permissions issue. It looks like the user connected does not have permission to create schemas in your warehouse.
306+
- Your warehouse went offline.
307+
- There's a setting needed for Segment to connect which hasn't been correctly configured. Refer to the [Warehouse documentation](/docs/connections/storage/warehouses/) to ensure all steps outlined there have been followed.
308+
309+
### Schema <schema_name> does not exist
310+
The syncs are failing due to a permissions issue. It looks like the user connected does not have permission to create schemas in your warehouse.
316311
317312
To resolve these errors Segment recommends connecting to your warehouse using the owner account, or granting permissions to the current account you use to connect to Segment. You can correct these permissions by running the following SQL statement - Replace `user` with the account you use to connect to Segment, and run this statement for each schema in the warehouse.
318313
319-
`GRANT CREATE ON DATABASE <database_name> TO <user>`</td>
320-
</tr>
321-
</table>
314+
`GRANT CREATE ON DATABASE <database_name> TO <user>`

0 commit comments

Comments
 (0)