注释
以下关于此连接器的文章由其所有者孔斯伯格提供，孔斯伯格也是 Microsoft Power Query 连接器认证计划的成员。 如果对本文的内容有疑问，或者对本文进行更改，请访问 Kongsberg 网站并使用此处的支持渠道。
概要
| 项 | DESCRIPTION |
|---|---|
| 发布状态 | 一般可用性 |
| 产品 | Power BI （语义模型） Power BI （数据流） Fabric（Dataflow Gen2） |
| 支持的身份验证类型 | 组织帐户 |
先决条件
在您可以登录到 Vessel Insight 之前，必须先将企业账号（用户名/密码）连接到租户。
支持的功能
- 进口
连接到 Vessel Insight
连接到 Vessel Insight：
在 Power BI Desktop 的“主页”功能区中，选择“获取数据”。 从左侧的类别中选择 “Other” ，选择 “Vessel Insight”，然后选择 “Connect”。
如果第一次通过 Vessel Insight 连接器获取数据，则会显示第三方通知。 如果不希望再次显示此消息，请选择“请勿再次通过此连接器提醒我”，然后选择“继续”。
若要登录到 Vessel Insight 帐户，请选择 “登录”。
在出现的窗口中，提供
<companyname>.kognif.ai格式的 Vessel Insight 租户 URL。 然后，选择“验证”。
在出现的窗口中，提供用于登录到 Vessel Insight 帐户的凭据。
如果输入了电子邮件地址和密码，请选择“ 继续”。
成功登录后，选择“ 保存”。
建立连接后，可以在 “导航器 ”对话框中预览并选择数据，以创建单个表格输出。
可以在导航器中选择以下选项：
- 高级：编写原生的自定义时序查询语言（TQL）查询。 对于高级 Kongsberg 用户。
- Vessel Insight 数据（已弃用）：旧资产层次结构中的舰队时序数据。
- Vessel Insight 数据 2.0：新资产层次结构中的舰队时序数据。 仅显示包含数据的标记。
- 航程：自动识别系统（AIS）的航程历史记录和位置数据。
您可以为所选择的项目提供任意必需的可选输入参数。 有关这些参数的详细信息，请转到 可选输入参数。
如果不输入 船舶洞察数据 2.0 的参数，则默认获取最新值。
在“航行”中，需要输入要为其提取数据的 IMO。
可以 加载 所选时序数据，这会将每个所选时序标记的一个表引入 Power BI Desktop，也可以选择“ 转换数据 ”以编辑查询，这将打开 Power Query 编辑器。 然后，可以筛选和优化要使用的数据集，然后将优化后的数据集加载到 Power BI Desktop 中。
可选输入参数
Vessel Insight 数据 2.0
通过“容器见解数据 2.0”节点导入时序数据并选择要在 Power Query Navigator 中加载或转换的标记时，还可以通过选择一组可选输入参数来限制数据量。
这些输入参数包括：
- 间隔 （可选）：显示时希望聚合数据的方式（1s、5s、 >=30s、1m、1h、1d）。
- 时间 （可选）：如果要按时间进行筛选，请设置时间筛选器类型。
- 最新：仅获取最新值。 返回一个值。
- 时间段：根据时间范围进行筛选。 需要设置下面所述的 开始 和 结束 日期。
- 自定义：用于筛选要返回的值数的自定义查询。
- 开始（时间：时间段），例如 2019-10-08T00：00：00Z （可选）：通过在此处插入开始日期和时间筛选范围。 可以 设置昨天 和 今天。 需要设置 时间：时间段。
- 结束（时间：时间段），例如 2019-10-08T01：00：00Z （可选）：通过在此处插入结束日期和时间来筛选范围。 可以设置为今天和现在。 需要设置 时间：时间段。
- 自定义（时间：自定义），例如 |> takebefore now 5 （可选）：添加自定义查询以筛选值数。 |> takebefore now 5 表示获取当前时间之前的五个值。 需要 时间：自定义。
导入聚合时间序列时，连接器默认返回平均值、最小值、最大值和计数。
如果要导入多个标记，则手动为每个标记输入参数可能很麻烦。 在这种情况下，建议在 Power Query 编辑器中使用Power Query 参数中的“开始”和“结束”日期。 详细信息： Power Query 参数
航程
通过 “航行 ”节点导入航程数据时，可以通过设置一组可选输入参数来限制 历史记录 和 位置历史记录 表的数据量。
这些输入参数包括：
- 逗号分隔的 IMO 编号：输入一个或多个您想获取航次数据的 IMO 编号。
- 开始（时间：时间段），例如 2019-10-08T00：00：00Z （可选）：通过在此处插入开始日期和时间筛选范围。 可以 设置昨天 和 今天。 需要设置 时间：时间段。
- 结束（时间：时间段），例如 2019-10-08T01：00：00Z （可选）：通过在此处插入结束日期和时间来筛选范围。 可以设置今天和现在。 需要设置 时间：时间段。
限制和问题
应注意以下与访问 Vessel Insight 数据相关的限制和问题。
除非工作区处于 Power BI Premium 高级许可容量中，否则导入至 Power BI 的数据通常情况下限制为 1 GB。 建议在导入时序数据时聚合并选择较短的日期范围，因为它可能会变得繁重。
每个具有关联值的时序标记都会输出到 Power BI 的单独表中。 如果需要将标记和值合并到一个表中，则需要在 Power Query 编辑器或 TQL 查询中合并标记及其值。
时序数据当前存储在 Couchbase 中，这可能具有影响 Power BI 连接器的弱点。
默认情况下，API 请求超时为 1 分钟。
有关如何访问Vessel Insight数据的更多信息，请转到入门指南。
建议的内容
你可能会发现以下Vessel Insight的信息很有用：