Referencia de comandos

2026-06-11
Peer Grønnerup

Applies to:

❌ ~~Tabular Editor 2~~
❌ ~~Tabular Editor 3~~
✔ Tabular Editor CLI

Important

La CLI de Tabular Editor se encuentra en vista previa pública limitada. Se ofrece para su evaluación con una cuenta de Tabular Editor; no se requiere ninguna licencia durante la vista previa. Los comandos, las opciones y las salidas pueden cambiar antes de la disponibilidad general. La versión preliminar deja de funcionar después de 2026-09-30. No recomendamos usar la CLI en pipelines de CI/CD de producción durante la vista previa. Consulta nuestro acuerdo de licencia.

Esta página ofrece una breve descripción y un ejemplo por comando. Todos los comandos aceptan --help para consultar la documentación completa de las opciones:

te deploy --help            # Help for a single command
te bpa run --help           # Help for a command with subcommands

Note

Durante la versión preliminar, la salida de --help de la CLI es la referencia definitiva de parámetros y opciones. El contenido de esta página se ha seleccionado manualmente y puede quedarse atrás respecto a --help cuando se añadan novedades entre versiones preliminares.

Rutas de objeto

El direccionamiento de objetos en la CLI usa una única gramática compartida por todos los comandos. En la referencia siguiente aparecen dos tipos de ruta:

<path>: identifica exactamente un objeto o contenedor. Lo usan los comandos que operan sobre un único destino: te get, te set, te add, te rm, te mv, te format -p, te deps, te macro run --on.
<path-filter>: identifica cero o más objetos y admite comodines. Lo usan los comandos que operan sobre un conjunto: te ls, te bpa run --path y otros comandos de tipo inspección.

Ambas formas de ruta comparten las mismas reglas de sintaxis; solo se diferencian en dos puntos:

Las rutas de filtro permiten comodines *; las rutas de objeto no.
Las rutas de objeto permiten el sufijo entre corchetes de DAX (por ejemplo, Sales[Amount]); las rutas de filtro no.

Segmentos y separadores

Una ruta es una secuencia de segmentos separados por barras. Cada segmento nombra un único paso: una tabla, un objeto hijo o una palabra clave de contenedor.

Sales — un segmento
Sales/Revenue — dos segmentos
Roles/Admin/Members/bob — cuatro segmentos

La entrada vacía y . significan «la raíz del modelo»: el punto de partida implícito para las rutas de filtro y el sujeto explícito de las consultas del tipo te get ..

Uso de comillas

La mayoría de los nombres de segmentos funcionan tal cual. Pon un segmento entre comillas cuando su nombre contenga espacios, barras, corchetes o cualquier carácter que, de otro modo, se interpretaría como sintaxis. La CLI sigue las convenciones de comillas de DAX, por lo que el uso de comillas en las rutas de te coincide con lo que escribirías dentro de una expresión DAX:

Forma	Uso	Regla de escape
`'Net Sales'`	Tablas y objetos con nombre con espacios.	Duplica la comilla simple (`'Bob''s'` → `Bob's`).
`"Net Sales"`	Igual que arriba; conveniente entre distintos shells cuando es engorroso escapar comillas simples.	Duplica la comilla doble (`"He said ""hi"""` → `He said "hi"`).
`[Sales Amount]`	Un sufijo entre corchetes al estilo DAX en una tabla (`'Sales'[Sales Amount]`) o una referencia global al modelo solo entre corchetes (`[Total Sales]`). Solo en rutas de objeto.	Duplica el corchete de cierre (`[foo]]bar]` → `foo]bar`).

Dentro de los segmentos entre comillas, * se trata como un carácter literal, no como un comodín. Por tanto, 'Sa*' coincide con una tabla cuyo nombre es exactamente Sa*.

Referencias al estilo DAX (solo rutas de objeto)

Se aceptan dos formas con sintaxis DAX en cualquier lugar donde se admita un <path>:

'Table'[Member] — equivalente a Table/Member. El sufijo entre corchetes hace que las coincidencias ambiguas se resuelvan a favor de columnas y medidas frente a jerarquías/particiones.
[Member] — una medida o columna independiente, sin tabla delante. Busca en todo el modelo una medida o columna con ese nombre. Las medidas tienen prioridad cuando existen tanto la medida como la columna.

te get "'Sales'[Amount]"             # Same as te get Sales/Amount
te get "'Net Sales'[Sales Amount]"   # Spaced names via DAX form
te get "[Total Sales]"               # Model-wide measure-or-column lookup

Contenedores y palabras clave

Varios nombres funcionan como palabras clave de contenedor. Una palabra clave puede usarse sola (para enumerar todo el contenedor) o aparecer dentro de una ruta (para entrar en esa subcolección del elemento padre actual).

Palabra clave	Ámbito	Significado
`Tables`, `Medidas`, `Columns`, `Hierarchies`, `Particiones`	Modelo	Todos los objetos de ese tipo en todo el modelo.
`Relaciones`, `Roles`, `Perspectives`, `Cultures`, `DataSources`, `Expressions`, `CalculationGroups`, `Functions`, `Annotations`	Modelo	Contenedores a nivel de modelo.
`Medidas`, `Columns`, `Hierarchies`, `Particiones`, `Calendars`, `CalculationItems`	Tabla	Subcontenedores dentro de una tabla.
`Levels`	Jerarquía	Niveles de una jerarquía.
`Members`, `TablePermissions` (alias `Permissions`)	Rol	Elementos hijos de un rol.

Algunos ejemplos muestran en qué se diferencian las rutas simples y las rutas con ámbito de contenedor:

te get Sales/Revenue                       # Measure or column on Sales
te get Sales/Measures/Revenue              # Same, container-scoped - disambiguates if other kinds share the name
te get Sales/Geography/Levels/Year         # Specific level of a hierarchy
te get Roles/Admin/Members/bob@example.com # Role member
te get Sales/refreshPolicy                 # Refresh-policy sub-object on a table
te get "Measures/Revenue/KPI"              # KPI sub-object of a measure

Pon un segmento entre comillas para forzar la coincidencia literal del nombre cuando el nombre real de un objeto coincide con una palabra clave. La tabla cuyo nombre literal es Tables es 'Tables' y se accede con te get "'Tables'".

Comodines en rutas de filtro

