Relatórios síncronos

O que é um relatório síncrono?

Um relatório síncrono é um relatório breve que precisa ser gerado muito rapidamente. Ao receber uma solicitação para gerar um relatório síncrono, a ferramenta de geração plataforma começará a executá-lo para você imediatamente. Relatórios como esses são melhores usadas em situações em que você precisa de um pequeno bloco de dados rapidamente, como quando você exibe métricas em uma interface gráfica interface gráfica do usuário.

Qual a diferença entre a geração de relatórios síncrona e assíncrona?

Gerar um relatório de maneira assíncrona sempre levará pelo menos alguns minutos, mesmo que você solicite uma quantidade pequena de dados. Síncrona esses relatórios retornam esses dados muito mais rapidamente, mas com um custo menor tempo limite para a geração do relatório. Você deve usar a geração de relatórios assíncronos quando não for possível gerá-los na tempo limite síncrono ou quando você não estiver em um período como uma interface do usuário.

Qual é o tempo limite do relatório síncrono?

Se o relatório for pequeno o suficiente para ser gerado em até 10 segundos, o sistema retornará um arquivo de relatório completo para sua solicitação de geração inicial. Caso contrário, a plataforma de relatórios do DCM vai executar o relatório por um período de até 50 segundos antes que o processo expire.

O que vai acontecer se um relatório síncrono levar muito tempo para ser gerado?

Se a geração síncrona de um relatório não for concluída dentro do período de tempo limite, ela será interrompida, e o relatório será direcionado à nossa fila de geração assíncrona de relatórios. Seu relatório não falhar ou retornar um erro, mas a mudança para a janela de significa que seu relatório agora levará pelo menos alguns minutos para gerar.

Você não vai receber uma indicação de que seu relatório excedeu o tempo limite para relatórios síncronos, somente informações sobre o tempo de geração do relatório. Ele será concluído de forma síncrona em até 50 segundos ou se tornam assíncronas e levam vários minutos.

Quais tipos de relatórios são compatíveis com a execução síncrona?

Todos os tipos de relatórios são compatíveis com a execução síncrona, exceto:

Todos os outros tipos de relatório são compatíveis com a execução síncrona, mas o tempo limite será atingido caso muitos dados ou uma combinação de métricas e dimensões que use muitos recursos sejam usados.

Como faço para gerar um relatório síncrono?

Por padrão, todos os relatórios são gerados de forma assíncrona. Ao solicitar a geração de um novo arquivo de relatório, você pode definir o parâmetro opcional synchronous como true para que ele seja síncrono. Consulte o exemplo de código na nossa documentação.

Devo solicitar todos os meus relatórios com relatórios a execução?

Não. Solicite a execução síncrona somente quando você esperar que o relatório seja concluído dentro do tempo limite. Se o relatório começar com a execução síncrona e atingir o tempo limite, ele será movido para a fila assíncrona. O tempo total da execução do relatório será o necessário para gerá-lo de maneira assíncrona somado ao tempo limite síncrono. Assim, se você solicitou o relatório de forma assíncrona, você teria evitado o atraso adicional de o tempo limite síncrono.

As métricas e as dimensões que eu solicitar afetarão o tempo de geração dos meus relatórios?

Sim. Algumas métricas e dimensões levam mais tempo são compiladas do que outras, e algumas delas podem até mesmo fazer com que sempre atingir o tempo limite. As dimensões geográficas raramente são rápidas o suficiente para serem incluídas em relatórios síncronos.

Como posso diminuir o tempo necessário para gerar meus relatórios e permitir a geração de relatórios síncronos?

Muitos fatores, como o tamanho das campanhas incluídas e os que o relatório abrange, afetam a velocidade. Geralmente, a melhor forma de enxugar seus relatórios é fazer alguns ajustes manuais. Comece com todos os dados que você quiser exibir rapidamente, depois reduza o relatório de maneira gradual até que ele seja concluído de modo síncrono.