---
title: "table_import"
description: "Importa as linhas de um `SELECT` SQL, como as de uma planilha, como novos registros de uma tabela, e lista as linhas recusadas."
---

| Operação | Escopo OAuth | Descrição |
| :-- | :-- | :-- |
| `table_import` | `files:write` | Roda um único `SELECT`, como o `sql`, e salva cada linha do resultado como um novo registro da tabela, contra `schemaVersion`, em uma transação. As linhas não passam pelo contexto do agente. Os nomes das colunas são os campos, e uma coluna `NULL` deixa o campo de fora. As linhas válidas são salvas. Uma linha que falha no esquema, em uma referência ou em uma chave única não é salva e volta em `failingRows`, com o número da linha (a partir de 1), o código da recusa e os primeiros problemas; `failingCount` conta todas. Com `check: true` nada é gravado, e o mesmo relatório mostra o que a importação salvaria e recusaria. No máximo 5.000 linhas. Repita o `requestId` para repetir a importação: uma importação já salva com ele devolve o relatório original com `replayed: true`, sem rodar a consulta de novo, e o mesmo `requestId` com outra consulta ou outro `schemaVersion` falha com `request_conflict`. `check: true` sempre mostra a consulta atual e não guarda nada. |

Grupo: [Tabelas, registros e exportações](/docs/agents/mcp/tables-records-and-exports).