Primeros pasos
ingest()
Referencia de upload() para envío de archivos.
1 min de lectura
Servicio obtenido con sdk.ingest().
upload(params)
await sdk.ingest().upload({ dataset, table, partitions, file })| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
dataset |
string |
Sí | Dataset que recibe el archivo. |
table |
string |
Sí | Tabla de entrada. |
partitions |
object |
Sí | Valores de las particiones de la tabla. |
file |
File |
Sí | Un único objeto File. |
El archivo debe ser .json.gz: un objeto JSON por línea (formato a veces
llamado JSON Lines o NDJSON), comprimido con gzip. Este requisito es de la
plataforma, no lo valida el SDK — enviar otro formato no genera error en la
llamada, pero el procesamiento del lado de la plataforma puede fallar.
upload() no comprueba el formato ni el contenido del archivo. Una llamada
exitosa (ingestId devuelto) confirma solo que el archivo llegó al
almacenamiento — no confirma que fue aceptado en el formato esperado.
Devuelve: una Promise sin valor, resuelta cuando el envío termina con
éxito.
Condiciones de error
- La promesa se rechaza cuando
filefalta o no es un único objetoFile. - La promesa se rechaza cuando no es posible obtener la dirección de envío.
- La promesa se rechaza cuando falla el envío del archivo.
Ejemplo mínimo
<script src="https://cdn.infinity6.ai/releases/sdkweb/latest/bundle/i6sdk-web.js"></script>
<input type="file" id="arquivo" />
<script type="module">
async function main() {
const sdk = new window.I6Sdk();
const user = await sdk.auth().requireUser();
if (!user) return;
const input = document.querySelector("#arquivo");
input.addEventListener("change", async () => {
const file = input.files[0];
if (!file) return;
await sdk.ingest().upload({
dataset: "<tu-dataset>",
table: "<tu-tabla>",
partitions: { "<tu-clave>": "<tu-valor>" },
file,
});
});
}
main();
</script>Notas
- El SDK pide a la plataforma una dirección de envío firmada y envía el
archivo a esa dirección con
PUT. - Cada llamada envía un archivo.
- El SDK valida solo
file.dataset,tableypartitionsse envían a la plataforma sin validación local.
Guía
Primera llamada
Página completa con envío de archivo.
Soporte
Soporte a la implementación
Canales oficiales para resolver dudas durante la integración.
Correo de soporte técnico
Respuesta en hasta 1 día hábil
Envíe dudas de implementación con el contexto del paso actual.
Enviar correoRespuesta de acuerdo con la fila de atención
Atención directa para dudas rápidas de integración.
Asistente de soporte
Respuesta inmediata
Asistente de documentación e implementación de i6.
