Menggunakan gateway data lokal di aliran data Power Platform

Instal gateway data lokal untuk mentransfer data dengan cepat dan aman antara aliran data Power Platform dan sumber data yang tidak ada di cloud, seperti database SQL Server lokal atau situs SharePoint lokal. Anda bisa menampilkan semua gateway yang izin administratifnya anda miliki dan mengelola izin dan koneksi untuk gateway tersebut.

Prasyarat

Layanan Power BI

• Anda harus menginstal gateway yang saat ini didukung untuk digunakan dengan Aliran Data. Versi minimum yang kompatibel dengan Dataflow Power BI 3000.214.8.

• Lisensi Power BI Pro atau lisensi PPU. Tidak punya satu? Mendaftar selama 60 hari gratis.

• Untuk membuat aliran data yang mengkueri sumber data lokal, Anda memerlukan salah satu hal berikut ini:

  • Akses administrator di gateway.
  • Izin pembuat koneksi di gateway.
  • Koneksi gateway untuk sumber data yang ingin Anda gunakan sudah dibuat di gateway tempat Anda menjadi pengguna.

Power Apps

• Anda harus menginstal gateway yang saat ini didukung agar dapat digunakan dengan Dataflow. Versi minimum yang berfungsi dengan Dataflow Power Apps adalah 3000.214.8.

• Akun Power Apps. Tidak punya satu? Mendaftar selama 30 hari gratis.

• Izin administratif pada gateway. Izin ini disediakan secara default untuk gateway yang Anda instal. Administrator dapat memberikan izin kepada orang lain untuk gateway.

• Lisensi yang mendukung akses data lokal menggunakan gateway lokal. Informasi selengkapnya: Baris "Sambungkan ke data Anda" dari tabel "Jelajahi paket Power Apps" di halaman harga Power Apps.

Menginstal gateway

Anda dapat menginstal gateway data lokal langsung dari layanan online.

Nota

• Ini adalah praktik umum yang baik untuk memastikan Anda menggunakan versi gateway data lokal yang didukung. Kami merilis pembaruan baru gateway data lokal setiap bulan. Saat ini, Microsoft secara aktif hanya mendukung enam rilis terakhir gateway data lokal.
• Mulai April 2022, versi minimum gateway yang diperlukan adalah Februari 2021. Aliran data yang di-refresh menggunakan versi gateway yang lebih lama mungkin berhenti di-refresh.

Menginstal gateway dari layanan Power BI

Untuk menginstal gateway dari layanan Power BI:

1. Pilih tombol unduhan di sudut kanan atas layanan Power BI, dan pilih Data Gateway.

   

2. Instal gateway menggunakan instruksi yang disediakan di Instal gateway data lokal.

Menginstal gateway dari Power Apps

Untuk menginstal gateway dari dalam Power Apps:

1. Di panel navigasi kiri powerapps.com, pilih Data>Gateway.

   

2. Pilih Gateway baru.

   

3. Di bagian Gateway Data Lokal, pilih Unduh.

4. Instal gateway menggunakan instruksi yang disediakan di Instal gateway data lokal.

Menggunakan sumber data lokal dalam aliran data

1. Untuk instruksi tentang cara membuat aliran data baru, buka Membuat aliran data dari sumber data.

2. Pilih sumber data lokal dari daftar sumber data.

   

3. Berikan detail koneksi untuk gateway perusahaan yang akan digunakan untuk mengakses data lokal. Anda harus memilih gateway itu sendiri, dan menyediakan kredensial untuk gateway yang dipilih. Hanya gateway tempat Anda menjadi administrator yang muncul dalam daftar.

   

Anda dapat mengubah gateway perusahaan yang digunakan untuk aliran data tertentu dan mengubah gateway yang ditetapkan ke semua kueri Anda menggunakan alat penulisan aliran data.

Nota

Aliran data akan mencoba menemukan atau membuat sumber data yang diperlukan menggunakan gateway baru. Jika tidak dapat melakukannya, Anda tidak akan dapat mengubah gateway hingga semua aliran data yang diperlukan tersedia dari gateway yang dipilih.

Menampilkan dan mengelola izin gateway

Izin gateway layanan Power BI

1. Pilih tombol penyetelan di sudut kanan atas layanan Power BI, pilih Kelola gateway, lalu pilih gateway yang Anda inginkan.

   

2. Untuk menambahkan pengguna ke gateway, pilih tabel Administrator dan masukkan alamat email pengguna yang ingin Anda tambahkan sebagai administrator. Membuat atau memodifikasi sumber data dalam aliran data memerlukan izin Admin ke gateway. Admin memiliki kontrol penuh atas gateway, termasuk menambahkan pengguna, mengatur izin, membuat koneksi ke semua sumber data yang tersedia, dan menghapus gateway.

Kondisi berikut berlaku saat menambahkan pengguna ke gateway:

1. Jika kami mendeteksi bahwa sumber data yang ada tersedia untuk gateway yang dipilih, bidang nama pengguna dan kata sandi akan diisi sebelumnya.

   1. Jika Anda memilih Berikutnya pada saat ini, Anda dianggap menggunakan sumber data yang ada, sehingga Anda hanya perlu memiliki izin ke sumber data tersebut.

   2. Jika Anda mengedit salah satu bidang kredensial dan memilih Berikutnya, maka Anda dianggap mengedit sumber data yang sudah ada, di titik mana Anda harus menjadi admin gateway.

2. Jika kami tidak mendeteksi bahwa sumber data yang ada tersedia untuk gateway yang dipilih, bidang Nama Pengguna dan Kata Sandi akan kosong, dan jika Anda mengedit bidang kredensial dan memilih Berikutnya, maka Anda dianggap membuat sumber data baru di gateway, di mana Anda perlu menjadi admin gateway.

