SuperAPI AI 工具集

carto-import-export-data

数据与分析

查看项目

更新于 10-15 17:31

技能介绍

用途:把本地文件或 URL 的地理空间数据(CSV、GeoJSON、Shapefile、GeoParquet)导入数据仓库并使其可查询;从仓库导出数据;在连接之间转移表;为千万行级以上空间数据集准备 tileset 以提升地图渲染性能;批量导出 CARTO 活动使用数据到本地磁盘做离线分析。若查询仓库中已有文件应转用 carto-query-datawarehouse,查看已有数据转用 carto-explore-datawarehouse。

主要能力与用法:接入 CARTO MCP 服务器(OAuth 会话)时,交互式操作用 import_data、export_data、transfer_data,各方法支持 submit|status,并用 execute_async_query 物化 tileset。脚本化/批量加载、无头流水线或未接入服务器时改用 carto import / carto sql job CLI。注意:在 token 认证的 MCP 会话下,导入/导出/转移工具不可见(仅只读/发现子集),需改用 CLI;carto activity export(使用数据到本地磁盘)仅 CLI 支持。CLI 示例:carto import --file ./data.csv --connection carto_dw --destination project.dataset.table(--url 用于远程源,--async 单独轮询,--overwrite 覆盖)。

要点与限制:connection 是连接名而非仓库项目 ID,可用 explore_data 的 list_connections 或 carto connections list --json 查看;destination 须为仓库语法的全限定名,如 BigQuery 的 project.dataset.table、Snowflake 的 DATABASE.SCHEMA.TABLE、Postgres/Redshift 的 schema.table、Databricks 的 catalog.schema.table、Oracle 的 SCHEMA.TABLE。单文件 1 GB 硬限制(CARTO 侧),更大文件需先暂存云存储再从预签名 URL 导入。已准备精确 schema 时用 --no-autoguessing 关闭自动推断,避免类似邮编的数字列被改类型。导入导出在 API 层为异步:MCP 返回 job id,用 status 轮询;CLI 默认轮询至完成,加 --async 立即返回 job id。tileset 流程为导入后物化 tileset 表(execute_async_query 或 carto sql job)再在地图中引用,tileset 创建于仓库而非搬运工具本身。详细格式、大小限制与目标语法见 references/imports.md、references/tilesets.md、references/exports.md。