用途:指导将企业搜索从 Elasticsearch 或 Algolia 迁移到 Glean,覆盖连接器迁移(用 Glean 推送索引 API 替代自建爬虫)、权限模型变更(把 ACL 映射到 Glean 数据源级权限)以及使用 bulkindexdocuments 全量重建索引。资料称中型部署(10 万至 100 万文档、多数据源)典型周期为 2 至 4 周。
主要能力:迁移评估(扫描现有索引与文档数、识别权限模型);文档导出与转换,映射为 Glean 文档结构(id、datasource、title、url、body、permissions、updatedAt);通过 adddatasource 创建数据源,按每批 200 条调用 bulkindexdocuments 批量索引;用测试查询对比新旧系统结果质量;提供回滚方案,包括删除数据源与恢复旧搜索提供方。
使用方式:先做基线统计、ACL 映射、新鲜度与合成允许/拒绝探测;在沙箱中演练有界且幂等的迁移,对结构或权限不匹配做隔离而非强行转换;按数据源分批迁移并比对计数、校验和与访问结果;仅在负责人批准并经过监控窗口后切换,保留旧路径直至满足恢复标准。回滚命令示例:curl -X DELETE "https://your-instance.glean.com/api/index/v1/deletedatasource" -H "Authorization: Bearer $GLEAN_API_TOKEN" -H "Content-Type: application/json" -d '{"name": "custom_knowledge_base"}'。
适用场景:企业搜索替换、自建爬虫替换、多数据源索引重建。
限制:需签署迁移计划、明确数据所有者与回滚决策人;需沙箱演练与冻结写入方法;常见错误包括 401 令牌无效、409 数据源重名、413 批次超 10 MB、422 文档缺必填字段、索引未刷新导致结果陈旧。迁移后需监控搜索质量 7 天并移除旧 SDK 依赖。具体价格、平台支持范围与效果数据暂未提供。