html-query-plan 项目使用教程

2024-09-27 22:30:56作者：董灵辛Dennis

1. 项目目录结构及介绍

html-query-plan/
├── examples/
│   ├── index.html
│   └── ...
├── images/
│   └── ...
├── src/
│   ├── qp.css
│   ├── qp.min.js
│   └── ...
├── test/
│   ├── test_plans/
│   └── ...
├── .gitignore
├── .npmignore
├── LICENSE.txt
├── README.md
├── karma.config.js
├── package-lock.json
├── package.json
├── screenshot.png
├── tsconfig.json
└── webpack.config.js

目录结构说明

examples/: 包含项目使用的示例文件，如 index.html 等。
images/: 包含项目使用的图片资源。
src/: 包含项目的主要源代码文件，如 qp.css 和 qp.min.js。
test/: 包含项目的测试文件，如 test_plans/ 等。
.gitignore: Git 忽略文件配置。
.npmignore: npm 忽略文件配置。
LICENSE.txt: 项目许可证文件。
README.md: 项目说明文档。
karma.config.js: Karma 测试配置文件。
package-lock.json: npm 包锁定文件。
package.json: npm 包配置文件。
screenshot.png: 项目截图。
tsconfig.json: TypeScript 配置文件。
webpack.config.js: Webpack 配置文件。

2. 项目启动文件介绍

项目的启动文件主要集中在 examples/ 目录下，其中 index.html 是一个典型的示例文件。以下是 index.html 的简要介绍：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
    <link rel="stylesheet" type="text/css" href="../src/qp.css" />
    <script src="../src/qp.min.js"></script>
</head>
<body>
    <div id="container"></div>
    <script>
        QP.showPlan(document.getElementById("container"), '<ShowPlanXML ...>');
    </script>
</body>
</html>

启动文件说明

index.html: 这是项目的示例启动文件，包含了引入 qp.css 和 qp.min.js 的代码，并通过 QP.showPlan 方法展示 SQL Server 执行计划。

3. 项目配置文件介绍

`package.json`

package.json 是 npm 包管理器的配置文件，包含了项目的依赖、脚本等信息。以下是部分内容：

{
  "name": "html-query-plan",
  "version": "2.6.1",
  "description": "Display SQL Server Execution Plans in HTML",
  "main": "src/qp.min.js",
  "scripts": {
    "test": "karma start",
    "build": "webpack && NODE_ENV=production webpack"
  },
  "dependencies": {
    ...
  },
  "devDependencies": {
    ...
  }
}

配置文件说明

name: 项目名称。
version: 项目版本。
description: 项目描述。
main: 项目的主入口文件。
scripts: 包含项目的脚本命令，如 test 和 build。
dependencies: 项目的依赖包。
devDependencies: 开发环境的依赖包。

`webpack.config.js`

webpack.config.js 是 Webpack 的配置文件，用于打包项目的 JavaScript 文件。以下是部分内容：

module.exports = {
  entry: './src/qp.js',
  output: {
    filename: 'qp.min.js',
    path: path.resolve(__dirname, 'dist')
  },
  ...
};

配置文件说明

entry: 项目的入口文件。
output: 打包后的输出文件配置，如 qp.min.js。

通过以上配置文件，可以完成项目的构建和打包工作。

登录后查看全文

项目优选

收起

本项目是CANN提供的transformer类大模型算子库，实现网络在NPU上加速计算。

本项目是CANN提供的神经网络类计算算子库，实现网络在NPU上加速计算。

Ascend Extension for PyTorch

openEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。

455

437

ops-math

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

华为昇腾面向大规模分布式训练的多模态大模型套件，支撑多模态生成、多模态理解。

CANN 学习中心仓，支持在线互动运行、边学边练，提供教程、示例与优化方案，一站式助力昇腾开发者快速上手。