在应用程序中消费数据产品

Analytics 开发人员可以使用数据目录将数据产品及其语义模型加载到分析应用程序中。数据目录生成必要的脚本，并为度量和维度创建主项。

当您使用数据产品时，数据目录会生成一个 IncludeModel 脚本语句，将选定的表、关系、度量和维度加载到您的应用程序中。来自语义模型的度量和维度会自动显示为主条目，可直接用于可视化。

先决条件

若要使用数据产品及其语义模型，您需要：

权限

要使用共享空间、托管空间和数据空间中数据产品的语义模型，您需要在包含该数据产品的空间中拥有 可以消费数据 或 可以查看 权限。

有关完整详细信息，请参阅数据产品角色和权限。

可访问的数据集

您必须有权访问语义模型中包含的数据集以及与底层数据的连接。

唯一数据产品名称

数据产品在空间内必须具有唯一的名称。如果应用程序已包含同名数据产品，则加载语义模型失败。

通过数据产品使用数据产品和语义模型

您可以直接从数据产品创建分析应用程序。您可以细化要从数据产品及其语义模型中使用的内容：数据集、字段和主条目。

1. 打开数据产品，可以通过从数据市场中选择，也可以通过浏览目录。

2. 在数据产品名称标头中，单击 用于 > 应用程序。

   

3. 在 创建新应用程序 窗口中，查看语义模型以及将要加载的数据。
4. 单击继续。

   新创建的应用程序的 数据加载编辑器 打开，您将被引导至数据目录。该数据产品默认已选中，但在将其加载到应用程序之前，您可以浏览、细化选择并查看数据。有关更多信息，请参阅通过 数据加载编辑器消费数据产品和语义模型。

5. 准备就绪后，单击加载数据。

数据加载后，您可以开始添加工作表并处理应用程序，或者根据需要导航至 数据加载编辑器 以检查和修改脚本。语义模型的表、关系、度量值和维度现已可供使用。

有关在工作表中可视化数据的更多信息，请参阅 创建分析并可视化数据。

通过 数据加载编辑器消费数据产品和语义模型

数据目录提供了一个界面，用于从数据产品中浏览和选择数据及语义模型信息，而无需手动输入脚本。

若要加载数据产品及其语义模型：

1. 打开应用程序。
2. 单击顶部导航条形中的 数据加载编辑器。
3. 在添加数据右侧面板中，单击从数据目录添加。
4. 数据目录模态框打开，显示可用数据，包括具有语义模型的数据产品。

   

浏览数据产品

数据目录显示包含语义模型的数据产品。您可以按名称、描述或标签浏览和搜索数据产品。

单击数据产品以查看将在应用程序脚本中加载的内容摘要，包括表、度量和维度。

如果语义模型中的数据集无法访问，则会使用警告指示器进行标记。您仍然可以使用语义模型中与其相关的度量和维度，但无法访问的数据集及其字段将被排除。

选择并优化语义模型

选择要使用的数据产品后，您可以细化选择，并精确选择要包含在应用程序中的语义模型组件。

1. 将鼠标悬停在所选数据产品上，然后单击 细化选择。

   

   提供了三个新选项卡，您可以在其中浏览数据产品的各个元素：

   • 表/字段
   • 维度
   • 度量
2. 使用复选框细化选择，并选择要包含的数据集、字段、度量和维度。
提示注释

高级用户可以切换重新加载时自动包含添加的项，以控制在语义模型发生更改时是否自动包含新项。

启用后，添加到语义模型的新字段、度量和维度将在重新加载时自动添加到数据模型和主条目中。这仅适用于分别勾选了所有字段、度量和维度的情况。

3. 选择准备就绪后，点击 插入脚本。

生成的 IncludeModel 脚本会插入到加载脚本中，并可在 数据加载编辑器 中查看和编辑。要将数据加载到应用程序中，请单击加载数据。

数据加载后，您可以开始添加工作表并处理应用程序。 有关详细信息，请参阅创建分析并可视化数据。

了解自动包含

自动包含功能控制当语义模型发生变化时应用程序如何做出响应。

当为组件类型启用自动包含时，生成的脚本使用通配符 (*) 选择器：

• Fields *：包含指定表中的所有字段。
• WithMeasures: *: 包含所有度量作为主条目。
• WithDimensions: *：包含所有维度作为主条目。

当禁用自动包含时，脚本会显式列出所选项目。例如：

• WithMeasures [Total sales], [Total quantity]：仅包含指定的度量。
• WithDimensions [Region], [Product]：仅包含指定的维度。

建议高级用户使用自动包含，以减少维护并确保您的应用程序能够受益于语义模型的改进。如果您需要严格控制包含哪些项目，请禁用自动包含。

理解生成的 IncludeModel 脚本

