Memecahkan masalah gateway - Power BI

Artikel
11/01/2023

Catatan

Kami telah membagi dokumen gateway data lokal menjadi konten yang khusus untuk Power BI dan konten umum yang berlaku untuk semua layanan yang didukung gateway. Anda saat ini berada dalam konten Power BI. Untuk memberikan umpan balik pada artikel ini, atau pengalaman dokumen gateway secara keseluruhan, gulir ke bagian bawah artikel.

Artikel ini membahas beberapa masalah umum saat Anda menggunakan gateway data lokal dengan Power BI. Jika Anda mengalami masalah yang tidak tercantum di sini, Anda bisa menggunakan situs Komunitas Power BI. Atau, Anda dapat membuat tiket dukungan.

Konfigurasi

Kesalahan: layanan Power BI melaporkan gateway lokal tidak dapat dijangkau. Mulai ulang gateway dan coba lagi.

Di akhir konfigurasi, layanan Power BI dipanggil lagi untuk memvalidasi gateway. Layanan Power BI tidak melaporkan gateway sebagai aktif. Memulai ulang layanan Windows mungkin memungkinkan komunikasi berhasil. Untuk mendapatkan informasi selengkapnya, Anda dapat mengumpulkan dan meninjau log seperti yang dijelaskan dalam Mengumpulkan log dari aplikasi gateway data lokal.

Sumber data

Catatan

Tidak semua sumber data memiliki artikel khusus yang merinci pengaturan atau konfigurasi koneksi mereka. Untuk banyak sumber data dan konektor non-Microsoft, opsi koneksi mungkin berbeda antara Power BI Desktop, dan Mengelola konfigurasi pengaturan sumber data gateway > di layanan Power BI. Dalam kasus seperti itu, pengaturan default yang disediakan adalah skenario yang saat ini didukung untuk Power BI.

Kesalahan: Tidak dapat Tersambung. Detail: "Kredensial koneksi tidak valid"

Dalam Tampilkan detail, pesan kesalahan yang diterima dari sumber data ditampilkan. Untuk SQL Server, Anda melihat pesan seperti berikut:

Login failed for user 'username'.

Verifikasi bahwa Anda memiliki nama pengguna dan kata sandi yang benar. Selain itu, verifikasi bahwa kredensial tersebut dapat berhasil tersambung ke sumber data. Pastikan akun yang digunakan cocok dengan metode autentikasi.

Kesalahan: Tidak dapat Tersambung. Detail: "Tidak dapat tersambung ke database"

Anda dapat tersambung ke server tetapi tidak ke database yang disediakan. Verifikasi nama database dan kredensial pengguna memiliki izin yang tepat untuk mengakses database tersebut.

Dalam Tampilkan detail, pesan kesalahan yang diterima dari sumber data ditampilkan. Untuk SQL Server, Anda akan melihat sesuatu seperti berikut ini:

Cannot open database "AdventureWorks" requested by the login. The login failed. Login failed for user 'username'.

Kesalahan: Tidak dapat Tersambung. Detail: "Kesalahan tidak diketahui di gateway data"

Kesalahan ini mungkin terjadi karena alasan yang berbeda. Pastikan untuk memvalidasi bahwa Anda bisa menyambungkan ke sumber data dari komputer yang menghosting gateway. Situasi ini bisa menjadi akibat dari server yang tidak dapat diakses.

Dalam Tampilkan detail, Anda dapat melihat kode kesalahan DM_GWPipeline_UnknownError.

Anda juga dapat melihat di Log Peristiwa>Log Aplikasi dan Layanan>Layanan gateway data lokal untuk informasi selengkapnya.

Kesalahan: Kami mengalami masalah saat mencoba menyambungkan ke <server>. Detail: "Kami mencapai gateway data, tetapi gateway tidak dapat mengakses sumber data lokal."

Anda tidak dapat tersambung ke sumber data yang ditentukan. Pastikan untuk memvalidasi informasi yang disediakan untuk sumber data tersebut.

Dalam Tampilkan detail, Anda dapat melihat kode kesalahan DM_GWPipeline_Gateway_DataSourceAccessError.

