Get Started #1: Install Honeycomb Data Explorer in Snowflake ​

This guide provides step-by-step instructions to install the Honeycomb Data Explorer into your Snowflake account. Watch the video or follow along with the detailed steps below.

Prerequisites ​

• A Snowflake account
• Necessary permissions to install applications (typically an ACCOUNTADMIN role)
• If the Honeycomb Data Explorer app has been shared with you privately, ensure you have access to it.

Step-by-Step Installation ​

1. Access the Snowflake Marketplace ​

1. Log in to your Snowflake account.
2. Navigate to the Data menu and select Marketplace.

2. Locate Honeycomb Data Explorer ​

1. Search for "Honeycomb Data Explorer" in the marketplace.
2. If the app has been shared privately, go to Apps and find it under Recently Shared with You.

3. Install the Application ​

1. Click on the Get button for Honeycomb Data Explorer.
2. In the modal window, select the warehouse for installation (use the default warehouse if unsure).
3. Leave the application name as is and click Get.
4. Wait a few seconds for the installation to complete.

4. Grant Application Privileges ​

1. After installation, click on the Honeycomb Data Explorer app.
2. Follow the activation flow by granting the necessary account privileges:
   • Create Compute Pool
   • Bind Service Endpoint
   • Create Warehouse
3. Click Grant to grant these privileges.
4. Click Activate to complete the activation process (this may take 10-20 minutes).

5. Grant Honeycomb Access to Data Tables ​

By default, Honeycomb does not have access to any tables within your Snowflake account. You must grant it access, similarly to how you can grant access to a user. Below are some sample queries that show how to add SELECT permissions to a table called FACT_ORDERS within the DELIVERY_DATA database.

GRANT USAGE ON DATABASE DELIVERY_DATA to application HONEYCOMB_DATA_EXPLORER;
GRANT SELECT ON TABLE DELIVERY_DATA.PUBLIC.FACT_ORDERS TO application HONEYCOMB_DATA_EXPLORER;

GRANT USAGE ON DATABASE DELIVERY_DATA to application HONEYCOMB_DATA_EXPLORER;
GRANT SELECT ON TABLE DELIVERY_DATA.PUBLIC.FACT_ORDERS TO application HONEYCOMB_DATA_EXPLORER;

6. Enable Connections for Map Tiles ​

1. Go to the Connections tab.
2. Enable the connection to allow Honeycomb to load map tiles from the Mapbox service.
3. Click Connect to grant this permission.

7. Launch Honeycomb Data Explorer ​

1. Click Launch App to open Honeycomb Data Explorer in a new tab.
2. Sign in using Single Sign-On (SSO) through Snowflake.
3. After logging in, you will see the Honeycomb welcome page where you can select a Snowflake table or load a demo map.

You have now successfully installed and configured Honeycomb Data Explorer in your Snowflake account. In the next guide, we will explore viewing a demo map within Honeycomb.