翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 ゲートウェイの設定](#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 はカスタムコネクタにアクセスできるようになります。Power BI Desktop へのコネクタは[こちら](https://github.com/aws/amazon-documentdb-odbc-driver/releases)から入手できます。Power BI Desktop を再起動して、コネクタがロードされていることを確認します。

**注記**  
カスタムコネクタは、認証用に Amazon DocumentDB のユーザー名とパスワードのみをサポートします。

## Amazon DocumentDB カスタムコネクタを使用して接続します
<a name="odbc-connect-custom-connector"></a>

1. **[データを取得]** から [Amazon DocumentDB (ベータ)] を選択し、**[接続]** をクリックします。サードパーティサービスの使用について警告が表示された場合は、**[続行]** をクリックします。  
![Amazon DocumentDB (ベータ) オプションが強調表示された [データを取得] インターフェイス。](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/get-data-1.png)

1. Amazon DocumentDB クラスターに接続するために必要な情報をすべて入力し、**[OK]** をクリックします。  
![Amazon DocumentDB クラスターの接続詳細入力フィールドがあるフォーム。](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/docdb-form-1.png)
**注記**  
ODBC ドライバーのデータソース名 (DSN) の設定によっては、DSN 設定で必要な情報をすでに提供している場合、SSH 接続の詳細画面が表示されない場合があります。

1. データ接続モードを選択します。
   + **インポート**: すべてのデータをロードし、情報をディスクに保存します。データの更新を表示するには、データを更新して再ロードする必要があります。
   + **ダイレクトクエリ**: データをロードしませんが、データに対してライブクエリを実行します。つまり、データの更新を表示するためにデータを更新したり再ロードしたりする必要はありません。  
![DocumentDB のデータ接続モードオプションを示すインターフェイス。](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/data-connectivity-1.png)
**注記**  
非常に大きなデータセットを使用している場合は、すべてのデータをインポートするのに時間がかかることがあります。

1. このデータソースに初めて接続する場合は、認証タイプを選択し、プロンプトが表示されたら認証情報を入力します。次に、**[接続]** をクリックします。  
![ユーザー名とパスワード認証情報の入力フィールドを示す [認証] インターフェイス。](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/docdb-credentials-1.png)

1. **[ナビゲーター]** ダイアログで、必要なデータベース表を選択し、**[ロード]** をクリックしてデータを読み込むか、**[データ変換]** をクリックしてデータの変換を続行します。  
![選択するデータベーステーブルのリストを示す [ナビゲータ] インターフェイス。[データをロードして変換] ボタンは右下にあります。](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/navigator-1.png)
**注記**  
接続すると、データソースの設定が保存されます。設定を変更するには、**[データ変換]** > **[データソース設定]** を選択します。

## Microsoft Power BI ゲートウェイの設定
<a name="odbc-power-bi-gw"></a>

**前提条件**
+ カスタムコネクタが Power BI ゲートウェイで動作することを確認します。
+ Power BI ゲートウェイがインストールされているマシンの **[システム]** タブにある ODBC データソースに ODBC DSN が作成されていることを確認します。

内部 SSH トンネル機能を使用している場合は、Power BI サービスアカウントがアクセスできる場所に `known_hosts` ファイルを配置する必要があります。

![PBIEgwService のアクセス許可を示す [known_hosts プロパティ] インターフェイス。](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/ssh-known-hosts-1.png)


**注記**  
これは、認証機関 (CA) 証明書ファイル (pem ファイル) など、Amazon DocumentDB クラスターへの接続を確立するために必要なすべてのファイルにも当てはまります。