I tried importing a Tableau .twbx file using the /importBI command in Databricks AI/BI Dashboard

I tried importing a Tableau .twbx file using the /importBI command in Databricks AI/BI Dashboard

2026.06.28

This page has been translated by machine translation. View original

This is Kawabata.

A new feature has been added to Databricks AI/BI Dashboard: the /importBI command, which allows you to import files from external BI tools. This feature reconstructs Tableau workbook/data source files or Power BI template files as AI/BI Dashboards.

https://docs.databricks.com/aws/en/dashboards/manage/import-bi

Previously, migrating BI from Tableau to Databricks often required a lot of manual work to rebuild dashboards, but this feature now allows AI/BI Dashboards to be automatically generated based on Tableau .twbx files. I actually tried importing a .twbx file obtained from Tableau Cloud, so I'll summarize the steps and results.

Feature Overview

/importBI is a command available in Databricks AI/BI Dashboard's Genie Code (Agent mode). It imports Tableau workbook/data source files or Power BI template files and reconstructs them as AI/BI Dashboard visualizations and Metric Views.

There are two ways to import:

  • Direct upload: Upload a file directly after running the /importBI command (up to 100MB)
  • Volume reference: Reference a file placed on Unity Catalog Volume (used for files exceeding 100MB or when you want to manage files in a permission-controlled location)

This time, I'll try using the Volume reference method.

Supported Formats

Format Description
.twb Tableau Workbook (XML-based workbook definition file. Does not include extracted data)
.twbx Tableau Packaged Workbook (Package format that can bundle extracted data and related files)
.tds Tableau Data Source
.tdsx Tableau Packaged Data Source
.pbit Power BI Template

This time I'll verify with a .twbx file. .twbx is the Tableau Packaged Workbook format, a package that bundles the workbook definition (.twb) with extracted data and related files. Downloads from Tableau Cloud are often obtained in .twbx format, which is also directly supported by /importBI. It is suitable for scenarios where you migrate and reconstruct existing BI assets while mapping them to tables and views on Unity Catalog prepared on the Databricks side.

Prerequisites

Official Requirements

  • Required setting 1: Partner-powered AI features must be enabled at both the account and workspace levels
  • Required setting 2: The "Import from External BI to AI/BI" Beta feature must be enabled in the workspace

Verification Prerequisites for This Time

  • Databricks workspace: AWS cloud version
  • Feature status: Beta as of June 27, 2026
  • Data source: Tables corresponding to the data used in the Tableau workbook are prepared on Unity Catalog
  • Tableau: An environment where .twbx files can be downloaded from Tableau Cloud

Preparation

Download the .twbx File from Tableau Cloud

Open a workbook in Tableau Cloud, click the Download button at the top of the screen, and select Tableau Workbook to download the workbook file. In this environment, it was downloaded as a .twbx file. Depending on the environment, permissions, and workbook configuration, the available format may be .twb or .twbx.

Note that the download formats available in Tableau Cloud depend on the permissions granted by the content owner or site administrator. Check in advance before proceeding.

2026-06-28_11h10_16

Upload the .twbx File to Unity Catalog Volume

Upload the downloaded .twbx file to a Unity Catalog Volume on Databricks.

Open Catalog in the Databricks workspace and navigate to the destination Volume (/Volumes/{catalog}/{schema}/{volume}/). Click the Upload to this volume button and upload the .twbx file.

2026-06-28_11h15_31

Clicking "Upload to this volume" will pop up the following screen.

2026-06-28_11h15_01

After uploading, it's fine if the .twbx file appears in the file list.

2026-06-28_11h17_20

Note the upload destination path. You'll use it in later steps.

/Volumes/{catalog}/{schema}/{volume}/{filename}.twbx

Enable Beta Features

The following two settings must be enabled to use the /importBI command.

1. Partner-powered AI features

At the account level, log in to the Account Console (https://accounts.cloud.databricks.com), and enable "Enable partner-powered AI features" from SettingsFeature enablement tab.

2026-06-28_11h00_41

At the workspace level, from the username menu at the top right of the workspace, go to SettingsAdvanced tab under Workspace admin and confirm that Partner-powered AI features is enabled.

2026-06-28_11h02_14

https://docs.databricks.com/aws/en/databricks-ai/partner-powered

2. Import from External BI to AI/BI (Beta feature)

From the username menu at the top right of the workspace, open Previews and enable "Import from External BI to AI/BI".

https://docs.databricks.com/aws/en/admin/workspace-settings/manage-previews

2026-06-28_11h02_59

There's no problem if both settings are enabled.

Trying It Out

Run the /importBI Command in AI/BI Dashboard

Create a new AI/BI Dashboard. If using an existing dashboard, open it in draft mode.

Click the Genie Code icon at the top right of the screen.
Type /importBI in the chat field. Then specify the Volume path noted during preparation with an @ prefix.

/importBI
@/Volumes/{catalog}/{schema}/{volume}/{filename}.twbx

2026-06-28_11h23_47

Once executed, the import process begins. Since there were only a few workbooks this time, it completed in about 3 to 5 minutes.

2026-06-28_11h26_07

You're good once the import is complete and visualizations are generated on the dashboard.

2026-06-28_11h45_01

Check the Import Results

Review the content of the generated dashboard.
Compare it with the original Tableau dashboard to check whether the main visualizations have been reproduced.

2026-06-28_11h45_37

Since I had the impression that the details weren't quite there, I attached a screenshot and asked Genie Code.
2026-06-28_11h47_24

It got quite close to the original dashboard.
2026-06-28_12h11_12

After that, by reviewing and configuring the details, it seems like it will be able to serve the purpose of the dashboard I had previously reviewed.

Closing

I confirmed that by using the /importBI command in Databricks AI/BI Dashboard, it is possible to import a Tableau .twbx file and reconstruct it as an AI/BI Dashboard.

In situations where you want to migrate existing Tableau assets to Databricks, I think it's worth trying as a first step in your evaluation.

I hope this article serves as a useful reference!


Tableauの導入支援はクラスメソッドにおまかせください

クラスメソッドでは、お客様のTableau導入時のオンボーディング(各種トレーニング、ナレッジ共有など導入ノウハウの提供)を行っております。データ分析環境の豊富な導入実績を持つクラスメソッドが、お客様のTableau導入を支援いたします。
Tableauの導入支援サービスを見る

Share this article