Dataverse Alternate Keys a výkon — intake snapshot

Toto je veřejný intake snapshot k výzkumu. Finální doporučení je zde: Dataverse Alternate Keys: doporučení pro pozdě doplněné externí ID.

Ověřená startovní fakta z Microsoft dokumentace

• Alternate Keys jsou v Dataverse určené pro identifikaci řádků jinak než primárním GUID a běžně dávají smysl pro integrace s externími systémy.
• Alternate Keys používají databázové indexy: Microsoft uvádí, že jimi vynucuje unikátnost a optimalizuje lookup výkon.
• Vytvoření indexu pro existující tabulku může trvat dlouho; stav se sleduje přes EntityKeyIndexStatus a index se vytváří asynchronně.
• Limity klíče: SQL index constraint v dokumentaci uvádí max. 900 bytes per key a 16 columns per key; tabulka může mít až 10 alternate key definitions.
• Podporované typy sloupců pro klíč zahrnují např. string, integer, decimal, datetime, lookup a choice/picklist; sloupce nesmí mít field-level security.
• Některé znaky ve string hodnotě klíče rozbíjí GET/PATCH adresování přes alternate key: /, <, >, *, %, &, :, \\, ?, +.
• Upsert má podle Microsoftu performance penalty proti Create; pokud víme, že řádek neexistuje, Microsoft doporučuje použít Create.

Konkrétní výzkumné otázky

1. Jaká je reálná cena Alternate Key na create/update cestě, protože je pod tím databázový index?
2. Co přesně Microsoft říká k výkonu pro Create, Update, Upsert a adresování řádku přes alternate key?
3. Co se stane, když je alternate-key string při create prázdný/null a doplní se až pozdějším update?
4. Je stringový external ID jako Alternate Key vhodný pro high-throughput integraci?
5. Kdy je lepší mít external ID jen jako normální sloupec a idempotenci řešit jiným stabilním klíčem?
6. Co má tým měřit v pre-produkci: latence create, latence pozdějšího update, konflikty unikátnosti, retry/replay chování a budoucí upsert výkon?

Vytvořené tasky

• t_3c10a4b4 — research: Dataverse Alternate Keys mechanics + performance implications
• t_47dc86cd — research: integration patterns when external ID arrives after Dataverse create
• t_c2b4b7a2 — analysis: recommendation for Dataverse Alternate Keys with delayed external ID
• t_114800f0 — writer: public intake snapshot
• t_5690191f — reviewer: intake snapshot + final recommendation review/fixup

Oficiální Microsoft dokumentace

• Work with alternate keys
• Use an alternate key to reference a record
• Use Upsert to create or update a record
• Retrieve a table row using the Web API — retrieve using an alternate key

Poznámka k rozsahu

Finální doporučení je publikované samostatně zde: Dataverse Alternate Keys: doporučení pro pozdě doplněné externí ID.