Edit

Digital twin builder (preview) tutorial part 1: Set up resources

This tutorial is Part 1 of a series that walks you through the basics of digital twin builder (preview) in Microsoft Fabric. Digital twin builder is a tool for creating digital representations of real-world assets and their relationships. In this part, you prepare your environment by uploading sample data to a lakehouse and creating a digital twin builder item.

In this tutorial, you:

  • Download and upload sample data to a Fabric lakehouse
  • Load CSV files into lakehouse tables
  • Create a digital twin builder item in your workspace

Important

This feature is in preview.

Prerequisites

Upload sample data to a lakehouse

  1. Download all the .csv files from the sample folder in GitHub: digital-twin-builder/contoso-energy.

  2. Go to Microsoft Fabric and open your workspace.

  3. Select + New item:

    Screenshot of Microsoft Fabric, New item.

  4. Scroll down or search for Lakehouse and select that item. Name your lakehouse GettingStartedRawData and select Create. Your lakehouse opens when it's done.

  5. In the Explorer pane on the left, select the more options menu (...) next to Files. Select Upload > Upload Files.

    Screenshot of Microsoft Fabric, upload files to the lakehouse.

  6. Select the sample data files you downloaded and then select Upload. When the files are finished uploading, close the Upload files pane.

    Screenshot of Microsoft Fabric, files uploaded.

  7. In the Explorer pane on the left, select Files to see the files in the lakehouse. For each file, complete these steps:

    1. Hover over the file name and select the more options menu (...). Select Load to Tables > New table.

      Screenshot of Microsoft Fabric, selecting the Load to Tables option.

    2. In the new table settings that appear, leave the default settings. Select Load.

      Screenshot of Microsoft Fabric, configuring the load.

    3. Wait for the table to finish loading before you start loading the next one.

You should now see five tables in the Explorer pane of your lakehouse, under Tables. Open them to verify they contain data.

Screenshot of Microsoft Fabric, sample data tables.

You now have sample data available in your GettingStartedRawData lakehouse. You use the data in this lakehouse throughout this tutorial.

Create new digital twin builder item in Fabric

Note

Recall from the tutorial prerequisites that Digital Twin Builder (preview) must be enabled in your Fabric tenant settings.

  1. Go to your Fabric workspace.

  2. Select New item.

  3. Search for the Digital Twin Builder (preview) item, and select it.

    Screenshot of Digital Twin Builder item.

  4. Name your item TutorialDTB and select Create.

    Tip

    Digital twin builder names can include numbers, letters, and underscores (no spaces or dashes).

  5. Wait for your digital twin builder item to be created. When your digital twin builder item is ready, it opens to the semantic canvas.

In the next step of this tutorial, you use the semantic canvas to define a domain ontology.

Next step

Tutorial part 2: Add entity types and map data

  • Last updated on