Jika Anda hanya memiliki izin pengguna sumber data di gateway, maka 1.b dan 2 tidak dapat dicapai dan aliran data tidak dapat dibuat.

Izin gateway Power Apps

1. Di panel navigasi kiri powerapps.com, pilih Gateway lalu pilih gateway yang Anda inginkan.

2. Untuk menambahkan pengguna ke gateway, pilih Pengguna, tentukan pengguna atau grup, lalu tentukan tingkat izin. Membuat sumber data baru dengan gateway dalam dataflow memerlukan izin Admin pada gateway. Admin memiliki kontrol penuh atas gateway, termasuk menambahkan pengguna, mengatur izin, membuat koneksi ke semua sumber data yang tersedia, dan menghapus gateway.

Menampilkan dan mengelola koneksi gateway

Koneksi gateway layanan Power BI

1. Pilih tombol penyetelan di sudut kanan atas layanan Power BI, pilih Kelola gateway, lalu pilih gateway yang Anda inginkan.

2. Lakukan tindakan yang Anda inginkan:

   • Untuk melihat detail dan mengedit pengaturan, pilih Pengaturan Kluster Gateway .
   • Untuk menambahkan pengguna sebagai administrator gateway, pilih Administrator .
   • Untuk menambahkan sumber data ke gateway, pilih Tambahkan Sumber Data, masukkan nama sumber data dan pilih jenis sumber data di bawah Pengaturan Sumber Data , lalu masukkan alamat email orang yang akan menggunakan sumber data.
   • Untuk menghapus gateway, pilih elipsis di sebelah kanan nama gateway lalu pilih Hapus.

Koneksi gateway Power Apps

1. Di bilah navigasi kiri powerapps.com, pilih Gateway, lalu pilih gateway yang Anda inginkan.

2. Lakukan tindakan yang Anda inginkan:

   • Untuk menampilkan detail, edit pengaturan, atau hapus gateway, pilih Koneksi, lalu pilih koneksi.

   • Untuk berbagi koneksi, pilih Bagikan lalu tambahkan atau hapus pengguna.

     Nota

     Anda hanya dapat berbagi beberapa jenis koneksi, seperti koneksi SQL Server. Untuk informasi selengkapnya, lihat Berbagi sumber daya aplikasi kanvas di Power Apps.

     Untuk informasi selengkapnya tentang cara mengelola koneksi, lihat Mengelola koneksi aplikasi kanvas di Power Apps.

Keterbatasan

Ada beberapa batasan yang diketahui saat menggunakan gateway perusahaan dan aliran data.

• Refresh aliran data mungkin gagal jika menggunakan gateway data yang kedaluwarsa. Mulai April 2022, versi gateway data minimum yang diperlukan adalah Februari 2021.

• Setiap aliran data hanya dapat menggunakan satu gateway. Dengan demikian, semua kueri harus dikonfigurasi menggunakan gateway yang sama.

• Mengubah gateway berdampak pada seluruh aliran data.

• Jika beberapa gateway diperlukan, praktik terbaiknya adalah membangun beberapa aliran data (satu untuk setiap gateway). Kemudian gunakan kemampuan referensi komputasi atau tabel untuk menyatukan data.

• Aliran data hanya didukung menggunakan gateway perusahaan. Gateway pribadi tidak akan tersedia untuk dipilih di daftar tarik-turun dan layar pengaturan.

• Membuat sumber data baru dengan gateway dalam aliran data hanya didukung untuk orang dengan izin Admin .

• Pengguna dengan izin Dapat Menggunakan atau Dapat Menggunakan atau Berbagi dapat menggunakan koneksi yang ada saat membuat aliran data.

• Konektor berikut didukung:

  • DB2
  • Sistem File
  • Apache Impala
  • Informix
  • MySQL
  • Oracle Database
  • PostgreSQL
  • SAP ERP
  • SharePoint
  • SQL Server
  • Teradata
  • Alur Desktop
  • HTTP dengan Microsoft Entra ID

Pemecahan masalah

Saat Anda mencoba menggunakan sumber data lokal untuk menerbitkan aliran data, Anda mungkin menemukan kesalahan MashupException berikut:

AzureDataLakeStorage failed to get the response:
'The underlying connection was closed: An unexpected error occurred on a send.'

Kesalahan ini biasanya terjadi karena Anda mencoba menyambungkan ke titik akhir Azure Data Lake Storage melalui proksi, tetapi Anda belum mengonfigurasi pengaturan proksi dengan benar untuk gateway data lokal. Untuk mempelajari selengkapnya tentang cara mengonfigurasi pengaturan proksi ini, buka Mengonfigurasi pengaturan proksi untuk gateway data lokal.

Untuk informasi selengkapnya tentang pemecahan masalah dengan gateway, atau mengonfigurasi layanan gateway untuk jaringan Anda, buka dokumentasi gateway data lokal .

Jika Anda mengalami masalah dengan versi gateway yang Anda gunakan, coba perbarui ke versi terbaru karena masalah Anda mungkin telah diselesaikan di versi terbaru. Untuk informasi selengkapnya tentang memperbarui gateway Anda, buka Memperbarui gateway data lokal.

Langkah berikutnya

• Membuat dan menggunakan aliran data di Power Apps

• Menambahkan data ke tabel di Microsoft Dataverse dengan menggunakan Power Query

• Sambungkan Azure Data Lake Storage Gen2 sebagai penyimpanan aliran data