corestack_ db_ import
Import into the database.
When to use it
Import a SQL dump (plain, gzip or zstd) into the environment's database, from an uploaded transfer or a file under the site root. A safety snapshot is taken first (always on production) and named in the result: restore it with corestack_restore_create if the import goes wrong. The sanitiser removes DEFINER clauses and statements the site user may not run; pass sanitise: false to send the dump unchanged. Once the data is in, the site's cache is flushed (cache_flushed in the result; when it is false, the data is still imported: flush it yourself as cache_flush says).
Ask for it
Using the Corefinity MCP server, call corestack_db_import with site_id 4211, transfer_id 2207, drop_existing_tables false. (Import into the database.) Tell me what it returned.Inputs
The site's domain, typed exactly, to import on production. Up to 253 characters.
Defaults to false.
Relative to the site root, or absolute under it. Up to 1,024 characters.
Defaults to true.
Defaults to true.
At least 1.
At least 1.
Your assistant fills in a confirmation only after you agree.
Example call
{
"name": "corestack_db_import",
"arguments": {
"site_id": 4211,
"transfer_id": 2207,
"drop_existing_tables": false
}
}If it is refused
| Reason | What to do |
|---|---|
import_running | Another import into the same database is running or holds the reserved import slot (taken under the environment-row lock before any safety snapshot); wait for it. |
snapshot_failed | corestack_db_import's safety snapshot failed; nothing was changed; retry once; then tell the person. |
transfer_changed | The transfer's object is not the generation recorded for it, or yields more bytes than its scan did; nothing was written; upload again. |
checksum_mismatch | The transfer's bytes do not match its declared sha256; nothing was written; upload again. |
transfer_expiring | The transfer has less life left than mcp.transfers.min_consume_seconds, so the run could outlive its object; upload it again, then call again. |
sanitise_unparsed | The SQL-aware sanitiser met a construct it cannot close; details names the byte offset; stopped before that statement reached mariadb; fix the dump, or call again with sanitise: false. |
managed_elsewhere | Another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done. |
invalid_arguments | The arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again. |
tenant_mismatch | The object does not exist or the token may not see it. Check the id. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
pin_refused | The grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it. |
rate_limited | Too many calls. Wait for the number of seconds the answer names. |
temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
internal_error | Something went wrong on our side. Quote the trace id to support. |