Udostępnij przez

Definiowanie kluczy alternatywnych do wierszy odwołań

Klucze alternatywne zapewniają wydajny i dokładny sposób integrowania danych z systemami zewnętrznymi. Jest to niezbędne w przypadkach, gdy system zewnętrzny nie przechowuje identyfikatorów GUID, które jednoznacznie identyfikują wiersze w Microsoft Dataverse.

System integracji danych używa kluczy alternatywnych do unikatowego identyfikowania wierszy przy użyciu co najmniej jednej wartości kolumny tabeli reprezentującej unikatową kombinację. Każdy klucz alternatywny ma unikatową nazwę.

Na przykład aby zidentyfikować wiersz konta z kluczem alternatywnym, możesz użyć numeru konta lub kolumny numer konta w połączeniu z innymi kolumnami, które mają wartości, które nie powinny ulec zmianie.

Uwaga / Notatka

Klucze alternatywne można definiować za pomocą usługi Power Apps, ale mogą być używane 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 przy użyciu danych importowanych z systemów zewnętrznych bez identyfikatorów wierszy.

Tworzenie klucza alternatywnego

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

Projektant Description
Portal usługi Power Apps Zapewnia ułatwione i zoptymalizowane doświadczenie, ale niektóre opcje nie są dostępne.
Więcej informacji: Definiowanie kluczy alternatywnych przy użyciu portalu usługi Power Apps
Eksplorator rozwiązań Nie tak proste, ale zapewnia większą elastyczność w przypadku mniej typowych wymagań.
Więcej informacji: Definiowanie kluczy alternatywnych przy użyciu Eksploratora rozwiązań

Uwaga / Notatka

W środowisku można również utworzyć klucz alternatywny, korzystając z następujących elementów:

Informacje zawarte w tym artykule ułatwiają wybór projektanta, którego można użyć.

Aby utworzyć klucze alternatywne, należy użyć portalu usługi Power Apps , chyba że musisz spełnić dowolne z następujących wymagań:

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

Limity tworzenia kluczy alternatywnych

Istnieją ograniczenia związane z tworzeniem klucza alternatywnego.

Pola, które mogą być używane dla kluczy alternatywnych

Do tworzenia kluczy alternatywnych można użyć tylko tych rodzajów kolumn:

  • Decimal
  • Liczba całkowita (Liczba całkowita)
  • Pojedynczy wiersz tekstu (ciąg)
  • Data i godzina
  • Lookup
  • Wybór

Uwaga / Notatka

  • Kolumny, które mają włączoną właściwość zabezpieczeń kolumny , nie mogą być używane jako klucz alternatywny. Więcej informacji: Tabele zabezpieczeń pól
  • Jeśli wartości NULL są używane w kolumnach klucza alternatywnego, unikatowość nie będzie wymuszana. Aby uniknąć zduplikowanych rekordów, nie używaj wartości null w kolumnach zdefiniowanych w unikatowym ograniczeniu klucza alternatywnego.

Liczba kluczy

Dla tabeli można zdefiniować maksymalnie 10 różnych kluczy.

Prawidłowy rozmiar klucza

Po utworzeniu klucza system sprawdza, czy klucz może być obsługiwany przez platformę, w tym że 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, które są używane w kluczu alternatywnym, zawierają jeden z następujących znaków: <, >, *, %, &, :, /, \\, #, to działania aktualizacji lub upsert (PATCH) nie będą działać.

Jeśli potrzebujesz tylko unikatowości, takie podejście działa, ale jeśli musisz użyć tych kluczy w ramach integracji danych, najlepiej utworzyć klucz w kolumnach, które nie zawierają danych z tymi znakami.

Śledzenie stanu tworzenia klucza alternatywnego

Po utworzeniu klucza alternatywnego inicjuje zadanie systemowe tworzenia indeksów w tabelach bazy danych w celu wymuszania unikatowych ograniczeń dotyczących kolumn używanych przez klucz alternatywny. Klucz alternatywny nie będzie obowiązywać do momentu 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 stan klucza alternatywnego to Aktywny i jest dostępny do użycia.

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

Uwaga / Notatka

Jeśli chcesz monitorować stan zadania systemowego, należy użyć Eksploratora rozwiązań do utworzenia indeksu. Będzie on zawierać link do zadania systemowego, aby można było go monitorować. Więcej informacji: (opcjonalnie) Wyświetl zadanie systemowe śledzące tworzenie indeksów

Zobacz także

Definiowanie kluczy alternatywnych przy użyciu portalu usługi Power Apps
Definiowanie kluczy alternatywnych przy użyciu Eksploratora rozwiązań
Dokumentacja dla deweloperów: Praca z kluczami alternatywnymi
Dokumentacja dla deweloperów: używanie klucza alternatywnego do odwołowania się do rekordu
Dokumentacja dla deweloperów: pobieranie rekordu przy użyciu klucza alternatywnego

  • Last updated on