管理用户标签值
一、功能概述
Quick BI 的“用户标签值管理”是用户管理中的关键功能之一，允许组织管理员通过手动管理或自定义标签表的方式，灵活设置和维护用户标签的具体值。该功能支持将用户按照特定属性（如地区、部门、岗位等）进行分类，为后续的数据权限控制提供基础。
主要优势：
灵活性高：支持手动输入和从数据源中自动同步两种方式，满足不同场景下的管理需求。
实时更新：通过绑定自定义标签表，可实现用户标签信息的实时读取与同步。
精细化权限控制：结合标签授权机制，可实现基于用户标签的数据行级权限控制，确保用户仅能看到与其标签匹配的数据内容。
典型应用场景：
按照用户所属区域打上“地区”标签（如北京、上海），并设置数据权限规则，使用户只能查看本地区的销售数据。
将用户按业务线划分，如“电商”、“零售”，并通过标签权限限制其访问范围。
结合数据库中的用户标签表，自动同步最新用户属性，避免人工维护带来的延迟与错误。
二、使用限制
为了确保用户标签值管理功能正常运行，请注意以下使用限制：
字段要求：当使用自定义标签表时，必须至少包含
account_id、account_name或nick_name中任意一个字段，并且这些字段对应的用户必须已添加至组织中；同时必须至少包含一个 tag 字段。缓存机制：标签表更新后，默认有 1 小时的缓存时间。若需立即生效，需手动清除缓存。
标签值格式：
多个标签值之间需用半角逗号（,）分隔。
支持使用
$ALL_VALUES$或$ALL_MEMBERS$表示所有标签值，但后者在某些权限场景下会被忽略。
删除影响：删除标签表后，相关标签字段会显示“标签表已删除”，并可能影响依赖该标签的权限配置。
三、操作步骤
手动管理用户标签值
登录Quick BI 控制台。
在首页进入用户标签管理页面。
单击标签管理页签。
在左侧导航栏选择手动管理。
为目标用户添加、修改或删除标签值。操作完成后，系统将自动刷新标签列表。
自定义标签表方式管理用户标签值
准备用户标签表，确保满足以下条件：
包含
account_id、account_name或nick_name中的一个字段；至少包含一个 tag 字段（如 area）；
多个标签值可用逗号分隔或多行表示。
进入用户标签管理页面，单击自定义标签表。
绑定数据源中的用户标签表。
配置标签表字段映射关系。
预览无误后，点击保存设置。
若需立即生效，可在标签管理页面点击清除缓存。
四、常见问题 (FAQ)
Q：如何让标签更新后权限立即生效？
A：标签表更新后默认有一小时的缓存时间。如果需要立即生效，请进入标签管理页面，找到对应标签表，点击右下角的清除缓存按钮，即可实时更新权限。
Q：什么是 $ALL_VALUES$ 和 $ALL_MEMBERS$？有何区别？
A：$ALL_VALUES$表示拥有所有标签值，在所有使用场景中均有效，通常用于代表“全部权限”。而$ALL_MEMBERS$同样表示所有标签值，但在行级权限和列级权限中该条件会被去除，在标签占位符场景下则等同于 “BI=BI”。
Q：标签表预览时报错：“permission denied for table ads_bi_pb_user_tag_df” 是什么原因？
A：此问题为数据库权限不足导致，建议联系数据库管理员授予相关用户对ads_bi_pb_user_tag_df表的访问权限。
Q：能否通过 API 获取用户信息以便与其他表做 JOIN 查询？
A：可通过 OpenAPI 接口获取用户信息，用于与其他表进行关联查询。
Q：如何判断当前账号是否已加入组织？
A：若只能看到首页而无法访问其他功能模块，可能是未加入组织。请联系管理员确认账号状态。
Q：用户和用户组怎么使用？
A：请参考 Quick BI 官方文档了解用户和用户组的使用方法：用户组创建指南
Q：导入用户模板时报错“用户名重复”，但实际上系统中不存在该用户名？
A：建议检查导入模板中的用户名和昵称字段是否确实未与系统中现有用户冲突。若确认无误仍报错，可尝试手工逐个添加用户以绕过该问题。