Skip to content

Commit

Permalink
docs(sf): add docs on how to update the analytics toolbox from a nati…
Browse files Browse the repository at this point in the history
…ve app (#527)
  • Loading branch information
vdelacruzb authored Sep 18, 2024
1 parent 775fb87 commit 4a2376e
Showing 1 changed file with 20 additions and 0 deletions.
20 changes: 20 additions & 0 deletions clouds/snowflake/native_app/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down

0 comments on commit 4a2376e

Please sign in to comment.