Las rutas de filtro añaden un único carácter comodín - * - que coincide con cualquier secuencia de caracteres dentro de un solo segmento (codicioso, de un solo segmento). Los comodines permiten que te ls y comandos similares acoten los resultados.

te ls 'Sa*'                          # Tables whose name starts with Sa
te ls 'Sales/*Amount'                # Children of Sales whose name ends with Amount
te ls '*/Amount'                     # An Amount column/measure across every table
te ls 'Roles/Re*/Members'            # Members of every role matching Re*

Una ruta de filtro con N segmentos produce resultados con N niveles de profundidad; los comodines nunca amplían automáticamente un nivel más allá de lo que hayas escrito. El atajo de un solo segmento te ls Sales es la excepción: un nombre de tabla sin calificar y sin comodines se expande a los elementos secundarios directos de la tabla para ajustarse a la intención de "muéstrame qué hay en Sales". En cambio, te ls Sa* devuelve solo las tablas coincidentes, sin expansión.

El sufijo entre corchetes de DAX se rechaza en las rutas de filtro; pon entre comillas los nombres que contengan [ y ] si necesitas que coincidan literalmente.

Errores y sugerencias

Los segmentos mal escritos generan un error contextual con una sugerencia de "quizás quisiste decir" cuando la CLI puede deducir lo que querías decir. Las rutas a las que les falta el elemento padre fallan antes de la comprobación del elemento hoja, así que los mensajes señalan el segmento que realmente está mal. Los contenedores vacíos (por ejemplo, te ls Hierarchies en un modelo sin jerarquías) muestran un simple mensaje de "no hay nada aquí" en lugar de un error.

Opciones globales

Estas opciones están disponibles en todos los comandos y se pueden usar antes o después del nombre del subcomando.

Opción	Descripción
`-m, --model <path>`	Ruta al modelo semántico (carpeta TMDL, archivo `.bim` o carpeta de TE).
`-s, --server <endpoint>`	Nombre del Workspace o punto de conexión (p. ej., `MyWorkspace`, `powerbi://...`, `asazure://...`, `localhost`).
`-d, --database <name>`	Nombre del modelo semántico en el Workspace.
`--local`	Conecta a una instancia de Power BI Desktop en ejecución local (solo Windows).
`--auth <method>`	Método de autenticación: `auto`, `interactive`, `spn`, `env`, `managed-identity` (predeterminado: `auto`).
`--output-format <format>`	Formato de Stdout: `text` (predeterminado), `json`, `csv`, `tmsl` (alias `bim`), `tmdl`. `csv` se respeta en los comandos que emiten datos tabulares; `tmsl`/`tmdl` solo se respeta en `te get` y `te ls` para la serialización de objetos completos. Los comandos rechazan los formatos que no admiten.
`--error-format <format>`	Formato de stderr para errores, advertencias y sugerencias: `text` (predeterminado) o `json`. Para cualquier otro valor, se usa `text`. Es independiente de `--output-format`, así que puedes combinar stdout en JSON con errores en texto sin formato (o viceversa).
`--recent [N]`	Usa un modelo que hayas usado recientemente. Sin valor = selector interactivo; `N` = el N-ésimo más reciente (1 = el último usado).
`--non-interactive`	Desactiva todas las indicaciones interactivas. Finaliza con un error accionable si falta algún dato obligatorio.
`--debug`	Habilita el registro de depuración en stderr (cadenas de conexión, flujo de autenticación, tiempos).

te --version muestra la versión de la CLI y sale.

En los comandos que leen un modelo, el orden de resolución es:

el argumento posicional <model> → la opción global --model → --server/--database (remoto) → conexión activa de te connect → --recent.

E/S del modelo

load

Carga un modelo semántico y muestra un resumen del modelo: nombre, nivel de compatibilidad y recuentos generales de objetos (tablas, medidas, columnas).

te load ./model                            # TMDL folder
te load model.bim                          # BIM file
te load -s MyWorkspace -d MyModel          # Remote workspace

save

Guarda un modelo en disco. Úsalo para escribir en archivos locales un modelo de un Workspace remoto, convertir formatos o guardar de nuevo las ediciones en el origen.

te save acepta:

-o, --output-path <path> - archivo o carpeta de destino. Opcional - si se omite, te save vuelve a escribir en la ubicación de origen y conserva el formato original.
--serialization <fmt> - tmdl, bim, te-folder, pbip, database.json. De forma predeterminada, se deduce a partir del modelo cargado (origen BIM → BIM, TMDL SemanticModel/ → TMDL en definition/).
--force - omite la validación y sobrescribe la salida existente. Algunos rechazos (contenedores ambiguos, raíces de proyecto con varios SemanticModel) siguen ocurriendo incluso con --force.
--skip-bpa - omite por completo el control de BPA.
--fix-bpa - corrige automáticamente las infracciones de BPA cuando las reglas definen una expresión de corrección.
--bpa-rules <path> - repetible; reemplaza bpa.rules de la configuración de la CLI solo en este guardado. Las reglas integradas siguen aplicándose a menos que bpa.builtInRules sea false.
--skip-validation - omite el análisis semántico y la validación de DAX para descargas rápidas en modo passthrough.
--supporting-files - genera archivos auxiliares de Fabric (.platform, definition.pbism).

te save                                    # Save back to source (no -o needed)
te save ./model.bim -o ./tmdl-out          # Convert BIM to TMDL
te save -o ./project --serialization pbip         # Save as a PBIP project
te save -o ./out -s my-workspace -d my-model --skip-validation   # Fast download

Tip

Use te save -o <path> -s <Workspace> -d <model> para descargar un modelo remoto a disco. Combínalo con --skip-validation para obtener el passthrough más rápido cuando solo necesites los bytes (sin análisis semántico de DAX).

open

Abre un modelo en la aplicación de escritorio de Tabular Editor 3. Solo para Windows (requiere que TE3 esté instalado).

te open ./my-model

init

Crea un nuevo modelo semántico vacío en la ruta especificada. De forma predeterminada, usa un modelo TMDL en modo de compatibilidad PowerBI, con nivel de compatibilidad 1702.

te init acepta:

