Migración desde la línea de comandos de TE2

2026-09-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 compilación de vista previa dejará de funcionar a partir del 2026-10-31. No recomendamos usar la CLI en pipelines de CI/CD de producción durante la vista previa.

Los equipos con canalizaciones de compilación existentes que invocan TabularEditor.exe con opciones al estilo de TE2 (-S, -A, -D, -O, -C, etc.) pueden adoptar la nueva CLI de forma gradual. La CLI de Tabular Editor acepta ambos formatos de comandos: la nueva forma basada en subcomandos (te deploy, te bpa run, …) y la sintaxis heredada de opciones de TE2, mediante una capa de compatibilidad integrada.

Para consultar la referencia heredada de la línea de comandos de TE2 para Windows, ve a Línea de comandos (Tabular Editor 2).

Cómo funciona la compatibilidad con TE2

El modo de compatibilidad con TE2 se activa de cualquiera de estas tres maneras:

Nombre del binario. Cambia el nombre de te a te2 (o crea un enlace simbólico) y la CLI se ejecutará en el modo exacto de TE2. Esta es la vía de reemplazo directo: sustituye TabularEditor.exe por te2 en tu canalización existente y los mismos argumentos funcionarán.
Variable de entorno. Establece TE_COMPAT=te2 antes de invocar te para forzar el modo TE2.
Detección automática. Si el primer argumento no es un subcomando de te (deploy, validate, …) y aparece al menos una opción de TE2 reconocida en algún punto de la lista de argumentos, la CLI redirige automáticamente al modo TE2. Esto significa que la mayoría de las invocaciones existentes de TE2 funcionan sin ningún cambio.

# All three are equivalent - each runs in TE2 mode
./te2 Model.bim -S fix.csx -D "localhost\tabular" MyDB -O
TE_COMPAT=te2 te Model.bim -S fix.csx -D "localhost\tabular" MyDB -O
te Model.bim -S fix.csx -D "localhost\tabular" MyDB -O

Note

El modo TE2 ejecuta la misma canalización Load → Scripts → Schema Check → Save → BPA → Deploy → TRX que TabularEditor.exe, incluido el comportamiento de las opciones en función del contexto (por ejemplo, -S después de -D significa -SHARED, no -SCRIPT).

El comando `migrate`

Usa te util migrate como referencia en tiempo real para ver cómo se asignan las opciones de TE2 a la nueva CLI. Muestra una tabla en color con todas las opciones conocidas de TE2, su estado (compatible, renombrada, prevista) y el comando te equivalente.

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

Consulta la salida del comando te util migrate para conocer el mapeo actual, que refleja la versión de la CLI que tienes instalada.

Mapeo de flags (subconjunto seleccionado)

A continuación se presenta un resumen no exhaustivo de las opciones más utilizadas. Ejecuta te util migrate para ver la lista completa.