Jika pesan kesalahan yang mendasar mirip dengan yang berikut ini, ini berarti bahwa akun yang Anda gunakan untuk sumber data bukan admin server untuk instans Analysis Services tersebut. Untuk informasi selengkapnya, lihat Memberikan hak admin server ke instans Analysis Services.

The 'CONTOSO\account' value of the 'EffectiveUserName' XML for Analysis property is not valid.

Jika pesan kesalahan yang mendasar mirip dengan yang berikut ini, itu bisa berarti bahwa akun layanan untuk Analysis Services mungkin kehilangan atribut direktori token-groups-global-and-universal (TGGAU).

The username or password is incorrect.

Domain dengan akses kompatibilitas pra-Windows 2000 mengaktifkan atribut TGGAU. Sebagian besar domain yang baru dibuat tidak mengaktifkan atribut ini secara default. Untuk informasi selengkapnya, lihat Beberapa aplikasi dan API memerlukan akses ke informasi otorisasi pada objek akun.

Untuk mengonfirmasi apakah atribut diaktifkan, ikuti langkah-langkah ini.

Koneksi ke mesin Analysis Services dalam SQL Server Management Studio. Dalam properti koneksi Tingkat Lanjut, sertakan EffectiveUserName untuk pengguna yang dimaksud dan lihat apakah penambahan ini mereproduksi kesalahan.
Anda dapat menggunakan alat Active Directory dsacls untuk memvalidasi apakah atribut tercantum. Alat ini ditemukan pada pengendali domain. Anda perlu tahu apa nama domain khusus untuk akun dan meneruskan nama itu ke alat tersebut.
```
dsacls "CN=John Doe,CN=UserAccounts,DC=contoso,DC=com"
```
Anda ingin melihat sesuatu yang mirip dengan yang berikut ini dalam hasilnya:
```
Allow BUILTIN\Windows Authorization Access Group
                                SPECIAL ACCESS for tokenGroupsGlobalAndUniversal
                                READ PROPERTY
```

Untuk memperbaiki masalah ini, Anda harus mengaktifkan TGGAU pada akun yang digunakan untuk layanan Windows Analysis Services.

Kemungkinan lain untuk "Nama pengguna atau kata sandi salah."

Kesalahan ini juga dapat disebabkan jika server Analysis Services berada di domain yang berbeda dari pengguna dan tidak ada kepercayaan dua arah yang ditetapkan.

Bekerja dengan administrator domain Anda untuk memverifikasi hubungan kepercayaan antar domain.

Tidak dapat melihat sumber data gateway data di Dapatkan Pengalaman data untuk Analysis Services dari layanan Power BI

Pastikan akun Anda tercantum di tab Pengguna dari sumber data dalam konfigurasi gateway. Jika Anda tidak memiliki akses ke gateway, tanyakan kepada administrator gateway dan minta mereka untuk memverifikasi. Hanya akun di daftar Pengguna yang dapat melihat sumber data yang tercantum dalam daftar Analysis Services.

Kesalahan: Anda tidak memiliki gateway apa pun yang terinstal atau dikonfigurasi untuk sumber data dalam himpunan data ini.

Pastikan Anda telah menambahkan satu atau beberapa sumber data ke gateway, seperti yang dijelaskan di Menambahkan sumber data. Jika gateway tidak muncul di portal admin di bawah Kelola gateway, kosongkan cache browser Anda atau keluar dari layanan lalu masuk kembali.

Kesalahan: Sumber data Anda tidak dapat disegarkan karena kredensial tidak valid. Perbarui kredensial Anda, lalu coba lagi.

Anda dapat menyambungkan dan menyegarkan himpunan data, tanpa kesalahan runtime untuk koneksi, namun di layanan Power BI bilah kesalahan ini muncul. Ketika pengguna mencoba memperbarui kredensial dengan kredensial yang diketahui baik, kesalahan muncul yang menyatakan bahwa kredensial yang disediakan tidak valid.

Kesalahan ini dapat terjadi ketika gateway mencoba koneksi pengujian, bahkan jika kredensial yang disediakan dapat diterima dan operasi refresh berhasil. Ini terjadi karena ketika gateway melakukan pengujian koneksi, gateway tidak menyertakan parameter opsional selama upaya koneksi, dan beberapa konektor data (seperti Snowflake, misalnya) memerlukan parameter koneksi opsional untuk terhubung.

