Table of Contents

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

  • 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.

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:

  1. 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.
  2. Variable de entorno. Establece TE_COMPAT=te2 antes de invocar te para forzar el modo TE2.
  3. Detección automática. Si el primer argumento no es un subcomando de te (load, deploy, …) 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 migrate como referencia práctica de cómo las opciones de TE2 se asignan 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 migrate                   # Full flag mapping table
te migrate -A                # Look up a single flag
te migrate --output-format json     # Machine-readable mapping

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

Mapeo de flags (subconjunto seleccionado)

Un resumen no exhaustivo de los flags más usados. Ejecuta te migrate para ver la lista completa.

Flag de TE2 Nuevo equivalente en la CLI Notas
file (posicional) te <command> <path> o el flag global --model Primer argumento posicional en la mayoría de los comandos.
server, database te connect <server> o te deploy <server> <database> El servidor ya no es un argumento posicional global.
-L / -LOCAL te connect --local Solo para Windows.
-S / -SCRIPT te script -S <file.csx> o -e "code" Admite varios scripts, código en línea y stdin. Nota: -S en mayúsculas; -s en minúsculas corresponde a la opción global --server.
-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> (sin --model-rules) Excluir las reglas incrustadas en el modelo es ahora el comportamiento predeterminado.
-B / -BIM te save <model> -o <file.bim> --serialization bim
-F / -FOLDER te save <model> -o <dir> --serialization te-folder Tras -D, el -F de TE2 significa -FULL. Consulta --deploy-full.
-TMDL te save <model> -o <dir> --serialization tmdl TMDL es el formato de guardado predeterminado.
-D / -DEPLOY te deploy <server> <database> <model> Comando independiente con opciones con nombre.
-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 ... --xmla <file> Usa - para stdout.
-V / -VSTS --ci vsts en validate, bpa run, deploy Emite anotaciones ##vso[...] en stderr.
-G / -GITHUB --ci github Emite anotaciones ::error:: / ::warning::.
-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:

  1. 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.
  2. Sustituye las opciones de forma gradual. Convierte un grupo de opciones cada 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.
  3. Cambia a flags de CI no interactivos. Añade --non-interactive --ci <vsts|github> a todos los comandos te y elimina cualquier wrapper start /wait: el nuevo CLI es un binario de consola estándar y no los necesita.
  4. 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.
  • Confirmación interactiva al desplegar. te deploy pide confirmación de forma predeterminada (siendo n la respuesta predeterminada segura). Las canalizaciones de CI deben especificar --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