<output-path> - argumento posicional: directorio donde se creará el modelo (omítelo para usar la ruta global --model).
--compatibility-mode <mode> - PowerBI (predeterminado) o AnalysisServices.
--compatibility-level <N> (alias --compat) - nivel de compatibilidad. De forma predeterminada, usa 1702 cuando el modo es PowerBI; 1500 en caso contrario. Consulta Actualizar el nivel de compatibilidad.
--name <name> - nombre del modelo o de la base de datos (predeterminado: el nombre del directorio).
--serialization <fmt> - tmdl (predeterminado), bim, te-folder, pbip.
--force - reemplaza cualquier archivo o directorio existente en la ruta de destino.

te init ./new-model                                       # TMDL, PowerBI mode, compat 1702
te init ./new-model --serialization bim                   # Single-file BIM model
te init ./as-model --compatibility-mode AnalysisServices  # AS model, compat 1500
te init ./existing-dir --force                            # Overwrite non-empty directory

Edición del modelo

set

Establece una propiedad en un objeto del modelo. Acepta un argumento <path>.

te set acepta:

-q <property> - nombre de la propiedad (por ejemplo, expression, formatString, description, isHidden).
-i <value> - valor (usa - para leer desde stdin).
--save / --save-to <path> - guarda los cambios.

te set Sales/Amount -q expression -i "SUM(Sales[Amt])" --save
te set "'Net Sales'[Sales Amount]" -q formatString -i "#,0" --save   # DAX form with spaced names
te set Sales -q isHidden -i true --save

add

Agrega un objeto al modelo. Especifica un <path> para el nuevo objeto (el elemento padre ya debe existir; el segmento final es el nuevo nombre) y el tipo mediante -t / --type. Las relaciones mantienen su sintaxis abreviada (Sales[Key]->Dim[Key]).

te add acepta:

-t, --type <type>: tipo de objeto. Valores comunes: Table, Measure, Column, CalculatedColumn, Hierarchy, Role, Perspective, Culture, CalculationGroup, CalculationItem. Se admite el autocompletado con la tecla Tab; la lista completa se puede obtener ejecutando te add --help.
--if-not-exists - sale con código 0 sin error si el objeto ya existe. Úsalo en canalizaciones de CI/CD idempotentes.

te add Sales/Revenue -t Measure -i "SUM(Sales[Amount])" --save
te add Sales -t Table --save
te add "Sales[ProdKey]->Product[ProdKey]" --save                           # Relationship shorthand
te add Sales/MarketingFlag -t CalculatedColumn -i "Sales[Amount] > 1000" --if-not-exists --save
te add Perspectives/Default/Sales --save                                   # Include Sales in the Default perspective
te add Roles/Reader -t Role --save                                         # New role at the model level

En las tablas vinculadas a datos, te add también admite la detección del esquema desde orígenes SQL, Lakehouse o Warehouse. Consulta te add --help para ver --source, --endpoint, --source-table, --columns, etc.

rm

Elimina un objeto. De forma predeterminada, comprueba las dependencias para evitar romper referencias existentes.

te rm acepta:

<path> — argumento posicional: el objeto que se va a eliminar.
--force — omite la comprobación de objetos dependientes.
--if-exists — sale con código 0 sin error si el objeto no existe. Úsalo en canalizaciones de CI/CD idempotentes.
--dry-run — muestra una vista previa de la eliminación sin aplicarla.
--save — guarda el cambio en el modelo cargado.

te rm Sales/Revenue --save
te rm "'Sales'[Revenue]" --save              # DAX form
te rm Sales/Revenue --dry-run                # Preview only
te rm Sales/OldMeasure --if-exists --save    # Idempotent

mv

Mueve o renombra un objeto del modelo. Tanto el origen como el destino son argumentos <path>.

te mv Sales/Revenue Finance/Revenue --save    # Move measure to another table
te mv Sales/Revenue Sales/TotalRevenue --save # Rename measure

replace

Busca y reemplaza texto en los objetos del modelo. Simulación de forma predeterminada; añade --save para aplicar.

te replace acepta:

--in <scope> — ámbito: names, expressions, descriptions, displayFolders, formatStrings, annotations, all (predeterminado: all).
--regex — trata el patrón de búsqueda como una expresión regular.
--case-sensitive — habilita la coincidencia que distingue entre mayúsculas y minúsculas.
--dry-run - previsualiza los cambios sin aplicarlos. Comportamiento predeterminado.
--save - guarda la modificación en la ubicación de origen. Incompatible con --revert y --stage.
--save-to <path> - guarda en una ruta diferente (implica --save).
--serialization <fmt> - serialización del modelo: tmdl, bim, te-folder.
--force - guarda incluso si la sustitución introduce errores de validación de DAX.

--in expressions recorre todas las propiedades que contienen expresiones:

Medida: Expression, DetailRowsExpression
KPI: TargetExpression, StatusExpression, TrendExpression
Partición: M de origen y M de sondeo
Permiso de tabla: FilterExpression
Grupo de cálculo: expresiones de selección
Columna calculada: expresión DAX

Al añadir al modelo nuevas propiedades basadas en expresiones, se muestran automáticamente.

te replace "OldTable" "NewTable" --in expressions --save
te replace "SUM" "SUMX" --regex --in expressions --save

Inspección

ls

Enumera objetos con una navegación similar a la del sistema de archivos. Acepta un argumento <path-filter> que admite comodines. Tanto los contenedores de nivel de modelo (Tables, Measures, Columns, Hierarchies, Relationships, Roles, Perspectives, Cultures) como los contenedores con ámbito de tabla (Sales/Measures, Sales/Columns, …) se admiten.

te ls acepta:

--type <kind> - limita a un tipo de objeto (table, measure, column, hierarchy, partition, relationship, role, perspective, culture). Sin <path-filter>, esto equivale a escribir la palabra clave del contenedor correspondiente.
--paths-only - emite una ruta de objeto por línea, ideal para pasarlo a xargs, te get o te set.
--no-multiline - contrae las celdas multilínea (normalmente expresiones DAX o M) a una sola línea y las trunca para que las filas sigan siendo fáciles de recorrer en tablas anchas. Solo afecta a la salida de texto; la salida JSON/CSV/TMSL no se ve afectada.
--output-format tmsl (alias bim) - genera los objetos coincidentes como un script TMSL/BIM. Útil para te ls Tables --output-format bim > tables.json. --output-format tmdl no es compatible con ls (TMDL solo admite un único objeto; usa te get).

