Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Connect ke Amazon DocumentDB dari Microsoft Power BI Desktop
<a name="connect-odbc-power-bi"></a>

**Topics**
+ [Prasyarat](#odbc-power-bi-prerequisites)
+ [Menambahkan konektor kustom Microsoft Power BI Desktop](#odbc-adding-power-bi)
+ [Menghubungkan menggunakan konektor kustom Amazon DocumentDB](#odbc-connect-custom-connector)
+ [Mengkonfigurasi Microsoft Power BI Gateway](#odbc-power-bi-gw)

## Prasyarat
<a name="odbc-power-bi-prerequisites"></a>

Sebelum memulai, pastikan driver Amazon DocumentDB ODBC diinstal dengan benar.

## Menambahkan konektor kustom Microsoft Power BI Desktop
<a name="odbc-adding-power-bi"></a>

Salin `AmazonDocumentDBConnector.mez` file ke `<User>\Documents\Power BI Desktop\Custom Connectors\` folder (atau `<User>\OneDrive\Documents\Power BI Desktop\Custom Connectors` jika menggunakan OneDrive). Ini akan memungkinkan Power BI untuk mengakses konektor khusus. Anda bisa mendapatkan konektor ke Power BI Desktop [di sini](https://github.com/aws/amazon-documentdb-odbc-driver/releases). Mulai ulang Power BI Desktop untuk memastikan konektor dimuat.

**catatan**  
Konektor khusus hanya mendukung nama pengguna dan kata sandi Amazon DocumentDB untuk otentikasi.

## Menghubungkan menggunakan konektor kustom Amazon DocumentDB
<a name="odbc-connect-custom-connector"></a>

1. **Pilih Amazon DocumentDB (Beta) **dari Dapatkan** Data dan klik Connect.** Jika Anda mendapatkan peringatan untuk menggunakan layanan pihak ketiga, klik **Lanjutkan**.  
![Antarmuka Dapatkan Data dengan opsi Amazon DocumentDB (Beta) disorot.](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/get-data-1.png)

1. **Masukkan semua informasi yang diperlukan untuk terhubung ke cluster Amazon DocumentDB Anda, lalu klik OK:**  
![Formulir dengan bidang input detail koneksi untuk klaster Amazon DocumentDB.](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-form-1.png)
**catatan**  
Bergantung pada konfigurasi Nama Sumber Data (DSN) driver ODBC Anda, layar detail koneksi SSH mungkin tidak ditampilkan jika Anda telah memberikan informasi yang diperlukan dalam pengaturan DSN.

1. Pilih mode konektivitas data:
   + **Impor** - memuat semua data dan menyimpan informasi pada disk. Data harus disegarkan dan dimuat ulang untuk menampilkan pembaruan data.
   + **Direct Query** - tidak memuat data, tetapi melakukan kueri langsung pada data. Ini berarti bahwa data tidak perlu di-refresh dan dimuat ulang untuk menampilkan pembaruan data.  
![Antarmuka yang menampilkan opsi mode Konektivitas Data untuk DocumentDB.](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/data-connectivity-1.png)
**catatan**  
Jika Anda menggunakan kumpulan data yang sangat besar, mengimpor semua data mungkin membutuhkan waktu yang lebih lama.

1. Jika ini adalah pertama kalinya menghubungkan ke sumber data ini, pilih jenis otentikasi dan masukkan kredensyal Anda saat diminta. Kemudian klik **Connect**:  
![Antarmuka otentikasi yang menampilkan bidang input untuk kredensi nama pengguna dan kata sandi.](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-credentials-1.png)

1. Dalam dialog **Navigator**, pilih tabel database yang Anda inginkan, lalu klik **Muat** untuk memuat data atau **Transform Data** untuk terus mengubah data.  
![Antarmuka navigator yang menampilkan daftar tabel database untuk dipilih. Tombol Load and Transform Data ada di kanan bawah.](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/navigator-1.png)
**catatan**  
Pengaturan sumber data Anda disimpan setelah Anda terhubung. Untuk memodifikasinya, pilih **Transform Data** **> Pengaturan Sumber Data**.

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

**Prasyarat**:
+ Pastikan konektor khusus akan bekerja dengan Power BI Gateway.
+ Pastikan ODBC DSN dibuat di sumber data ODBC di tab **Sistem** pada mesin tempat Power BI Gateway diinstal.

Jika Anda menggunakan fitur terowongan SSH internal, file `known_hosts` harus ditempatkan di mana akun layanan Power BI memiliki akses ke sana.

![Antarmuka properti known_hosts yang menunjukkan izin untuk Layanan. PBIEgw](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ssh-known-hosts-1.png)


**catatan**  
Ini juga berlaku untuk file apa pun yang mungkin Anda perlukan untuk dapat membuat sambungan ke klaster Amazon DocumentDB Anda, seperti file sertifikat otoritas sertifikat (CA) (file pem).