Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-09-08

Endpoint: GET /api/v1/tables/{dataset}/{table}

Referencia del endpoint que devuelve filas paginadas (limit/offset) de una tabla de un mart publicado del workspace.

En esta página (8)

La API de consulta REST (/api/v1) está en acceso anticipado y todavía no está abierta para uso externo. El código existe y el contrato de abajo es el del comportamiento actual. Para consumo externo ahora, use el feed OData.

Acceso anticipado

Contrato documentado para planificación. No construyas integraciones críticas sobre la API REST mientras no se libere.

Devuelve filas paginadas de una tabla de un mart publicado (*_gold/*_silver) del workspace. Solo lectura, con alcance al workspace.

Resumen#

Método · rutaGET /api/v1/tables/{dataset}/{table}?limit=&offset=
Basehttps://ingestia.io
AuthClave de API (Authorization: Bearer ing_live_… o ?api_key=)
Rol (RBAC)exportación de datos (member+); clave de datos = owner
Costocobra por los bytes reales leídos en el datalake (ver abajo)
Estados200 · 400 · 401 · 403 · 429 · 402 · 502 · 503

Parámetros#

ParámetroDóndePredeterminadoMáx.Observación
datasetruta——debe ser {prefixo}_gold o {prefixo}_silver (prefixo = prefijo de tu workspace); si no, 403
tableruta——solo [A-Za-z0-9_]
limitquery1001000filas por página
offsetquery0—desplazamiento inicial

Ejemplo#

curl -H "Authorization: Bearer ing_live_EXEMPLO" \
  "https://ingestia.io/api/v1/tables/prd_aurora_gold/vendas?limit=100&offset=0"

Respuesta 200#

json
{
  "table": "vendas",
  "rows": [ { "data": "2026-09-01", "total": 1234.56 } ],
  "rowCount": 100,
  "nextOffset": 100
}

nextOffset es null cuando no hay más páginas. La respuesta incluye el encabezado x-ingestia-cost-brl (costo proyectado de la llamada).

Costo y paginación#

Paginar una tabla grande es la forma más cara de extraer

LIMIT/OFFSET no reducen los bytes leídos en el datalake — cada página recorre la tabla. El cobro usa los bytes reales procesados. Para pagar menos, filtra/agrega con el feed OData (que hace pushdown de $select/$filter).

Errores#

CódigoCuándo
400nombre de dataset/tabla inválido
401clave ausente/inválida
403el dataset no es un mart publicado del workspace / rol insuficiente
429 · 402rate limit / pago pendiente
502falla al consultar la tabla en el datalake
503limitador no disponible o datalake no aprovisionado

Seguridad#

  • Solo marts publicados (gold/silver); cualquier otro dataset → 403.
  • Las columnas PII no se exponen.
  • El cobro y el SQL quedan en la auditoría del workspace.

Relacionados#


Última revisión: 2026-09-08.

Enlaces relacionados