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

# 从 Microsoft Power BI Desktop 连接到 Amazon DocumentDB
<a name="connect-odbc-power-bi"></a>

**Topics**
+ [先决条件](#odbc-power-bi-prerequisites)
+ [添加 Microsoft Power BI Desktop 自定义连接器](#odbc-adding-power-bi)
+ [使用 Amazon DocumentDB 自定义连接器进行连接](#odbc-connect-custom-connector)
+ [配置 Microsoft Power BI Gateway](#odbc-power-bi-gw)

## 先决条件
<a name="odbc-power-bi-prerequisites"></a>

在开始之前，请确保已正确安装 Amazon DocumentDB ODBC 驱动程序。

## 添加 Microsoft Power BI Desktop 自定义连接器
<a name="odbc-adding-power-bi"></a>

将 `AmazonDocumentDBConnector.mez` 文件复制到 `<User>\Documents\Power BI Desktop\Custom Connectors\` 文件夹（如果使用 OneDrive，则复制到 `<User>\OneDrive\Documents\Power BI Desktop\Custom Connectors`）。这将允许 Power BI 访问自定义连接器。可以在[此处](https://github.com/aws/amazon-documentdb-odbc-driver/releases)获取 Power BI Desktop 的连接器。重启 Power BI Desktop 以确保连接器已加载。

**注意**  
自定义连接器仅支持使用 Amazon DocumentDB 用户名和密码进行身份验证。

## 使用 Amazon DocumentDB 自定义连接器进行连接
<a name="odbc-connect-custom-connector"></a>

1. 从**获取数据**中选择 Amazon DocumentDB (Beta)，然后单击**连接**。如果您收到有关使用第三方服务的警告，请点击**继续**。  
![\[“获取数据”界面，其中突出显示了“Amazon DocumentDB（Beta）”选项。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/get-data-1.png)

1. 输入所有必要信息连接到 Amazon DocumentDB 集群，然后单击 **OK**：  
![\[表单中包含适用于 Amazon DocumentDB 集群的连接详细信息输入字段。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-form-1.png)
**注意**  
根据 ODBC 驱动程序的数据来源名称 (DSN) 的配置，如果您已在 DSN 设置中提供了必要的信息，则可能不会显示 SSH 连接详细信息屏幕。

1. 选择数据连接模式：
   + **导入** - 加载所有数据并将信息存储在磁盘上。必须刷新并重新加载数据才能显示数据更新。
   + **直接查询** - 不加载数据，但对数据进行实时查询。这意味着无需刷新和重新加载数据即可显示数据更新。  
![\[界面显示了 DocumentDB 的“数据连接模式”选项。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/data-connectivity-1.png)
**注意**  
如果您使用的数据集非常大，则导入所有数据可能需要更长的时间。

1. 如果这是首次连接到此数据来源，请选择身份验证类型，并在出现提示时输入凭证。然后，单击**连接**：  
![\[“身份验证”界面显示了用户名和密码凭证输入字段。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-credentials-1.png)

1. 在**导航栏**对话框中，选择所需的数据库表，然后单击**加载**以加载数据，或单击**转换数据**以继续转换数据。  
![\[“导航器”界面显示了可供选择的数据库表列表。“加载”和“转换数据”按钮位于右下角。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/navigator-1.png)
**注意**  
连接后，将保存数据来源设置。若要修改，请选择**转换数据** > **数据来源设置**。

## 配置 Microsoft Power BI Gateway
<a name="odbc-power-bi-gw"></a>

**先决条件**
+ 确保自定义连接器可与 Power BI Gateway 配合使用。
+ 请确保 ODBC DS 创建在位于安装了 Power BI Gateway 的计算机的**系统**选项卡中的 ODBC 数据来源。

如果使用内部 SSH 隧道功能，则需要将文件 `known_hosts` 置于 Power BI 服务帐户有权访问的位置。

![\[known_hosts 属性界面显示了 PBIEgwService 的权限。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/ssh-known-hosts-1.png)


**注意**  
这也适用于您可能需要能够与 Amazon DocumentDB 集群建立连接的任何文件，例如证书颁发机构 (CA) 证书文件（pem 文件）。