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 ,
Thank you tayloramy for your inputs.
We’d like to follow up regarding the recent concern. Kindly confirm whether the issue has been resolved, or if further assistance is still required. We are available to support you and are committed to helping you reach a resolution.
Best Regards,
Chaithra E.