te-docs

Tabular Editor のドキュメントと構成

Tabular Editor のドキュメント検索と TE3 構成ファイル（.tmuo、Preferences.json など）に関するガイダンスです。

事前確認

ドキュメントを検索する前に、pbi-search がインストールされていることを確認してください。

pbi-search --version

コマンドが見つからない場合はユーザーに伝え、次の 2 つの方法を提示してください。

1. pbi-search をインストールする（推奨）：cargo install または GitHub Releases からのインストール手順については、data-goblin/pbi-search の bin/README.md を参照してください。
2. CLI を使わずに検索する：Microsoft Learn のコンテンツには microsoft-learn MCP ツール（microsoft_docs_search、microsoft_docs_fetch）を使用するか、WebFetch を使用して次のソースからドキュメントを直接取得してください。
   • Tabular Editor のドキュメント：https://docs.tabulareditor.com/
   • DAX リファレンス：https://dax.guide/<function>/
   • SQLBI の記事：https://www.sqlbi.com/articles/
   • Data Goblins：https://data-goblins.com/

CLI の使用を強く推奨します。すべてのソースを同時に検索し、整った Markdown を返します。代替方法では URL を手動で組み立て、複数回取得する必要があります。

ドキュメント検索

Tabular Editor のドキュメントや関連する Power BI／DAX リソースの検索には、推奨される方法である pbi-search CLI を使用してください。Tabular Editor のドキュメント、DAX.guide、SQLBI、Microsoft Learn（Power BI + Fabric）、TE ブログ、Data Goblins を同時に検索し、整った Markdown を返します。

インストール後、ローカルのマニフェストキャッシュを一度だけ作成します。

pbi-search sync        # ~13s

検索

# Search all sources
pbi-search search "creating measures"

# Search only Tabular Editor docs
pbi-search search "BPA rules" --source te-docs

# Search TE blog + TE docs
pbi-search search "incremental refresh" --source te-docs --source te-blog

# JSON output for structured use in agents
pbi-search search "workspace mode" --source te-docs --json

# Include content excerpts
pbi-search search "calculated columns" --source te-docs --excerpts

ドキュメント全体の取得

# Tabular Editor doc by bare path (from search results)
pbi-search fetch features/Best-Practice-Analyzer

# Any supported URL
pbi-search fetch https://docs.tabulareditor.com/features/workspace-mode
pbi-search fetch https://dax.guide/calculate/

# Extract a specific section
pbi-search fetch features/Best-Practice-Analyzer --section "Creating rules"

# Truncate for context budget
pbi-search fetch features/creating-measures --max-chars 3000 --json

エージェントの検索ワークフロー

1. pbi-search search "<topic>" --source te-docs --json — 関連するドキュメントを検索します
2. 結果に含まれる path または url を使用します：pbi-search fetch <path>
3. 結果が見つからない場合は、範囲を広げます：pbi-search search "<topic>"（すべてのソース）
4. DAX に関する質問では、必ず --source dax-guide を追加します

利用可能なソース

ID	内容
te-docs	Tabular Editor のドキュメント（機能、使い方、KB、リファレンス）
dax-guide	約 480 ページの DAX 関数リファレンス
te-blog	Tabular Editor のブログ
ms-learn	Microsoft Learn — Power BI + Fabric（ライブ、同期不要）
sqlbi	約 370 件の SQLBI 技術記事
data-goblins	Data Goblins の Power BI 投稿

検索品質の向上（任意）

デフォルトの同期では、高速なタイトルのみのインデックスが作成されます。「列のフィルターを解除する」のような概念的なクエリを検索するには、説明を含めて一度実行してください。

pbi-search sync --descriptions   # fetches meta descriptions; ~30s extra

---

構成ファイル（.tmuo）

TMUO ファイルには、Tabular Editor 3 の開発者およびモデル固有の設定が保存されます。

重要事項

• TMUO ファイルにはユーザー固有の設定が含まれるため、バージョン管理にコミットしないでください
• 資格情報は Windows User Key で暗号化されるため、ユーザー間で共有できません
• すべてのプロジェクトの .gitignore に *.tmuo を追加してください
• ファイル名：<ModelFileName>.<WindowsUserName>.tmuo

構造

{
  "UseWorkspace": true,
  "WorkspaceConnection": "localhost",
  "WorkspaceDatabase": "MyModel_Workspace_JohnDoe",
  "Deployment": {
    "TargetConnectionString": "powerbi://api.powerbi.com/v1.0/myorg/Workspace",
    "TargetDatabase": "MyModel",
    "DeployPartitions": false,
    "DeployModelRoles": true
  },
  "DataSourceOverrides": {
    "SQL Server": {
      "ConnectionString": "Data Source=localhost;Initial Catalog=DevDB"
    }
  }
}

セクション

セクション	目的
UseWorkspace	ワークスペースデータベースモードを有効にします
WorkspaceConnection	ワークスペースデータベースのサーバー
WorkspaceDatabase	ワークスペースデータベース名（開発者／モデルごとに一意）
Deployment	ターゲットサーバー、データベース、およびデプロイオプション
DataSourceOverrides	ワークスペースの接続を上書きします
TableImportSettings	Import Tables 機能の設定

デプロイオプション

フィールド	型	説明
TargetConnectionString	string	ターゲットサーバーへの接続
TargetDatabase	string	ターゲットデータベース名
DeployPartitions	bool	パーティション定義をデプロイします
DeployModelRoles	bool	セキュリティロールをデプロイします
DeployModelRoleMembers	bool	ロールメンバーをデプロイします
DeploySharedExpressions	bool	共有 M 式をデプロイします

アプリケーションの設定

TE3 は、アプリケーションレベルの設定を %LocalAppData%\TabularEditor3\ に保存します。

ファイル	用途
Preferences.json	アプリケーション設定（プロキシ、更新、テレメトリ）
UiPreferences.json	UI の状態（ウィンドウの位置、パネルのサイズ）
Layouts.json	保存されたレイアウト設定

参考資料

• references/doc-structure.md -- 詳細なドキュメント構成
• references/url-redirects.md -- リンク切れに対応する旧 URL から新 URL へのマッピング
• schema/ -- tmuo、設定、レイアウト、UI 設定用の JSON スキーマ
• scripts/validate_config.py -- TE3 設定ファイルを検証します
• scripts/validate_tmuo.py -- TMUO ファイルを検証します

外部リンク

• pbi-search on GitHub
• Tabular Editor のユーザーオプション
• ワークスペースモード
• 設定リファレンス