管理应用程序

本主题介绍在使用者账户中安装 Snowflake Native App 后,如何对其进行管理。

查看已安装的 Snowflake Native Apps 和 Streamlit 应用程序

要查看已安装的应用程序或作为应用程序一部分安装的 Streamlit 应用程序,请执行以下步骤:

  1. 登录 Snowsight

  2. 在导航菜单中,选择 Data Products » Apps

  3. 查看已安装的应用程序和 Streamlit 应用程序的列表,然后在列表中选择应用程序。

    • 如果您选择了一个应用程序,则该应用程序将在工作表中打开。

    • 如果您选择了一个 Streamlit 应用程序,则该 Streamlit 应用程序将在编辑器中显示。

查看应用程序的自述文件

要查看已安装的应用程序的自述文件,请执行以下步骤:

  1. 登录 Snowsight。

  2. 在导航菜单中,选择 Data Products » Apps

  3. 在列表中选择应用程序,然后选择工具栏中的 Readme 图标。

将应用程序角色授予账户角色

要使用 Snowsight 将应用程序角色授予您账户中的账户角色,请执行以下步骤:

  1. 登录 Snowsight

  2. 在导航菜单中,选择 Data Products » Apps

  3. 选择应用程序,然后选择 Manage Access

  4. 选择 Add roles,然后选择您想要授予应用程序角色访问权限的账户角色。

  5. 选择 Done

要使用 SQL 命令将应用程序角色授予使用者账户中的账户角色,请使用 GRANT DATABASE ROLE 的 GRANT APPLICATION ROLE 命令,如下例所示:

GRANT APPLICATION ROLE hello_snowflake_app.app_public TO ROLE data_manager;
Copy

使用自定义预算来监控应用程序的 credit 使用情况

预算 允许您为应用程序的 计算成本 定义每月支出限额。您可以创建和配置自定义预算,以监控应用程序所有且使用 credit 的对象的 credit 使用情况。

当您将应用程序添加到自定义预算时,应用程序所有且使用 credit 的对象会自动添加到自定义预算。其中包括应用程序拥有的仓库和计算池。

自定义预算不会自动跟踪 共享 仓库和计算池,但是您可以手动将其添加到自定义预算。为应用程序创建自定义预算时,您不能将应用程序创建和拥有的对象添加到单独的自定义预算。但是,您可以将共享的仓库和计算池添加到单独的自定义预算。

设置所需角色,为应用程序创建自定义预算

要为应用程序创建或编辑自定义预算,您必须使用拥有正确权限的角色。请参阅 创建自定义角色以管理账户预算

在 Snowsight 中为应用程序创建自定义预算

您可以直接从应用程序配置页面或从 成本管理 页面,为应用程序创建或编辑自定义预算。

要从应用程序配置页面为应用程序创建自定义预算,请执行以下步骤:

  1. 登录 Snowsight。

  2. 在导航菜单中,选择 Data Products » Apps

  3. 选择您想要查看其自定义预算的应用程序。

  4. 选择 Cost management 选项卡。

  5. 选择 Create Budget

  6. 选择 Budget

  7. 输入 Budget name

  8. 选择要在其中创建预算的数据库和架构。

  9. 输入 Spending limit

  10. 输入用于接收通知的电子邮件地址。

    备注

    为自定义预算通知添加的每个电子邮件地址都必须 经过验证。如果列表中的电子邮件地址 经过验证,则通知电子邮件设置会失败。

  11. 选择 Resources to monitor

  12. 选择要添加到自定义预算的应用程序。

    • 要添加应用程序,请展开 Native Apps 以选择一个应用程序。

    • 要添加数据库,请展开 Databases 以选择数据库。

    • 要在架构中添加对象,请展开架构以列出可用对象。展开对象类别(例如,TablesTasks)以选择对象。

    • 要添加仓库,请展开 Warehouses 以选择仓库。

    • 要添加计算池,请展开 Compute Pools 以选择计算池。

    备注

    • 当您选择数据库或架构时,所有 `支持的对象 <https://docs.snowflake.cn/user-guide/budgets#label-budgets-supported-objects>`_(例如,数据库或架构中包含的表)也会添加到自定义预算。

    • 您只能将对象添加到一个自定义预算。如果某个对象当前包含在一个自定义预算中,而且您将该对象添加到第二个自定义预算中,则 Snowflake 会从第一个自定义预算中移除该对象,而不发出警告。