Saat refresh Anda selesai dengan benar dan Anda tidak mengalami kesalahan runtime, Anda dapat mengabaikan kesalahan koneksi pengujian ini untuk sumber data yang memerlukan parameter opsional.

Model semantik

Kesalahan: Tidak ada cukup ruang untuk baris ini.

Kesalahan ini terjadi jika Anda memiliki satu baris yang berukuran lebih besar dari 4 MB. Tentukan baris dari sumber data Anda, dan coba filter atau kurangi ukuran untuk baris tersebut.

Kesalahan: Nama server yang disediakan tidak cocok dengan nama server pada sertifikat SSL SQL Server.

Kesalahan ini dapat terjadi ketika nama umum sertifikat adalah untuk nama domain server yang sepenuhnya memenuhi syarat (FQDN), tetapi Anda hanya menyediakan nama NetBIOS untuk server. Situasi ini menyebabkan ketidakcocokan pada sertifikat. Untuk mengatasi masalah ini, buat nama server dalam sumber data gateway dan file PBIX menggunakan FQDN server.

Kesalahan: Anda tidak melihat gateway data lokal ada saat mengonfigurasi refresh terjadwal.

Beberapa skenario yang berbeda dapat bertanggung jawab atas kesalahan ini:

Nama server dan database tidak cocok dengan apa yang dimasukkan di Power BI Desktop dan sumber data yang dikonfigurasi untuk gateway. Nama-nama ini harus sama. Mereka tidak peka huruf besar/kecil.
Akun Anda tidak tercantum di tab Pengguna dari sumber data dalam konfigurasi gateway. Anda perlu ditambahkan ke daftar tersebut oleh administrator gateway.
File Power BI Desktop Anda memiliki beberapa sumber data di dalamnya, dan tidak semua sumber data tersebut dikonfigurasi dengan gateway. Anda harus menentukan setiap sumber data dengan gateway agar gateway muncul dalam refresh terjadwal.

Kesalahan: Data yang tidak dikompresi yang diterima pada klien gateway telah melebihi batas.

Batasan yang tepat adalah 10 GB data yang tidak dikompresi per tabel. Jika Anda mengalami masalah ini, ada opsi yang baik untuk mengoptimalkan dan menghindarinya. Secara khusus, kurangi penggunaan nilai string yang sangat konstan dan panjang dan sebaliknya gunakan kunci yang dinormalisasi. Atau, menghapus kolom jika tidak digunakan membantu.

Error: DM_GWPipeline_Gateway_SpooledOperationMissing

Beberapa skenario berbeda dapat bertanggung jawab atas kesalahan ini

Proses gateway mungkin telah dimulai ulang saat refresh himpunan data sedang berlangsung.
Komputer gateway dikloning tempat gateway berjalan. Kita tidak boleh mengkloning mesin gateway.

Laporan

Kesalahan: Laporan tidak dapat mengakses sumber data karena Anda tidak memiliki akses ke sumber data kami melalui gateway data lokal.

Masalah biasanya disebabkan oleh salah satu faktor berikut:

Informasi sumber data tidak cocok dengan apa yang ada di himpunan data yang mendasar. Nama server dan database harus cocok antara sumber data yang ditentukan untuk gateway data lokal dan apa yang Anda berikan dalam Power BI Desktop. Jika Anda menggunakan alamat IP di Power BI Desktop, sumber data untuk gateway data lokal juga perlu menggunakan alamat IP.
Tidak ada sumber data yang tersedia di gateway apa pun dalam organisasi Anda. Anda bisa mengonfigurasi sumber data di gateway data lokal baru atau yang sudah ada.

Kesalahan: Kesalahan akses sumber data. Silakan hubungi administrator gateway.

Jika laporan ini menggunakan koneksi Analysis Services langsung, Anda dapat mengalami masalah dengan nilai yang diteruskan ke EffectiveUserName yang tidak valid atau tidak memiliki izin pada mesin Analysis Services. Biasanya, masalah autentikasi disebabkan oleh fakta bahwa nilai yang diteruskan untuk EffectiveUserName tidak cocok dengan nama prinsipal pengguna lokal (UPN).

