使用 Cortex Analyst 语义视图生成器

Cortex Analyst 语义视图生成器为创建和管理 语义视图 提供了图形用户界面 (GUI)。此向导指导您完成定义业务语义的过程，使可能不熟悉 SQL 的用户可以访问该语义。

有关在 YAML 中使用生成器和管理语义模型的更多信息，请参阅以下主题：

创建语义视图

备注

要创建语义视图，必须使用具有 创建语义视图所需的权限 中所述权限的角色。

要使用 Cortex Analyst 语义视图生成器创建新的语义视图，请执行以下操作：

  1. 在 Snowsight 中，选择 AI & ML。

  2. 找到 Cortex Analyst 磁贴，然后选择 Try。此时 Select a semantic model 窗口将打开。

  3. 在 Role and warehouse 下：

    1. 选择应拥有语义视图的角色。

    2. 选择应用于查询该语义视图的仓库。

  4. 在 Select from 下，选择 Semantic Views。

  5. 从显示 No Database selected 的菜单中，选择要在其中创建语义视图的数据库和架构。

  6. 选择 Create new。“Semantic View Generator”向导打开。

  7. 在向导的 Description 步骤中：

    1. 如果您尚未选择位置，请从 Location to store 中选择应存储模型的数据库和架构。

    2. 在 Name 中，输入语义模型的名称。

      必须指定以字母或下划线开头且仅包含字母、数字、下划线或美元符号的名称。

    3. （可选）在 Description 中，描述您的语义模型提供的数据，并描述用户可以提出的问题类型。

    4. 选择 Next: Select tables。

  8. 在向导的 Select tables 步骤中：

    1. 在 Find tables and views 选项卡中，选择包含要在语义视图中使用的数据的表或视图。

      必须选择至少一个表或视图。

      为了获得更好的性能，选择的表不要超过十个。

      如果要查看所选表和视图的列表，请选择 Selected 选项卡。

    2. 选择 Next: Select columns。

  9. 在向导的 Select columns 步骤中：

    1. 选择要包含在模型中的列。

      要选择表或视图中的所有列，请选择表或视图。

      为了获得更好的性能，请不要选择超过 50 个列。

    2. 选择 Create and Save。

      Cortex Analyst 窗口打开，并显示有关您创建的语义模型的详细信息。

  10. 在 Logical tables 下：

    1. 查看为每个表或视图定义的事实、维度和指标。

    2. 提供对企业友好的名称和描述。

    3. 添加所需的任何其他事实、维度和指标。

  11. 在 Relationships 下：

    1. 确认生成器定义的所有关系。

    2. 根据需要修改关系属性。

    3. 添加所需的任何其他关系。

  12. 如果您对语义视图进行了任何更改，请在 Save 窗口的右上角选择 Cortex Analyst。

编辑语义视图

要编辑语义视图，请执行以下操作：

  1. 在 Snowsight 中，选择 AI & ML。

  2. 找到 Cortex Analyst 磁贴，然后选择 Try。此时 Select a semantic model 窗口将打开。

  3. 在 Role and warehouse 下：

    1. 选择拥有语义视图的角色。

    2. 选择用于语义视图查询的仓库。

  4. 在 Select from 下，选择 Semantic Views。

  5. 从数据库菜单中，选择包含要编辑的语义视图的数据库和架构。

  6. 选择要编辑的语义视图，然后选择 Open。

  7. 对语义视图进行更改。您可以：

    • 修改描述和基本信息。

    • 添加或移除数据源。

    • 更改列选择。

    • 更新关系。

    • 添加、修改或移除事实、维度和指标。

  8. 如果您计划在此视图中使用 Cortex Analyst，请考虑以下几点：

    • 向 Verified Queries 部分添加示例查询。

      • 这些示例查询可帮助 Cortex Analyst 了解如何使用语义视图。

      • 添加代表数据常见用例的查询。

    • 为您的表、事实、维度或指标添加同义词。

      • 这些同义词是用户可能在查询中使用的替代术语。

      • 同义词有助于 Cortex Analyst 正确解释用户的问题。

    • 添加自定义指令。

      • 它们为如何解释数据提供了更多上下文信息。

      • 包括应考虑的业务规则或限制。

  9. 在 Cortex Analyst 窗口的右上角选择 Save。

使用 Cortex Analyst 语义视图生成器的最佳实践

  • 提供清晰的描述：

    • 在所有名称和描述中使用业务术语。

    • 使描述足够详细，以方便非技术用户理解。

  • 包括代表性的用户问题：

    • 包括可以帮助模型生成器更好地理解您的意图的问题。

    • 包括提问方式的变体。

  • 仔细查看生成的建议：

    • 确保问题与用例相关。

    • 确保建议的关系符合您的业务理解。

  • 使用真实问题进行测试：

    • 创建语义视图后，使用实际业务问题对其进行测试。

    • 根据模型对这些问题的支持程度，完善语义视图。

  • 迭代开发语义视图：

    • 从一个简单的星型架构开始。

    • 从核心表和指标开始，然后扩展。为了简单起见，建议使用三个表。

    • 获取业务用户的反馈，并完善您的语义视图。

故障排除

  • 如果您的语义视图未在 Cortex Analyst 语义视图生成器的视图列表中列出，请刷新模型列表（而不是页面本身）。

  • 如果语义视图中的关系出现错误，请确保这些关系与实际数据结构相匹配。

  • 如果查询速度很慢，请减少表或列的数量。

  • 如果在使用语义视图时 Cortex Analyst 产生意外的结果，请查看语义视图中的事实、维度和指标。

语言: 中文