diff --git a/contents/docs/cdp/sources/clickhouse.mdx b/contents/docs/cdp/sources/clickhouse.mdx index 8400adeb8300..c81efca815f8 100644 --- a/contents/docs/cdp/sources/clickhouse.mdx +++ b/contents/docs/cdp/sources/clickhouse.mdx @@ -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). @@ -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"; diff --git a/contents/docs/cdp/sources/microsoft-sql-server.mdx b/contents/docs/cdp/sources/microsoft-sql-server.mdx index 7387d71df903..81e1fef719d4 100644 --- a/contents/docs/cdp/sources/microsoft-sql-server.mdx +++ b/contents/docs/cdp/sources/microsoft-sql-server.mdx @@ -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). @@ -36,6 +39,6 @@ The data warehouse then starts syncing your Azure SQL Server data. You can see d -import InboundIpAddresses from '../_snippets/inbound-ip-addresses.mdx' +import InboundIpAddresses from "../_snippets/inbound-ip-addresses.mdx"; diff --git a/contents/docs/cdp/sources/mysql.mdx b/contents/docs/cdp/sources/mysql.mdx index 8b6af2e7c6cb..33376064f60a 100644 --- a/contents/docs/cdp/sources/mysql.mdx +++ b/contents/docs/cdp/sources/mysql.mdx @@ -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). @@ -37,6 +40,6 @@ The data warehouse then starts syncing your MySQL data. You can see details and -import InboundIpAddresses from '../_snippets/inbound-ip-addresses.mdx' +import InboundIpAddresses from "../_snippets/inbound-ip-addresses.mdx"; diff --git a/contents/docs/cdp/sources/postgres.mdx b/contents/docs/cdp/sources/postgres.mdx index 22e644116364..624b9158d3a4 100644 --- a/contents/docs/cdp/sources/postgres.mdx +++ b/contents/docs/cdp/sources/postgres.mdx @@ -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. diff --git a/contents/docs/cdp/sources/snowflake.mdx b/contents/docs/cdp/sources/snowflake.mdx index dd815b4bdafe..891a821fff60 100644 --- a/contents/docs/cdp/sources/snowflake.mdx +++ b/contents/docs/cdp/sources/snowflake.mdx @@ -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` @@ -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`. @@ -34,9 +36,9 @@ 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. @@ -44,6 +46,6 @@ Once done, you can now [query](/docs/data-warehouse/query) your new table using -import InboundIpAddresses from '../_snippets/inbound-ip-addresses.mdx' +import InboundIpAddresses from "../_snippets/inbound-ip-addresses.mdx";