Untuk mengonfirmasi nama pengguna yang efektif, ikuti langkah-langkah ini.

Temukan nama pengguna yang efektif dalam log gateway.
Setelah Anda memiliki nilai yang diteruskan, validasi bahwa nilai tersebut benar. Jika nilai tersebut milik pengguna Anda, Anda dapat menggunakan perintah berikut dari perintah untuk melihat UPN. UPN terlihat seperti alamat email.
```
whoami /upn
```

Secara opsional, Anda dapat melihat apa yang didapatkan Power BI dari ID Microsoft Entra.

Telusuri https://developer.microsoft.com/graph/graph-explorer.
Di sudut kanan atas, pilih Masuk.
Jalankan kueri berikut: Anda melihat respons JSON yang agak besar.
```
https://graph.windows.net/me?api-version=1.5
```
Cari userPrincipalName.

Jika MICROSOFT Entra UPN Anda tidak cocok dengan UPN Direktori Aktif lokal, Anda dapat menggunakan fitur Nama pengguna peta untuk menggantinya dengan nilai yang valid. Atau, Anda dapat bekerja dengan admin Power BI atau admin Active Directory lokal untuk mengubah UPN Anda.

Kerberos

Jika server database yang mendasar dan gateway data lokal tidak dikonfigurasi dengan tepat untuk delegasi yang dibatasi Kerberos, aktifkan pencatatan verbose di gateway. Kemudian, selidiki berdasarkan kesalahan atau jejak dalam file log gateway sebagai titik awal untuk pemecahan masalah. Untuk mengumpulkan log gateway untuk ditampilkan, lihat Mengumpulkan log dari aplikasi gateway data lokal.

ImpersonationLevel

ImpersonationLevel terkait dengan pengaturan SPN atau pengaturan kebijakan lokal.

[DataMovement.PipeLine.GatewayDataAccess] About to impersonate user DOMAIN\User (IsAuthenticated: True, ImpersonationLevel: Identification)

Solusi

Ikuti langkah-langkah berikut untuk menyelesaikan masalah.

Siapkan SPN untuk gateway lokal.
Siapkan delegasi yang dibatasi di Active Directory Anda.

FailedToImpersonateUserException: Gagal membuat identitas Windows untuk userid

FailedToImpersonateUserException terjadi jika Anda tidak dapat meniru atas nama pengguna lain. Kesalahan ini juga bisa terjadi jika akun yang Anda coba tirukan berasal dari domain lain daripada domain layanan gateway yang aktif. Ini adalah batasan.

Solusi

Verifikasi bahwa konfigurasi sudah benar sesuai langkah-langkah di bagian "ImpersonationLevel" sebelumnya.
Pastikan bahwa ID pengguna yang coba ditiru adalah akun Active Directory yang valid.

Kesalahan umum: Kesalahan 1033 saat Anda mengurai protokol

Anda mendapatkan kesalahan 1033 saat ID eksternal yang dikonfigurasi di SAP Hana tidak cocok dengan rincian masuk jika pengguna ditiru dengan menggunakan UPN (alias@domain.com). Dalam log, Anda akan melihat "UPN Asli 'alias@domain.com' diganti dengan UPN baru 'alias@domain.com'" di bagian atas log kesalahan, seperti yang terlihat di sini:

[DM.GatewayCore] SingleSignOn Required. Original UPN 'alias@domain.com' replaced with new UPN 'alias@domain.com.'

Solusi

SAP Hana mengharuskan pengguna yang ditiru untuk menggunakan atribut sAMAccountName di Active Directory. (alias pengguna). Jika atribut ini tidak benar, Anda akan melihat kesalahan 1033.
Dalam log, Anda melihat sAMAccountName (alias) dan bukan UPN, yang merupakan alias diikuti oleh domain (alias@doimain.com).

      <setting name="ADUserNameReplacementProperty" serializeAs="String">
        <value>sAMAccount</value>
      </setting>
      <setting name="ADServerPath" serializeAs="String">
        <value />
      </setting>
      <setting name="CustomASDataSource" serializeAs="String">
        <value />
      </setting>
      <setting name="ADUserNameLookupProperty" serializeAs="String">
        <value>AADEmail</value>