te ls                                     # All tables in the model
te ls Sales                               # All children of Sales (columns + measures + hierarchies + partitions)
te ls Sales/Measures                      # Just Sales's measures
te ls 'Sales/*Amount'                     # Children of Sales whose name ends with Amount
te ls 'Sa*'                               # Tables whose name starts with Sa (no auto-expansion)
te ls '*/Amount'                          # An Amount column/measure across every table
te ls 'Roles/Re*/Members'                 # Members of every role matching Re*
te ls Sales/Geography/Levels              # All levels of the Geography hierarchy
te ls "'Net Sales'/'Sales Amount'"        # Quote names containing spaces
te ls Measures --paths-only               # One Table/Measure per line for piping
te ls --type measure                      # Same as `te ls Measures`
te ls Measures --no-multiline             # Wide table with column dividers, single-line DAX
te ls Tables --output-format bim > tables.json   # All tables emitted as TMSL/BIM

get

Obtiene las propiedades de un objeto del modelo. Acepta un <path>.

te get acepta:

-q, --query <property> - obtiene una única propiedad (por ejemplo, expression, formatString).
-t, --type <kind> - desambigua cuando la ruta coincide con varios elementos secundarios de una tabla (p. ej., una columna y una jerarquía con el mismo nombre). Valores: Measure, Column, CalculatedColumn, Hierarchy, Calendar, Partition, CalculationItem.
--output-format tmsl (alias bim) - genera el objeto resuelto como JSON TMSL/BIM.
--output-format tmdl - genera el objeto resuelto como TMDL (solo objetos con nombre).

te get y te ls comparten un único catálogo de descriptores, por lo que todas las propiedades aparecen igual en todos los formatos: la tabla de texto y las salidas JSON y CSV muestran el mismo conjunto, y al agregar una propiedad nueva al modelo queda expuesta en todas partes.

te get Sales/Amount -q expression                # Print DAX
te get "'Sales'[Amount]"                         # DAX form: same as Sales/Amount
te get "[Total Sales]"                           # Lone-bracket: model-wide measure-or-column
te get "'Net Sales'[Sales Amount]" -q expression # DAX form with spaced names
te get "Sales/Revenue/KPI"                       # KPI sub-object of a measure
te get Sales --output-format tmdl                       # Emit the table as TMDL
te get Sales --output-format bim                        # Emit the table as TMSL/BIM
te get Model -q description

find

Busca texto en todos los objetos del modelo.

te find acepta:

--in <scope> - igual que en te replace (valor predeterminado: all).
--regex, --case-sensitive, --paths-only.
--no-multiline - contrae el contexto de coincidencia multilínea a una sola línea. Solo para la salida de texto.

--in expressions abarca todos los IExpressionObject del modelo, incluidas las TargetExpression / StatusExpression / TrendExpression de los KPI, la DetailRowsExpression de la medida, el M de origen/sondeo de la partición, la FilterExpression de los permisos de tabla y las expresiones MultipleOrEmptySelection / NoSelection del grupo de cálculo; así, un literal como 123 definido en el objetivo de un KPI aparece igual que el cuerpo de una medida.

te find "CALCULATE" --in expressions
te find "Revenue" --in names
te find "CALCULATE" --in expressions --paths-only | xargs -I{} te get {} -q expression

diff

Compara dos modelos para detectar diferencias estructurales. Devuelve los siguientes códigos de salida: 0 = idéntico, 1 = diferencias encontradas, 2 = error.

te diff ./model-v1 ./model-v2
te diff old.bim new.bim

deps

Analiza las dependencias ascendentes y descendentes de un objeto, o detecta objetos sin usar en todo el modelo. La forma de un solo objeto acepta un <path>.

te deps admite:

--upstream - muestra solo las dependencias ascendentes (lo que usa este objeto).
--downstream - muestra solo las dependencias descendentes (los objetos que usan este objeto).
--deep - muestra el árbol de dependencias recursivo en lugar de solo las dependencias directas.
--max-depth <N> - profundidad máxima para el recorrido de --deep (predeterminado: 10).
-t, --type <kind> - desambigua cuando la ruta coincide con varios elementos secundarios de una tabla (p. ej., una columna y una jerarquía con el mismo nombre).
--unused - enumera las medidas, las columnas calculadas y todas las columnas de datos a las que no hace referencia ninguna expresión DAX y que no se usan en ninguna relación, nivel de jerarquía, ordenación por columna, variación, base de AlternateOf ni rol de tiempo de calendario. Cada resultado muestra (hidden) en modo de texto y un campo isHidden en JSON.
--hidden - limita --unused a solo los objetos ocultos. Los objetos ocultos y sin usar son los candidatos más seguros para eliminar, porque ningún elemento visible para el usuario depende de ellos.

te deps Sales/Revenue                     # Upstream + downstream for one object
te deps "'Sales'[Revenue]"                # DAX form is accepted everywhere a <path> is
te deps Sales/Revenue --downstream --deep # Everything that depends on Revenue, recursively
te deps --unused                          # All unused measures and columns
te deps --unused --hidden                 # Only hidden, unused objects

Análisis y calidad

validate

Valida las expresiones del modelo, la integridad del esquema y los errores de TOM.

te validate admite:

--ci <fmt> - emite anotaciones de CI en stderr: vsts o github.
--trx <PATH> - escribe los resultados en un archivo .trx de VSTEST.
--errors-only - forma abreviada de --no-warnings --no-antipatterns: muestra solo errores.
--no-warnings - oculta las advertencias del analizador semántico.
--no-antipatterns - oculta las sugerencias de antipatrones (recomendaciones de buenas prácticas de DAX).
--server-only - muestra solo los errores notificados por el servidor conectado; omite el análisis semántico local.
--no-multiline - contrae el contenido de varias líneas de las celdas (mensajes de error, expresiones) en una sola línea. Solo salida de texto.

te validate ./model
te validate --ci github --trx results.trx
te validate --errors-only                 # Hide warnings and anti-pattern hints

bpa run

Ejecuta reglas de Best Practice Analyzer contra un modelo.

te bpa run admite:

