Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 16 additions & 13 deletions contents/docs/cdp/sources/clickhouse.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,19 +16,22 @@ To link ClickHouse:
1. Go to the [Data pipeline page](https://app.posthog.com/data-management/sources) and the sources tab in PostHog
2. Click **New source** and select ClickHouse
3. Enter your database connection details:
- **Host:** The hostname or IP of your ClickHouse server like `play.clickhouse.com` or `123.132.1.100`.
- **Port:** The HTTP(S) port your ClickHouse server is listening on. The default is `8443` for HTTPS and `8123` for HTTP.
- **Database:** The name of the database you want to sync. The default is `default`.
- **User:** The username with read permissions on the database.
- **Password:** The password for the user (optional).
- **Use HTTPS?:** Whether to connect over HTTPS. Default is enabled.
- **Verify SSL certificate?:** Whether to verify the server's SSL certificate. Default is enabled. Disable if your server uses a self-signed certificate.

> **Tip:** You can paste a connection string URL to auto-populate the fields below. Supported schemes are `https://`, `http://`, `clickhouse://`, and `clickhouses://`. The secure setting and default port are derived from the scheme (`https` → port `8443`, `http` → `8123`, `clickhouses` → `9440`, `clickhouse` → `9000`).
- **Host:** The hostname or IP of your ClickHouse server like `play.clickhouse.com` or `123.132.1.100`.
- **Port:** The HTTP(S) port your ClickHouse server is listening on. The default is `8443` for HTTPS and `8123` for HTTP.
- **Database:** The name of the database you want to sync. The default is `default`.
- **User:** The username with read permissions on the database.
- **Password:** The password for the user (optional).
- **Use HTTPS?:** Whether to connect over HTTPS. Default is enabled.
- **Verify SSL certificate?:** Whether to verify the server's SSL certificate. Default is enabled. Disable if your server uses a self-signed certificate.

4. If you need to connect through an SSH tunnel, enable and configure it (optional):
- **Tunnel host:** The hostname of your SSH server.
- **Tunnel port:** The port your SSH server is listening on.
- **Authentication type:**
- For password authentication, enter your SSH username and password.
- For key-based authentication, enter your SSH username, private key, and optional passphrase.
- **Tunnel host:** The hostname of your SSH server.
- **Tunnel port:** The port your SSH server is listening on.
- **Authentication type:**
- For password authentication, enter your SSH username and password.
- For key-based authentication, enter your SSH username, private key, and optional passphrase.
5. Click **Next**

The data warehouse then starts syncing your ClickHouse data. You can see details and progress in the [sources tab](https://app.posthog.com/data-management/sources).
Expand Down Expand Up @@ -61,6 +64,6 @@ ClickHouse's Arrow output does not support every type, so PostHog serializes the

`Nullable` and `LowCardinality` wrappers, `DateTime`/`DateTime64` precision and timezones, and `Decimal[32–256]` are all preserved natively.

import InboundIpAddresses from '../_snippets/inbound-ip-addresses.mdx'
import InboundIpAddresses from "../_snippets/inbound-ip-addresses.mdx";

<InboundIpAddresses />
17 changes: 10 additions & 7 deletions contents/docs/cdp/sources/microsoft-sql-server.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,12 +22,15 @@ To link Azure SQL Server:
1. Go to the [Data pipeline page](https://app.posthog.com/data-management/sources) and the sources tab in PostHog
2. Click **New source** and select Azure SQL Server
3. Enter your database connection details:
- **Host:** The hostname or IP your database server like `db.example.com` or `123.132.1.100`.
- **Port:** The port your database server is listening to. The default is `1433`.
- **Database:** The name of the database you want like `analytics_db`.
- **User:** The username with the necessary permissions to access the database.
- **Password:** The password for the user.
- **Schema:** The schema for your database where your tables are located. The default is `dbo`.

> **Tip:** You can paste a connection string in the format `mssql://user:password@host:port/database` or `sqlserver://user:password@host:port/database` to auto-populate the fields below.
- **Host:** The hostname or IP your database server like `db.example.com` or `123.132.1.100`.
- **Port:** The port your database server is listening to. The default is `1433`.
- **Database:** The name of the database you want like `analytics_db`.
- **User:** The username with the necessary permissions to access the database.
- **Password:** The password for the user.
- **Schema:** The schema for your database where your tables are located. The default is `dbo`.

4. Click **Link**

The data warehouse then starts syncing your Azure SQL Server data. You can see details and progress in the [sources tab](https://app.posthog.com/data-management/sources).
Expand All @@ -36,6 +39,6 @@ The data warehouse then starts syncing your Azure SQL Server data. You can see d

<SourceParameters />

import InboundIpAddresses from '../_snippets/inbound-ip-addresses.mdx'
import InboundIpAddresses from "../_snippets/inbound-ip-addresses.mdx";

<InboundIpAddresses />
29 changes: 16 additions & 13 deletions contents/docs/cdp/sources/mysql.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,19 +16,22 @@ To link MySQL:
1. Go to the [Data pipeline page](https://app.posthog.com/data-management/sources) and the sources tab in PostHog
2. Click **New source** and select MySQL
3. Enter your database connection details:
- **Host:** The hostname or IP your database server like `db.example.com` or `123.132.1.100`.
- **Port:** The port your database server is listening to. The default is `3306`.
- **Database:** The name of the database you want like `analytics_db`.
- **User:** The username with the necessary permissions to access the database.
- **Password:** The password for the user.
- **Schema:** The schema for your database where your tables are located. The default is `public`.
- **Use SSL:** Whether to use SSL for the connection. Default is enabled.

> **Tip:** Paste a connection string in the format `mysql://user:password@host:port/database` to auto-populate the fields below. SSL parameters like `?ssl=true` or `?useSSL=true` are also detected.
- **Host:** The hostname or IP your database server like `db.example.com` or `123.132.1.100`.
- **Port:** The port your database server is listening to. The default is `3306`.
- **Database:** The name of the database you want like `analytics_db`.
- **User:** The username with the necessary permissions to access the database.
- **Password:** The password for the user.
- **Schema:** The schema for your database where your tables are located. The default is `public`.
- **Use SSL:** Whether to use SSL for the connection. Default is enabled.

4. If you need to connect through an SSH tunnel, enable and configure it (optional):
- **Tunnel host:** The hostname of your SSH server.
- **Tunnel port:** The port your SSH server is listening on.
- **Authentication type:**
- For password authentication, enter your SSH username and password.
- For key-based authentication, enter your SSH username, private key, and optional passphrase.
- **Tunnel host:** The hostname of your SSH server.
- **Tunnel port:** The port your SSH server is listening on.
- **Authentication type:**
- For password authentication, enter your SSH username and password.
- For key-based authentication, enter your SSH username, private key, and optional passphrase.
5. Click **Next**

The data warehouse then starts syncing your MySQL data. You can see details and progress in the [sources tab](https://app.posthog.com/data-management/sources).
Expand All @@ -37,6 +40,6 @@ The data warehouse then starts syncing your MySQL data. You can see details and

<SourceParameters />

import InboundIpAddresses from '../_snippets/inbound-ip-addresses.mdx'
import InboundIpAddresses from "../_snippets/inbound-ip-addresses.mdx";

<InboundIpAddresses />
3 changes: 3 additions & 0 deletions contents/docs/cdp/sources/postgres.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,12 +16,15 @@ To link Postgres:
1. Go to the [Data pipeline page](https://app.posthog.com/data-management/sources) and the sources tab in PostHog
2. Click **New source** and select Postgres
3. Enter your database connection details:

> **Tip:** Paste a connection string in the format `postgres://user:password@host:port/database` to auto-populate the fields below.
- **Host:** The hostname or IP your database server like `db.example.com` or `123.132.1.100`.
- **Port:** The port your database server is listening to. The default is `5432`.
- **Database:** The name of the database you want like `analytics_db`.
- **User:** The username with the necessary permissions to access the database.
- **Password:** The password for the user.
- **Schema:** The schema for your database where your tables are located. The default is `public`.

4. If you need to connect through an SSH tunnel, enable and configure it (optional):
- **Tunnel host:** The hostname of your SSH server.
- **Tunnel port:** The port your SSH server is listening on.
Expand Down
14 changes: 8 additions & 6 deletions contents/docs/cdp/sources/snowflake.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,12 @@ availability:
sourceId: Snowflake
---

The data warehouse can link to data in Snowflake.
The data warehouse can link to data in Snowflake.

Start by going to the [Data pipeline page](https://app.posthog.com/data-management/sources) and the sources tab and clicking **New source**. Choose Snowflake and enter the following data:

> **Tip:** You can paste a connection string in the format `snowflake://user:password@account_id/database/schema?warehouse=X&role=Y` to auto-populate the fields below. This only works with password authentication.

- **Account identifier**: Likely a combination of your organization and the name of the account (e.g. `myorg-account123`). You can find this in the sidebar account selector or by executing the `CURRENT_ACCOUNT_NAME` and `CURRENT_ORGANIZATION_NAME` functions in SQL.
- **Database**: Like `tasty_bytes_sample_data`
- **Warehouse**: Like `compute_wh`
Expand All @@ -23,9 +25,9 @@ Start by going to the [Data pipeline page](https://app.posthog.com/data-manageme
- **Table Prefix:** The optional prefix for your tables in PostHog. For example, if your table name ended up being `menu`, a prefix of `snow_prod_` would create a table in PostHog called `snow_prod_menu`.

<ProductScreenshot
imageLight="https://res.cloudinary.com/dmukukwp6/image/upload/Clean_Shot_2024_07_23_at_13_50_56_2x_c31bfa6237.png"
imageLight="https://res.cloudinary.com/dmukukwp6/image/upload/Clean_Shot_2024_07_23_at_13_50_56_2x_c31bfa6237.png"
imageDark="https://res.cloudinary.com/dmukukwp6/image/upload/Clean_Shot_2024_07_23_at_13_50_42_2x_aa20de1109.png"
alt="Snowflake details"
alt="Snowflake details"
classes="rounded"
/>

Expand All @@ -34,16 +36,16 @@ Once added, click **Next**, select the tables you want to sync, as well as the [
Once done, you can now [query](/docs/data-warehouse/query) your new table using the table name.

<ProductScreenshot
imageLight="https://res.cloudinary.com/dmukukwp6/image/upload/Clean_Shot_2024_07_23_at_13_56_32_2x_9c0bc2d35f.png"
imageLight="https://res.cloudinary.com/dmukukwp6/image/upload/Clean_Shot_2024_07_23_at_13_56_32_2x_9c0bc2d35f.png"
imageDark="https://res.cloudinary.com/dmukukwp6/image/upload/Clean_Shot_2024_07_23_at_13_56_53_2x_76a2b7f711.png"
alt="Snowflake details"
alt="Snowflake details"
classes="rounded"
/>

## Configuration

<SourceParameters />

import InboundIpAddresses from '../_snippets/inbound-ip-addresses.mdx'
import InboundIpAddresses from "../_snippets/inbound-ip-addresses.mdx";

<InboundIpAddresses />
Loading