udbsanitizer.exe 使用说明

概述

Urchin 数据库维护实用程序 udb-sanitizer 可用于检查 Urchin 6 配置文件数据库以及对这些数据库执行各种维护操作。

udb-sanitizer 可执行的操作类型有：

• 将数据库回滚到以前保存的备份状态
• 删除某天、数天或整月的配置文件数据

用法

udb-sanitizer 位于 Urchin 6 发行套装的 util 目录下。

该实用程序的用法如下：

  udb-sanitizer [-h] （显示用法消息并退出）

  udb-sanitizer [-v] （显示版本并退出）

  udb-sanitizer -p profile [-d YYYYMM[DD]] -bfhprq] [-z [-e DD]] 

其中，

   -b  直接转到回滚选项

   -d  指定操作的年份和月份以及日期（可选）

   -e  使用 z 和 d 选项，将同一月中的数天（范围 d->e）清零

   -f  强制进行操作而无需确认

   -h  显示此帮助信息

   -p  指定配置文件的名称（必需）

   -a  指定帐户名称

   -r  直接转到删除选项

   -q  静止模式，除非有重要用户确认，否则不得输出

   -z  直接转到零天选项 

请注意： 如果调用 udb-sanitizer 时使用的选项没有完全说明要执行的操作，则会显示用法文本（等同于 -h 选项）。 通过使用 –f 和 -q 的选项组合以及适用的 -d、-b、-r 或 -z 选项，您可以在没有任何用户互动的情况下促使执行操作。

操作

常规操作中，从提供适用于计划类型操作的选项的命令解释程序调用 udb-sanitizer。

与以上列出的可用选项相关的操作包括：

1. 数据回滚 (–r)

• 此选项允许用户恢复配置文件已经存档的数据。 系统会向用户展示压缩 (ZIP) 存档备份列表以供选择，所选的存档文件的内容将替换现有报告数据库的内容。 按照惯例，压缩存档通常命名为“YYYYMM-backupv6-YYYYMMDDHHMMSS.zip”，其中开头的 YYYYMM 指备份数据的月份（如：200803 指 2008 年 3 月），而 YYYYMMDDHHMMSS 部分是创建压缩存档时的时间戳。 此时间戳有助于确定要回滚到的压缩存档。

2. 删除月数据 (-d)

• 删除指定月的特定配置文件的所有数据。 如果某个月的数据不正确（如应用了错误的过滤器或处理了错误的日志），此选项可用于清除该月的统计数据。此外，如果更改了一些高级配置文件参数（如点击路径深度或推介链接级别），这样就需要更新此月的 Urchin 报告数据以反映此更改。 可以在没有用户互动的情况下，通过调用 udb-sanitizer 以及 -f、-r 和 -q 参数来执行此操作。

udb-sanitizer -f –q -r -d 200309 -p mysite.com 

3. 将一天或数天的数据清零

• 此选项可以将某月中选定日期范围内的数据清零，从而使 Urchin 日志处理仅针对这段时间重新运行（如 urchin -p profile -d YYYYMMDD）。 可以在没有用户互动的情况下，通过调用 udb-sanitizer 以及 -f、–q、-z 和 -d 参数来将某一天的数据清零。例如：

udb-sanitizer –f -q -z -d 20030907 -p mysite.com 

• 对于数天的情况，加上“-e”参数并指定结束日期即可，例如：

udb-sanitizer -f -z -d 20030907 -e 10 -p mysite.com 

• 这样，会将 9 月 7 号至 10 号的数据清零。 请注意，–e 参数仅提供结束日期。 由于只需对数据库索引和标题检查一次，因此，与调用多个 udb-sanitizer 实例以一次仅对某一天进行清零相比，这样更为有效。 索引/标题检查操作要求对包含大量数据的配置文件投入相当长的时间。

4. 如果配置文件是帐户的一部分，则应使用 -a 参数指定帐户名称。

重要提示： 一旦执行删除每日或每月数据操作，便无法撤消！ 唯一的解决方法是重新处理相应时间段的网络服务器日志以重新放入配置文件数据库。 请谨慎使用这些选项。