使用 SQL 为应用程序创建自定义预算

要使用 SQL 为应用程序创建自定义预算,请参阅 使用 SQL 命令创建自定义预算

应用程序不可用时怎么办

安装后,Snowflake Native App 可能因多种原因无法使用。要检查应用程序的状态,请查看 SHOW APPLICATION 命令中 upgrade_status 的值。如果应用程序不可用,DESCRIBE APPLICATION 命令将失败。返回的错误信息提供应用程序不可用的原因。

下表列出了应用程序不可用的几种情况以及或许可以解决问题的方法:

原因

可能的解决方案

Snowflake 禁用了该应用程序。

请联系 Snowflake 支持部门

使用者账户被锁定或暂停后处于不活动状态。

账户恢复后,应用程序将重新启用。

应用程序的版本已从提供商账户的应用程序包中删除。

在这种情况下,应用程序将不再可用,必须卸载并通过当前列表重新安装。

使用者的使用量超出了 基于试用的使用限制

有关可能的选项,请参阅 基于使用情况的试用

该应用程序是通过付费列表安装的,但未提供付款信息或付款信息不是最新。

支付列表费用。有关更多信息,请参阅 为列表付费

已超过列表的试用期。

联系应用程序提供商。

卸载 Snowflake Native App

您可以使用 Snowsight 或者运行 SQL 命令来卸载应用程序。

卸载应用程序所需的权限

要卸载应用程序,必须使用具有应用程序 OWNERSHIP 权限的角色。有关更多信息,请参阅 GRANT OWNERSHIP

要转让应用程序所拥有的,存在于应用程序之外的对象的所有权,必须使用具有对象的 MANAGE GRANTS 权限的角色。有关更多信息,请参阅 访问控制注意事项

在 Snowsight 中卸载应用程序

要使用 Snowsight 卸载应用程序,请执行以下步骤:

  1. 登录 Snowsight

  2. 在导航菜单中,选择 Data Products » Apps

  3. 在应用程序旁边,选择 ...,然后选择 Uninstall

    如果应用程序创建的对象存在于应用程序之外,则会出现一个对话框,显示对象及其所属类型的列表。

    1. 选择以下选项之一:

      • Yes, transfer selected objects to a role

        如果选择此选项,请从列表中选择一个角色。该角色将成为对象的新所有者。

        小心

        使用 Snowsight 时,只有 Snowflake Native App 拥有的以下对象可以转让给不同角色:

        • 数据库

        • 架构

        • 视图

      • No, delete all objects created outside the app

        如果选择此选项,则卸载应用程序时将删除对象。

  4. 选择 Uninstall

使用 SQL 命令卸载应用程序

要使用 SQL 命令卸载应用程序,请执行以下步骤:

  1. 使用 SHOW OBJECTS OWNED BY APPLICATION 命令查看 Snowflake Native App 所拥有的,存在于应用程序之外的对象,如以下示例所示:

    SHOW OBJECTS OWNED BY APPLICATION hello_snowflake_app;
    
    Copy

    该命令显示对象及其所属类型的列表。

  2. 要将对象的所有权转让给不同的角色,请使用 GRANT OWNERSHIP 命令,如以下示例所示。

    GRANT OWNERSHIP ON DATABASE na_external_db TO ROLE consumer_role;
    
    Copy
  3. 要删除应用程序,请运行 DROP APPLICATION 命令,如以下示例所示:

    DROP APPLICATION hello_snowflake_app CASCADE;
    
    Copy

    备注

    如果不将所有权转让给不同的角色,则必须使用 CASCADE 选项。

语言: 中文