Zobacz Definiowanie kluczy alternatywnych odwołujących się do wierszy

  • Artykuł

Klucze alternatywne zapewniają skuteczny i dokładny sposób integrowania danych z systemami zewnętrznymi. Ważne jest to w przypadkach, gdy system zewnętrzny nie przechowuje identyfikatorów Unikatowy identyfikator globalny (GUID), które unikatowo identyfikują wiersze w Microsoft Dataverse.

System integracji danych używa kluczy alternatywnych do jednoznacznej identyfikacji wierszy przy użyciu jednej lub większej liczby wartości kolumn tabeli, które reprezentują unikalną kombinację. Każdy klucz alternatywny ma unikatową nazwę.

Na przykład, aby zidentyfikować wiersz konta za pomocą klucza alternatywnego, możesz użyć numeru rachunku lub kolumny numeru konta w połączeniu z innymi kolumnami, które mają wartości, które nie powinny się zmieniać.

Uwaga

Możesz definiować klucze alternatywne z Power Apps, ale można ich używać tylko programowo, w kodzie. Aby dowiedzieć się więcej na temat programowego używania kluczy alternatywnych, zobacz:

Niektóre z korzyści wynikających ze stosowania funkcji kluczy alternatywnych to:

  • Szybsze wyszukiwanie wierszy.
  • Wydajniejsze operacje zbiorcze na danych.
  • Uproszczone programowanie z danymi importowanymi z systemów zewnętrznych bez identyfikatorów wierszy.

Tworzenie klucza alternatywnego

Istnieją dwaj projektanci, których można użyć do tworzenia kluczy alternatywnych:

Projektant Opis
Portal Power Apps Zapewnia łatwe i sprawne działanie, ale niektóre opcje nie są dostępne.
Więcej informacji: Definiowanie kluczy alternatywnych przy użyciu portalu Power Apps
Eksplorator rozwiązań Nie aż tak łatwe, ale zapewnia większą elastyczność dla mniej typowych wymagań.
Więcej informacji: Definiowanie kluczy alternatywnych przy użyciu eksploratora rozwiązań

Uwaga

Można również tworzyć klucz alternatywny w środowisku przy użyciu następujących czynności:

Informacje zawarte w tym artykule pomogą Ci wybrać projektanta, którego możesz użyć.

Powinieneś użyć Portalu Power Apps, aby utworzyć klucze alternatywne, chyba że musisz się zająć następującymi wymaganiami:

  • Utwórz klucz alternatywny w ramach rozwiązania innego niż rozwiązanie domyślne Common Data Service
  • Chcesz łatwo śledzić utworzone zadanie systemowe, które śledzi postęp tworzenia indeksów pomocniczych.

Ograniczenia podczas tworzenia kluczy alternatywnych

Istnieją ograniczenia podczas tworzenia kluczy alternatywnych.

Pola, których można używać dla kluczy alternatywnych

Tylko te rodzaje kolumn mogą być używane do utworzenia kluczy alternatywnych:

  • Dziesiętne
  • Liczba całkowita (Liczba całkowita)
  • Pojedynczy wiersz tekstu (Ciąg)
  • Data i godzina
  • Lookup
  • Opcja wyboru

Uwaga

  • Kolumny z włączoną właściwością Włącz zabezpieczenia kolumny nie mogą być używane jako klucz alternatywny. Więcej informacji: Tabele Zabezpieczenia pól
  • Jeśli w kolumnach klucza alternatywnego użyte zostaną wartości NULL, unikatowość nie będzie wymuszana. Aby uniknąć duplikacji rekordów, nie używaj wartości NULL w kolumnach określonych jako unikatowe według klucza alternatywnego.

Liczba kluczy

Możesz określić maksymalnie 10 różnych kluczy dla tabeli.

Prawidłowy rozmiar klucza

Po utworzeniu klucza system sprawdza, czy klucz może być obsługiwany przez platformę, w tym, czy całkowity rozmiar klucza nie narusza ograniczeń indeksu opartych na języku SQL, takich jak 900 bajtów na klucz i 16 kolumn na klucz. Jeśli rozmiar klucza nie spełnia ograniczeń, zostanie wyświetlony komunikat o błędzie.

Znaki Unicode w wartości klucza

Jeśli dane w kolumnie używanej w kluczu alternatywnym będą zawierać jeden z następujących znaków: <,>,*,%,&,:,/,\\,#, akcje aktualizacji lub upsert nie będą działać.

Jeśli potrzebujesz tylko unikatowości to ta metoda będzie działać, ale jeśli musisz używać tych kluczy w ramach integracji danych, najlepiej jest utworzyć klucz na kolumnach, które nie będą zawierać danych z tymi znakami.

Śledzenie stanu tworzenia klucza alternatywnego

Gdy tworzony jest klucz alternatywny, inicjowane jest zadanie systemowe mające na celu utworzenie indeksów w tabelach bazy danych w celu wymuszenia unikatowych ograniczeń w kolumnach używanych przez klucz alternatywny. Klucz alternatywny nie będzie obowiązywać do czasu utworzenia tych indeksów. Tworzenie tych indeksów może zająć trochę czasu w zależności od ilości danych w systemie.

Stan zadania systemowego określa stan klucza alternatywnego. Klucz alternatywny może mieć następujące stany:

  • Oczekiwanie
  • W toku
  • Aktywny
  • Nie działa

Po zakończeniu zadania systemowego klucz alternatywny ma status Aktywny i jest dostępny do użycia.

Jeśli zadanie systemowe zakończyło się niepowodzeniem, znajdź zadanie systemowe, aby wyświetlić błędy. To zadanie systemowe ma nazwę zgodną z tym wzorcem: Create index for {0} for table {1}, gdzie 0 to Nazwa wyświetlana klucza alternatywnego a 1 to nazwa tabeli.

Uwaga

Aby monitorować stan zadania systemowego, należy użyć eksploratora rozwiązania, aby utworzyć indeks. Będzie on zawierać łącze do zadania systemowego, pozwalające je monitorować. Więcej informacji: (Optionalnie) Wyświetl tworzenie indeksów śledzenia zadania systemowego

Zobacz także

Definiowanie kluczy alternatywnych przy użyciu portalu Power Apps
Definiowanie kluczy alternatywnych przy użyciu eksploratora rozwiązań
Dokumentacja dla deweloperów: Zdefiniuj klucze alternatywne dla tabeli
Dokumentacja dla deweloperów: Użyj klucza alternatywnego, aby utworzyć wiersz

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).