From 753c072ad2353546e76a4081b65e545b46717959 Mon Sep 17 00:00:00 2001
From: vdelacruzb <vdelacruzb@gmail.com>
Date: Wed, 11 Sep 2024 12:53:21 +0200
Subject: [PATCH] update native apps docs

---
 clouds/snowflake/native_app/README.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/clouds/snowflake/native_app/README.md b/clouds/snowflake/native_app/README.md
index 36764875d..2a35ba16b 100644
--- a/clouds/snowflake/native_app/README.md
+++ b/clouds/snowflake/native_app/README.md
@@ -47,6 +47,26 @@ GRANT USAGE ON FUTURE PROCEDURES IN SCHEMA CARTO.CARTO TO ROLE PUBLIC;
 CALL CARTO.CARTO.INSTALL('CARTO_ANALYTICS_TOOLBOX', 'CARTO.CARTO');
 ```
 
+##### * Update the Analytics Toolbox
+
+When a new package of the Analytics Toolbox gets released, the Analytics Toolbox installer gets updated automatically. As in the first installation most of the required permissions were already set, only the next queries should be necessary in order to update the Analytics Toolbox.
+
+```
+-- Set admin permissions
+USE ROLE ACCOUNTADMIN;
+
+-- Generate the installer procedure in the specified location
+CALL CARTO_ANALYTICS_TOOLBOX.CARTO.GENERATE_INSTALLER('CARTO.CARTO');
+
+-- Update ownership of the install procedure
+GRANT OWNERSHIP ON PROCEDURE CARTO.CARTO.INSTALL(STRING, STRING) TO ROLE ACCOUNTADMIN REVOKE CURRENT GRANTS;
+
+-- Install the Analytics Toolbox in CARTO.CARTO
+CALL CARTO.CARTO.INSTALL('CARTO_ANALYTICS_TOOLBOX', 'CARTO.CARTO');
+```
+
+If your Analytics Toolbox doesn't get updated properly please try to drop the app, get it back from Snowflake Marketplace and follow the Step 1.
+
 ### Usage Examples
 
 Please refer to CARTO's [SQL reference](https://docs.carto.com/data-and-analysis/analytics-toolbox-for-snowflake/sql-reference) to find the full list of available functions and procedures as well as examples.