通过

ASTrace 实用工具示例自述文件

使用 ASTrace 实用工具可以捕获 Analysis Services 跟踪并将其记录到一个 SQL Server 表中。 稍后可以使用 SQL Server Profiler来查询或读取该表。 ASTrace 实用工具作为 Windows 服务运行，它连接到 Analysis Services，然后创建跟踪并使用 SQL Server Profiler格式将跟踪事件记录到一个 SQL Server 表中。 ASTrace 实用工具使用标准跟踪模板创建跟踪，您可以使用 SQL Server Profiler创作该模板。

应用场景

Analysis Services 没有可提取跟踪并将其保存到文件或表中的内置工具。 此 ASTrace 实用工具示例演示了如何实现该跟踪功能。

语言

C#

必备组件

在运行此示例之前，请确保安装了下列软件：

  • Microsoft SQL Server 2005，包括下列组件：
    • 数据库引擎
    • Analysis Services
    • SQL Server Management Studio
    • Business Intelligence Development Studio
    • 数据库引擎示例
  • Microsoft .NET Framework SDK 2.0 或 Visual Studio 2005

生成示例

选项 1：使用 Visual Studio 生成示例

  1. 找到存储解决方案文件 ASTrace.sln 的文件夹。

  2. 将签名文件 ASTrace.snk 移动到该解决方案文件夹。

  3. 打开 Visual Studio。

  4. 在**“最近使用的项目”选项卡上，单击“打开”，再单击“项目”**。

  5. 打开保存解决方案文件 ASTrace.sln 的文件夹，选择该文件，然后单击**“打开”**。

  6. 按 F6 以生成项目。

选项 2：使用 .Net Framework SDK 中的 msbuild.exe 生成示例

  1. 找到存储解决方案文件 ASTrace.sln 的文件夹。

  2. 将签名文件 ASTracer.snk 移动到该解决方案文件夹。

  3. 打开命令提示符窗口并将目录更改为保存该解决方案文件的位置。 根据《.NET Framework 开发人员指南》中的如何在命令提示符下进行编译主题中的说明配置环境。

  4. 键入 msbuild.exe ASTrace.sln，然后按 Enter 键。

安装示例

下列过程描述了如何将 ASTrace 实用工具作为服务安装。

步骤 1：复制可执行文件

  • 将下列文件复制到要从计算机上的该位置中运行此服务的文件夹：

    • ASTrace.exe
    • ASTrace.exe.config
    • Standard.tdf

步骤 2：注册服务

  1. 在安装的 Microsoft .NET Framework SDK 2.0 版本中找到 InstallUtil.exe。

  2. 打开命令提示符窗口。

  3. 将当前目录更改为在上一步中向其复制了可执行文件的文件夹。

  4. 将包含 InstallUtil.exe 的文件夹添加到路径中。

  5. 运行以下命令以安装服务：

    InstallUtil.exe ASTrace.exe

  6. 在**“管理工具”中，打开“计算机管理”，展开“服务和应用程序”，然后选择“服务”**。

  7. 在右侧窗格中搜索**“ASTrace Service”并双击它。 确认“常规”选项卡中的“可执行文件的路径”**显示了复制的文件所在的正确路径。 至此，服务已注册完毕并且在使用您的文件。

    Bb283156.note(zh-cn,SQL.90).gif注意：
    在下一步中配置该服务之前，请不要启动它。

步骤 3：配置服务

  1. 在记事本或任何其他不含控制字符的文本编辑器中打开 ASTrace.exe.config 文件。

  2. 根据其定义在以下字段中填入内容：

    • AnalysisServerName—要跟踪的 Analysis Service 实例的名称。
    • SQLServer—要在其中记录跟踪的 SQL Server 实例的名称。
    • SQLServerDatabase—将保存跟踪表的 SQL Server 数据库的名称。
    • TraceTableName—要将跟踪记录到其中的表的名称。
    • TraceDefinition—包含用于创建 Analysis Services 跟踪的跟踪模板的文件的名称。 如果需要修改 ASTrace 模板，请使用 SQL Server Profiler进行修改。

运行示例

下列过程显示了如何启动服务并配置安全性。

步骤 1：启动服务

  • 打开 Windows 服务控制管理器，导航到 ASTrace 实用工具并启动服务。

    如果服务成功启动，则表明它能够连接 Analysis Services 实例并创建跟踪；此外，它还能够连接 SQL Server 并创建跟踪表，然后开始向其中写入跟踪日志。

    如果在启动过程中出现任何问题，您会看到 ASTraceService.log 文件（在您的本地安装目录中创建）中将记录相应错误。 请再次检查名称以确保正确指定了所有服务器名称，并且 ASTrace 服务拥有适当的安全权限。 ASTrace 实用工具是使用 LocalSystem 帐户安装的，以便您能够测试其功能。

步骤 2：配置安全性

  1. 请确保将 ASTrace 服务帐户更改为适当的本地或域用户帐户。 这样可以尽量减少攻击的可攻击面。

  2. 若要运行 ASTrace 服务应用程序，必须确保运行该服务的服务帐户拥有下列权限：

    • Analysis Services 管理员权限。
    • SQL Server 数据库管理员权限，以便在您指定的数据库中创建表并记录事件。

删除示例

请使用下列过程来卸载服务。

卸载 ASTrace 服务

  • 打开命令提示符窗口并运行以下命令：

    InstallUtil.exe ASTrace.exe