Table of Contents

安装并激活 Tabular Editor 3

本页介绍 Tabular Editor 3 常见的安装和激活问题,以及相应的解决方法。有关标准激活流程,请参阅 @getting-started。有关高级部署场景(静默安装、许可证预配、安装后配置),请参阅 @installation-activation-basic。

检查系统要求

进一步排查前,先确认这台计算机满足要求:

  • 操作系统: Windows 10、Windows 11、Windows Server 2016、Windows Server 2019 或更高版本
  • 架构: x64、ARM64(自 3.23.0 起原生支持)
  • .NET 运行时: .NET Desktop Runtime 8.0

请从 下载页面 下载与系统架构匹配的 MSI 安装包。安装程序与系统架构不匹配是导致安装失败以及首次启动时出现缺少依赖项错误的常见原因。

检查已激活的许可证

Tabular Editor 3 会将激活详细信息存储在 Windows 注册表 HKEY_CURRENT_USER\SOFTWARE\Kapacity\Tabular Editor 3 下。

若要查看当前 Windows 用户的许可证密钥,请在 Windows 命令提示符(开始 > 运行 > cmd.exe)中运行以下命令:

REG QUERY "HKCU\Software\Kapacity\Tabular Editor 3" /v LicenseKey

你也可以使用 regedit.exe 直接查看和编辑这些值。有关该键中每个值的说明,参见注册表详细信息。

注册表编辑器

激活对话框反复出现

Tabular Editor 3 会在启动时以及随后定期连接 https://api.tabulareditor.com 以验证许可证。如果由于防火墙或代理无法访问该端点,应用程序每 30 天都需要重新激活一次。使用的端点完整列表请参阅 @policies。

如果激活提示持续出现:

  1. 确认受影响的计算机可以访问 api.tabulareditor.com。
  2. 在 工具 > 偏好设置 > 代理设置 中配置代理。与代理相关的故障排除请参阅 @proxy-settings,其中包括用于启用外部 MSAL 代理支持的 AnalysisServices.AppSettings.json 覆盖设置。
  3. 如果网络阻止向激活端点的出站连接,请使用下面的手动激活。

手动激活(无网络连接)

如果运行 Tabular Editor 的计算机无法访问激活终结点,激活提示会提供手动激活流程。

手动激活提示

  1. 请输入你的电子邮箱地址。会弹出一个对话框,其中包含指向激活密钥的链接。

  2. 复制该 URL,并在另一台可访问互联网的计算机上打开它。该 URL 会返回一个 JSON 对象。

    手动激活 JSON 对象

  3. 复制完整的 JSON 对象,并将其粘贴到离线计算机上的对话框中。

    已填写的手动激活信息

然后,Tabular Editor 3 会验证许可证。

无法通过 UI 更改许可证密钥

只有在未加载任何模型时,帮助 > 关于 Tabular Editor 下的 更改许可证密钥 选项才会显示。如果在打开模型时看不到该选项,请在 文件 > 关闭模型 中关闭模型后重试。

如果界面上的该选项仍然无效,请通过注册表编辑器重置许可证::

  1. 关闭所有 Tabular Editor 3 实例。
  2. 打开注册表编辑器(开始 > 运行 > regedit.exe)。
  3. 定位到 HKEY_CURRENT_USER\SOFTWARE\Kapacity\Tabular Editor 3。
  4. 删除 LicenseKey、User、ActivationKey 和 Activation 值。
  5. 重新启动 Tabular Editor 3。

或者,在 Windows 命令提示符中运行以下命令。如果某个值不存在,相应命令会报告 Report 错误,但其余命令仍会继续执行:

REG DELETE "HKCU\Software\Kapacity\Tabular Editor 3" /v LicenseKey /f
REG DELETE "HKCU\Software\Kapacity\Tabular Editor 3" /v User /f
REG DELETE "HKCU\Software\Kapacity\Tabular Editor 3" /v ActivationKey /f
REG DELETE "HKCU\Software\Kapacity\Tabular Editor 3" /v Activation /f

下次启动时会提示输入许可证密钥。删除这些注册表值后,该安装在许可服务中仍会保持激活状态;可以使用 Tabular Editor 自助门户 管理已激活的许可证。。

Important

一旦移除许可证密钥,在输入新的许可证密钥之前,该计算机上的当前 Windows 用户将无法使用该产品。

许可证绑定到了错误的 Windows 用户

Tabular Editor 3 的激活信息会按用户存储在 HKEY_CURRENT_USER 下。如果多名用户共用一台计算机,每位用户都需要在各自的 Windows 用户配置文件中激活该产品。在某个 Windows 帐户下激活的许可证,对同一台计算机上的其他 Windows 帐户不可见。

要检查哪个 Windows 帐户持有该许可证,请使用该用户登录,并运行检查已激活的许可证中的注册表查询。

Windows 帐户与 Power BI / Entra 帐户

一个常见的混淆点是:运行 Tabular Editor 3 的 Windows 帐户,与用于对 Power BI / Fabric 工作区进行身份验证的 Microsoft Entra 帐户是相互独立的。

  • 许可证激活 存储在激活该产品的 Windows 用户的 HKEY_CURRENT_USER 下。它不与任何云身份绑定。
  • Workspace 身份验证是在 从数据库加载语义模型 对话框中建立连接时进行的。在这里使用对该 Workspace 有权限的 Microsoft Entra 帐户登录。

即使你使用单独的 Entra 帐户连接到 Power BI(例如未启用邮件的管理员帐户),也不需要因此改用其他 Windows 帐户并通过 以其他用户身份运行 启动 Tabular Editor 3。使用你常用的 Windows 帐户启动,在该帐户下激活许可证,并在连接对话框中提供管理员 Entra 凭据。

有关如何选择正确的身份验证模式的详细信息(例如,当你的 Windows 登录与 Power BI 帐户不一致时使用 Microsoft Entra MFA),参见 @xmla-as-connectivity。

企业版席位正被另一位用户占用

企业版许可证按席位分配。当所有席位都已占用时,如需为新用户激活 Tabular Editor 3,必须先通过 Tabular Editor 自助服务门户 将现有用户从某个席位取消注册。此操作需由订阅所有者或许可证管理员执行。

Note

只有企业版才支持重新分配席位。

代理环境下激活

Tabular Editor 3 会发起出站 Web 请求,用于产品激活、检查更新、DAX 格式化以及下载外部最佳实践规则。如果你通过代理上网:

  1. 在 工具 > 偏好 > 代理设置 中进行配置。在 System 和 None 之间切换 代理类型,重启 Tabular Editor 3,然后重试激活。
  2. 如果激活仍然失败,请参阅 代理设置 进行高级代理诊断。
  3. 如果对 api.tabulareditor.com 的出站访问被阻止,使用 手动激活。
Tip

代理设置可能会干扰身份验证对话框和其他外部提示。更改代理类型后,重新测试前务必先关闭并重新打开 Tabular Editor 3。

确认你正在使用最新版本

与激活相关的问题有时会在较新的 Tabular Editor 3 版本中修复。提交支持请求前,请先确认你正在使用最新版本。在 工具 > 偏好 > 更新和反馈 中检查更新,或从 下载页面 下载最新安装程序。