Documentación

Primeros pasos

ingest()

Referencia de upload() para envío de archivos.

1 min de lectura

Servicio obtenido con sdk.ingest().

upload(params)

js
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 file falta o no es un único objeto File.
  • 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

html
<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, table y partitions se envían a la plataforma sin validación local.

Guía

Primera llamada

Página completa con envío de archivo.

Ver guía

Soporte

Soporte a la implementación

Canales oficiales para resolver dudas durante la integración.

Respuesta en hasta 1 día hábil

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 correo
Próximamente

WhatsApp

Respuesta de acuerdo con la fila de atención

Atención directa para dudas rápidas de integración.

Disponible

Asistente de soporte

Respuesta inmediata

Asistente de documentación e implementación de i6.