本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 如何在 Grafana 中使用 AWS IoT TwinMaker 知识图谱
<a name="tm-knowledge-Grafana-panel"></a>

本节介绍如何在 AWS IoT TwinMaker Grafana 控制面板中添加查询编辑器面板以运行和显示查询。

## AWS IoT TwinMaker 查询编辑器先决条件
<a name="tm-knowledge-graph-Grafana-prereqs"></a>

在 Grafana 中使用 AWS IoT TwinMaker 知识图谱之前，请完成以下先决条件：
+ 创建 AWS IoT TwinMaker 工作空间。您可以在 [AWS IoT TwinMaker 控制台](https://console.aws.amazon.com/iottwinmaker/)中创建工作区。
+ 配置 AWS IoT TwinMaker 为与 Grafana 配合使用。有关说明，请参阅[AWS IoT TwinMaker Grafana 控制面板集成](grafana-integration.md)。

**注意**  
要使用 AWS IoT TwinMaker 知识图表，您需要处于**标准**或**分层捆绑**定价模式。有关更多信息，请参阅 [切换 AWS IoT TwinMaker 定价模式](tm-pricing-mode.md)。

## AWS IoT TwinMaker 查询编辑器权限
<a name="tm-knowledge-graph-Grafana-config"></a>

要在 Grafana 中使用 AWS IoT TwinMaker 查询编辑器，您必须拥有拥有操作权限的 IAM 角色。`iottwinmaker:ExecuteQuery`将该权限添加到您的工作区仪表板角色中，如以下示例所示：

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObject"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket",
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iottwinmaker:GetEntity",
                "iottwinmaker:ListEntities",
                "iottwinmaker:ExecuteQuery"
            ],
            "Resource": [
                "arn:aws:iottwinmaker:us-east-2:111122223333:workspace/workspaceId",
                "arn:aws:iottwinmaker:us-east-2:111122223333:workspace/workspaceId/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": "iottwinmaker:ListWorkspaces",
            "Resource": "*"
        }
    ]
}
```

------

**注意**  
配置 AWS IoT TwinMaker Grafana 数据源时，请务必使用具有此权限的角色作为**代**入角色 ARN 字段。添加后，便可以从**工作区**旁边的下拉列表中选择工作区。

有关更多信息，请参阅 [创建控制面板 IAM 角色](dashboard-IAM-role.md#dashboard-IAM-role.title)。

### 设置 AWS IoT TwinMaker 查询编辑器面板
<a name="tm-knowledge-graph-Grafana-panel"></a>

**为知识图谱设置新的 Grafana 仪表板面板**

1. 打开你的 AWS IoT TwinMaker Grafana 控制面板。

1. 新建一个**控制面板**。有关如何创建面板的详细步骤，请参阅 Grafan [a 文档中的创建控制面板](https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/create-dashboard/)。

1. 从可视化列表中，选择**AWS IoT TwinMaker 查询编辑器**。  
![\[AWS IoT TwinMaker 控制面板中的下拉列表包含 AWS IoT TwinMaker 查询编辑器的选项。\]](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/tw-query-editor-dropdown.png)

1. 选择要对其运行查询的数据来源。

1. **（可选）**在提供的字段中为新面板添加名称。

1. 选择 “**应用**” 以保存并确认您的新面板。

知识图谱面板的工作方式与 AWS IoT TwinMaker 控制台中提供的查询编辑器类似。您可以运行、编写和清除在面板中提出的查询。有关如何编写查询的更多信息，请参阅[AWS IoT TwinMaker 知识图谱其他资源](tm-knowledge-graph-resources.md)。

#### 如何使用 AWS IoT TwinMaker 查询编辑器
<a name="tm-knowledge-graph-Grafana-use"></a>

查询结果以三种方式显示，如下图所示：在图表中可视化、在表格中列出或以运行摘要的形式呈现。
+ **图表可视化：**  
![\[AWS IoT TwinMaker 查询编辑器结果显示为可视化图表。\]](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/kg-vis-graph.png)

  可视化图表仅显示结果中至少有一个关系的查询的数据。该图表将实体显示为节点，将关系显示为图形中的定向边。
+ **表格数据：**  
![\[AWS IoT TwinMaker 查询编辑器结果显示为表格数据。\]](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/kg-table-data.png)

  表格数据格式显示所有查询的数据。可以在表格中搜索特定的结果或结果的子集。数据可以以 JSON 或 CSV 格式导出。
+ **运行摘要**  
![\[AWS IoT TwinMaker 查询编辑器结果显示为运行摘要。\]](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/kg-run-sum.png)

  运行摘要显示查询和有关查询状态的元数据。