mssql-cli 命令行工具的遥测数据指南
项目地址: https://gitcode.com/gh_mirrors/ms/mssql-cli 什么是遥测数据
遥测数据(Telemetry)是指软件自动收集的关于产品使用情况的匿名数据。对于mssql-cli这个SQL Server命令行工具来说，开发团队通过收集这些数据可以了解用户的使用习惯、常见问题和性能瓶颈，从而有针对性地改进产品。
数据收集内容
mssql-cli收集的遥测数据主要分为三类：
1. 环境信息
这些数据帮助开发团队了解用户的使用环境，以便优先支持主流平台和配置：
- 操作系统平台及版本
- 连接的SQL Server版本及类型(单实例或Azure)
- Python版本
- mssql-cli版本
- 用户区域设置
- 使用的Shell类型
2. 使用测量数据
这些数据用于分析工具性能和使用模式：
- 会话开始时间
- 会话结束时间
- 会话持续时间
3. 错误信息
主要记录异常终止情况，帮助识别稳定性问题：
- 错误标志(指示异常终止类型)
数据匿名化处理
所有收集的数据都经过严格匿名化处理：
- 使用SHA256加密算法生成随机UUID作为用户标识
- 不收集任何个人识别信息或特定数据
- 数据仅用于产品改进目的
如何查看收集的数据
mssql-cli会将收集的遥测数据保存在本地日志文件中，用户可以随时查看：
Windows系统：
C:\Users\<用户名>\AppData\Local\dbcli\mssqlcli\mssqlcli_telemetry.log
MacOS/Linux系统：
~/.config/mssqlcli/mssqlcli_telemetry.log
日志文件内容示例：
{
"name": "mssqlcli",
"properties": {
"Reserved.SequenceNumber": 1,
"Reserved.EventId": "e6f0bdab-65b0-4e79-87a4-b05fa514c92d",
"Reserved.SessionId": "3fa7361c-50ff-4bff-8a55-f22bdc26452d"
}
}
如何禁用遥测数据收集
如果您不希望发送使用数据，可以通过设置环境变量来禁用遥测功能：
Windows系统：
set MSSQL_CLI_TELEMETRY_OPTOUT=True
MacOS/Linux系统(bash)：
export MSSQL_CLI_TELEMETRY_OPTOUT=True
设置后需要重新启动mssql-cli才会生效。禁用遥测不会影响工具的核心功能，但开发团队将无法获取您的使用反馈来改进产品。
隐私保护说明
mssql-cli严格遵循微软隐私政策，所有收集的数据仅用于产品改进，不会用于其他商业目的。数据收集和处理过程符合行业标准的隐私保护规范。
通过理解这些遥测数据的作用和收集方式，用户可以更清楚地了解mssql-cli如何持续改进，同时也能够根据自己的隐私偏好做出选择。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
