Bagikan melalui

Mendefinisikan kunci alternatif untuk baris referensi

  • Artikel

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 menggunakan kunci alternatif untuk mengidentifikasi baris secara unik menggunakan satu atau beberapa nilai kolom tabel yang mewakili kombinasi unik. Setiap kunci alternatif memiliki nama unik.

Misalnya, untuk mengidentifikasi baris akun dengan kunci alternatif, Anda bisa menggunakan nomor akun atau kolom nomor akun bersama dengan beberapa kolom lain, yang memiliki nilai yang seharusnya tidak 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 yang mudah disederhanakan, tetapi 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 dalam artikel ini membantu Anda memilih desainer mana yang dapat Anda gunakan.

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

  • Buat kunci alternatif dalam solusi selain Common Data Service Solusi Default.
  • Anda ingin dengan mudah melacak pekerjaan sistem yang dibuat yang 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

Catatan

  • Kolom yang mengaktifkan properti Aktifkan keamanan kolom tidak dapat digunakan sebagai kunci alternatif. Informasi selengkapnya: Tabel keamanan bidang
  • Ketika nilai NULL digunakan dalam kunci alternatif kolom, keunikan tidak akan diterapkan. Untuk menghindari rekaman duplikat, jangan gunakan nilai null di kolom yang ditentukan dalam batasan unik kunci alternatif.

Jumlah kunci

Anda dapat menentukan hingga 10 kunci berbeda untuk sebuah tabel.

Ukuran kunci yang valid

Ketika kunci dibuat, sistem memvalidasi bahwa kunci dapat didukung oleh platform, termasuk bahwa ukuran kunci total tidak melanggar batasan indeks berbasis SQL seperti 900 byte 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 berisi salah satu karakter < berikut,>,,*``%,&``:``/``\\``# maka tindakan pembaruan atau peningkatan (PATCH) tidak akan berfungsi.

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

Melacak status pembuatan kunci alternatif

Ketika kunci alternatif dibuat, ia memulai pekerjaan sistem untuk membuat indeks pada tabel database untuk menerapkan batasan unik pada kolom yang digunakan oleh kunci alternatif. Kunci alternatif tidak akan berlaku sampai 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

Ketika pekerjaan sistem selesai, status kunci 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).