<model> - argumento posicional: ruta al modelo (alternativa a la opción global --model).
-r, --rules <rules> - ruta(s) o URL(s) a archivo(s) de reglas BPA en formato JSON. Se puede repetir. Sustituye la capa de reglas de usuario en esta invocación: consulta Orígenes y resolución de reglas más abajo.
--no-model-rules - excluye las reglas de BPA incrustadas en las anotaciones del modelo.
--no-defaults - excluye las reglas predeterminadas de BPA integradas.
--vpax <file> - carga estadísticas del Analizador VertiPaq desde un archivo .vpax para habilitar reglas compatibles con VPA.
--vpa-rules - incluir reglas integradas compatibles con VPA (requiere --vpax o un modelo preanotado).
--allow-external-rules - permitir obtener archivos de reglas de BPA desde direcciones URL incrustadas en las anotaciones del modelo.
--rule <id> - ejecutar solo regla(s) específicas por ID. Se puede repetir.
--path <path-filter> - limitar el análisis a las tablas que contengan los objetos coincidentes. Acepta nombres literales, palabras clave de contenedor y comodines (por ejemplo, 'Sales', 'Sa*', 'Sales/Medidas', '*/Amount').
--fix - aplicar expresiones de corrección para corregir automáticamente las infracciones cuando sea posible.
--save - volver a guardar el modelo en el origen después de aplicar las correcciones.
--save-to <path> - guardar el modelo en una ruta diferente después de aplicar las correcciones.
--serialization <fmt> - serialización del modelo: tmdl, bim, te-folder.
--fail-on <severity> - umbral de fallo: error (predeterminado) o warning. Sale con el código 1 cuando las infracciones alcanzan el umbral.
--ci <fmt> - emitir comandos de registro de CI a stderr: vsts (Azure DevOps), github (GitHub Actions).
--trx <path> - escribir los resultados como un archivo .trx de VSTEST en la PATH especificada.
--no-multiline - contraer el contenido de varias líneas de las celdas de la tabla de infracciones en una sola línea. Solo para la salida de texto.

te bpa run --fail-on error --ci github
te bpa run --fix --save
te bpa run --rule PERF_UNUSED_HIDDEN_COLUMN
te bpa run --path Sales            # Tables touched by the Sales filter only
te bpa run --path 'Sa*'            # Wildcard - every table starting with Sa
te bpa run --path Sales/Measures   # Path filter applied to the matched tables

Orígenes de las reglas y su resolución

Cada invocación de te bpa run reúne reglas de tres capas independientes:

Reglas de usuario - se aplica exactamente un origen, en este orden de prioridad:
- -r, --rules <rules>: acepta una PATH de archivo o una URL (prioridad más alta)
- La variable de entorno TE_BPA_RULES
- la matriz bpa.rules de la configuración de la CLI (~/.config/te/config.json)
Reglas integradas predeterminadas - se cargan a menos que se pase --no-defaults o que bpa.builtInRules sea false en la configuración. Se omiten las reglas integradas individuales incluidas en bpa.disabledBuiltInRuleIds.
Reglas integradas en el modelo - reglas en la anotación BestPracticeAnalyzer_Rules del modelo; se cargan a menos que se pase --no-model-rules. Se omiten las anotaciones de URL externas, a menos que también pases --allow-external-rules.

Se eliminan los ID de reglas duplicados (las reglas del usuario prevalecen sobre las integradas). Después se eliminan los ID de reglas de la anotación BestPracticeAnalyzer_IgnoreRules del modelo.

La línea Rules loaded: de la salida atribuye cada capa que contribuye, por ejemplo:

Rules loaded: 41 from 1 file(s) from bpa.rules config + built-in defaults + model annotations

bpa rules

Administra colecciones de reglas de BPA: enumera, inspecciona, inicializa y activa o desactiva reglas en tu archivo local de reglas o en las anotaciones del modelo. Las reglas integradas son de solo lectura; para omitir una sin perder el resto, usa te bpa rules disable (no edites directamente el conjunto integrado).

Subcomandos:

Subcomando	Propósito
`add <id> [model]`	Agrega una nueva regla de BPA.
`disable`	Desactiva una regla de BPA integrada para el usuario actual.
`enable`	Vuelve a activar una regla de BPA integrada que se había desactivado antes.
`ignore <rule-id> [model]`	Agrega una regla a la lista de ignorados del modelo.
`init`	Crea un archivo vacío de reglas de BPA en la ruta PATH resuelta.
`list`	Enumera las reglas de BPA de todos los orígenes con su estado.
`rm <rule-id> [model]`	Elimina una regla de BPA.
`set <rule-id> [model]`	Actualiza las propiedades de una regla del BPA.
`unignore <rule-id> [model]`	Elimina una regla de la lista de reglas ignoradas del modelo.

Todos los subcomandos de te bpa rules aceptan:

--rules-file <PATH>: ruta a un archivo JSON de reglas del BPA. De forma predeterminada, se usa la primera entrada existente de bpa.rules en la configuración de la CLI (~/.config/te/config.json) o la variable de entorno TE_BPA_RULES.
--model-rules: opera sobre las reglas incrustadas en la anotación del modelo en lugar de un archivo.

Important

te bpa rules set y te bpa rules rm se niegan a modificar los ID de reglas integradas. Si intentas hacerlo, el comando finaliza con el código 1 y te indica que uses te bpa rules disable. Para personalizar el comportamiento de una regla integrada, deshabilita la regla integrada y agrega una copia personalizada con un identificador distinto:

te bpa rules disable TE3_BUILT_IN_DATE_TABLE_EXISTS
te bpa rules add MY_DATE_TABLE_EXISTS

bpa rules list

Muestra las reglas de todos los orígenes (integradas, de usuario y del modelo).

te bpa rules list acepta:

(predeterminado) Solo las reglas activas.
--all: incluye las reglas deshabilitadas e ignoradas.
--disabled: solo los ID de reglas integradas que el usuario ha deshabilitado mediante te bpa rules disable.
--ignored: solo las reglas cuyos ID aparecen en BestPracticeAnalyzer_IgnoreRules en el modelo.
--no-defaults: excluye las reglas integradas de la salida.

te bpa rules list              # Active rules
te bpa rules list --all        # Include disabled and ignored rules
te bpa rules list --ignored

Las reglas integradas deshabilitadas se marcan con un marcador [disabled] junto al ID de la regla.

bpa rules init

Crea un archivo de reglas del BPA vacío ([]) en el PATH configurado. Úsalo una vez antes de ejecutar te bpa rules set / te bpa rules rm sobre una ruta que todavía no existe.

te bpa rules init acepta:

--force: sobrescribe un archivo existente con []. Es obligatorio si el archivo de destino ya existe.
--rules-file <path> - ruta del archivo de destino. Puede aparecer antes o después del subcomando init.

