Dataverse

Ringkasan

Prasyarat

Anda harus memiliki lingkungan Dataverse.

Anda harus memiliki izin baca untuk mengakses data dalam tabel.

Untuk menggunakan konektor Dataverse, pengaturan titik akhir TDS harus diaktifkan di lingkungan Anda. Informasi selengkapnya: Mengelola pengaturan fitur

Untuk menggunakan konektor Dataverse, salah satu port TCP 1433 atau 5558 perlu terbuka untuk menyambungkan. Port 1433 digunakan secara otomatis. Namun, jika port 1433 diblokir, Anda dapat menggunakan port 5558 sebagai gantinya. Untuk mengaktifkan port 5558, Anda harus menambahkan nomor port tersebut ke URL lingkungan Dataverse, seperti yourenvironmentid.crm.dynamics.com, 5558. Informasi selengkapnya: Masalah koneksi SQL Server karena port tertutup

Kemampuan yang didukung

• URL Server
• Impor
• DirectQuery (model semantik Power BI)
• Maju
  • Menyertakan kolom hubungan

Menyambungkan ke Dataverse dari Power Query Desktop

Untuk menyambungkan ke Dataverse dari Power Query Desktop:

1. Pilih opsi Dataverse dari Dapatkan Data. Informasi selengkapnya: Tempat mendapatkan data

2. Jika Anda menyambungkan ke situs ini untuk pertama kalinya, pilih Masuk dan masukkan kredensial Anda. Kemudian pilih Sambungkan.

   

3. Di Navigator, pilih data yang Anda butuhkan, lalu muat atau ubah data.

   

4. Jika Anda menggunakan Power Query dari Power BI Desktop, Anda diminta untuk memilih mode konektivitas data Impor atau DirectQuery . Kemudian pilih OK.

   

Menyambungkan ke Dataverse dari Power Query Online

Untuk menyambungkan ke Dataverse dari Power Query Online:

1. Pilih opsi Dataverse di halaman Pilih sumber data. Informasi selengkapnya: Tempat mendapatkan data

2. Di halaman Sambungkan ke sumber data, biarkan alamat URL server kosong. Membiarkan alamat kosong mencantumkan semua lingkungan yang tersedia yang dapat Anda gunakan di jendela Power Query Navigator.

   

   Catatan

   Jika Anda perlu menggunakan port 5558 untuk mengakses data, Anda harus memuat lingkungan tertentu dengan port 5558 ditambahkan di akhir di alamat URL server. Dalam hal ini, buka Menemukan URL lingkungan Dataverse Anda untuk instruksi tentang mendapatkan alamat URL server yang benar.

3. Jika perlu, masukkan gateway data lokal jika Anda akan menggunakan data lokal. Misalnya, jika Anda akan menggabungkan data dari Dataverse dan database SQL Server lokal.

4. Masuk ke akun organisasi Anda.

5. Saat Anda berhasil masuk, pilih Berikutnya.

6. Di halaman navigasi, pilih data yang Anda perlukan, lalu pilih Transformasi Data.

   

Menyambungkan menggunakan opsi tingkat lanjut

Power Query Online menyediakan opsi tingkat lanjut yang bisa Anda tambahkan ke kueri Anda jika diperlukan.

Tabel berikut ini mencantumkan opsi tingkat lanjut yang bisa Anda atur di Power Query Online.

Setelah Anda memilih opsi tingkat lanjut yang Anda perlukan, pilih Berikutnya untuk menyambungkan ke Dataverse.

Menemukan URL lingkungan Dataverse Anda

Jika Anda perlu menggunakan port 5558 untuk menyambungkan ke Dataverse, Anda harus menemukan URL lingkungan Dataverse Anda. Buka Power Apps. Di kanan atas halaman Power Apps, pilih lingkungan yang akan Anda sambungkan. Pilih ikon pengaturan, lalu pilih Pengaturan tingkat lanjut.

Di tab browser baru yang terbuka, salin akar URL. URL akar ini adalah URL unik untuk lingkungan Anda. URL dalam format https://< yourenvironmentid.crm.dynamics.com/> Pastikan Anda menghapus https:// dan trailing / dari URL sebelum menempelkannya untuk terhubung ke lingkungan Anda. Tambahkan port 5558 ke akhir URL lingkungan, misalnya yourenvironmentid.crm.dyamics.com.5558.

Kapan menggunakan konektor Common Data Service (Warisan)

Dataverse adalah pengganti langsung untuk konektor Common Data Service. Namun, mungkin ada kalanya perlu memilih konektor Common Data Service (Warisan) alih-alih konektor Dataverse :

Ada jenis data Tabular Data Stream (TDS) tertentu yang didukung di OData saat menggunakan Common Data Service (Legacy) yang tidak didukung di Dataverse. Jenis data yang didukung dan tidak didukung tercantum dalam Bagaimana Dataverse SQL berbeda dari Transact-SQL.

Semua fitur ini akan ditambahkan ke konektor Dataverse di masa mendatang, pada saat itu konektor Common Data Service (Warisan) akan ditolak.

Informasi selengkapnya: Mengakses data Dataverse dalam jumlah besar

Batasan dan masalah

Spesifik host Excel

Konektor Power Query Dataverse di dalam Excel saat ini tidak mendukung kluster sovereign cloud (misalnya, Tiongkok, Jerman, AS).

