Práticas recomendadas para a geração de relatórios

Salvar e reutilizar relatórios

É recomendável criar e salvar relatórios para consultas que você faz regularmente porque inserir e excluir o mesmo relatório várias vezes desperdiça recursos. Usar períodos relativos como YESTERDAY ou LAST_7_DAYS facilita a reutilização dos relatórios.

Relatórios programados

Pode ser um desperdício de recursos usar relatórios ad hoc (ou únicos) porque eles são gerados de forma individual e, possivelmente, em um conjunto de dados incompleto. Com os relatórios programados, é possível aproveitar mais os recursos disponíveis porque eles são gerados em massa. Além disso, é possível ter certeza de que eles só serão gerados após o processamento dos dados do dia anterior. Consulte os campos de programação disponíveis para detalhes.

Usar backoff exponencial ao pesquisar status de relatório

Não é possível prever quanto tempo levará para gerar um relatório. Isso pode variar de segundos a horas, dependendo de muitos fatores, como o período e a quantidade de dados a serem processados. Também não há correlação entre o tempo de geração do relatório e o número de linhas retornadas. Por isso, você precisa verificar regularmente o status do relatório gerado para identificar quando o processo foi concluído. Esse processo é chamado de "pesquisa".

Embora a pesquisa seja necessária, uma implementação ineficiente poderá esgotar sua cota de forma rápida se uma geração de relatório demorar muito para ser concluída. Use o backoff exponencial para limitar as tentativas e economizar sua cota.

Consulte backoff exponencial para mais informações.

Fazer download de várias partes

Os arquivos de relatório podem ter vários Gigabytes. Fazer o download desses relatórios em uma única solicitação pode levar a problemas de conexão. Além disso, se um download de solicitação única for interrompido, não será possível retomá-lo. Também não será possível retomar um download de solicitação única com falha. Evite esse problema usando downloads de várias partes para dividir downloads grandes em porções menores. Se apenas uma das partes falhar, o download poderá ser retomado a partir desse ponto.

Essa divisão tem muitos benefícios, mas cada parte gera uma solicitação individual. Use um tamanho mínimo de 10 MB para evitar o desperdício de cota. No entanto, se o tamanho médio do relatório for muito grande, considere aumentar o tamanho das partes de acordo com a velocidade da conexão.

Limitar o número de relatórios que são gerados simultaneamente

Se você gerar mais de 10 relatórios ao mesmo tempo, todas as solicitações adicionais serão aceleradas. Isso faz com que a geração de relatórios demore mais e, em casos extremos, pode levar a erros e expiração de tempo limite. Recomendamos gerar até cinco relatórios simultâneos para ficar abaixo do limite e evitar problemas.