Resolución de rutas (PATH; se usa la primera coincidencia): --rules-file → variable de entorno TE_BPA_RULES → primera entrada de bpa.rules[] en la configuración de tu CLI → ./BPARules.json (directorio de trabajo actual).

te bpa rules init
te bpa rules init --rules-file ./MyRules.json
te bpa rules init --force

bpa rules disable

Deshabilita una regla BPA integrada específica. El identificador de la regla se agrega a bpa.disabledBuiltInRuleIds en la configuración de tu CLI. Las ejecuciones posteriores del gate (deploy, save, mutation) y te bpa run omiten la regla deshabilitada.

El comando es idempotente: ejecutar disable sobre una regla ya deshabilitada finaliza correctamente sin modificar la configuración. Finaliza con el código 1 si <rule-id> no es una regla BPA integrada; usa te bpa rules list para ver los identificadores válidos de reglas BPA integradas.

te bpa rules disable TE3_BUILT_IN_DATE_TABLE_EXISTS

bpa rules enable

Vuelve a habilitar una regla BPA integrada deshabilitada anteriormente al quitar el identificador de la regla de bpa.disabledBuiltInRuleIds. Finaliza con el código 1 si la regla no está deshabilitada actualmente.

te bpa rules enable TE3_BUILT_IN_DATE_TABLE_EXISTS

vertipaq

Analiza las estadísticas de almacenamiento de VertiPaq.

te vertipaq acepta:

--columns, --relationships, --partitions, --all.
--detail - muestra columnas expandidas (desglose del tamaño de datos/diccionario/jerarquía, codificación, segmentos).
--fields <list> - campos separados por comas para mostrar (p. ej., --fields name,card,size,%tbl,%db,bar). Los campos disponibles varían según la vista.
--export <file.vpax> - exporta las estadísticas de VertiPaq a un archivo .vpax para analizarlas sin conexión.
--import <file.vpax> - carga un archivo .vpax exportado previamente y lo analiza sin conexión.
--obfuscate - ofusca nombres y expresiones en el VPAX exportado.
--top <N>, --stats, --annotate, --save.

te vertipaq                    # Columns by size (default)
te vertipaq --all              # Tables, columns, relationships, partitions
te vertipaq --export stats.vpax
te vertipaq --import stats.vpax  # Analyze offline

format

Da formato a expresiones DAX o M/Power Query.

te format acepta:

-e, --expression <text> - da formato a una sola expresión en línea.
-p, --path <path> - da formato a una medida o columna específica mediante su ruta.
-t, --type <kind> - desambigua cuando la ruta coincide con varios elementos secundarios de la tabla.
--lang <lang> - lenguaje de expresión: dax (predeterminado) o m/pq para Power Query.
--semicolons - usa el punto y coma como separador de listas (configuración regional europea).
--long - usa el formato largo (más saltos de línea). De forma predeterminada se usa el formato corto.
--no-space-after-function - omite el espacio después de los nombres de función.
--save / --save-to - guarda las expresiones formateadas.

te format --save                                           # Format all DAX
te format -p Sales/Amount --save                           # Single measure
te format -e "SUM ( Sales[Amount] )"                       # Inline
te format --lang m --save                                  # Format M

Ejecución

query

Ejecuta una consulta DAX contra un modelo implementado.

te query admite:

-q, --query <dax> - consulta en línea.
--file <file.dax> - consulta desde un archivo.
--limit <N> - valor predeterminado: 100.
-o, --output-file <path> - escribe los resultados en un archivo (.csv, .tsv, .json, .dax).
--trace, --cold, --plan, --runs <N> - seguimiento del rendimiento y pruebas comparativas.
--no-validate - omite la validación semántica de DAX previa a la ejecución.

te query -q "EVALUATE TOPN(5, 'Sales')" -s my-ws -d my-model
te query --file query.dax --output-format json

script

Ejecuta uno o varios C# Scripts contra un modelo semántico. La CLI usa el mismo host de scripts que Tabular Editor 3 Desktop, así que un script que se ejecuta en TE3 se ejecuta aquí sin cambios.

te script admite:

-S, --script <file> - archivo .cs / .csx (repetible).
-e, --expression <code> - C# en línea (usa - para stdin).
--save / --save-to / --serialization.
--dry-run - compila el/los script(s) y genera un Report de errores sin ejecutarlos.

te script --script fix.cs --save
te script -e "Info(Model.Tables.Count)"
echo "Info(Model.Name);" | te script -e -

Important

Dos detalles de comportamiento que conviene conocer si vas a portar un script antiguo:

No hay selección interactiva en los scripts de la CLI. Los asistentes de TE3 Desktop SelectMeasure(), SelectTable(), SelectColumn(), SelectObject() y SelectObjects() lanzan NotSupportedException cuando se invocan desde te script - la CLI no tiene interfaz de usuario para mostrar una ventana emergente. Resuelve previamente el/los objeto(s) fuera del script y pásalos mediante variables de entorno o stdin, o envuelve la llamada en try/catch si el script se comparte con TE3.
Las directivas using predeterminadas coinciden con las de TE3 Desktop. Los scripts que usan DataTable, File, StringBuilder o Regex deben incluir explícitamente la directiva correspondiente using System.Data; / using System.IO; / using System.Text; / using System.Text.RegularExpressions;.

Note

Símbolos del preprocesador para scripts compartidos entre hosts. Los scripts compilados por te script tienen definido el símbolo TECLI. En los scripts de TE3 Desktop se define TE3 en su lugar, además de símbolos acotados por versión como TE3_3_10_OR_GREATER ... TE3_3_X_OR_GREATER para la versión menor actual de TE3. TE2 no define ninguno de los dos símbolos. Úselos para escribir scripts portátiles:

#if TECLI
    // CLI-only code - no UI calls
    Info($"Running under the CLI on {Environment.OSVersion.Platform}");
#elif TE3
    // TE3 Desktop-only code - UI APIs available
    ShowMessage("Hello from TE3");
#else
    // TE2 (legacy) - neither TECLI nor TE3 is defined
    Info("Hello from TE2");
#endif

#if TE3_3_15_OR_GREATER
    // Gated on a specific TE3 minor version
#endif

Consulta C# Scripts para conocer el panorama general del scripting entre versiones.

macro

