ingest()

Serviço obtido com sdk.ingest().

upload(params)

await sdk.ingest().upload({ dataset, table, partitions, file })

O arquivo deve ser .json.gz: um objeto JSON por linha (formato às vezes chamado de JSON Lines ou NDJSON), comprimido com gzip. Esta exigência é da plataforma, não é validada pelo SDK — enviar outro formato não gera erro na chamada, mas o processamento do lado da plataforma pode falhar.

O upload() não confere o formato nem o conteúdo do arquivo. Uma chamada bem-sucedida (ingestId retornado) confirma apenas que o arquivo chegou ao armazenamento — não confirma que ele foi aceito no formato esperado.

Devolve: uma Promise sem valor, resolvida quando o envio termina com sucesso.

Condições de erro

• A promessa é rejeitada quando file está ausente ou não é um único objeto File.
• A promessa é rejeitada quando não é possível obter o endereço de envio.
• A promessa é rejeitada quando o envio do arquivo falha.

Exemplo 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: "<seu-dataset>",
        table: "<sua-tabela>",
        partitions: { "<sua-chave>": "<seu-valor>" },
        file,
      });
    });
  }
  main();
</script>

Notas

• O SDK pede à plataforma um endereço de envio assinado e envia o arquivo a esse endereço por PUT.
• Cada chamada envia um arquivo.
• O SDK valida apenas file. dataset, table e partitions são enviados à plataforma sem validação local.