接入前需要确认
接入前请核对
请移除终端提示符、行数与折行,并保留打印出的列名。
接入前请核对
重复键与逐单元格类型解析可能改变值,或使对象布局丢失列。
代码示例
这些示例以 multipart/form-data 发送样例,并原样保存响应字节。请先设置环境变量 TABLECONVERT_API_KEY。
MySQL终端结果 转 JSON记录 API · cURL
curl --fail-with-body --max-time 40 \
'https://api.tableconvert.com/v2/convert/mysql-to-json' \
--header "Authorization: Bearer $TABLECONVERT_API_KEY" \
--form-string 'data=+-----+-------+--------+
| id | name | active |
+-----+-------+--------+
| 101 | Alice | true |
| 102 | Bob | false |
+-----+-------+--------+
' \
--form-string 'output[parsingJSON]=false' \
--form-string 'output[minify]=false' \
--form-string 'output[format]=object' \
--form-string 'output[indentSize]=2' \
--form-string 'output[rootName]=' \
--output 'mysql-to-json.json'需要 cURL。若示例采用文件上传,请先下载输入样例。
MySQL终端结果 转 JSON记录 API · Python
import os
from pathlib import Path
import requests
endpoint = "https://api.tableconvert.com/v2/convert/mysql-to-json"
headers = {"Authorization": "Bearer " + os.environ["TABLECONVERT_API_KEY"]}
fields = {
"data": (None, "+-----+-------+--------+\n| id | name | active |\n+-----+-------+--------+\n| 101 | Alice | true |\n| 102 | Bob | false |\n+-----+-------+--------+\n"),
"output[parsingJSON]": (None, "false"),
"output[minify]": (None, "false"),
"output[format]": (None, "object"),
"output[indentSize]": (None, "2"),
"output[rootName]": (None, ""),
}
response = requests.post(endpoint, headers=headers, files=fields, timeout=40)
response.raise_for_status()
Path("mysql-to-json.json").write_bytes(response.content)需要 Python 3 与 requests,可通过 pip install requests 安装。
MySQL终端结果 转 JSON记录 API · Node.js
import { writeFile } from "node:fs/promises";
const form = new FormData();
form.set("data", "+-----+-------+--------+\n| id | name | active |\n+-----+-------+--------+\n| 101 | Alice | true |\n| 102 | Bob | false |\n+-----+-------+--------+\n");
form.set("output[parsingJSON]", "false");
form.set("output[minify]", "false");
form.set("output[format]", "object");
form.set("output[indentSize]", "2");
form.set("output[rootName]", "");
const response = await fetch("https://api.tableconvert.com/v2/convert/mysql-to-json", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.TABLECONVERT_API_KEY },
body: form,
signal: AbortSignal.timeout(40_000),
});
if (!response.ok) {
throw new Error("HTTP " + response.status + ": " + await response.text());
}
await writeFile("mysql-to-json.json", Buffer.from(await response.arrayBuffer()));需要 Node.js 20 或更新版本,使用内置 fetch、FormData 和 Blob。
身份验证
发送 Authorization: Bearer YOUR_API_KEY。请让 HTTP 客户端设置 multipart 边界,不要手动指定 Content-Type。
生产环境的 API Key 请保存在服务端环境变量中。
请求参数
此来源指复制的MySQL终端表格输出,不是实时数据库连接。边框线会被移除,再解析可见单元格文本。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
data | string | — | 直接发送 MySQL 表格内容;data、file、url 三种来源任选其一。 |
file | binary | — | 通过 multipart/form-data 上传 txt 文件。 |
url | string | — | 可公开访问的受支持文件 HTTP 或 HTTPS URL。 |
使用 data、file 或 url 提供一种输入来源。页面示例使用适合该格式的来源模式。
输出选项
根据首行表头与数据网格生成JSON,也可选择其他数组布局;可选单元格解析会改变值表示,需要明确检查类型。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
output[parsingJSON] | boolean | false | 尝试为每个单元格解析JSON;需要保留带有重要前导零的编号等文本时请关闭。 |
output[minify] | boolean | false | 减少生成内容的排版空白;请检查该格式对单元格内容的具体影响。 |
output[format] | string | object | 选择对象、二维、按列或带键的JSON布局;各布局使用首行的方式不同。 |
output[indentSize] | number | 2 | 设置生成文本的缩进;它控制格式,不控制数据类型。 |
output[rootName] | string | 空字符串 | 将JSON结果包装到以此名称为属性的对象下。 |
转换规则
| 情况 | 处理方式 |
|---|---|
| 映射规则 1 | MySQL CLI边框被剥离,打印出的表头与数据行成为普通单元格。 |
| 映射规则 2 | 默认布局将表头名称映射到行值;其他布局会改变此映射。 |
| 映射规则 3 | 打印表头提供记录键,NULL保留为展示文本,除非明确重映射;不会连接数据库。 |
输入读取方式
- 请粘贴MySQL命令行客户端返回的带边框文本表格。
- 无需数据库主机、密码,也不会执行查询或连接数据库。
- 转换前请移除行数提示、命令提示符与终端自动换行。
- 打印出的NULL和数字外观单元格均为文本;无法从终端展示恢复数据库列类型。
输出生成方式
- 默认对象布局使用表头值作为属性名,数据记录不包含表头行。
- 对象布局中重复表头可能覆盖属性;请使用唯一名称。
- parsingJSON尝试逐单元格解析JSON;需要保留文本编号时请关闭。
适用场景
此转换的实际用途
以复制的MySQL CLI查询结果为起始数据,准备应用JSON payload或测试样本。请移除终端提示符、行数与折行,并保留打印出的列名。
JSON记录
将平铺数据集表示为API记录或确定性的集成测试样本。
响应与错误
| HTTP 状态 | 说明 |
|---|---|
200 | text/plain; charset=utf-8 |
400 | 输入或转换参数无效。 |
402 | 积分不足,无法处理此请求。 |
403 | API Key 缺失或无效。 |
413 | 输入超过已配置的请求限制。 |
415 | 不支持的输入媒体类型。 |
429 | 请求超过频率限制。 |
500 | 转换未能完成。 |
503 | 渲染服务不可用或请求超时。 |
重试前请先检查响应。新的 HTTP 请求属于新的转换,可能再次消耗积分。
限制、计费与版本
本地预览最多接受 200 KB。当前 API 实现允许上传一个不超过 50 MiB 的文件,multipart 中每个文本字段限制为 1 MiB,v2 转换任务的截止时间为 30 秒。部署环境可能设置更严格的限制。重试前请先检查错误内容;部分解析或渲染失败会返回 HTTP 500。
真实调用遵循 API 积分规则。转换失败会返还积分;若转换已完成,随后下载连接中断不会撤销该次成功转换。
查看 API 定价与积分参考资料与格式规范
格式参考资料用于说明底层语法;上方转换规则与样例描述 TableConvert 的实际实现。