Administra y ejecuta macros desde un archivo JSON de macros (normalmente MacroActions.json). El archivo de macros se determina en este orden: --macros <PATH> → la variable de entorno TE_MACROS_PATH → macros en la configuración de la CLI → ./MacroActions.json.

Subcomandos:

Subcomando	Propósito
`list`	Listar macros.
`run <name-or-id>`	Ejecutar una macro.
`add <name>`	Agregar una macro.
`set <name-or-id>`	Actualizar las propiedades de la macro.
`rm <name-or-id>`	Eliminar una macro.
`sort`	Ordenar y reasignar los identificadores.
`init`	Crear un archivo de macros vacío en la ruta resuelta.

macro init

Crea un archivo de macros vacío ({"Actions":[]}) en la ruta configurada. Úsalo una sola vez cuando el archivo de macros resultante aún no exista.

te macro init acepta:

--force - sobrescribe un archivo existente. Obligatorio si el destino ya existe.
--macros <path> - ruta del archivo de destino. Puede aparecer antes o después del subcomando init.

te macro init
te macro init --macros ./project-macros.json
te macro init --force

macro run

Ejecuta una macro. Las macros que emiten tablas mediante dataTable.Output() muestran una salida con formato en la terminal, por lo que las macros de consulta de estilo DAX funcionan igual en te macro run que en TE3.

te macro run acepta:

--on <path> - establece el contexto de selección de la macro en un único objeto con nombre (una tabla, una medida, una columna, …). Equivale a hacer clic con el botón derecho en ese objeto en TE3 e invocar la macro desde el menú contextual.
--save / --save-to - guarda cualquier cambio que realice la macro.

te macro run "Hide all measures"
te macro run "Format DAX" --on Sales/Revenue --save
te macro run "Format DAX" --on "'Net Sales'[Sales Amount]" --save   # DAX form works in --on too

Implementación y actualización

deploy

Implementa un modelo semántico en Power BI, Fabric o Azure Analysis Services.

te deploy acepta:

-s, --server / -d, --database - Workspace y modelo de destino.
--deploy-full - sobrescribir + conexiones + particiones + expresiones compartidas + roles + miembros de roles.
--deploy-connections
--deploy-partitions
--skip-refresh-policy
--deploy-roles
--deploy-role-members
--deploy-shared-expressions
--create-only
--xmla <file> - genera un script XMLA/TMSL en lugar de realizar el despliegue (- para stdout).
--skip-bpa - omite por completo el control de BPA.
--fix-bpa - corrige automáticamente las infracciones de BPA cuando las reglas definan una expresión de corrección.
--bpa-rules <PATH> - se puede repetir; anula bpa.rules de la configuración de tu CLI solo para este despliegue. Las reglas integradas siguen aplicándose a menos que bpa.builtInRules sea false.
--force - omite la confirmación interactiva (necesario para CI).
--ci <fmt> - vsts o github.
--profile <name> - uso puntual de un perfil de Autenticación y conexiones guardado.

te deploy ./model -s my-workspace -d my-model --force --ci github
te deploy ./model --xmla script.tmsl    # Generate TMSL only
te deploy ./model --profile staging --force

Important

te deploy ejecuta el Best Practice Analyzer como control previo antes de realizar el despliegue. En modo interactivo, se muestran un resumen y un mensaje de confirmación, con n como opción segura predeterminada. En CI, pasa --force para omitir la confirmación. Consulta Configuración personalizada para la configuración del control de BPA.

refresh

Inicia una actualización de datos en un modelo implementado.

te refresh admite:

--type <type> - full, dataonly, automatic, calculate, clearvalues, defragment, add (predeterminado: automatic).
--table <name> - actualiza tabla(s) específicas; se puede repetir.
--partition <Table.Partition> - actualiza partición(es) específicas.
--apply-refresh-policy - aplica la política de actualización para determinar qué particiones se actualizan con la actualización incremental.
--effective-date <yyyy-MM-dd> - establece la fecha efectiva que usa la política de actualización.
--max-parallelism <N> - establece el número máximo de particiones que se pueden actualizar en paralelo.
--dry-run - muestra el script TMSL sin ejecutarlo.
--no-progress, --trace [path].

te refresh --type full                                 # Full refresh
te refresh --table Sales --type full                    # Single table
te refresh --type full --dry-run > refresh.tmsl         # Emit TMSL only

incremental-refresh

Gestiona las políticas de actualización para la actualización incremental de las tablas.

te incremental-refresh show <table>

Los subcomandos adicionales (set, rm, apply) están documentados en te incremental-refresh --help.

Pruebas

test run

Ejecuta un conjunto de pruebas de aserción de DAX contra un modelo desplegado.

te test run admite:

--suite <path> - directorio de la suite de pruebas (predeterminado: .te-tests/).
--tag <tag> - solo las pruebas con esta etiqueta.
--fail-on <severity> - error (predeterminado) o warning.
--ci <fmt>, --trx <PATH> - anotaciones de CI y salida TRX.

te test run --ci github --trx results.trx
te test run --tag revenue

test init / spec / use / list / snapshot / compare

Los subcomandos adicionales permiten crear la estructura de las pruebas, imprimir el formato de la especificación de aserciones, cambiar la suite activa, listar las suites, capturar instantáneas y comparar modelos. Consulta te test --help para más detalles.

te test init --example             # Scaffold an example suite
te test spec                       # Print the full assertion format reference
te test init --from-model --model ./my-model  # Generate stubs from your measures

Conexión y autenticación

connect

Establece (o muestra) la conexión activa para la sesión actual del terminal. Consulta Autenticación y conexiones.

te connect                         # Show current active connection
te connect my-workspace my-model   # Remote
te connect ./model                 # Local
te connect --local                 # Power BI Desktop (Windows)
te connect --profile prod          # Activate a saved profile
te connect --clear                 # Clear the active connection (and any workspace mirror)

Modo del área de trabajo (`-w` / `--workspace`)

Empareja un origen principal con un destino secundario para que cada --save posterior sincronice el modelo entre ambos. Útil para mantener una copia de trabajo local de un Workspace remoto o para enviar los cambios locales a un Workspace al guardar.