Flag de TE2	Nuevo equivalente en la CLI	Notas
`file` (posicional)	`--model <path>` (opción global)	Siempre se usa la opción global `--model`; ningún comando acepta el modelo como argumento posicional. O establece un modelo activo una vez con `te connect <path>`.
`server`, `database`	`te connect <server> <database>` o bien las opciones globales `-s <server> -d <database>`	`-s`/`-d` siempre identifican el origen del modelo; los destinos de implementación usan `--target-server` / `--target-database`.
`-L` / `-LOCAL`	`te connect --local`	Solo para Windows.
`-S` / `-SCRIPT`	`te script --file <file.csx>` o `--inline "code"`	También funciona indicar solo la ruta a un archivo `.csx` (`te script fix.csx`). Admite varios scripts (`--file a.csx --file b.csx`), código en línea y stdin (`--inline -`); los archivos y el código en línea se ejecutan en el orden indicado.
`-A` / `-ANALYZE`	`te bpa run --rules <file-or-url>`	Admite `--fail-on`, `--fix` y varios archivos de reglas.
`-AX` / `-ANALYZEX`	`te bpa run --rules <file> --no-model-rules`	Las reglas integradas en el modelo se incluyen de forma predeterminada; `--no-model-rules` las excluye, como hacía `-AX`.
`-B` / `-BIM`	`te save-as --model <model> -o <file.bim> --serialization bim`
`-F` / `-FOLDER`	`te save-as --model <model> -o <dir> --serialization Database.json`	Tras `-D`, el `-F` de TE2 significa `-FULL`. Consulta `--deploy-full`.
`-TMDL`	`te save-as --model <model> -o <dir> --serialization tmdl`	`--serialization` puede omitirse: el formato se infiere a partir de la ruta de salida.
`-D` / `-DEPLOY`	`te deploy --model <model> --target-server <server> --target-database <database> --execute`	Comando independiente con opciones con nombre. Sin `--execute`, `te deploy` realiza una ejecución de prueba que imprime el TMSL que enviaría.
`-O` / `-OVERWRITE`	(predeterminado) o `--create-only` para no aplicarlo	La sobrescritura es el comportamiento predeterminado en la nueva CLI.
`-C` / `-CONNECTIONS`	`te deploy --deploy-connections`
`-P` / `-PARTITIONS`	`te deploy --deploy-partitions`
`-Y` / `-SKIPPOLICY`	`te deploy --deploy-partitions --skip-refresh-policy`	Requiere `--deploy-partitions`.
`-SHARED`	`te deploy --deploy-shared-expressions`	Después de `-D`, `-S` en TE2 significa `-SHARED`.
`-R` / `-ROLES`	`te deploy --deploy-roles`
`-M` / `-MEMBERS`	`te deploy --deploy-role-members`
`-FULL` (después de `-D`)	`te deploy --deploy-full`	Equivale a: sobrescritura + conexiones + particiones + elementos compartidos + roles + miembros de rol.
`-X` / `-XMLA <file>`	`te deploy ... > <file>` (omite `--execute`)	La emisión de scripts es el comportamiento predeterminado: sin `--execute`, deploy se conecta en modo de solo lectura y muestra el TMSL en stdout; redirígelo a un archivo.
`-V` / `-VSTS`	`--ci vsts` en `validate`, `bpa run`, `deploy`, `test run`	Emite anotaciones `##vso[...]` en stderr. Se aceptan `azdo` y `azure-devops` como alias.
`-G` / `-GITHUB`	`--ci github` (alias `gh`)	Emite anotaciones `::error::` / `::warning::` / `::notice::`.
`-T` / `-TRX <file>`	`--trx <file>` en `validate`, `bpa run`, `test run`	Archivo `.trx` de VSTEST para publicar pruebas en Azure DevOps.
`-W` / `-WARN`	(predeterminado)	Las advertencias siempre se incluyen en el Report de resultados de la implementación.
`-E` / `-ERR`	(predeterminado)	La implementación devuelve un código de salida distinto de cero cuando hay errores de DAX.
`-SC` / `-SCHEMACHECK`	Aún no se ha implementado.	La comprobación del esquema de TE2 se conecta a los Data source reales. A diferencia de `te validate` (validación semántica de DAX, sin conexión al Data source).
`-L` / `-LOGIN <user> <pass>` (después de `-D`)	`te auth login -u <id> -p <secret> -t <tenant>`	Usa una entidad de servicio o credenciales basadas en variables de entorno. El inicio de sesión se guarda en caché, así que los comandos posteriores obtienen tokens de forma silenciosa; consulta Autenticación y conexiones.

Guía de migración

La ruta recomendada para pasar de un pipeline basado en TE2 al nuevo CLI:

Reemplazo directo. Sustituye TabularEditor.exe por te (o te2) en tu pipeline actual. Comprueba que el pipeline siga funcionando: la compatibilidad con TE2 mantiene intacta la mayoría de las invocaciones.
Sustituye las opciones de forma incremental. Convierte un grupo de opciones a la vez:
- Empieza con -A / -AX → te bpa run para obtener una salida de BPA más completa (--fail-on, --fix, --trx).
- Después, -D → te deploy para un control de despliegue más detallado.
- Por último, -V / -G → --ci vsts / --ci github.
Pasa a las opciones de CI no interactivas. Añade --non-interactive a todos los comandos te (y --ci <vsts|github> en validate, bpa run, deploy y test run), usa --execute --force en los pasos de deploy/refresh que deban aplicar cambios y elimina cualquier envoltorio start /wait: la nueva CLI es un binario de consola normal y no lo necesita.
Adopta la autenticación con entidad de servicio. Sustituye -D -L <user> <pass> por te auth login -u ... -p ... -t ... o un paso del pipeline con credenciales de entorno. Consulta Autenticación y conexiones.

Diferencias importantes

BPA como control previo al despliegue. te deploy ahora ejecuta BPA como comprobación previa de forma predeterminada. Usa --skip-bpa para mantener el comportamiento anterior, o --fix-bpa para corregir automáticamente los incumplimientos antes del despliegue. Consulta Configuración personalizada.
Simulación de forma predeterminada. te deploy y te refresh imprimen el TMSL exacto que enviarían y no cambian nada; usa --execute para ejecutar la operación. --execute solicita confirmación en una terminal (con n como valor predeterminado seguro); las canalizaciones de CI deben pasar --execute --force.
Salida estructurada. Todos los comandos admiten --output-format json para una salida procesable por máquinas; consulta Automatización y scripts.
No hace falta start /wait. La nueva CLI es un binario de consola normal; ejecútalo directamente en scripts de shell, PowerShell y tareas de CI.
Multiplataforma. La CLI funciona en Windows, macOS y Linux. Las conexiones locales a SSAS y Power BI Desktop siguen estando disponibles solo en Windows.

Páginas relacionadas

Línea de comandos (Tabular Editor 2) - la referencia heredada de la línea de comandos de TE2.
Referencia de comandos - la referencia completa de comandos de la nueva CLI.
Integración de CI/CD - ejemplos de canalizaciones para GitHub Actions y Azure DevOps.

Table of Contents