te2-cli

Tabular Editor 2 CLI

Tabular Editor 2（TE2）のコマンドラインインターフェイスです。このスキルでは、TabularEditor.exe 実行ファイルを扱います。TE3 には独自の CLI があり、別製品です。

メモ

TE2 CLI（TabularEditor.exe）は引き続きサポートされており、安定しているため、既存の Windows CI/CD パイプラインでは今も有力な選択肢です。現在は、新しいクロスプラットフォームの Tabular Editor CLI（te）と比べると旧式と見なされています。これは TE3 を基盤としており、2026 年第 4 四半期まではプレビュー版です。te のコマンドセットとフラグごとの移行については、te-cli スキルを参照してください。プレビュー版の te バイナリは、Tabular Editor CLI downloads page からダウンロードしてください。

インストール

Tabular Editor 2（無料）

• ダウンロード：https://github.com/TabularEditor/TabularEditor/releases
• 任意の場所に展開するか、Chocolatey を使用します：choco install tabulareditor2

実行ファイル

TabularEditor.exe -- 無料、Windows 専用です。Mac/Linux では、Windows VM またはコンテナー上で実行してください。

接続元

ローカルファイル

# model.bim (JSON format)
TabularEditor.exe Model.bim

# TMDL folder
TabularEditor.exe definition/

# PBIP project
TabularEditor.exe MyReport.pbip

リモート XMLA エンドポイント

# Analysis Services
TabularEditor.exe "localhost\tabular" "AdventureWorks"

# Power BI Premium/Fabric
TabularEditor.exe "powerbi://api.powerbi.com/v1.0/myorg/WorkspaceName" "ModelName"

Power BI Desktop

# Auto-detect running instance
TabularEditor.exe localhost:PORT DatabaseName

注：ポートは PBIDesktop の診断ファイルで確認するか、DAX Studio などのツールを使用してください。

コマンドラインリファレンス

基本構文

TabularEditor.exe <source> [options]

スクリプトの実行

# Inline C# script
TabularEditor.exe Model.bim -S "Info(Model.Name);"

# Script file
TabularEditor.exe Model.bim -S script.csx

# Multiple scripts (executed in order)
TabularEditor.exe Model.bim -S script1.csx -S script2.csx

デプロイ

# Deploy to XMLA endpoint
TabularEditor.exe Model.bim -D "server" "database"

# Deploy with options
TabularEditor.exe Model.bim -D "server" "database" -O -C -P -R -M -E -V -W

デプロイオプション

フラグ	ロング形式	説明
-O	-OVERWRITE	既存のデータベースを上書きします
-C	-CONNECTIONS	データソースをデプロイ／上書きします（接続文字列のプレースホルダー置換に対応）
-P	-PARTITIONS	既存のテーブルパーティションをデプロイ／上書きします
-R	-ROLES	ロールをデプロイします
-M	-MEMBERS	ロールメンバーをデプロイします
-S	-SHARED	共有式をデプロイします（-D のコンテキスト内で使用します。注：-S は -D の外ではスクリプトを意味します）
-E	-ERR	デプロイ後に AS がエラーメッセージを返した場合、ゼロ以外の終了コードを返します
-V	-VSTS	Azure DevOps のロギングコマンドを出力します
-W	-WARN	未処理のオブジェクトに関する警告を出力します
-F	-FULL	完全なデプロイを実行します（-O -C -P -S -R -M と同等）
-X	-XMLA	デプロイの代わりに XMLA/TMSL スクリプトを生成します
-L	-LOGIN	デプロイで統合セキュリティを無効にします
-Y	-SKIPPOLICY	増分更新ポリシーのパーティションをスキップします

出力の保存

# Save to model.bim
TabularEditor.exe Model.bim -S script.csx -B Output.bim

# Save to TMDL folder
TabularEditor.exe Model.bim -S script.csx -TMDL output/

# Save to legacy folder structure
TabularEditor.exe Model.bim -S script.csx -F output/

ベストプラクティスアナライザー

# Run BPA rules
TabularEditor.exe Model.bim -A rules.json

# Run BPA with Azure DevOps logging output
TabularEditor.exe Model.bim -A rules.json -V

# Run BPA with GitHub Actions logging output
TabularEditor.exe Model.bim -A rules.json -G

# Analyze excluding rules embedded in model annotations
TabularEditor.exe Model.bim -AX rules.json

スキーマチェック

# Validate data source schemas against the model
TabularEditor.exe Model.bim -SC

一般的な操作

1. ローカルモデルをサービスにデプロイ

TabularEditor.exe Model.bim ^
    -D "powerbi://api.powerbi.com/v1.0/myorg/Workspace" "SemanticModel" ^
    -O -C

2. スクリプトを実行して保存

TabularEditor.exe Model.bim -S format-dax.csx -B Model.bim

3. BPA 分析を実行

TabularEditor.exe Model.bim ^
    -A https://raw.githubusercontent.com/microsoft/Analysis-Services/master/BestPracticeRules/BPARules.json ^
    -V

4. モデルデータを更新

TabularEditor.exe "server" "database" ^
    -S "Model.RequestRefresh(RefreshType.Full);" ^
    -D "server" "database"

5. サービスからモデルをエクスポート

TabularEditor.exe "powerbi://api.powerbi.com/v1.0/myorg/Workspace" "Model" ^
    -TMDL output/definition

認証

認証方法（Windows、サービスプリンシパル、対話型）と CI/CD の統合（Azure DevOps、GitHub Actions）については、references/auth-and-cicd.md を参照してください。

終了コード

コード	説明
0	成功
1	エラーレベルの出力があった場合（スクリプトエラー、デプロイ失敗、重大度が 3 以上の BPA 違反）

ファイル形式

入力形式

• model.bim - Tabular JSON（レガシー形式）
• definition/ - TMDL フォルダー（モダン形式）
• *.pbip - Power BI Project（TE3）

出力形式

フラグ	形式	説明
-B	.bim	Tabular JSON
-TMDL	フォルダー	TMDL
-F	フォルダー	レガシーなフォルダー構成

トラブルシューティング

よくあるエラー（データベースが見つからない、認証に失敗する、スクリプトの実行に失敗する）については、references/auth-and-cicd.md を参照してください。

クイックリファレンスカード

+---------------------------------------------------------+
| TABULAR EDITOR CLI QUICK REFERENCE                      |
+---------------------------------------------------------+
| SOURCES                                                 |
|   Model.bim           Local JSON model                  |
|   definition/         TMDL folder                       |
|   "server" "db"       XMLA connection                   |
+---------------------------------------------------------+
| SCRIPTS                                                 |
|   -S "code"           Inline C# script                  |
|   -S file.csx         Script file                       |
+---------------------------------------------------------+
| DEPLOYMENT                                              |
|   -D "server" "db"    Deploy to target                  |
|   -O                  Overwrite existing                |
|   -C                  Create if not exists              |
+---------------------------------------------------------+
| OUTPUT                                                  |
|   -B output.bim       Save as JSON                      |
|   -TMDL folder/       Save as TMDL                      |
+---------------------------------------------------------+
| BPA                                                     |
|   -A rules.json       Run BPA analysis                  |
|   -G results.sarif    Output BPA results                |
+---------------------------------------------------------+

参考資料

最新の XMLA およびデプロイ関連ドキュメントを取得するには、https://learn.microsoft.com を検索し、該当するページを取得してください。十分な情報を確認してから作業を進められるよう、ユーザーの依頼に応じて検索し、必要に応じて複数回検索してください。

• TE2 CLI ドキュメント
• XMLA エンドポイント