Forum Discussion
Issue Creating Shortcuts to KQL Database from Digital Twin Lakehouse Output Tables
- 1 year ago
Hi Sireesha_r,
This pattern (Digital Twin Builder -> Lakehouse ->KQL DB via shortcuts) should work, but there are a few easy-to-miss constraints that often explain why some tables shortcut fine while others fail.
Quick checks
- Add in batches of 10
Digital Twin Builder can generate a lot of output tables. In the KQL DB shortcut wizard you can only add 10 tables per pass; add the next 10 after the first batch completes. Microsoft's guide calls this out ("You can only add 10 tables at a time"), and it links to the KQL DB shortcut instructions. - Naming/character limitations
KQL DB shortcuts (and OneLake shortcuts generally) are picky about names/characters:- No spaces in Delta table names (discovery can break). Doc
- Shortcut names/paths can’t include “%” or “+”, and non-Latin chars aren't supported.
- Create the shortcut from the KQL Database, to the Digital Twin Builder lakehouse ("…dtdm")
From your Eventhouse’s KQL DB: New -> OneLake shortcut ->Internal ->select your "<twin-name> dtdm"
Lakehouse ->Tables ->pick a specific table. Then it will appear under Shortcuts and you’ll query it with external_table('YourShortcutName'). See the Digital Twin Builder handoff article here. - Shortcut creation quirks
In KQL DB, shortcuts can't be renamed and are created one at a time (UI restriction).
Propagation/recognition isn't instant; if a table was just created or is empty, give it a moment and try again. The OneLake docs note recognition delays and limits. Doc - Optionally try with acceleration off/on
If you enabled "Accelerate" during creation and it fails, try creating the shortcut with it off, then enable it after. (Feature is preview; docs: Query acceleration over OneLake shortcuts.) - If the UI error is opaque, try the REST API
The OneLake Shortcuts REST API returns clearer errors (bad path, illegal characters, etc.). Create/list the shortcut there to see the exact failure.
Why this path is supported
This is the exact flow Microsoft recommends for Digital Twin Builder: create an Eventhouse/KQL DB and add OneLake shortcuts for all "dtdm" lakehouse tables, then query with external_table(). GuideIf you can share one failing table name/path (redact anything sensitive), folks here can sanity-check it against the naming rules above.
If you found this helpful, consider giving some Kudos. If I answered your question or solved your problem, please mark this post as the solution.
- Add in batches of 10
Hi Sireesha_r ,
May I ask if you have resolved this issue? Please let us know if you have any further issues, we are happy to help.
Thank you.