Things to check before integrating
Before you integrate
Remove terminal prompts, row counts and wrapped lines; keep the printed column header.
Before you integrate
This is code text, not a MAT file or numeric matrix; validate names and string quoting before execution.
Code examples
These examples send the sample as multipart/form-data and save the returned bytes unchanged. Set TABLECONVERT_API_KEY in your environment.
MySQL query result to MATLAB cell-array code API · cURL
curl --fail-with-body --max-time 40 \
'https://api.tableconvert.com/v2/convert/mysql-to-matlab' \
--header "Authorization: Bearer $TABLECONVERT_API_KEY" \
--form-string 'data=+--------+---------+---------+
| sample | reading | group |
+--------+---------+---------+
| A | 12.5 | control |
| B | 18.2 | test |
+--------+---------+---------+
' \
--output 'mysql-to-matlab.m'Requires cURL. Download the sample input first when this example uploads a file.
MySQL query result to MATLAB cell-array code API · Python
import os
from pathlib import Path
import requests
endpoint = "https://api.tableconvert.com/v2/convert/mysql-to-matlab"
headers = {"Authorization": "Bearer " + os.environ["TABLECONVERT_API_KEY"]}
fields = {
"data": (None, "+--------+---------+---------+\n| sample | reading | group |\n+--------+---------+---------+\n| A | 12.5 | control |\n| B | 18.2 | test |\n+--------+---------+---------+\n"),
}
response = requests.post(endpoint, headers=headers, files=fields, timeout=40)
response.raise_for_status()
Path("mysql-to-matlab.m").write_bytes(response.content)Requires Python 3 and requests. Install it with pip install requests.
MySQL query result to MATLAB cell-array code API · Node.js
import { writeFile } from "node:fs/promises";
const form = new FormData();
form.set("data", "+--------+---------+---------+\n| sample | reading | group |\n+--------+---------+---------+\n| A | 12.5 | control |\n| B | 18.2 | test |\n+--------+---------+---------+\n");
const response = await fetch("https://api.tableconvert.com/v2/convert/mysql-to-matlab", {
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-matlab.m", Buffer.from(await response.arrayBuffer()));Requires Node.js 20 or later with built-in fetch, FormData and Blob.
Authentication
Send Authorization: Bearer YOUR_API_KEY. Let the HTTP client set the multipart boundary; do not set Content-Type manually.
Keep production API keys in server-side environment variables.
Request parameters
This source means copied MySQL terminal table output, not a live database connection. Border lines are removed and visible cell text is parsed.
| Parameter | Type | Default | Description |
|---|---|---|---|
data | string | — | Inline MySQL table content. Choose one of data, file or url. |
file | binary | — | Upload a txt file using multipart/form-data. |
url | string | — | A supported publicly accessible HTTP or HTTPS file URL. |
Send one source: data, file, or url. The examples below use the source mode appropriate for this format.
Output options
Generate one MATLAB cell-array assignment per column. The output contains string values and is not a numeric matrix or a MAT binary file.
This output format does not expose additional options.
Conversion rules
| Case | Behavior |
|---|---|
| Mapping rule 1 | The MySQL CLI border is stripped and its printed header and rows become plain cells. |
| Mapping rule 2 | Header names become MATLAB variables containing columns of quoted string cells. |
| Mapping rule 3 | Use the copied result’s displayed values and explicitly map NULL and numeric text before analytical casting; no SQL query runs. |
How the input is read
- Paste the bordered text table returned by the MySQL command-line client.
- No database host, password, query execution or connection is required or performed.
- Remove row-count messages, prompts and wrapped terminal output before conversion.
- Printed NULL values and numeric-looking cells are text; database column types are not available from the terminal rendering.
How the output is written
- Headers become variable names and each column becomes a cell array.
- Values are quoted as text; apply explicit numeric or datetime conversion in MATLAB when needed.
- Validate MATLAB identifiers and embedded quote characters before running the generated code.
When to use this API
This conversion in practice
Use a copied MySQL CLI query result as the starting dataset for a MATLAB analysis-script fixture. Remove terminal prompts, row counts and wrapped lines; keep the printed column header.
MATLAB cell-array code
Prepare a small textual dataset for a MATLAB analysis script.
Responses and errors
| HTTP status | Description |
|---|---|
200 | text/plain; charset=utf-8 |
400 | Invalid input or conversion parameters. |
402 | Insufficient credits for this request. |
403 | Missing or invalid API key. |
413 | The input exceeds the configured request limit. |
415 | Unsupported input media type. |
429 | Rate limit exceeded. |
500 | The conversion could not be completed. |
503 | The renderer is unavailable or the request timed out. |
Check the response before retrying. A new HTTP request is a new conversion and may use credits again.
Limits, billing and versions
Local previews accept up to 200 KB. The current API implementation allows one uploaded file up to 50 MiB, limits each multipart text field to 1 MiB, and gives v2 conversion tasks a 30-second deadline. Deployment limits may be stricter. Read the returned error before retrying; some parser or renderer failures return HTTP 500.
Live calls follow the API credit policy. Failed conversions are refunded; a completed conversion is not undone if the download connection later fails.
View API pricing and creditsUsing API v1?
This page documents v2, which returns the output directly. API v1 wraps the result in a JSON envelope. Check the overview before changing an existing integration.
API overviewReferences and format specifications
Format references explain the underlying syntax. The conversion rules and samples above describe TableConvert’s implementation.