接入前需要确认
接入前请核对
请移除终端提示符、行数与折行,并保留打印出的列名。
接入前请核对
多行会重复顶层键,完整内容不是有效TOML;请重组为表或表数组,并校验转义。
代码示例
这些示例以 multipart/form-data 发送样例,并原样保存响应字节。请先设置环境变量 TABLECONVERT_API_KEY。
MySQL终端结果 转 TOML键值草稿 API · cURL
curl --fail-with-body --max-time 40 \
'https://api.tableconvert.com/v2/convert/mysql-to-toml' \
--header "Authorization: Bearer $TABLECONVERT_API_KEY" \
--form-string 'data=+----------+-------------+---------+
| name | mode | retries |
+----------+-------------+---------+
| frontend | production | 3 |
| worker | development | 1 |
+----------+-------------+---------+
' \
--output 'mysql-to-toml.toml'需要 cURL。若示例采用文件上传,请先下载输入样例。
MySQL终端结果 转 TOML键值草稿 API · Python
import os
from pathlib import Path
import requests
endpoint = "https://api.tableconvert.com/v2/convert/mysql-to-toml"
headers = {"Authorization": "Bearer " + os.environ["TABLECONVERT_API_KEY"]}
fields = {
"data": (None, "+----------+-------------+---------+\n| name | mode | retries |\n+----------+-------------+---------+\n| frontend | production | 3 |\n| worker | development | 1 |\n+----------+-------------+---------+\n"),
}
response = requests.post(endpoint, headers=headers, files=fields, timeout=40)
response.raise_for_status()
Path("mysql-to-toml.toml").write_bytes(response.content)需要 Python 3 与 requests,可通过 pip install requests 安装。
MySQL终端结果 转 TOML键值草稿 API · Node.js
import { writeFile } from "node:fs/promises";
const form = new FormData();
form.set("data", "+----------+-------------+---------+\n| name | mode | retries |\n+----------+-------------+---------+\n| frontend | production | 3 |\n| worker | development | 1 |\n+----------+-------------+---------+\n");
const response = await fetch("https://api.tableconvert.com/v2/convert/mysql-to-toml", {
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-toml.toml", 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 提供一种输入来源。页面示例使用适合该格式的来源模式。
输出选项
根据列生成带引号的TOML风格键值赋值;多条记录目前会重复顶层键,因此多行输出需先重组再交给TOML解析器。
此输出格式不提供额外选项。
转换规则
| 情况 | 处理方式 |
|---|---|
| 映射规则 1 | MySQL CLI边框被剥离,打印出的表头与数据行成为普通单元格。 |
| 映射规则 2 | 表头名称成为赋值键,每行输出另一组带引号赋值。 |
| 映射规则 3 | 移除CLI边框及状态行,再明确每条查询结果行如何成为配置记录。 |
输入读取方式
- 请粘贴MySQL命令行客户端返回的带边框文本表格。
- 无需数据库主机、密码,也不会执行查询或连接数据库。
- 转换前请移除行数提示、命令提示符与终端自动换行。
- 打印出的NULL和数字外观单元格均为文本;无法从终端展示恢复数据库列类型。
输出生成方式
- 表头成为键,每行分别为各列输出赋值。
- TOML禁止同一表内重复键;请手动将多条记录重组为经过检查的表数组节。
- 请校验键语法、引号转义与换行;此接口提供配置文本起点。
适用场景
此转换的实际用途
以复制的MySQL CLI查询结果为起始数据,准备待整理为有效TOML的配置草稿。请移除终端提示符、行数与折行,并保留打印出的列名。
TOML键值草稿
起草单记录配置,或将多行模板重组为TOML表。
响应与错误
| 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 的实际实现。