Saran dan Komentar

Mendefinisikan kunci alternatif untuk baris referensi

  • Artikel
  • 3 menit untuk membaca

Kunci alternatif memberikan cara yang efisien dan akurat untuk mengintegrasikan data dengan sistem eksternal. Hal ini penting dalam kasus bila sistem eksternal tidak menyimpan ID Pengidentifikasi Unik Global (GUID) yang secara unik mengidentifikasi baris di Microsoft Dataverse.

Sistem integrasi data akan menggunakan kunci alternatif untuk secara unik mengidentifikasi baris dengan menggunakan satu atau beberapa nilai kolom tabel yang menunjukkan kombinasi unik. Setiap kunci alternatif memiliki nama unik.

Contohnya, untuk mengidentifikasi baris akun dengan kunci alternatif, Anda dapat menggunakan nomor akun, atau kolom nomor akun yang dikombinasikan dengan beberapa kolom yang memiliki nilai yang tidak boleh berubah.

Catatan

Meskipun Anda dapat menentukan kunci alternatif dengan Power Apps, kunci tersebut hanya dapat digunakan secara terprogram dalam kode. Untuk mempelajari lebih lanjut tentang penggunaan pemrograman kunci alternatif, lihat:

Beberapa manfaat dari fitur kunci alternatif meliputi:

  • Pencarian baris yang lebih cepat.
  • Operasi data massal yang lebih kuat.
  • Pemrograman yang sederhana dengan data yang diimpor dari sistem eksternal tanpa ID baris.

Membuat Kunci Alternatif

Ada dua desainer yang dapat Anda gunakan untuk membuat kunci alternatif:

Desainer Keterangan
portal Power Apps Memberikan pengalaman ringkas yang mudah, namun beberapa opsi tidak tersedia.
Informasi lebih lanjut: Menentukan kunci alternatif menggunakan portal Power Apps
Penelusur solusi Bukan semudah itu, namun menyediakan lebih banyak fleksibilitas untuk persyaratan kurang umum.
Informasi lebih lanjut: Menentukan kunci alternatif menggunakan penelusur solusi

Catatan

Anda juga dapat membuat kunci alternatif di lingkungan Anda menggunakan berikut:

Informasi di topik ini akan membantu Anda memilih desainer yang dapat Anda gunakan.

Anda harus menggunakan portal Power Apps untuk membuat kunci alternatif, kecuali jika Anda harus memenuhi persyaratan berikut:

  • Membuat kunci alternatif dalam solusi selain Solusi Default Common Data Service
  • Anda ingin mudah melacak pekerjaan sistem yang dibuat untuk melacak kemajuan pembuatan indeks pendukung

Batas dalam membuat kunci alternatif

Ada batasan pada pembuatan kunci alternatif.

Bidang yang dapat digunakan untuk kunci alternatif

Hanya jenis kolom ini dapat digunakan untuk membuat kunci alternatif:

  • Decimal
  • Bilangan utuh (bilangan bulat)
  • Satu Baris Teks (String)
  • Tanggal dan Waktu
  • Pencarian
  • Pilihan

Jumlah kunci

Anda dapat menetapkan hingga sepuluh kunci yang berbeda untuk sebuah tabel.

Ukuran kunci yang valid

Saat kunci dibuat, sistem memvalidasi bahwa kunci dapat didukung oleh platform, termasuk ukuran kunci total tidak melanggar batasan indeks berbasis SQL seperti 900 bita per kunci dan 16 kolom per kunci. Jika ukuran kunci tidak memenuhi batasan, pesan kesalahan akan ditampilkan.

Karakter unicode di nilai kunci

Jika data dalam kolom yang digunakan dalam kunci alternatif akan berisi salah satu karakter berikut <,>,*,%,&,:,/,\\ maka tindakan pembaruan atau upsert (PATCH) tidak akan berfungsi.

Jika Anda hanya perlu keunikan maka pendekatan ini akan berfungsi, tetapi jika Anda perlu menggunakan kunci ini sebagai bagian dari integrasi data maka terbaik untuk membuat kunci pada kolom yang tidak memiliki data dengan karakter ini.

Melacak status pembuatan kunci alternatif

Saat kunci alternatif dibuat ia akan memulai pekerjaan sistem untuk membuat indeks di tabel database untuk menjalankan batasan unik pada kolom yang digunakan oleh kunci alternatif. Kunci alternatif tidak akan berlaku hingga indeks ini dibuat. Membuat indeks ini mungkin memakan waktu tergantung pada jumlah data dalam sistem.

Status pekerjaan sistem menentukan status kunci alternatif. Kunci alternatif dapat memiliki status berikut:

  • Tertunda
  • Sedang Berlangsung
  • Aktif
  • Gagal

Setelah pekerjaan sistem selesai, status utama alternatif adalah aktif dan tersedia untuk digunakan.

Jika pekerjaan sistem gagal, Cari pekerjaan sistem untuk melihat kesalahan apa pun. Pekerjaan sistem akan memiliki nama yang mengikuti pola ini: Create index for {0} for table {1} di mana 0 adalah Nama Tampilan kunci alternatif dan 1 adalah nama tabel.

Catatan

Jika Anda ingin memantau status pekerjaan sistem, Anda harus menggunakan penelusur solusi untuk membuat indeks. Ini akan mencakup tautan ke pekerjaan sistem sehingga Anda dapat memantau. Informasi lebih lanjut: (opsional) lihat pembuatan indeks pelacakan pekerjaan sistem

Lihat juga

Menentukan kunci alternatif menggunakan portal Power Apps
Menentukan kunci alternatif menggunakan penjelajah solusi
Dokumentasi Pengembang: Menentukan kunci alternatif untuk tabel
Dokumentasi Pengembang: Menggunakan kunci alternatif untuk membuat baris

Catatan

Apa bahasa dokumentasi yang Anda inginkan? Lakukan survei singkat. (perlu diketahui bahwa survei ini dalam bahasa Inggris)

Survei akan berlangsung kurang lebih selama tujuh menit. Tidak ada data pribadi yang dikumpulkan (pernyataan privasi).