数据源
数据源用于连接外部数据库、文件存储、API 和在线表格。连接成功后，AIR 将可查询的数据映射为基础视图（PDS），供工作簿、视图和投影使用。文件、API 和飞书表格还需要完成文件转换、请求解析或表格配置。
支持的数据源
在左侧菜单选择“数据源”，点击“新建数据源”。可通过分类或名称搜索选择类型；版本及兼容模式在选中类型后的连接表单中配置。
下表按接入方式组织，覆盖当前版本的 43 个数据源创建入口。具体操作见对应章节。
| 接入方式 | 数据源 | 使用说明 |
|---|---|---|
| 数据库与数据仓库 | Apache Hive、MySQL、PostgreSQL、Oracle、GaussDB、ClickHouse、Microsoft SQL Server、Dameng、SAP HANA、OceanBase、Apache Doris、StarRocks、TiDB、Impala、Databricks、AIR、Athena、Vertica、Snowflake、Db2、Trino、ArgoDB、Huawei DWS、openGauss、InterSystems、MaxCompute、AnalyticDB、Kingbase、PolarDB | 数据库与数据仓库 |
| NoSQL、搜索与图数据库 | MongoDB、Tablestore、Elasticsearch、Nebula | NoSQL、搜索与图数据库 |
| HBase | Apache HBase | HBase |
| 文件系统与对象存储 | HDFS、S3、Azure Blob、ECS、KSYUN | 文件系统与对象存储 |
| 本地文件 | File | 文件上传 |
| HTTP 接口 | API | API 源 |
| 消息队列 | Kafka | Kafka |
| 在线表格 | Feishu（飞书电子表格、多维表格） | 飞书表格 |
Hive、MySQL、SQL Server、OceanBase、AnalyticDB、PolarDB 等类型包含多个版本或兼容模式。请先选择数据源，再根据目标系统选择对应模式，不需要为每个模式寻找独立入口。
连接前的准备
- 确认当前账号具备创建数据源和访问目标资产的权限。
- 准备目标系统的连接地址、端口、数据库或存储范围，以及连接所需的账号或应用凭据。
- 确认 AIR 服务及执行查询的引擎能够访问目标地址。仅浏览器能访问目标系统，并不代表 AIR 能够连接。
- 为连接账号授予所需的元数据读取和数据查询权限。文件存储需能够列举并读取目标文件；飞书应用需能够读取目标表格。
创建数据源
- 进入“数据源”，点击“新建数据源”，选择目标类型。
- 填写“基础信息”。数据源名称由字母、数字或下划线组成，以字母或下划线开头；按需填写描述。
- 在“数据连接”中填写对应类型的连接信息。必填项以页面星号为准；需要额外参数时，填写合法的 JSON，详见数据源额外配置。
- 按需设置“投影更新”和“元数据同步”。不同类型显示的配置项有所不同。
- 对提供“连通性测试”的类型，先进行测试；确认配置后点击“创建”。
- 打开新建数据源，检查目录、表和字段。文件、API、飞书等类型按对应章节继续配置可查询的基础视图。
投影更新与元数据同步
这两类配置用途不同：投影更新控制用于查询加速的数据刷新；元数据同步更新库、表、字段等结构信息。
| 配置项 | 用途 |
|---|---|
| 周期调度 | 设置该数据源下基础视图的投影默认刷新周期，具体以表单提供的调度选项为准 |
| 触发方式 | 按需配置消息触发 |
| 投影过期时间 | 选择永不过期或指定时间过期；过期不等于删除源端数据 |
| 数据库目录更新 | 配置自动采集目录的周期，或选择通过接口指定采集范围；部分数据源不提供此项 |
| 表详情元数据更新 | 配置表结构等元数据的更新周期，按需使用“自定义范围” |
投影的完整配置与行为见投影。创建数据源时的默认配置不能替代对具体基础视图、投影状态的检查。
编辑基础视图
基础视图的分区字段、表级下推、并行拉取和投影更新默认配置，在表详情页的“编辑”入口维护，详见编辑表。
投影构建所需的下推与写账号
逻辑视图需要开启“下推写入”构建投影时，须在其所属 catalog 上启用下推，并配置写账号和临时表所在库（Schema）。这些是数据源级配置；投影中还需单独开启“下推写入”。支持范围、界面配置步骤和权限要求见为投影下推写入配置 catalog，执行原理见投影下推写入。
验证与常见问题
创建成功后，依次检查数据源状态、目录是否可见、字段是否正确，以及工作簿中的小范围查询是否成功。连通性测试通过不代表账号已经拥有所有库表的数据访问权限。
| 现象 | 优先检查 |
|---|---|
| 连通性测试失败 | 地址、端口、网络访问、认证方式和连接凭据 |
| 数据源存在，但看不到库表 | 源端权限、数据库或存储范围、元数据采集配置及采集结果 |
| 字段缺失或类型不正确 | 元数据同步状态；MongoDB、HBase、Tablestore 的字段维护配置 |
| 目录中有文件但无法查询 | 是否已转换为基础视图，文件格式与解析参数是否匹配 |
| API 或飞书表格预览失败 | 请求或表链接、应用权限、返回数据结构，以及解析配置 |