该数据生成一个引用语义模型并指定要加载哪些组件的 IncludeModel 脚本语句。

示例脚本

IncludeModel [My Example Data Product] FromSpace [My Shared Space]
WithTables
  Table [dataset_dim_dateinfo] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_customer] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_fact_transactions] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_category] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_sales_rep] Fields * Connection [My Shared Space:DataFiles]
WithMeasures *
WithDimensions *;

脚本参数：

• IncludeModel：包含语义模型的数据产品名称。
• FromSpace：指定包含数据产品的空间。
• WithTables：指定要包含的表。
• Table：指定要包含的表。您可以为要使用的每个表包含 Table 语句，以逗号分隔。
• Fields：指定要从指定表中包含哪些字段。使用 * 表示所有字段，或使用逗号分隔的字段列表。
• Connection：使用格式 environment:space:connection、space:connection 或 connection 指定表格位置。
• WithMeasures: 指定要作为主度量包含的度量。使用 * 表示所有度量，或使用特定度量名称列表。
• WithDimensions：指定要作为主维度包含的维度。使用 * 表示所有维度，或使用特定维度名称列表。

您可以手动编辑 IncludeModel 语句以调整包含哪些项，或在通配符和显式选择模式之间进行切换。

有关 IncludeModel 语句的完整详细信息，请参阅 IncludeModel。

字段和表命名

当数据产品加载到应用程序中时，字段和表名称可能会被自动调整，以防止命名冲突，并遵循 Qlik 分析模式将关系转换为基于名称的关联。

• 无关联的同名字段：如果两个表包含同名字段，但这些字段之间不存在关联，则字段名称会自动使用其表名进行限定（例如 TableName.FieldName），以防止在应用程序中发生非预期的自动关联。
• 具有关系的字段：如果两个字段具有关系但名称不同，则在加载到应用程序中以形成关联时，它们会被重命名为相同的名称（即关系的名称）。

• 复合键：对于复合键，会向所涉及的表中添加一个新的关键字段。

• 同名表：如果两个表同名，将通过追加数字后缀自动对其进行重命名，例如 TableName_1、TableName_2 等。

使用继承的主条目

当您重新加载包含 IncludeModel 语句的应用程序时，来自语义模型的度量和维度会自动显示在主条目面板中。

若要使用语义模型中的主条目：

1. 重新加载应用程序以从语义模型加载数据。
2. 在编辑模式下打开工作表。
3. 在左侧面板中，单击主条目。
4. 语义模型中的度量和维度会带有数据产品指示符显示在列表中。

   

5. 将主度量或维度拖动到可视化上以使用它。

从语义模型继承的主条目会显示其源数据产品名称和描述。您可以将鼠标悬停在度量或维度上，以查看其使用的表达式。

主条目属性

从语义模型继承的主条目的大多数属性在消费端应用程序中均为只读。某些其他主条目属性，例如与可视化相关的属性，仍可在应用程序中进行编辑。

只读行为仅适用于用户界面——您可以通过 API 设置多个主条目属性：

• 在语义模型中可配置，但在使用方应用程序的用户界面中为只读的属性。这包括标题、描述和标签。

• 未在语义模型中配置且未在使用方应用程序的用户界面中公开的属性。

应用程序重新加载时，对语义模型定义的属性所做的更改将被覆盖。

主项目删除

在未发布的应用程序中，您可以删除继承的主条目，但如果它仍被 IncludeModel 脚本引用，则会在下次重新加载时重新出现。若要永久删除它，请先将其从脚本中删除。您也可以复制继承的主条目。该复制是普通的应用主条目，完全可编辑。

主条目与发布应用程序

发布应用程序时，其继承的主条目将保持固定为发布该应用程序时所使用的数据产品版本。重新加载已发布的应用不会创建、更新或删除数据产品中的主条目。若要使用新增或更改的度量和维度，请更新应用程序并重新发布。

在应用程序中处理语义模型更新

如果语义模型在您使用后发生更改，您可以更新应用程序以反映这些更改。

如果您使用了带有通配符选择器的自动包含模式，新的度量和维度会自动包含在内。如果您使用了显式选择，则仅加载您最初选择的项目。

若要从语义模型添加新项：

1. 打开 数据加载编辑器。
2. 在您的脚本中找到 IncludeModel 语句。
3. 编辑语句以添加新项，或将选择器更改为 * 以实现自动包含。
4. 重新加载应用程序。

或者，您可以删除现有的 IncludeModel 语句，并使用数据目录生成包含更新后选择的新语句。

在其他工具中消费数据产品

在 脚本 中，可以消费数据产品，但度量和维度会被忽略。

在应用程序和脚本以外的资产（例如数据流和表配方）中消费数据产品时，数据产品充当一组可供选择的可信数据集。这些工具使用数据集作为源，并且数据产品在世系中不会显示为源节点。