te connect <ws> <model> -w ./src - el origen principal es remoto; ./src recibe una exportación inicial de TMDL y refleja cada guardado.
te connect ./src -w <ws> <model> - el origen principal es local; un despliegue inicial envía el modelo al Workspace, y los guardados posteriores lo vuelven a desplegar automáticamente.
--workspace-format <bim|TMDL> - elige el formato en disco al sincronizarlo con una carpeta o archivo (por ejemplo, -w ./model.bim deduce BIM).
--workspace-auth <method> - método de autenticación para un destino de Workspace remoto cuando el principal es local. Toma el valor de --auth si está establecido; de lo contrario, auto.
--force: obligatorio cuando el destino ya existe (carpeta no vacía o base de datos existente). Sin él, te connect muestra un prompt interactivo y/n, con n como opción segura predeterminada.

Una vez activado, te set --save, te rm --save, te script --save, etc. guardan de forma transparente en ambos destinos. El orden de guardado siempre es primero local y después remoto, para que la copia en disco refleje el último cambio del usuario aunque falle el envío al servidor. Borra la réplica con te connect --clear.

te connect Finance "Revenue Model" -w ./revenue-model    # Mirror remote → local TMDL
te connect ./revenue-model -w Finance "Revenue Model"    # Mirror local → remote

Administra la autenticación almacenada en caché. Consulta Autenticación y conexiones.

profile list / show / set / remove

Administra perfiles de conexión con nombre. Consulta Autenticación y conexiones.

Configuración

config show / paths / init / set

Consulta y administra la configuración de la CLI y las sobrescrituras de PATH de TE3. Consulta Configuración personalizada.

te config show                          # Display all settings
te config paths                         # Resolved TE3 file paths
te config init                          # Create default config
te config set autoFormat true

license

te license está reservado para la versión GA y no está disponible en esta versión preliminar. El comando sigue integrado con el analizador, por lo que los scripts existentes que lo invocan no darán error durante el análisis, pero todos los subcomandos finalizan con el código de salida 1 y mensajes de "no está disponible en esta versión preliminar". Consulta el aviso de versión preliminar en la página de información general para conocer el panorama más amplio de licencias.

migrate

Guía de referencia que muestra cómo las opciones heredadas de la CLI de Tabular Editor 2 se corresponden con la nueva CLI. Útil como referencia rápida mientras migras una canalización basada en TE2. Consulta Migración desde la línea de comandos de TE2 para ver la guía de migración completa.

te migrate                   # Full flag mapping table
te migrate -A                # Look up a single TE2 flag
te migrate --output-format json     # Machine-readable mapping

Shell

interactive

Inicia una sesión REPL guiada con un prompt adaptado al modelo. Consulta Modo interactivo.

te interactive                                # Connect later
te interactive ./model                        # Start with a local model
te interactive -s MyWorkspace -d MyModel      # Start with a remote model

Las comillas y las referencias de estilo DAX funcionan igual que fuera de la sesión - consulta la sección Rutas de objetos de arriba y Modo interactivo para más detalles sobre la división de argv con reconocimiento de corchetes dentro del REPL.

sesión

Muestra o administra la sesión actual del terminal. La CLI guarda el estado de cada terminal (conexión activa, perfil activo y conjunto de pruebas activo) en un archivo de sesión, aislado por proceso de shell. Establece la variable de entorno TE_SESSION para compartir una sesión con nombre entre procesos de shell.

Subcomandos:

Subcomando	Propósito
`show`	Muestra los detalles de la sesión actual (ID, ruta de archivo, estado activo). Es la opción predeterminada cuando no se proporciona ningún subcomando.
`list`	Lista todos los archivos de sesión.
`clear`	Borra el estado activo de la sesión actual.
`prune`	Elimina los archivos de sesión cuyo proceso de shell ya no está en ejecución.

te session prune acepta:

--all - también elimina las sesiones con shells activos, así como las sesiones con nombre (TE_SESSION). La sesión actual siempre se conserva.
--dry-run - muestra qué se eliminaría, sin eliminar nada.

te session                        # Show current session details
te session list                   # List all session files
te session clear                  # Clear active state for this session
te session prune                  # Remove sessions whose shell is dead
te session prune --all --dry-run  # Preview a full cleanup

completion

Genera un script de autocompletado para la shell en bash, zsh, powershell (alias pwsh) o fish. Consulta Instalación y configuración.

te completion bash
te completion zsh
te completion pwsh
te completion fish

Códigos de salida

Código de salida	Significado
`0`	Éxito.
`1`	Fallo genérico (argumentos no válidos, fallo del comando, errores de validación, fallo de autenticación, el BPA gate falló con una gravedad ≥ error). Para `te diff`: se encontraron diferencias.
`2`	Solo en `te diff`: se produjo un error durante la comparación, por lo que se desconoce el estado de las diferencias.

Para un control detallado en las canalizaciones de CI, combina los códigos de salida con las anotaciones --ci <vsts/github> y los archivos de resultados --trx; consulta Integración de CI/CD.

Páginas relacionadas

Tabular Editor CLI (Vista previa pública limitada) - información general y contexto.
Instalación y configuración - instalación y configuración de la CLI.
Autenticación y conexiones - autenticación y administración de conexiones.
Configuración personalizada - archivo de configuración, BPA gate y comportamiento tras la mutación.
Migración desde la línea de comandos de TE2 - mapeo de opciones TE2 → TE3.

Table of Contents

Referencia de comandos

Important

Note

Rutas de objeto

Segmentos y separadores

Uso de comillas

Referencias al estilo DAX (solo rutas de objeto)

Contenedores y palabras clave

Comodines en rutas de filtro

Errores y sugerencias

Opciones globales

E/S del modelo

load

save

Tip

open

init

Edición del modelo

set

add

rm

mv

replace

Inspección

ls

get

find

diff

deps

Análisis y calidad

validate

bpa run

Orígenes de las reglas y su resolución

bpa rules

Important

bpa rules list

bpa rules init

bpa rules disable

bpa rules enable

vertipaq

format

Ejecución

query

script

Important

Note

macro

macro init

macro run

Implementación y actualización

deploy

Important

refresh

incremental-refresh

Pruebas

test run

test init / spec / use / list / snapshot / compare

Conexión y autenticación

connect

Modo del área de trabajo (-w / --workspace)

auth login / status / logout

profile list / show / set / remove

Configuración

config show / paths / init / set

license

migrate

Shell

interactive

sesión

completion

Códigos de salida

Páginas relacionadas

Modo del área de trabajo (`-w` / `--workspace`)