From f6224f7a46ca914c50776a3b69b69c083e310b25 Mon Sep 17 00:00:00 2001 From: Vladi Bilonenko Date: Fri, 11 Oct 2024 09:44:15 +0200 Subject: [PATCH] Add Snowpark documentation --- config/_default/menus.toml | 6 ++ content/docs/about/screencast/index.md | 7 +-- content/docs/snowflake-snowpark/about.md | 76 ++++++++++++++++++++++++ 3 files changed, 84 insertions(+), 5 deletions(-) create mode 100644 content/docs/snowflake-snowpark/about.md diff --git a/config/_default/menus.toml b/config/_default/menus.toml index 561b466b..d902060c 100644 --- a/config/_default/menus.toml +++ b/config/_default/menus.toml @@ -22,6 +22,12 @@ identifier = "cloud" url = "/docs/cloud/" +[[docs]] + name = "Snowpark" + weight = 1 + identifier = "snowflake-snowpark" + url = "/docs/snowflake-snowpark/" + [[docs]] name = "About" weight = 1 diff --git a/content/docs/about/screencast/index.md b/content/docs/about/screencast/index.md index 3e5a8ae0..ac445425 100644 --- a/content/docs/about/screencast/index.md +++ b/content/docs/about/screencast/index.md @@ -10,9 +10,6 @@ menu: --- -{{< img-simple src="screencast.gif" caption="Querying Chicago Crime Dataset from BigQuery Public Data" >}} +

-
-

Try Live on Playground

-

Use with Private Datasets

-
+

Create free Workspace

diff --git a/content/docs/snowflake-snowpark/about.md b/content/docs/snowflake-snowpark/about.md new file mode 100644 index 00000000..ca6abae1 --- /dev/null +++ b/content/docs/snowflake-snowpark/about.md @@ -0,0 +1,76 @@ +--- +title: "Dekart Snowpark Application" +description: "Why Dekart Cloud is Secure" +date: 2021-02-22T07:48:05+01:00 +lastmod: 2021-02-22T07:48:05+01:00 +draft: false +menu: + docs: + parent: "snowflake-snowpark" +images: [] +--- + +**Dekart** enables you to create powerful **Kepler.gl** visualizations directly from SQL queries in Snowflake, simplifying the process of visualizing and sharing location data without ETL pipelines. + +

+ +

Get it instantly in Snowflake Marketplace

+ +## 💡 How Dekart Works + +- **Single Docker Container**: Dekart runs efficiently as a single container within the Snowpark Container Service, requiring minimal setup. +- **State Management**: All Dekart's state is securely stored on `dekart.app_public.app_state_stage`, which includes 7 days of backups. When the application is uninstalled, the associated stage is also deleted. +- **Data Warehouse**: Dekart uses a dedicated `dw_dekart` data warehouse for executing and storing SQL queries. +- **Query Results**: Query data is loaded from Snowflake's persisted query results. If the query results expire, Dekart will automatically rerun the query to refresh the map data. + + **Recommended limits**: + - Maximum result size: **100 MB** + - Maximum number of rows: **1 million rows** + +## 🛡️ Accessing Datasets + +To use datasets in your visualizations, Dekart needs access to the relevant databases. For instance, to grant Dekart access to the **OpenStreetMap New York** dataset, run the following SQL command: + +```SQL +-- Grant access to a dataset (e.g., OpenStreetMap New York) +GRANT IMPORTED PRIVILEGES ON DATABASE OPENSTREETMAP_NEW_YORK TO application DEKART__WEBGL_MAPS_FOR_SNOWFLAKE; +``` + +💡 Please note that app name could be changed during the installation process. + +## 👫 Granting Access to Other Users + +To allow other users access to the Dekart application, assign them the appropriate role with the following SQL command: + +```SQL +-- Grant access to a user role +GRANT application role DEKART__WEBGL_MAPS_FOR_SNOWFLAKE.app_public.app_user TO role user_role; +``` + +💡 Please note that app name could be changed during the installation process. + +## 🎁 Getting access to free Overture Maps + +Dekart offers great way to explore Overture Maps datasets and enrich your visualizations with Places, Roads, and other map data. + +1. Go to Snowflake Marketplace and search for [Overture Maps](https://app.snowflake.com/marketplace/data-products/search?search=overture%20maps) + +2. Get Datasets you need, for example Places. They are instantly available in your Snowflake account. + +3. Give Dekart access to the dataset: + +```SQL +-- as ACCOUNTADMIN +GRANT IMPORTED PRIVILEGES ON DATABASE OVERTURE_MAPS__PLACES TO APPLICATION DEKART__WEBGL_MAPS_FOR_SNOWFLAKE; +``` + +4. Go to Dekart application, create a new report click *Start with sample query* to test it. + +💡 Please note that app name could be changed during the installation process. + +## 🛟 Support + +* [Get support in Slack Community](https://slack.dekart.xyz/) +* [Book a walkthrough demo with our team](https://calendly.com/vladi-dekart/30min) +* [Create a GitHub Issue](https://github.com/dekart-xyz/dekart/issues) +* Contact us over email [support@dekart.xyz](mailto:support@dekart.xyz)