import_tableau

Convert Tableau workbooks and datasources into Snowflake Semantic Views.

Updated Jun 9, 2025
One-click install
npx skills add https://github.com/RajaPoseidon/snippets_repo --skill import-tableau-rajaposeidon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: import_tableau
Source: https://github.com/RajaPoseidon/snippets_repo/tree/main/snowflake/skills/import_tableau
Command: npx skills add https://github.com/RajaPoseidon/snippets_repo --skill import-tableau-rajaposeidon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Migrating Tableau workbooks (.twb/.twbx) and datasources (.tds/.tdsx) into Snowflake Semantic Views requires manually translating datasources, calculated fields, relationships, and filters, which is error-prone and slow. ## Core Features & Use Cases - File Analysis: Inspect Tableau files staged in Snowflake to list datasources, worksheets, column counts, custom SQL usage, and conversion warnings before exporting. - Semantic Model Export: Generate a semantic model YAML from a Tableau file with options to filter by worksheets, columns, or datasource, remap target database/schema, and control custom SQL handling. - Published Datasource Resolution: Merge published datasource metadata from .tds/.tdsx files when the workbook alone cannot resolve column metadata. - Use Case: A data team migrating from Tableau to Snowflake uploads a .twbx workbook to a stage, analyzes its 40 columns and 3 datasources, exports a filtered semantic model YAML, verifies table references, and deploys the semantic view. ## Quick Start Import the Tableau workbook at @DB.SCHEMA.STAGE/sales.twbx into a Snowflake Semantic View named sales_model.

Frequently Asked Questions about import_tableau

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I import a Tableau workbook into Snowflake Semantic Views?▼

Upload the .twb or .twbx file to a Snowflake stage, run the tableau_analyze tool to inspect its contents, then execute the tableau_export_yaml.py script with the stage path, model name, and output file to generate the semantic model YAML.

How to convert Tableau calculated fields to Snowflake semantic models?▼

The export script converts supported Tableau calculated fields automatically during YAML generation. Unsupported calculations such as LOD expressions and table calculations are skipped with warnings and must be recreated manually in SQL.

Can I import Tableau workbooks that use published datasources?▼

Yes, but the workbook alone cannot resolve published datasource column metadata. Download the published datasource as a .tds or .tdsx file, upload it to the same stage, and re-run the export with the --additional-files option.

Does the Tableau import support custom SQL queries?▼

Yes, workbooks with custom SQL are handled in two ways: the export can generate placeholder custom views with DDL statements, or embed the SQL directly in the YAML using the --use-custom-sql-in-definition flag.

Why does my Tableau export produce an empty YAML file?▼

An empty YAML with zero columns usually means the include_worksheets or include_columns filters are too restrictive. Filter names are case-sensitive exact matches, so verify spelling against the analysis output.

What Tableau features are not supported in Snowflake Semantic Views?▼

Multi-table fact expressions, many-to-many relationships, LOD expressions, and table calculations cannot be auto-converted. These are excluded during export with warnings and must be recreated manually.