将 Excel 转换为 SQL – Aspose.Cells Cloud API
Contents
[
Hide
]
此 REST API 可将电子表格文件转换为 SQL 格式文件。
前置条件
要使用此接口,您必须拥有一个有效的 JWT 令牌,其生成方式请参阅 基于 JWT 令牌的认证 指南。API 支持的 Excel 文件大小不超过服务文档中定义的限制,并且在提供 password 查询参数时可处理密码保护的工作簿。
PostConvertWorkbookToSQL API
POST https://api.aspose.cloud/v3.0/cells/convert/sql
安全与认证
Aspose.Cells Cloud API 采用安全机制,需要 基于 JWT 令牌的认证。
查询参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| password | string | 打开 Excel 文件所需的密码。 |
| storageName | string | 存放文件的存储空间名称。 |
| checkExcelRestriction | bool | 指示在修改单元格相关对象时是否检查 Excel 文件限制。 |
请求体参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| datafile | data file | 待转换的电子表格文件,作为请求的第一个部分包含在内。 |
响应
API 返回一个 FileInfo 对象,其中包含生成的 SQL 文件。
| 字段 | 类型 | 描述 |
|---|---|---|
| Filename | string | SQL 文件名(例如 example.sql)。 |
| FileSize | int | 文件大小(单位:字节)。 |
| FileContent | string | SQL 文件内容(Base64 编码)。 |
HTTP 状态码
| 状态码 | 含义 | 描述 |
|---|---|---|
| 200 | OK(成功) | 过滤器应用成功;响应包含操作详情。 |
| 400 | Bad Request | 缺少或无效参数(例如不支持的文件类型)。 |
| 401 | Unauthorized | JWT 令牌无效或缺失。 |
| 413 | Payload Too Large | 上传文件超出大小限制。 |
| 500 | Internal Server Error | 服务器内部错误。 |
如何使用 SDK 调用 PostConvertWorkbookToSQL API
PostConvertWorkbookToSQL API 规范
OpenAPI 规范 定义了一个公开可访问的编程接口,可让您直接通过网页浏览器发起 REST 请求。
您可以使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例展示了如何使用 cURL 调用云 API。
使用 Aspose.Cells Cloud SDK
使用 SDK 是加快开发速度的最佳方式。SDK 会处理底层细节,让您专注于项目任务。请查看 GitHub 仓库,获取 Aspose.Cells Cloud SDK 的完整列表。
以下代码示例展示了如何使用多种 SDK 调用 Aspose.Cells Web 服务:
实现此功能的其他 API
-
POST /cells/{name}/saveAs – 将工作簿保存为其他格式,并将结果存储在指定存储空间中。
-
PUT /cells/convert – 将工作簿转换为另一种格式(支持可选设置),并将结果返回于响应中。
-
GET /cells/{name} – 获取工作簿(支持可选转换设置)。
注意事项
- 转换密码保护的 Excel 文件时,请确保提供
password查询参数;否则转换将失败,并返回 400 错误。 - 服务返回的 SQL 文件内容为 Base64 编码格式,请在保存为
.sql文件前进行解码。
示例文件
点击此处下载示例 Excel 工作簿 sample.xlsx,以及预生成的 SQL 结果 sample.sql,以快速测试该 API。