[SAP AG] [LIBODBCHDB DLL] [HDBODBC] Kegagalan tautan komunikasi:-10709 Koneksi gagal (RTE:[-1] Kesalahan Kerberos. Utama: "Kegagalan lain-lain [851968]." Minor: "Tidak ada kredensial yang tersedia dalam paket keamanan."

Anda mendapatkan pesan kesalahan "-10709 Koneksi gagal" jika delegasi Anda tidak dikonfigurasi dengan benar di Active Directory.

Solusi

Pastikan Anda memiliki server SAP Hana pada tab delegasi di Active Directory. untuk akun layanan gateway.

Ekspor log untuk tiket dukungan

Log gateway diperlukan untuk pemecahan masalah dan pembuatan tiket dukungan. Gunakan langkah-langkah berikut untuk mengekstrak log ini.

Identifikasi kluster gateway.

Jika Anda adalah pemilik himpunan data, pertama-tama periksa nama kluster gateway yang terkait dengan himpunan data Anda. Dalam gambar berikut, IgniteGateway adalah kluster gateway.
Periksa properti gateway.

Admin gateway kemudian harus memeriksa jumlah anggota gateway dalam kluster dan apakah penyeimbangan beban diaktifkan.

Jika penyeimbangan beban diaktifkan, maka langkah 3 harus diulang untuk semua anggota gateway. Jika tidak diaktifkan, maka mengekspor log di gateway utama sudah cukup.
Mengambil dan mengekspor log gateway.

Selanjutnya, admin gateway, yang juga administrator sistem gateway, harus melakukan langkah-langkah berikut:

a. Masuk ke mesin gateway, lalu luncurkan aplikasi gateway data lokal untuk masuk ke gateway.

b. Aktifkan pencatatan tambahan.

c. Secara opsional, Anda dapat mengaktifkan fitur pemantauan performa dan menyertakan log performa untuk memberikan detail tambahan untuk pemecahan masalah.

d. Jalankan skenario yang Anda coba ambil log gatewaynya.

e. Ekspor log gateway.

Riwayat refresh

Saat Anda menggunakan gateway untuk refresh terjadwal, riwayat Refresh dapat membantu Anda melihat kesalahan apa yang terjadi. Ini juga dapat memberikan data yang berguna jika Anda perlu membuat permintaan dukungan. Anda dapat melihat refresh terjadwal dan sesuai permintaan. Langkah-langkah berikut menunjukkan bagaimana Anda bisa masuk ke riwayat refresh.

Di panel navigasi Power BI, dalam Model semantik, pilih himpunan data. Buka menu, dan pilih Jadwalkan refresh.
Di Pengaturan untuk..., pilih Riwayat refresh.

Untuk informasi selengkapnya tentang skenario refresh pemecahan masalah, lihat Memecahkan masalah skenario refresh.

Ada pertanyaan lagi? Coba Komunitas Power BI.

Bagikan melalui

Memecahkan masalah gateway - Power BI

Konfigurasi

Kesalahan: layanan Power BI melaporkan gateway lokal tidak dapat dijangkau. Mulai ulang gateway dan coba lagi.

Sumber data

Kesalahan: Tidak dapat Tersambung. Detail: "Kredensial koneksi tidak valid"

Kesalahan: Tidak dapat Tersambung. Detail: "Tidak dapat tersambung ke database"

Kesalahan: Tidak dapat Tersambung. Detail: "Kesalahan tidak diketahui di gateway data"

Kesalahan: Kami mengalami masalah saat mencoba menyambungkan ke <server>. Detail: "Kami mencapai gateway data, tetapi gateway tidak dapat mengakses sumber data lokal."

Kemungkinan lain untuk "Nama pengguna atau kata sandi salah."

Tidak dapat melihat sumber data gateway data di Dapatkan Pengalaman data untuk Analysis Services dari layanan Power BI

Kesalahan: Anda tidak memiliki gateway apa pun yang terinstal atau dikonfigurasi untuk sumber data dalam himpunan data ini.

Kesalahan: Sumber data Anda tidak dapat disegarkan karena kredensial tidak valid. Perbarui kredensial Anda, lalu coba lagi.

Model semantik

Kesalahan: Tidak ada cukup ruang untuk baris ini.

Kesalahan: Nama server yang disediakan tidak cocok dengan nama server pada sertifikat SSL SQL Server.

Kesalahan: Anda tidak melihat gateway data lokal ada saat mengonfigurasi refresh terjadwal.

Kesalahan: Data yang tidak dikompresi yang diterima pada klien gateway telah melebihi batas.

Error: DM_GWPipeline_Gateway_SpooledOperationMissing

Laporan

Kesalahan: Laporan tidak dapat mengakses sumber data karena Anda tidak memiliki akses ke sumber data kami melalui gateway data lokal.

Kesalahan: Kesalahan akses sumber data. Silakan hubungi administrator gateway.

Kerberos

ImpersonationLevel

FailedToImpersonateUserException: Gagal membuat identitas Windows untuk userid

Kesalahan umum: Kesalahan 1033 saat Anda mengurai protokol

[SAP AG] [LIBODBCHDB DLL] [HDBODBC] Kegagalan tautan komunikasi:-10709 Koneksi gagal (RTE:[-1] Kesalahan Kerberos. Utama: "Kegagalan lain-lain [851968]." Minor: "Tidak ada kredensial yang tersedia dalam paket keamanan."

Ekspor log untuk tiket dukungan

Riwayat refresh

Sumber Daya Tambahan:

Bagikan melalui

Memecahkan masalah gateway - Power BI

Konfigurasi

Kesalahan: layanan Power BI melaporkan gateway lokal tidak dapat dijangkau. Mulai ulang gateway dan coba lagi.

Sumber data

Kesalahan: Tidak dapat Tersambung. Detail: "Kredensial koneksi tidak valid"

Kesalahan: Tidak dapat Tersambung. Detail: "Tidak dapat tersambung ke database"

Kesalahan: Tidak dapat Tersambung. Detail: "Kesalahan tidak diketahui di gateway data"

Kesalahan: Kami mengalami masalah saat mencoba menyambungkan ke <server>. Detail: "Kami mencapai gateway data, tetapi gateway tidak dapat mengakses sumber data lokal."

Kemungkinan lain untuk "Nama pengguna atau kata sandi salah."

Tidak dapat melihat sumber data gateway data di Dapatkan Pengalaman data untuk Analysis Services dari layanan Power BI

Kesalahan: Anda tidak memiliki gateway apa pun yang terinstal atau dikonfigurasi untuk sumber data dalam himpunan data ini.

Kesalahan: Sumber data Anda tidak dapat disegarkan karena kredensial tidak valid. Perbarui kredensial Anda, lalu coba lagi.

Model semantik

Kesalahan: Tidak ada cukup ruang untuk baris ini.

Kesalahan: Nama server yang disediakan tidak cocok dengan nama server pada sertifikat SSL SQL Server.

Kesalahan: Anda tidak melihat gateway data lokal ada saat mengonfigurasi refresh terjadwal.

Kesalahan: Data yang tidak dikompresi yang diterima pada klien gateway telah melebihi batas.

Error: DM_GWPipeline_Gateway_SpooledOperationMissing

Laporan

Kesalahan: Laporan tidak dapat mengakses sumber data karena Anda tidak memiliki akses ke sumber data kami melalui gateway data lokal.

Kesalahan: Kesalahan akses sumber data. Silakan hubungi administrator gateway.

Kerberos

ImpersonationLevel

FailedToImpersonateUserException: Gagal membuat identitas Windows untuk userid

Kesalahan umum: Kesalahan 1033 saat Anda mengurai protokol

[SAP AG] [LIBODBCHDB DLL] [HDBODBC] Kegagalan tautan komunikasi:-10709 Koneksi gagal (RTE:[-1] Kesalahan Kerberos. Utama: "Kegagalan lain-lain [851968]." Minor: "Tidak ada kredensial yang tersedia dalam paket keamanan."

Ekspor log untuk tiket dukungan

Riwayat refresh

Konten terkait

Sumber Daya Tambahan: