diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/connect_data_source.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/connect_data_source.png new file mode 100644 index 0000000000..1fea5c2be1 Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/connect_data_source.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/create_built_in_report.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/create_built_in_report.png new file mode 100644 index 0000000000..1eb2fa686c Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/create_built_in_report.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/create_dashboard.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/create_dashboard.png new file mode 100644 index 0000000000..4e49434861 Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/create_dashboard.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/create_gd.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/create_gd.png new file mode 100644 index 0000000000..f0db9c7bf5 Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/create_gd.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/create_rb.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/create_rb.png new file mode 100644 index 0000000000..c452fd3cef Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/create_rb.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/dashboard_config.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/dashboard_config.png new file mode 100644 index 0000000000..0f61207c04 Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/dashboard_config.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/drag_bar_chart.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/drag_bar_chart.png new file mode 100644 index 0000000000..ea151b016c Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/drag_bar_chart.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/enter_credentials.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/enter_credentials.png new file mode 100644 index 0000000000..55cbd50f58 Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/enter_credentials.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/finished_report.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/finished_report.png new file mode 100644 index 0000000000..83b67184aa Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/finished_report.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/gd_commit.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/gd_commit.png new file mode 100644 index 0000000000..97f8efa083 Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/gd_commit.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/rb_create_dataset.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/rb_create_dataset.png new file mode 100644 index 0000000000..af153293ca Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/rb_create_dataset.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/rb_dataset_config.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/rb_dataset_config.png new file mode 100644 index 0000000000..9e47dc8a99 Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/rb_dataset_config.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/select_database.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/select_database.png new file mode 100644 index 0000000000..43a6c82bc9 Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/select_database.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/successful_db_connection.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/successful_db_connection.png new file mode 100644 index 0000000000..b735204ba8 Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/successful_db_connection.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/unsynced_tables.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/unsynced_tables.png new file mode 100644 index 0000000000..f6d931f317 Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/unsynced_tables.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/write_gd.png b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/write_gd.png new file mode 100644 index 0000000000..17e274be56 Binary files /dev/null and b/site/sfguides/src/build_analytics_with_explo_and_snowflake/assets/write_gd.png differ diff --git a/site/sfguides/src/build_analytics_with_explo_and_snowflake/build_analytics_with_explo_and_snowflake.md b/site/sfguides/src/build_analytics_with_explo_and_snowflake/build_analytics_with_explo_and_snowflake.md new file mode 100644 index 0000000000..e8a577f38f --- /dev/null +++ b/site/sfguides/src/build_analytics_with_explo_and_snowflake/build_analytics_with_explo_and_snowflake.md @@ -0,0 +1,132 @@ +author: Annette Chen +id: explo_integration +summary: Explo Integration +categories: Analytics,Getting-Started,Partner-Integrations +environments: web +status: Published +feedback link: https://github.com/Snowflake-Labs/sfguides/issues +tags: Getting Started, Analytics, Dashboards, Explo + +# Explo Integration + + + +## Overview + +Duration: 1 + +[Explo](https://explo.co) is an customer-facing analytics platform that enables embedding of interactive dashboards and reports into your customer-facing web applications. In this guide, you'll learn how to connect a Snowflake database to Explo and begin building a dashboard or report. + +### Prerequisites + +- A Snowflake account with a database +- An Explo account +- Familiarity with basic SQL + +### What You’ll Learn + +- How to connect a Snowflake database in an Explo workspace +- How to build a dataset in Explo that can be used to create dashboards and reports + + + +## Connect Snowflake data in Explo + +Duration: 10 + +In the Explo application, go to the Data page and click on `Connect Datasource`. + +![Connect Datasource](assets/connect_data_source.png) + +First, give your database a nickname, and create a new schema for your datasource. On the next page, select `Snowflake` as the database type. + +![Select Database](assets/select_database.png) + +Enter the credentials for your Snowflake database and hit `Next`. Click the `Connect` button once the green banner appears that confirms the connection was successful. + +![Successful Connection](assets/successful_db_connection.png) + +Back on the Data page, you can optionally choose to sync the tables by clicking on the new datasource and clicking `Sync Tables`. This will allow you to use autocomplete when writing queries. + +![Sync Tables](assets/unsynced_tables.png) + +Now the data is successfull connected, and you should be able to click on the datasource to preview the data. + + + +## Create a dataset + +Duration: 10 + +A dataset is view created with SQL that defines a table of data that can be used to create charts and tables. + +To create a dataset, go to the Data Library page, click `Create Dataset` in the top right. Give the dataset a name, and select the schema that you created in the previous section. + +![Create Dataset](assets/create_gd.png) + +Then, define your dataset with Snowflake compatible SQL. The dataset editor is very flexible so that SQL can contain joins, filtering logic, computed columns, etc. To keep it simple, you can just create a dataset that pulls an entire table, e.g. `SELECT * from `. Preview the data to confirm that the resulting data is as expected. + +![Write Dataset](assets/write_gd.png) + +Once the dataset is complete, click the `Create Commit` button in the top left. Add a simple message and click `Create`. + +![Commit Dataset](assets/gd_commit.png) + +Your dataset is now ready to use! + + + +## Build an Explo Product + +Duration: 30 + +Once the Snowflake database is connected and a dataset is created, you are now able to create dashboards and reports in Explo. + +For a dashboard, go to the Dashboard page and click `Create Dashboard`. + +![Create Dashboard](assets/create_dashboard.png) + +Navigate to the Datasets tab and import the dataset you created in the Data Library from the previous section. + +Then, go back to the main dashboard page and pull on any element to add it to the dashboard and select the global dataset. + +![Drag dashboard element](assets/drag_bar_chart.png) + +Then, you can use the left panel to configure the data, formatting, and interactive options on the chart. Repeat this process with however many elements you would like. + +![Build Dashboard](assets/dashboard_config.png) + +For a Report Builder, go to the Report Builder page and click `Create Report Builder`. + +![Create Report Builder](assets/create_rb.png) + +Import the global dataset that you created in the Data Library in the previous section. In the middle section, format the columns, determine initial column visibility, and add any custom aggregations that your end users may want to use to aggregate data. + +![Dataset Config](assets/rb_dataset_config.png) + +Then, go to the Built Ins section and create a new built in report. Click on the `Select Data` button in the middle of right panel and select the imported global dataset. + +![Create Built In](assets/create_built_in_report.png) + +Now, you can configure the built in report as desired. Add filters, aggregate columns, create multiple views, change the chart type, etc. + +![Build Built In](assets/finished_report.png) + + + +## Conclusion and Resources + +Duration: 10 + +Congratulations! You have successfully created a dashboard or report to visualize data from your Snowflake database. + +### What You Learned + +- How to connect a Snowflake database to Explo +- How to create a dataset in Explo +- How to begin creating a dashboard and report builder + +### Resources + +[Explo Documentation](https://docs.explo.co/explo-help-desk) +[Request an Explo Trial](https://www.explo.co/request-a-trial)