Power BI Semantic Model Exporter 📊

🇺🇸 English Version | 🇧🇷 Versão em Português

---

🇺🇸 English Version

Description

This repository contains C# scripts designed to be executed within Tabular Editor. They extract the metadata and semantic structure of a Power BI model and copy it directly to your clipboard. It is highly useful for documenting Data Warehouses, creating data dictionaries, or feeding LLMs with your semantic model context.

Features

• Table Classification: Automatically identifies Fact and Dimension tables based on table names.
• Analytical Role Inference: Uses heuristics (column name prefixes and data types) to classify columns into roles: METRIC, KEY, DESCRIPTION, or RULE / FLAG.
• Relationship Mapping: Extracts all active and inactive relationships, including their cardinality (1:1, N:1) and cross-filtering direction.
• Clipboard Integration: Instantly copies the generated report to your clipboard for easy pasting into Notepad, Markdown files, or chats.

Prerequisites

1. Power BI Desktop installed with your target model open.
2. Tabular Editor (version 2 or 3) installed. You can download Tabular Editor 2 for free from SQLBI or GitHub.

How to Use

1. Open your model in Power BI Desktop.
2. Navigate to the External Tools tab in the ribbon.
3. Click on Tabular Editor to open the model's metadata.
4. In Tabular Editor, go to the C# Script tab (usually at the bottom or accessible via View > C# Script).
5. Choose the appropriate script from this repository:
   • Use the English script if your database uses international naming conventions (fact, id_, amt_, etc.).
   • Use the Portuguese script if your database uses Brazilian naming conventions (fato, cd_, vl_, etc.).
6. Paste the script into the C# script editor.
7. Click the Run button (▶) or press F5.
8. A popup will confirm the export. Press Ctrl+V wherever you want to paste your semantic model documentation!

Naming Conventions (Heuristics)

The script relies on the following prefixes to infer column roles:

• Metrics: amt_, val_ (or data types Double/Decimal)
• Keys: id_, cd_, nk_
• Descriptions: desc_, nm_
• Flags/Rules: is_, flg_

---

🇧🇷 Versão em Português

Descrição

Este repositório contém scripts em C# desenvolvidos para serem executados dentro do Tabular Editor. Eles extraem os metadados e a estrutura semântica de um modelo do Power BI e copiam tudo diretamente para a sua área de transferência. É uma ferramenta excelente para documentar Data Warehouses, criar dicionários de dados ou passar o contexto do seu modelo para IAs.

Funcionalidades

• Classificação de Tabelas: Identifica automaticamente tabelas Fato e Dimensão com base no nome.
• Inferência de Papéis Analíticos: Utiliza heurísticas (prefixos e tipos de dados) para classificar colunas em: MÉTRICA, CHAVE, DESCRIÇÃO ou REGRA / FLAG.
• Mapeamento de Relacionamentos: Extrai todos os relacionamentos (ativos e inativos), incluindo cardinalidade (1:1, N:1) e direção de filtro.
• Integração com o Clipboard: Copia o relatório gerado automaticamente para a área de transferência.

Pré-requisitos

1. Power BI Desktop instalado e com o modelo aberto.
2. Tabular Editor (versão 2 ou 3) instalado. Você pode baixar a versão 2 gratuitamente pelo SQLBI ou pelo GitHub.

Como Usar

1. Abra o seu modelo no Power BI Desktop.
2. Vá até a guia Ferramentas Externas (External Tools) no menu superior.
3. Clique em Tabular Editor.
4. Dentro do Tabular Editor, abra a aba C# Script (geralmente na parte inferior ou em View > C# Script).
5. Escolha o script adequado neste repositório:
   • Use o script em Inglês se o seu banco de dados usar o padrão internacional (fact, id_, amt_, etc.).
   • Use o script em Português se o seu banco usar o padrão brasileiro (fato, cd_, vl_, etc.).
6. Cole o código na janela de script.
7. Clique no botão de Executar (▶) ou pressione F5.
8. Um aviso confirmará a cópia. Pressione Ctrl+V onde quiser colar a documentação do seu modelo!

Padrão de Nomenclatura (Heurística)

O script utiliza os seguintes prefixos para inferir o papel das colunas:

• Métricas: vl_ (ou tipos de dados Double/Decimal)
• Chaves: cd_, nk_
• Descrições: dc_
• Flags/Regras: fl_