RAI Native App Status#
This guide walks you through common tasks for managing the RAI Native App on Snowflake, such as activating, deactivating, and checking its status.
All app management procedures require the app_admin
application role.
Table of Contents#
Activate the App#
To activate the RAI Native App after installing it, or to re-activate an app that has been deactivated, use the activate()
procedure:
#CALL relationalai.app.activate();
When you activate your app for the first time, the necessary resources are provisioned:
- An
X-SMALL
Snowflake warehouse for executing queries against the RAI Native App’s Snowflake database. A dedicated warehouse is necessary to ensure that service operations against this database do not contend with other workloads. - Five Snowflake compute pools:
- One
HIGHMEM_X64_S
pool for hosting small RAI engines. - One
HIGHMEM_X64_M
pool for hosting medium engines. - Two
CPU_X64_S
pools for internal use. - One
CPU_X64_M
pool for internal use.
- One
It may take several minutes to provision the app’s resources prior to the app being fully activated.
When you re-activate a deactivated app:
- All RAI engines that were deleted when the app was deactivated are re-created.
- The CDC service is configured with the engine that was used when the app was deactivated.
- If the CDC service was active when the app was deactivated, it is resumed. Otherwise, it remains suspended.
It may take several minutes to re-create engines after the app is re-activated.
Use the engines
view to monitor the status of your engines.
Deactivate the App#
Use the deactivate()
procedure to deactivate the RAI Native App and reduce costs when you are not using it:
#CALL relationalai.app.deactivate();
Models built with the relationalai
Python package can’t execute queries while your RAI Native App is deactivated.
When you deactivate the app:
- The CDC service is suspended.
- All currently running queries are terminated.
- All existing RAI engines are deleted.
Check App Status#
Use the service_status()
procedure to check the status of the RAI Native App:
#CALL relationalai.app.service_status();
View Application Telemetry#
When you install the RAI Native App, you are prompted to share continuous telemetry data with RelationalAI. This data is written to your account’s active event table and contains operational information such as internal system logs, engine sizes, and usage data. Customer data and personally identifiable information are not included in continuous telemetry data.
See the Snowflake documentation for details on viewing and working with event tables.