# 管理连接器文件

在连接器可访问的文件空间中查询、上传、预览、下载和删除文件。本页只处理连接器文件；需要对数据库表执行导入，请参阅[导入任务](import-data.md)。

## 前提条件

准备可访问目标工作区的凭据和目标连接器标识。有关服务地址、认证和通用请求格式，请参阅[调用前准备](../../api-call-basics.md)。

如果尚未创建或验证连接器，请先完成[创建与维护连接器](connectors.md)。

## 调用顺序

1. 先查询文件列表，确定目标文件及其标识。
2. 需要检查内容时，先预览文件；需要获取完整内容时，下载文件。
3. 需要新增内容时上传文件，并重新查询列表确认目标文件可见。
4. 确认不再使用某个文件后，再执行删除操作。

## API 操作

### 查询和读取文件

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询文件列表 | [查看文件列表](../../../../reference/api/ai-studio/data-connections/connector-files/list-files.md) | 定位文件或确认上传、删除后的文件集合。 |
| 预览文件 | [预览文件](../../../../reference/api/ai-studio/data-connections/connector-files/preview-file.md) | 读取前检查文件内容时使用。 |
| 下载文件 | [下载文件](../../../../reference/api/ai-studio/data-connections/connector-files/download-file.md) | 需要取得文件时使用。 |

### 写入和删除文件

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 上传文件 | [上传文件](../../../../reference/api/ai-studio/data-connections/connector-files/upload-file.md) | 需要向连接器文件空间新增文件时使用。 |
| 删除文件 | [删除文件](../../../../reference/api/ai-studio/data-connections/connector-files/delete-file.md) | 确认不再需要该文件后使用。 |

## 结果确认

上传或删除后，重新调用[查看文件列表](../../../../reference/api/ai-studio/data-connections/connector-files/list-files.md)确认文件集合；读取前可用[预览文件](../../../../reference/api/ai-studio/data-connections/connector-files/preview-file.md)确认选定内容。

## 限制和注意事项

- 删除前确认目标文件不会再被后续导入任务使用。
- 预览和下载适用于不同读取方式；具体可读取范围以相应动作页为准。

## 下一步

- [导入任务](import-data.md)