Data Formulator 的 Load Data 页面为什么看不到某些数据源？怎么检查原因？

Data Formulator 的 Load Data 页面为什么看不到某些数据源怎么检查原因【免费下载链接】data-formulator Data Formulator is an interactive AI-powered data analysis system makes it easy to connect, explore and visualize data.项目地址: https://gitcode.com/GitHub_Trending/da/data-formulator如果你打开 Data Formulator 的 Load Data 页面发现某个数据源类型比如 Kusto、BigQuery在 Add Connection 里选不到或者管理员明明配置了某个连接但页面上没有对应的卡片这篇文档提供一套按顺序排查的路径先确认该类型是否注册成功再确认连接是否配置、是否对当前用户可见最后区分部署模式带来的限制。适用前提Data Formulator 0.7 的服务已经启动你拥有服务器端访问权限能查看启动日志、能请求/api/data-loaders。以下检查依据 数据源连接指南 与 DataConnector API 规范。先理解卡片从哪里来Load Data 页面的内容来自两层看不到也分两类可用类型层后端启动时扫描内置 loader 和插件目录形成 loader 注册表DATA_LOADERS。缺依赖的类型不会进入注册表只被记录到DISABLED_LOADERS并附带安装提示。连接实例层注册表里的类型要能显示为卡片还得存在连接实例——管理员通过DATA_FORMULATOR_HOME/connectors.yaml或DF_SOURCES__*环境变量预配置或用户自己在 Add Connection 里创建。连接实例的可见规则admin connector 全局可见user connector 只对创建它的 identity登录用户可见。所以排查顺序是类型没注册依赖/插件/部署模式问题→ 类型已注册但没有配置连接 → 连接存在但当前用户不可见。检查一/api/data-loaders的 disabled 列表管理员请求GET /api/data-loaders这是前端创建连接表单的 discovery 入口。响应包含三个部分loaders注册成功的类型列表每项含type、name、params、auth_mode等disabled注册失败的类型每项带install_hintplugins插件目录信息dir、enabled、reason、loaded、errors。文档示例字段结构来自 data_connector.py 的返回体{ loaders: [ { type: postgresql, name: Postgresql, params: [] } ], disabled: { mysql: { install_hint: pip install pymysql } }, plugins: { dir: /home/xxx/.data_formulator/plugins, enabled: true, reason: WORKSPACE_BACKENDlocal, loaded: [], errors: [] } }如果目标类型出现在disabled里install_hint直接告诉你缺什么包或什么错。若类型连disabled里都没有多半属于下面检查三、四的配置或模式问题。检查二服务端启动日志里的安装提示loader 在模块加载阶段逐个独立导入缺依赖只禁用那一个 loader。loader 注册表 会输出如下格式的日志下行为日志格式示例mysql/pymysql为示例值Data loader mysql disabled (missing: pymysql). Install with: pip install pymysql各内置 loader 对应的 pip 依赖包来自_LOADER_SPECS注册表loader 类型依赖包mysqlpymysqlmssqlmssql-pythonpostgresqlpsycopg2-binarykustoazure-kusto-datadatabricksdatabricks-sql-connectors3 / athenaboto3azure_blobazure-storage-blobmongodbpymongocosmosdbazure-cosmosbigquerygoogle-cloud-bigquerysupersetrequestslocal_folderpyarrow检查三部署模式对 local_folder 和插件的限制这一类看不到是部署约束不是错误local_folderConnect Local Folder只在本地模式可用。多人服务器或云部署WORKSPACE_BACKEND不等于local中local_folder 会从注册表移除并记入DISABLED_LOADERS提示为local_folder connector is disabled in multi-user mode (WORKSPACE_BACKEND ! local)。目的是避免用户读取服务器上的任意文件。插件 loader插件目录扫描默认只在WORKSPACE_BACKENDlocal时启用多人/托管部署需要显式设置DF_ALLOW_PLUGINS1才开启插件会执行任意 Python需可信目录。响应里plugins.enabled为false时plugins.reason会给出原因如WORKSPACE_BACKENDazure_blob (set DF_ALLOW_PLUGINS1 to enable)。插件文件本身有问题文件名必须是*_data_loader.py且不能与内置 loader 或已有插件重名重名会被拒绝并记入plugins.errors含file、reason、kind字段。自定义类型不出现时先看errors。检查四连接是否配置、是否对当前用户可见类型注册正常但没有卡片时确认连接实例是否存在管理员连接来自DATA_FORMULATOR_HOME/connectors.yaml或DF_SOURCES__*环境变量后者优先级更高相同connector_id时覆盖 YAML 定义。YAML 中每条连接需要id、type、name、params等字段params里支持${ENV_VAR}引用。用户连接由用户通过POST /api/connectors创建只保存到DATA_FORMULATOR_HOME/users/identity/connectors.yaml且只对创建者可见——同事创建的 user connector 不会出现在你的 Load Data 页面这不是故障。GET /api/connectors返回当前 identity 可见的连接列表响应字段可用来核对文档示例取值来自 API 规范{ id: postgresql:analytics, source: user, deletable: true, display_name: PostgreSQL · analytics, connected: true }source区分user与 admin 来源admin connector 对用户可见但deletable为false。如果这里也没有目标连接说明该连接从未被配置或创建回到 Add Connection 流程补建即可。检查五外部连接器是否被整体禁用如果部署启用了DISABLE_DATA_CONNECTORStrue浏览器/托管模式所有外部数据连接器都会关闭只剩内置示例数据可用。启动时会打印External data connectors disabled (DISABLE_DATA_CONNECTORStrue) — sample datasets remain available此时看不到任何外部数据源属于预期行为不是依赖缺失。修复与验证按检查出的原因分别处理缺依赖在服务运行的 Python 环境中安装对应包例如pip install pymysql注意副作用这会修改服务器运行环境的 Python 包需要服务器管理权限。loader 注册表在服务启动时扫描安装后需要重启服务进程才能生效。插件未启用多人部署设置DF_ALLOW_PLUGINS1后重启并确认plugins.errors为空。local_folder 被禁这是多人模式的强制限制需要本机目录访问就使用本地模式部署多人服务器上该能力不提供。连接未配置/不可见管理员补connectors.yaml或DF_SOURCES__*配置配置只创建连接实例不定义新 loader type或让用户在 Add Connection 中自建连接。验证方式重启后再次请求GET /api/data-loaders目标类型从disabled移到loaders再请求GET /api/connectors或打开 Load Data 页面确认新数据源卡片出现点击卡片能进入目录浏览界面即完成闭环。两个容易误判的边界sample_datasets示例数据和local_folder都有独立入口不会出现在 Add Connection 的类型列表里这是设计如此不代表注册失败。筛选控件源端筛选只在 PostgreSQL、MySQL、Superset 上支持其他数据源没有筛选控件属于能力差异与数据源不可见是两回事。【免费下载链接】data-formulator Data Formulator is an interactive AI-powered data analysis system makes it easy to connect, explore and visualize data.项目地址: https://gitcode.com/GitHub_Trending/da/data-formulator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考