Merge pull request #41 from DataRecce/feature/drc-1833-add-warehouse-connection-document-in-the-doc-site

Add the "connect to warehouse" doc

Author: popcornylu

docs/2-getting-started/start-free-with-cloud.md

@@ -86,16 +86,19 @@ Go beyond metadata to see how changes affect your actual data. Configure your da
 ### Supported Warehouses
 
 - Snowflake
-- others are on upcoming future
+- Databricks
+- Others coming in future releases
 
 ### Warehouse Connection
 
-Configure connection to your data warehouse to enable query result comparisons.
+Configure connection to your data warehouse to enable query result comparisons. For detailed connection settings, see [Connect to Warehouse](../5-data-diffing/connect-to-warehouse.md).
 
 **Connection setup:**
 
 1. Navigate to [settings](https://cloud.reccehq.com/settings#organization){target="_blank"}
 2. Add Connection
+3. Navigate to your [project home](https://cloud.datarecce.io/) and open the project settings by clicking the gear icon
+4. Link the newly added connection to your project
 
 Your connection credentials are secure. See our [security practices](https://reccehq.com/security/){target="_blank"} for details.
 

docs/5-data-diffing/connect-to-warehouse.md

@@ -0,0 +1,39 @@
+---
+title: Connect to Warehouse
+---
+
+## Recce OSS
+Recce OSS supports all warehouses that dbt supports. It uses the same configuration as dbt, simply use your existing dbt profiles to connect to your warehouse. No additional setup required.
+
+## Recce Cloud
+If you use Recce Cloud, here are the warehouse connection settings. We currently support:
+
+- [Snowflake](#snowflake)
+- [Databricks](#databricks)
+
+Others are coming in future releases
+
+### Snowflake
+We only support password-based authentication.
+
+Field | Description | Examples
+----|------|----
+`account` | The Snowflake account to connect to | `xxxxxx.us-central1.gcp`
+`database` | The default database to connect to | `MYDB`
+`schema` | The default schema to connect to | `PUBLIC`
+`warehouse` | The warehouse to use when running queries | `WH_LOAD`
+`user` | The user to log in as | `MYUSER`
+`password` | The password for the user | `MYPASS`
+
+
+### Databricks
+
+We only support token-based authentication.
+
+Field | Description | Examples
+----|------|----
+`host` | The hostname of your cluster | `YOURORG.databrickshost.com`
+`http_path` | The HTTP path to your SQL Warehouse or all-purpose cluster | `/SQL/YOUR/HTTP/PATH`
+`catalog` | The catalog used to connect to the warehouse. This is optional if you are using Unity Catalog | `MY_CATALOG`
+`schema` | The default schema to connect to | `MY_SCHEMA`
+`token` | The Personal Access Token (PAT) to connect to Databricks | `dapiXXXXXXXXXXXXXXXXXXXXXXX`

docs/styles/extra.css

@@ -39,6 +39,10 @@
 	font-weight: bold;
 } */
 
+.md-nav__item--section>.md-nav__link {
+	color: #000 !important;
+}
+
 .md-nav__link[href]:hover {
 	color: #ff6e42;
 }

mkdocs.yml

@@ -63,6 +63,7 @@ nav:
           - 4-downstream-impacts/breaking-change-analysis.md
           #- 4-downstream-impacts/transformation-types.md
       - Data Diffing:
+          - 5-data-diffing/connect-to-warehouse.md
           - 5-data-diffing/row-count-diff.md
           - 5-data-diffing/profile-diff.md
           - 5-data-diffing/value-diff.md