ASH Viewer 技术文档

1. 安装指南

1.1 下载与安装

1. 下载最新版本的二进制文件。
2. 根据你的数据库类型（Oracle 或 PostgreSQL），下载相应的 JDBC 驱动。
3. 解压二进制文件并运行 ASH-Viewer.jar。

1.2 配置数据库连接

1. 打开连接对话框，填写数据库连接信息。
   • Oracle 数据库的 URL 格式为：jdbc:oracle:thin:@host:port:SID
2. 点击“连接”按钮，开始监控系统。

2. 项目使用说明

2.1 快速开始

• 启动 ASH-Viewer.jar 后，系统会自动弹出连接对话框。
• 填写数据库连接信息并点击“连接”按钮，系统将开始监控数据库的活跃会话历史数据。

2.2 功能介绍

• Top Activity：显示数据库中的活跃会话活动。
• Raw Data：提供详细的活跃会话历史数据。
• SQL 和 Session 详情：双击 Top SQL 或 Session 界面，可以查看详细的 ASH 数据。

3. 项目 API 使用文档

3.1 数据库连接 API

• 连接数据库：通过 JDBC 驱动连接到 Oracle 或 PostgreSQL 数据库。
• 加密与安全设置：支持 AES 和 PBE 加密方式，确保数据库密码的安全性。

3.2 数据存储 API

• 本地存储：使用嵌入式数据库 Oracle Berkeley DB Java Edition 存储 ASH 数据。
• 数据保护：支持 Windows Data Protection API (DPAPI) 和系统注册表存储，确保敏感数据的安全。

4. 项目安装方式

4.1 源码编译

1. 安装 JDK 11 或更高版本、Maven 和 Git。
2. 使用 Git 下载项目源码。
3. 使用 Maven 编译项目：

   mvn clean compile
   

4. 打包可执行 jar 文件：

   mvn clean package -DskipTests=true
   

4.2 直接运行

1. 下载并解压二进制文件。
2. 运行 ASH-Viewer.jar。

通过以上步骤，你可以顺利安装并使用 ASH Viewer 项目，监控和分析数据库的活跃会话历史数据。