接入前需要确认
接入前请核对
请移除终端提示符、行数与折行,并保留打印出的列名。
接入前请核对
启发式类型声明与带引号值可能需要调整,之后DAX表达式才有效。
代码示例
这些示例以 multipart/form-data 发送样例,并原样保存响应字节。请先设置环境变量 TABLECONVERT_API_KEY。
MySQL终端结果 转 DAX DATATABLE API · cURL
curl --fail-with-body --max-time 40 \
'https://api.tableconvert.com/v2/convert/mysql-to-dax' \
--header "Authorization: Bearer $TABLECONVERT_API_KEY" \
--form-string 'data=+----------+-------+---------+
| product | units | revenue |
+----------+-------+---------+
| Notebook | 12 | 48 |
| Marker | 8 | 24 |
+----------+-------+---------+
' \
--form-string 'output[delimiter]=,' \
--output 'mysql-to-dax.dax'需要 cURL。若示例采用文件上传,请先下载输入样例。
MySQL终端结果 转 DAX DATATABLE API · Python
import os
from pathlib import Path
import requests
endpoint = "https://api.tableconvert.com/v2/convert/mysql-to-dax"
headers = {"Authorization": "Bearer " + os.environ["TABLECONVERT_API_KEY"]}
fields = {
"data": (None, "+----------+-------+---------+\n| product | units | revenue |\n+----------+-------+---------+\n| Notebook | 12 | 48 |\n| Marker | 8 | 24 |\n+----------+-------+---------+\n"),
"output[delimiter]": (None, ","),
}
response = requests.post(endpoint, headers=headers, files=fields, timeout=40)
response.raise_for_status()
Path("mysql-to-dax.dax").write_bytes(response.content)需要 Python 3 与 requests,可通过 pip install requests 安装。
MySQL终端结果 转 DAX DATATABLE API · Node.js
import { writeFile } from "node:fs/promises";
const form = new FormData();
form.set("data", "+----------+-------+---------+\n| product | units | revenue |\n+----------+-------+---------+\n| Notebook | 12 | 48 |\n| Marker | 8 | 24 |\n+----------+-------+---------+\n");
form.set("output[delimiter]", ",");
const response = await fetch("https://api.tableconvert.com/v2/convert/mysql-to-dax", {
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-dax.dax", 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 提供一种输入来源。页面示例使用适合该格式的来源模式。
输出选项
根据列名与记录值生成DAX DATATABLE表达式;这是用于模型编写的表达式文本,不导入Power BI或部署模型。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
output[delimiter] | string | , | 设置生成分析表达式或内联数据中的值分隔符。 |
转换规则
| 情况 | 处理方式 |
|---|---|
| 映射规则 1 | MySQL CLI边框被剥离,打印出的表头与数据行成为普通单元格。 |
| 映射规则 2 | 表头建立列声明,记录变为静态值元组。 |
| 映射规则 3 | 请使用复制结果中的展示值,并在分析类型转换前显式映射NULL与数字文本;不会执行SQL查询。 |
输入读取方式
- 请粘贴MySQL命令行客户端返回的带边框文本表格。
- 无需数据库主机、密码,也不会执行查询或连接数据库。
- 转换前请移除行数提示、命令提示符与终端自动换行。
- 打印出的NULL和数字外观单元格均为文本;无法从终端展示恢复数据库列类型。
输出生成方式
- 表头名称成为列声明,行值成为DATATABLE元组。
- 使用简单值启发式推断列类型;请检查数字、布尔值与空值。
- 生成值带引号;使用类型列前,请在DAX编辑器中校验表达式。
适用场景
此转换的实际用途
以复制的MySQL CLI查询结果为起始数据,准备Power BI静态查找表草稿。请移除终端提示符、行数与折行,并保留打印出的列名。
DAX DATATABLE
为Power BI语义模型起草小型静态查找表。
响应与错误
| 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 的实际实现。