Umami v2 引入了重新设计的架构和一些重大更改。
重大更改
- API 端点已更改，包括添加了新的端点。有关更多信息，请参见 API。
- 跟踪脚本已更名为
script.js，之前为umami.js。 - 收集 API 端点已更名为
/api/send，之前为/api/collect。 - 跟踪器不再使用 CSS 类名来触发事件。它现在使用 HTML 数据属性。有关更多信息，请参见 跟踪事件。
- 全局
umamiJavaScript 对象的方法已更改。现在有一个单一的.track()方法和一种新的发送事件数据的方法。有关更多信息，请参见 跟踪器函数。 TRACKER_SCRIPT_NAME环境变量不再在脚本名称后附加.js扩展名。有关更多信息，请参见 环境变量。
数据迁移
由于架构更改，v1 数据库中的数据需要转换为 v2。
为了帮助迁移，我们创建了一个脚本 @umami/migrate-v1-v2，它将为您迁移所有数据。
需求
- 数据库架构必须与最新的 v1 版本（v1.4.0）同步。该脚本将查询 prisma 迁移表以确保最新迁移已运行。
重要提示
- 在使用之前备份目标数据库。如果迁移被中断，可能会发生数据丢失。
- 对于数据集较大的用户（5M+），迁移可能需要一些时间。请提前做好计划。
- 该脚本不会将任何事件数据迁移到 v2。
- 脚本将在迁移完成后询问您是否希望删除 v1 表。
- 如果发现
event_data表中有数据，将重命名为v1_event_data，但不删除。
排除故障
- 如果您的
DATABASE_URL是 localhost，而迁移无法连接到数据库，请尝试更改为 IP 地址，例如：127.0.0.1。
运行迁移
有两种方法可以运行迁移脚本。
在 Umami 文件夹内运行
如果您可以访问应用程序文件夹的终端，请使用此方法。
确保您的应用程序已构建。如果没有，请先运行 yarn build。
cd umami
npx @umami/migrate-v1-v2@latest
独立运行
如果您无法访问应用程序文件夹，例如在 Vercel 或 Netlify 上部署时，请使用此方法。
安装
git clone https://github.com/umami-software/migrate-v1-v2.git
cd migrate-v1-v2
yarn install
yarn build
配置
创建一个 .env 文件，并定义以下变量：
DATABASE_URL={连接 URL}
运行
yarn start
Docker 迁移
进入正在运行的 Docker 容器。您可以通过 docker ps 的输出找到名称。
docker exec -ti -u 0 <应用容器名称> sh
运行迁移脚本。
npx @umami/migrate-v1-v2@latest
当迁移成功运行时，它应如下所示：
