RelationalAI App Management#
The RelationalAI (RAI) Native App runs in a container on Snowpark Container Services and manages the RAI Engines that execute queries written with the relationalai Python package.
All app management procedures require the app_admin application role.
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-SMALLSnowflake 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_Spool for hosting small RAI engines. - One
HIGHMEM_X64_Mpool for hosting medium engines. - Two
CPU_X64_Spools for internal use. - One
CPU_X64_Mpool 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.