Performa dataverse dan batas pembatasan

Untuk informasi tentang batas performa dan pembatasan untuk koneksi Dataverse, buka Batas permintaan dan alokasi. Batasan ini berlaku untuk konektor Dataverse dan konektor Umpan OData saat mengakses titik akhir yang sama.

Tingkat pengambilan tabel

Sebagai pedoman, sebagian besar tabel default diambil dengan laju sekitar 500 baris per detik menggunakan konektor Dataverse. Perhitungkan tarif ini saat memutuskan apakah Anda ingin tersambung ke Dataverse atau mengekspor ke data lake. Jika Anda memerlukan tingkat pengambilan yang lebih cepat, pertimbangkan untuk menggunakan fitur Ekspor ke data lake atau titik akhir Tabular Data Stream (TDS). Untuk informasi selengkapnya, buka Koneksi Dataverse Alternatif.

Koneksi Dataverse alternatif

Ada beberapa cara alternatif untuk mengekstrak dan memigrasikan data dari Dataverse:

• Gunakan fitur Azure Synapse Link di Power Apps untuk mengekstrak data dari Dataverse ke Azure Data Lake Storage Gen2, yang kemudian dapat digunakan untuk menjalankan analitik. Untuk informasi selengkapnya tentang fitur Azure Synapse Link, buka Apa itu Azure Synapse Link for Dataverse?.

• Gunakan konektor OData untuk memindahkan data masuk dan keluar dari Dataverse. Untuk informasi selengkapnya tentang cara memigrasikan data antara lingkungan Dataverse menggunakan konektor OData aliran data, buka Memigrasikan data antar lingkungan Dataverse menggunakan konektor OData aliran data.

Masalah koneksi SQL Server karena port tertutup

Saat menyambungkan dengan konektor Dataverse, Anda mungkin mengalami kesalahan Tidak dapat menyambungkan yang menunjukkan bahwa terjadi kesalahan khusus jaringan atau instans saat membuat koneksi ke SQL Server. Kesalahan ini kemungkinan disebabkan oleh port TCP 1433 atau 5558 diblokir selama koneksi. Untuk memecahkan masalah kesalahan port yang diblokir, buka Port yang diblokir.

Menggunakan kueri database asli dengan Dataverse

Anda bisa menyambungkan ke Dataverse menggunakan pernyataan SQL kustom atau kueri database asli. Meskipun tidak ada antarmuka pengguna untuk pengalaman ini, Anda bisa memasukkan kueri menggunakan Editor Lanjutan Power Query. Untuk menggunakan kueri database asli, Database harus ditentukan sebagai Sumber.

Source = CommonDataService.Database([DATABASE URL])

Setelah sumber database ditentukan, Anda dapat menentukan kueri asli menggunakan fungsi Value.NativeQuery .

myQuery = Value.NativeQuery(Source, [QUERY], null, [EnableFolding=true])

Sama sekali, kueri terlihat seperti ini.

let
    Source = CommonDataService.Database("[DATABASE]"),
    myQuery = Value.NativeQuery(Source, "[QUERY]", null, [EnableFolding=true])
in
    myQuery

Salah eja nama kolom dapat mengakibatkan pesan kesalahan tentang pelipatan kueri alih-alih kolom yang hilang.

Mengakses data Dataverse dalam jumlah besar

Kueri pada tabel Dataverse dapat mengembalikan data dalam jumlah besar. Jika Anda menggunakan konektor Power Query Dataverse, kueri tertentu apa pun yang mengakses model memiliki batas waktu tetap lima (5) menit terlepas dari ukuran data. Untuk informasi selengkapnya, buka batasan. Jadi Anda mungkin perlu mengkueri data beberapa kali untuk mengakses semua data dalam model. Menggunakan beberapa kueri dapat memakan waktu yang cukup lama untuk mengembalikan semua data.

Jika Anda menggunakan konektor Common Data Service (Legacy), Anda bisa menggunakan satu kueri untuk mengakses semua data. Konektor ini bekerja secara berbeda dan mengembalikan hasil dalam "halaman" dari rekaman 5-K. Meskipun konektor Common Data Service (Warisan) lebih efisien dalam mengembalikan data dalam jumlah besar, masih perlu waktu yang signifikan untuk mengembalikan hasilnya.

Alih-alih menggunakan konektor ini untuk mengakses data Dataverse dalam jumlah besar, kami sarankan Anda menggunakan Azure Synapse Link untuk mengakses model besar. Menggunakan Azure Synapse Link bahkan lebih efisien daripada konektor Power Query Dataverse atau Common Data Service (Warisan), dan dirancang khusus di sekitar skenario integrasi data.

Masalah performa yang terkait dengan kolom hubungan

Mirip dengan konektor SQL Server, ada opsi yang tersedia untuk menonaktifkan properti navigasi (kolom hubungan) di konektor Dataverse untuk meningkatkan performa. Opsi ini dapat diatur dalam opsi tingkat lanjut yang tersedia di Power Query Online, atau dapat diatur menggunakan CreateNavigationProperties=false parameter dalam fungsi konektor Dataverse.

 Source = CommonDataService.Database("{crminstance}.crm.dynamics.com",[CreateNavigationProperties=false]),