接入前需要确认
接入前请核对
请移除终端提示符、行数与折行,并保留打印出的列名。
接入前请核对
生成键会随调用变化;转换不执行Firebase写入或鉴权操作。
代码示例
这些示例以 multipart/form-data 发送样例,并原样保存响应字节。请先设置环境变量 TABLECONVERT_API_KEY。
MySQL终端结果 转 Firebase JSON列表 API · cURL
curl --fail-with-body --max-time 40 \
'https://api.tableconvert.com/v2/convert/mysql-to-firebase' \
--header "Authorization: Bearer $TABLECONVERT_API_KEY" \
--form-string 'data=+-------+-----+--------+
| name | age | active |
+-------+-----+--------+
| Alice | 28 | true |
| Bob | 34 | false |
+-------+-----+--------+
' \
--form-string 'output[parsingJSON]=true' \
--output 'mysql-to-firebase.json'需要 cURL。若示例采用文件上传,请先下载输入样例。
MySQL终端结果 转 Firebase JSON列表 API · Python
import os
from pathlib import Path
import requests
endpoint = "https://api.tableconvert.com/v2/convert/mysql-to-firebase"
headers = {"Authorization": "Bearer " + os.environ["TABLECONVERT_API_KEY"]}
fields = {
"data": (None, "+-------+-----+--------+\n| name | age | active |\n+-------+-----+--------+\n| Alice | 28 | true |\n| Bob | 34 | false |\n+-------+-----+--------+\n"),
"output[parsingJSON]": (None, "true"),
}
response = requests.post(endpoint, headers=headers, files=fields, timeout=40)
response.raise_for_status()
Path("mysql-to-firebase.json").write_bytes(response.content)需要 Python 3 与 requests,可通过 pip install requests 安装。
MySQL终端结果 转 Firebase JSON列表 API · Node.js
import { writeFile } from "node:fs/promises";
const form = new FormData();
form.set("data", "+-------+-----+--------+\n| name | age | active |\n+-------+-----+--------+\n| Alice | 28 | true |\n| Bob | 34 | false |\n+-------+-----+--------+\n");
form.set("output[parsingJSON]", "true");
const response = await fetch("https://api.tableconvert.com/v2/convert/mysql-to-firebase", {
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-firebase.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 提供一种输入来源。页面示例使用适合该格式的来源模式。
输出选项
生成以新建push风格标识符为键的JSON对象;它准备列表结构的payload,不连接或写入Firebase数据库。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
output[parsingJSON] | boolean | true | 尝试为每个单元格解析JSON;需要保留带有重要前导零的编号等文本时请关闭。 |
转换规则
| 情况 | 处理方式 |
|---|---|
| 映射规则 1 | MySQL CLI边框被剥离,打印出的表头与数据行成为普通单元格。 |
| 映射规则 2 | 表头命名记录属性,再将记录放入新生成的push风格键下。 |
| 映射规则 3 | 打印表头提供记录键,NULL保留为展示文本,除非明确重映射;不会连接数据库。 |
输入读取方式
- 请粘贴MySQL命令行客户端返回的带边框文本表格。
- 无需数据库主机、密码,也不会执行查询或连接数据库。
- 转换前请移除行数提示、命令提示符与终端自动换行。
- 打印出的NULL和数字外观单元格均为文本;无法从终端展示恢复数据库列类型。
输出生成方式
- 列名成为生成记录标识符下的子属性。
- 每次转换都会生成标识符,因此重复调用不保证逐字节一致。
- 另行写入数据库前,请校验Firebase键限制并检查parsingJSON。
适用场景
此转换的实际用途
以复制的MySQL CLI查询结果为起始数据,准备经过检查的Firebase列表导入payload。请移除终端提示符、行数与折行,并保留打印出的列名。
Firebase JSON列表
为受控的Realtime Database导入准备小型列表payload。
响应与错误
| 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 的实际实现。