> For the complete documentation index, see [llms.txt](https://docs.fabricplan.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fabricplan.com/documentation/plan/powertable-sheets/how-tos/connect-powertable-sheet-to-a-semantic-model.md).

# Connect PowerTable sheet to a semantic model

In this article, you look at the steps to connect to a semantic model from a PowerTable sheet. Connect to an existing semantic model and create a table app. The data table, along with any changes or updates, is saved to your preferred destination database.

{% hint style="info" %}

#### Important

This feature is in preview.
{% endhint %}

{% hint style="info" %}

#### Note

You can also create a table by uploading data from an Excel or CSV file. For more information, see [Create a table app with PowerTable sheets.](/documentation/plan/powertable-sheets/how-tos/create-a-table-app-with-powertable-sheets.md)
{% endhint %}

### Prerequisites

Before you begin, make sure that you have the following prerequisites in place:

* Connections established to the [Fabric SQL database](/documentation/plan/planning-sheets/how-tos/create-a-database-connection.md) and the [semantic model](/documentation/plan/planning-sheets/how-tos/create-and-share-a-cloud-connection-for-a-semantic-model-sp.md) that contain the data for your PowerTable.
* A [Plan item](/documentation/plan/planning-sheets/how-tos/creating-a-planning-sheet.md#create-a-planning-sheet) created in your Fabric workspace.

### Create a PowerTable sheet

1. In your plan, select **New PowerTable Sheet** or select the **PowerTable** icon on the landing page. Enter a name for the sheet and select **Create**.

<figure><img src="/files/v9x5CWcih4TWeQOTg9Iq" alt=""><figcaption></figcaption></figure>

2. Select **Create a New App** to create your app. You can also select **Explore PowerTable** to experience a sample PowerTable app.

<figure><img src="/files/64IknoGab86EFy2RGuWj" alt=""><figcaption></figcaption></figure>

3. **Select a Connection:** Choose a Fabric SQL connection if available. If there are no connections, you can create one by selecting [Create Connection](/documentation/plan/planning-sheets/how-tos/create-a-database-connection-for-collaboration.md).

<figure><img src="/files/oXhDjCoshk0j5cFYgPBd" alt=""><figcaption></figcaption></figure>

4. **Database Name:** Select the destination Fabric SQL database to store the table data. Select **Add**.

<figure><img src="/files/crW5ZzNs1xIetZ8X5rtN" alt=""><figcaption></figcaption></figure>

5. Select **Connect**.

<figure><img src="/files/niMXtcR4TyAzc1OuIEWo" alt="" width="375"><figcaption></figcaption></figure>

### Create a table

1. Select **New Table**.
2. Choose the database schema.
3. Enter a **Table Name**.
4. Choose **Connect To Semantic Model** in **Import Data**.
5. Select your **Connection** and the required **Semantic Model**.
6. Select **Next**.

<figure><img src="/files/SkZUhPQ8kHBXU04P8FA8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

#### Note

Capacity workspaces with Pro licenses are not supported. Make sure to select a workspace of premium capacity.
{% endhint %}

7. Map and assign your data to the table by selecting the required fields and corresponding values.

<figure><img src="/files/0JQffktugO2hVo6I3Tcs" alt=""><figcaption></figcaption></figure>

8. Set the primary key fields by selecting the three dots and selecting primary keys.

<figure><img src="/files/MWe7AkB13XKDqEfa7oS2" alt=""><figcaption></figcaption></figure>

9. If needed, you can use filters to include only specific field values from the table.

<figure><img src="/files/5jEyIW2DBHlUKCI7hlog" alt=""><figcaption></figcaption></figure>

10. Select **Next**.

<figure><img src="/files/ydN66tAVBjJLgEWusxyi" alt=""><figcaption></figcaption></figure>

#### Configure columns

PowerTable sheets automatically detect column properties and rename any unsupported column names to match the supported format. You can review and modify them as needed.

<figure><img src="/files/32VLgZJ0Ue342gncBj0L" alt=""><figcaption></figcaption></figure>

1. Review the detected column settings.
2. If the primary key is unselected, select the appropriate column as the primary key.
3. Configure columns as required:
   * Mark fields as **Mandatory** if they must contain values.
   * Set fields with distinct values as **Unique Key** to allow only unique values.
   * Set a column as an **Identity Column** when you need PowerTable to generate unique, sequential values automatically. Only numeric columns and primary key columns can be configured as identity columns.
4. Modify column properties, including:
   * Length
   * Data type
   * Input type
   * Display name
5. Enter default values for columns, if required.
6. Optionally, select **Add Column** to create additional columns.
7. To create a composite primary key, select **Unique Combination**, and then select two or more columns to define a unique combination key.
8. Select **Finish**.

{% hint style="info" %}

#### Note

In this step, you can **enable Slowly Changing Dimensions (SCDs)** by turning the toggle. For a table, this is a one-time configuration that cannot be modified later.
{% endhint %}

9. The table app is created successfully in PowerTable with the configured columns and values. Select **Save** to save your table.

<figure><img src="/files/SHbIjmuGTN4e7UgbzaOo" alt=""><figcaption></figcaption></figure>

### Next steps <a href="#next-steps" id="next-steps"></a>

Configure [access control](/documentation/plan/powertable-sheets/how-tos/set-up-row-and-column-access-control.md) and automated workflows and [approvals](/documentation/plan/powertable-sheets/how-tos/approval-flow/configure-approval-workflow.md) for your new app.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.fabricplan.com/documentation/plan/powertable-sheets/how-tos/connect-powertable-sheet-to-a-semantic-model.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.