Skip to content

Commit 1d37c3e

Browse files
committed
Updating Db2 steps/editing pass
1 parent 7cb5529 commit 1d37c3e

File tree

1 file changed

+26
-48
lines changed
  • src/connections/storage/catalog/db2

1 file changed

+26
-48
lines changed

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

Lines changed: 26 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -15,77 +15,55 @@ Warehouse and Segment in a flash.
1515
1616
## Getting Started
1717

18-
To get started, you'll need to create a Db2 user for Segment, give that user
19-
sufficient permissions, and then create the Segment Db2 Destination.
18+
To get started, you'll need to [create a Db2 user for Segment](#create-a-user-for-segment), [give that user sufficient permissions](#give-the-segment-user-permissions), and then [create the Segment Db2 Destination](#create-segment-db2-destination).
2019

2120
### Create a User for Segment
2221

23-
To create the user account that Segment will use to load data, open the
24-
top-left menu and navigate to Settings → Manage Users:
22+
In order to connect your IBM Db2 warehouse to Segment, you need to create a user account that Segment can assume. To create a user account for Segment:
2523

26-
<img src="./images/db2_menu.png" style="max-width: 380px">
24+
1. Open the Db2 warehouse. Click the top-left menu, select **Administration**, and open the **User management** tab.
2725

28-
Then click on "Add":
26+
2. Click **Add**.
2927

30-
<img src="./images/manage_users.png" style="max-width: 437px">
31-
32-
Fill in your desired Segment user settings and make sure that their Privilege
33-
is "User". You will enter these settings in to Segment later:
34-
35-
<img src="./images/add_user.png" style="max-width: 394px">
28+
3. Create a new user account with "User" priveleges. Save the username and password, as these are required to set up the Segment configuration in a later step.
3629

3730
### Give the Segment User Permissions
3831

39-
In order to load data, your new Segment Db2 user will need permissions to
40-
load that data. Open the top-left menu and navigate to Run SQL:
41-
42-
<img src="./images/run_sql.png" style="max-width: 325px">
43-
44-
In the SQL input, type "GRANT CONNECT, CREATETAB, IMPLICIT_SCHEMA ON DATABASE TO
45-
USER segment":, replacing "segment" with the user ID that you chose above:
46-
47-
<img src="./images/grant.png" style="max-width: 616px">
48-
49-
Select Run → Run All to execute the `GRANT` command.
32+
Now that you created an IBM Db2 user for Segment, you must grant the Segment user permission to connect to your database. To grant the Segment user access to your database:
33+
1. Open the top-left menu and select **Run SQL**.
34+
2. In the SQL input, copy the following code snippet, replacing "segment_user" with the user ID that you created above:
35+
```json
36+
GRANT CONNECT, CREATETAB, IMPLICIT_SCHEMA ON DATABASE TO USER <segment_user>
37+
```
38+
3. Select Run All to execute the `GRANT` command.
5039

5140
### Create Segment Db2 Destination
5241

53-
In the Segment App, select Add Destination:
54-
55-
<img src="./images/add_destination.png" style="max-width: 682px">
56-
57-
Search for and select "Db2":
58-
59-
<img src="./images/search_results.png" style="max-width: 842px">
60-
61-
Add your credentials as follows:
62-
63-
- Host (Found in Settings → Connection Info → Connection Information)
64-
- Port (50001 is Db2 Default)
65-
- Database name
66-
- User (This is the "User ID" that you created above)
67-
- Password
68-
- Security (Enter "SSL" in this field if applicable - optional)
42+
To set up an IBM Db2 destination in the Segment app:
6943

44+
1. Open the Segment app. Select **Connections** and click **Add Destination**.
45+
2. Search for and select IBM Db2 Warehouse.
46+
3. Select the sources you want to connect to the IBM Db2 warehouse, and click **Next**.
47+
4. Enter a name for your destination, and enter the following credentials:
48+
- Host (Found in your Db2 instance, under Administration → Connections)
49+
- Port (50001 is the default for Db2)
50+
- Database name (Found in your Db2 instance, under Administration → Connections)
51+
- User (This is the "User ID" that you created above)
52+
- Password (This is the "Password" that you created above)
53+
- Security (Enter "SSL" in this field)
7054

71-
<img src="./images/settings.png" style="max-width: 540px">
7255

73-
Click connect to test the connection. If the connection is valid, your Db2
74-
Destination will be enabled! Segment will begin syncing data to your Db2
75-
database shortly.
56+
Click **Connect** to complete the setup
7657

7758
## Security
7859

7960
### Allowlisting IPs
8061

81-
If your Db2 Warehouse is in a private network, be sure to [allowlist Segment's IP address](/docs/connections/storage/warehouses/faq/#which-ips-should-i-allowlist).
82-
Otherwise, Segment can't load your data.
62+
If your Db2 Warehouse is in a private network, be sure to [allowlist Segment's IP address](/docs/connections/storage/warehouses/faq/#which-ips-should-i-allowlist) when creating the Db2 user Segment assumes. Otherwise, Segment won't be able to load your data.
8363

8464
### Unique User
8565

86-
Segment recommends you to create a unique User for the Segment Db2 Warehouse
87-
connection to your Db2 Warehouse instance so that you can manage permissions
88-
separately.
66+
Segment recommends you to create a unique User for the Segment Db2 Warehouse connection to your Db2 Warehouse instance so that you can manage permissions separately.
8967

9068
### SSL/TLS
9169
Always require SSL/TLS and make sure your data warehouse can only accept secure connections. Segment only connects to your data warehouse using SSL/TLS.

0 commit comments

Comments
 (0)