跳转到内容
API 接口文档v2

MySQL终端结果 转 YAML记录 API

通过TableConvert转换API,由复制的MySQL CLI查询结果准备由记录映射构成的YAML序列。打印表头提供记录键,NULL保留为展示文本,除非明确重映射;不会连接数据库。

REST APIv2 · 直接返回输出MySQL终端结果 → YAML记录每次成功转换消耗 1 积分

试用这个转换接口

查看真实样例,在浏览器本地预览,或使用自己的密钥发送真实请求。

已验证样例
POSThttps://api.tableconvert.com/v2/convert/mysql-to-yaml

YAML记录 响应

-
  name: frontend
  region: eu
  enabled: true
-
  name: worker
  region: us
  enabled: false

本地预览不消耗积分,并使用导入的第一个表格或工作表。

转换选项
每次成功的真实请求消耗 1 积分。

密钥仅发送给转换 API,此页面不会保存密钥。

接入前需要确认

接入前请核对

请移除终端提示符、行数与折行,并保留打印出的列名。

接入前请核对

未加引号的类似true字符串、内部引号与多行值可能改变解析;请使用目标YAML解析器校验。

代码示例

这些示例以 multipart/form-data 发送样例,并原样保存响应字节。请先设置环境变量 TABLECONVERT_API_KEY。

MySQL终端结果 转 YAML记录 API · cURL

curl --fail-with-body --max-time 40 \
  'https://api.tableconvert.com/v2/convert/mysql-to-yaml' \
  --header "Authorization: Bearer $TABLECONVERT_API_KEY" \
  --form-string 'data=+----------+--------+---------+
| name     | region | enabled |
+----------+--------+---------+
| frontend | eu     | true    |
| worker   | us     | false   |
+----------+--------+---------+
' \
  --form-string 'output[indentSize]=2' \
  --form-string 'output[arrayStyle]=block' \
  --form-string 'output[quotationStyle]=none' \
  --output 'mysql-to-yaml.yaml'

需要 cURL。若示例采用文件上传,请先下载输入样例。

身份验证

发送 Authorization: Bearer YOUR_API_KEY。请让 HTTP 客户端设置 multipart 边界,不要手动指定 Content-Type。

生产环境的 API Key 请保存在服务端环境变量中。

请求参数

此来源指复制的MySQL终端表格输出,不是实时数据库连接。边框线会被移除,再解析可见单元格文本。

参数类型默认值说明
datastring—直接发送 MySQL 表格内容;data、file、url 三种来源任选其一。
filebinary—通过 multipart/form-data 上传 txt 文件。
urlstring—可公开访问的受支持文件 HTTP 或 HTTPS URL。

使用 data、file 或 url 提供一种输入来源。页面示例使用适合该格式的来源模式。

输出选项

使用block或flow布局生成由行映射构成的YAML序列;引号与标量解释需要在消费端解析器中检查。

参数类型默认值说明
output[indentSize]string2设置生成文本的缩进;它控制格式,不控制数据类型。
output[arrayStyle]stringblock为YAML序列与映射使用block或flow样式。
output[quotationStyle]stringnone选择YAML标量引号样式;请另外校验内部引号与多行值。

转换规则

情况处理方式
映射规则 1MySQL CLI边框被剥离,打印出的表头与数据行成为普通单元格。
映射规则 2表头名称成为映射键,每个数据行成为一个序列项。
映射规则 3打印表头提供记录键,NULL保留为展示文本,除非明确重映射;不会连接数据库。

输入读取方式

  • 请粘贴MySQL命令行客户端返回的带边框文本表格。
  • 无需数据库主机、密码,也不会执行查询或连接数据库。
  • 转换前请移除行数提示、命令提示符与终端自动换行。
  • 打印出的NULL和数字外观单元格均为文本;无法从终端展示恢复数据库列类型。

输出生成方式

  • 表头名称成为映射键,数据行成为序列项。
  • 请根据目标流程选择缩进、arrayStyle与quotationStyle。
  • 生成器不是完整YAML引号处理器;请校验冒号、引号、多行值与类似布尔值的字符串。

适用场景

此转换的实际用途

以复制的MySQL CLI查询结果为起始数据,准备YAML配置或数据样本。请移除终端提示符、行数与折行,并保留打印出的列名。

YAML记录

为消费YAML的工具起草小型配置或数据样本。

响应与错误

HTTP 状态说明
200text/plain; charset=utf-8
400输入或转换参数无效。
402积分不足,无法处理此请求。
403API Key 缺失或无效。
413输入超过已配置的请求限制。
415不支持的输入媒体类型。
429请求超过频率限制。
500转换未能完成。
503渲染服务不可用或请求超时。

重试前请先检查响应。新的 HTTP 请求属于新的转换,可能再次消耗积分。

限制、计费与版本

本地预览最多接受 200 KB。当前 API 实现允许上传一个不超过 50 MiB 的文件,multipart 中每个文本字段限制为 1 MiB,v2 转换任务的截止时间为 30 秒。部署环境可能设置更严格的限制。重试前请先检查错误内容;部分解析或渲染失败会返回 HTTP 500。

真实调用遵循 API 积分规则。转换失败会返还积分;若转换已完成,随后下载连接中断不会撤销该次成功转换。

查看 API 定价与积分

仍在使用 API v1?

此页介绍直接返回转换结果的 v2。API v1 使用 JSON 包装响应。调整现有集成前,请先查看 API 总览。

API 总览

参考资料与格式规范

格式参考资料用于说明底层语法;上方转换规则与样例描述 TableConvert 的实际实现。