Documentation
搜索文档
karat

+

K

API 参考 ↗
数据连接与集成时间序列Time series setup传感器对象类型设置

注意：以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。

传感器对象类型设置

本页包含有关如何设置和配置传感器对象类型的说明。

传感器对象或TSP

如果您预期时间序列数据仅出现在给定对象类型的部分对象上，您应该继续创建链接回这些根对象类型的传感器对象。然而，如果您预期时间序列数据会出现在给定对象类型的（几乎）所有对象上，您应该直接在该对象类型上添加TSP。在时间序列文档中了解更多关于这些设置选项的信息。

先决条件：时间序列对象类型支持的数据集

首先，请按照创建新的时间序列对象类型的说明进行操作。您的时间序列对象类型支持的数据集应具备以下模式：

列类型描述
主键字符串[必填] 每行的主键。
系列ID字符串[必填] 唯一TSP的系列ID。请注意，如果您的传感器对象类型由多个时间序列同步支持，您将需要一个合格的系列ID。TSP不能是主键或标题属性。
传感器名称字符串[必填] 标识给定传感器对象的时间序列数据表示的名称。链接到单个根对象的所有传感器对象的传感器名称必须唯一。
外键字符串[必填] 用于将传感器对象类型链接到根对象类型的外键。主键可以用于此目的，但传感器对象类型至少需要一种链接类型。
是否分类Boolean[如果TSP由多种数值和分类类型的同步支持则必填] true表示给定传感器对象具有分类时间序列数据，否则假定数据为数值型。如果您是从Measures设置迁移而来，此前称为is_enum。
单位字符串[非必填] 应该为给定传感器对象显示的单位。
内部插值字符串[非必填] 应该为给定传感器对象使用的内部插值。

设置传感器对象类型

在Ontology Manager的功能页面中，选择开始在时间序列部分内。

开始

在时间序列设置对话框的第一步中，打开传感器对象类型。

设置对话框传感器对象类型设置

然后按照对话框中的其余步骤完成设置您的TSP。

传感器对象类型配置选项

添加属性后，您将在时间序列属性表下看到一个扩展的传感器对象类型配置部分，其中包含以下配置选项：

  • 传感器链接_(必填)_
    • 您必须选择至少一种链接类型，将此传感器对象类型链接到记录时间序列数据的根对象类型。
    • 您还必须选择包含传感器名称的属性以用于此链接类型。
  • 主传感器链接_(如果存在则必填)_
    • 这仅在您的Foundry实例中仍可访问旧版本的Quiver时出现。
    • 如果出现此选项，您必须选择一个链接类型和传感器名称以匹配您在上述传感器链接部分下配置的条目之一。
  • 是否分类？(如果TSP由多种类型的同步支持则必填)
    • 如果您的TSP由数值和分类同步的混合类型支持，您必须选择一个布尔属性来指示传感器对象是否具有分类时间序列数据。
  • 单位_(非必填，推荐)_
    • 可以选择包含每个传感器对象时间序列数据单位的属性。
  • 内部插值_(非必填)_
    • 可以选择包含每个传感器对象时间序列数据的内部插值类型的属性。
    • 有效值为：
      • LINEAR: 在两点之间进行线性插值。仅适用于数值时间序列。
      • NEAREST: 取最近点的值。
      • PREVIOUS: 取前一个点的值。
      • NEXT: 取下一个点的值。
      • NONE: 从不插值。

传感器对象类型配置部分。

传感器对象类型的单位和插值应在传感器对象类型配置部分中设置，而不是通过基本格式器。

传感器对象类型基本格式器警告。

从Measures迁移

如果您在Ontology Manager中对象类型的功能页面中看到如下所示的警告，则该对象类型以前被配置为Measure。Measures正在被弃用。您可以在类似的工作流中使用传感器对象类型。

Measures迁移横幅

您的对象类型可能已经完全或局部迁移到传感器对象类型。如果您在Ontology Manager的功能页面的时间序列部分看到开始按钮，说明您的Measure尚未迁移。要将您的Measure迁移到传感器对象类型，请按照以下步骤进行。如果您在此部分的传感器对象类型部分看到绿色勾号和全部完成，则您的对象类型已完全迁移。本页底部提供了一个示例。如果您的设置不符合这些描述中的任何一个，您已局部迁移。按照屏幕上的提示完成您的迁移。

我们不建议进行迁移，除非您确信知道哪些时间序列同步支持您的Measure。如果您不确定哪些时间序列同步支持您的Measure但仍然想要迁移，请联系Palantir支持。

  1. 确定哪些时间序列同步支持您的Measure。如果您有多个时间序列同步支持您的Measure，您将需要生成一个合格的系列ID。了解更多关于设置合格系列ID的信息。
  2. 在Measure对象类型中，系列ID列可能被用作主键。这在传感器对象类型中是不允许的，因为TSP不能用作主键。根据用作主键的列，您有以下选项：
    • **选项1：**如果您可以使用不是系列ID的列作为主键，则无需进一步操作。
    • **选项2：**如果您使用系列ID列作为Measure的主键，则需要创建一个新列用作主键。
      • 创建此列的最简单方法是打开生成支持数据集的Pipeline Builder管道或代码仓库，并创建一个是系列ID副本的列。
      • **注意：**任何没有重复的非时间序列属性都可以用作主键。使用最适合您的应用案例的内容。
    • **选项3：**如果您必须重新格式化系列ID列，因为您的Measure由多个时间序列同步支持，您可以使用先前作为系列ID的列作为主键，只要它是唯一标识符。
  3. 在Ontology Manager中打开Measure并打开功能页面。选择开始并按照上述描述填写流程。请注意，传感器对象类型切换应为开启状态，并且许多选择可能已为您填写。

Measures迁移步骤1开始对话框。

不要忘记保存对Ontology的更改。在设置结束时，您应该在Ontology Manager中功能页面的时间序列部分的传感器对象类型部分看到绿色勾号和全部完成。下面显示了一个示例：

传感器对象设置完成。