{"id":16530,"date":"2023-10-17T15:37:31","date_gmt":"2023-10-17T18:37:31","guid":{"rendered":"https:\/\/darkorchid-wallaby-287256.hostingersite.com\/?p=16530"},"modified":"2023-10-17T15:37:32","modified_gmt":"2023-10-17T18:37:32","slug":"agregacoes-automaticas-auto-aggs-podem-otimizar-o-directquery","status":"publish","type":"post","link":"https:\/\/dataex.com.br\/en\/agregacoes-automaticas-auto-aggs-podem-otimizar-o-directquery\/","title":{"rendered":"Agrega\u00e7\u00f5es autom\u00e1ticas (auto-aggs) podem otimizar o DirectQuery"},"content":{"rendered":"Reading time:<\/span> 12<\/span> minutes<\/span><\/span>\n
\"\"<\/figure>\n\n\n\n

Voc\u00ea sabia que agora, com apenas um clique<\/strong> no bot\u00e3o do mouse, os criadores de conjuntos de dados do Power BI – com qualquer n\u00edvel de habilidade<\/em> – podem melhorar o desempenho de um conjunto de dados DirectQuery<\/strong>? Para come\u00e7ar, acesse o portal Power BI, exiba as configura\u00e7\u00f5es de um conjunto de dados DirectQuery<\/strong>, expanda a se\u00e7\u00e3o Atualiza\u00e7\u00e3o Agendada<\/strong> e Otimiza\u00e7\u00e3o de Desempenho<\/strong> e alterne a op\u00e7\u00e3o de Treinamento<\/strong> Agrega\u00e7\u00f5es Autom\u00e1ticas<\/strong> to Ativado<\/strong><\/a> (como na captura de tela a seguir). Mas n\u00e3o se esque\u00e7a de configurar uma agenda de atualiza\u00e7\u00e3o de dados<\/strong> para atualizar suas agrega\u00e7\u00f5es regularmente.<\/p>\n\n\n\n

Inicialmente, isso \u00e9 basicamente tudo que voc\u00ea precisa saber fazer<\/strong>.<\/p>\n\n\n\n

Quer obter mais informa\u00e7\u00f5es sobre como as agrega\u00e7\u00f5es autom\u00e1ticas podem ajudar a melhorar o desempenho das visualiza\u00e7\u00f5es de relat\u00f3rio? Consulte Vis\u00e3o Geral das Agrega\u00e7\u00f5es Autom\u00e1ticas na documenta\u00e7\u00e3o do produto.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

<\/p>\n\n\n\n

E quando as agrega\u00e7\u00f5es autom\u00e1ticas n\u00e3o funcionam?<\/h2>\n\n\n\n

Quando voc\u00ea habilita agrega\u00e7\u00f5es autom\u00e1ticas (auto aggs<\/strong>), voc\u00ea acaba sem agrega\u00e7\u00f5es e sem ganhos de desempenho correspondentes. Nessas situa\u00e7\u00f5es problem\u00e1ticas, pode ser \u00fatil ter mais controle sobre o processo do que sobre a interface do usu\u00e1rio fornece. O controle granular permite ajustar os aggs autom\u00e1ticos<\/strong>.<\/p>\n\n\n\n

Voc\u00ea pode excluir tabelas espec\u00edficas definindo um limite de tamanho m\u00ednimo abaixo do qual voc\u00ea n\u00e3o deseja gerar aggs autom\u00e1ticos. Ou talvez voc\u00ea queira testar o treinamento de auto-aggs com defini\u00e7\u00f5es de configura\u00e7\u00e3o diferentes e verificar se o Power BI realmente adicionou aggs autom\u00e1ticos ao seu conjunto de dados.<\/p>\n\n\n\n

O TOM (Tabular Object Model) <\/a>e o TMSL (Tabular Model Scripting Language) oferecem as op\u00e7\u00f5es avan\u00e7adas para cobrir esses cen\u00e1rios<\/strong>, conforme explicado neste artigo.<\/p>\n\n\n\n

Como desenvolvedores de BI podem utilizar aggs?<\/h2>\n\n\n\n

Se voc\u00ea for um desenvolvedor de BI e quiser seguir o aplicativo de console .NET Core<\/strong> usado neste artigo em seu pr\u00f3prio ambiente, consulte o c\u00f3digo de exemplo TOM anexado para obter detalhes<\/strong>.<\/p>\n\n\n\n

Certifique-se de usar as bibliotecas de cliente mais recentes do Analysis Services<\/strong> e hospedar seu conjunto de dados em uma capacidade Premium<\/strong> ou de malha com XMLA Leitura\/Grava\u00e7\u00e3o habilitada<\/strong>. Se voc\u00ea preferir trabalhar com TMSL<\/strong>, mantenha a instala\u00e7\u00e3o do SQL Server Management Studio (SSMS)<\/strong> na vers\u00e3o mais recente.<\/p>\n\n\n\n

Mas se voc\u00ea n\u00e3o for um desenvolvedor de BI, ainda poder\u00e1 achar \u00fatil a seguinte orienta\u00e7\u00e3o de solu\u00e7\u00e3o de problemas. Ent\u00e3o, vamos analisar rapidamente como as agrega\u00e7\u00f5es autom\u00e1ticas funcionam antes de nos aprofundarmos em v\u00e1rios cen\u00e1rios e trechos de c\u00f3digo.<\/p>\n\n\n\n

Para que o auto aggs funcione, voc\u00ea deve realizar as tr\u00eas tarefas essenciais a seguir:<\/h2>\n\n\n\n
    \n
  1. Gerar consultas DAX.<\/strong> Voc\u00ea precisa usar relat\u00f3rios ou outros meios para consultar seu conjunto de dados porque o processo de gera\u00e7\u00e3o de agrega\u00e7\u00f5es autom\u00e1ticas depende de um log de consulta que controla as consultas enviadas ao conjunto de dados ao longo de sete dias. Como ilustra o diagrama abaixo, o log de consultas serve como entrada para o treinamento de auto aggs. Ent\u00e3o, como um pr\u00e9-requisito para gerar auto aggs, certifique-se de semear o log de consulta!<\/li>\n\n\n\n
  2. Execute o treinamento de agrega\u00e7\u00f5es autom\u00e1ticas.<\/strong> O treinamento de aggs autom\u00e1tico \u00e9 o processo que gera as tabelas aggs gerenciadas pelo sistema no conjunto de dados. Esse processo analisa o log de consultas, bem como a cardinalidade e outras caracter\u00edsticas das colunas da tabela de origem. Esse processo normalmente \u00e9 executado no hor\u00e1rio de atualiza\u00e7\u00e3o do conjunto de dados durante a primeira atualiza\u00e7\u00e3o do dia, mas voc\u00ea tamb\u00e9m pode acionar o treinamento de auto-aggs manual e programaticamente.<\/li>\n\n\n\n
  3. Execute uma atualiza\u00e7\u00e3o de dados.<\/strong> Lembre-se de que o treinamento auto-aggs gera apenas as tabelas aggs e as adiciona ao conjunto de dados, mas n\u00e3o preenche essas tabelas com dados. Carregar os dados aggs \u00e9 o trabalho da atualiza\u00e7\u00e3o de dados, portanto, n\u00e3o se esque\u00e7a de atualizar seu conjunto de dados e configurar a atualiza\u00e7\u00e3o agendada para manter os dados aggs atualizados. S\u00f3 ent\u00e3o voc\u00ea ver\u00e1 uma melhoria de perf de consulta para tabelas DirectQuery qualificadas.<\/li>\n<\/ol>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    Resolvendo problemas no auto aggs do Power BI.<\/h2>\n\n\n\n

    Com o b\u00e1sico coberto, vamos agora mergulhar em um cen\u00e1rio comum de solu\u00e7\u00e3o de problemas: voc\u00ea habilitou o auto aggs, mas n\u00e3o percebe nenhum ganho de perf.<\/p>\n\n\n\n

    Nessa situa\u00e7\u00e3o, um bom primeiro passo \u00e9 verificar se voc\u00ea realmente tem tabelas aggs em seu conjunto de dados<\/strong>.<\/p>\n\n\n\n

    Talvez o Power BI n\u00e3o tenha gerado nenhum porqu\u00ea simplesmente n\u00e3o havia dados de entrada significativos no log de consulta, ou talvez o conjunto de dados ainda n\u00e3o tenha sido atualizado para que o treinamento nunca tenha sido executado, ou talvez o treinamento n\u00e3o tenha terminado dentro do limite de tempo de 1 hora, o que significa que o treinamento ainda n\u00e3o foi conclu\u00eddo e ser\u00e1 retomado no dia seguinte.<\/p>\n\n\n\n

    O treinamento de aggs autom\u00e1tico pode levar muito tempo, dependendo da velocidade com que a fonte de dados pode processar as consultas de cardinalidade e outras consultas que o Power BI gera durante a fase de treinamento<\/strong>. Seja qual for o motivo, se n\u00e3o houver tabelas aggs no conjunto de dados, suas consultas DAX n\u00e3o poder\u00e3o aproveitar agrega\u00e7\u00f5es, \u00e9 claro.<\/p>\n\n\n\n

    As tabelas Aggs s\u00e3o relativamente f\u00e1ceis de detectar no SSMS. Conecte-se ao seu espa\u00e7o de trabalho, expanda seu conjunto de dados DirectQuery<\/strong> e procure tabelas com GUIDs <\/strong>como seus nomes. A captura de tela a seguir mostra uma dessas tabelas aggs chamada b83b1a0c-5712-4f35-8d73-d1db0a0c6c33. Depois de criar scripts dessa tabela, voc\u00ea pode ver que ela \u00e9 uma tabela oculta gerenciada pelo sistema com uma fonte de parti\u00e7\u00e3o inferida.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    No c\u00f3digo gerenciado usando TOM<\/strong>, \u00e9 igualmente descomplicado verificar se h\u00e1 tabelas aggs. Consulte o trecho de c\u00f3digo a seguir. Como mencionado anteriormente, o c\u00f3digo de exemplo TOM est\u00e1 anexado a este artigo<\/a>.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Vamos continuar nossa jornada de solu\u00e7\u00e3o de problemas e assumir que o conjunto de dados ainda n\u00e3o tem tabelas auto-aggs. Uma pr\u00f3xima pergunta l\u00f3gica pode ser se os auto-aggs est\u00e3o habilitados. Agora, voc\u00ea pode ficar tentado a procurar configura\u00e7\u00f5es de auto-aggs no conjunto de dados.<\/p>\n\n\n\n

    Por exemplo, voc\u00ea pode verificar a propriedade AutomaticAggregationOptions <\/strong>do objeto Model<\/a>. No entanto, observe que o Power BI n\u00e3o armazena suas configura\u00e7\u00f5es de auto-aggs nos metadados do modelo. A captura de tela a seguir ilustra esse aspecto. O propriet\u00e1rio do conjunto de dados habilitou aggs autom\u00e1ticos no Power BI, mas n\u00e3o h\u00e1 AutomaticAggregationOptions <\/strong>no modelo. As configura\u00e7\u00f5es de auto-aggs que o Power BI usa s\u00f3 est\u00e3o dispon\u00edveis na p\u00e1gina de configura\u00e7\u00f5es do conjunto de dados.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Ent\u00e3o, qual \u00e9 a finalidade da propriedade AutomaticAggregationOptions <\/strong>se o Power BI n\u00e3o a usar? Sua finalidade \u00e9 armazenar uma configura\u00e7\u00e3o padr\u00e3o de auto-aggs que voc\u00ea pode aplicar programaticamente ao treinamento de auto-aggs usando o m\u00e9todo ApplyAutomaticAggregations<\/strong>. O Power BI n\u00e3o usa essa propriedade, mas solu\u00e7\u00f5es personalizadas podem.<\/p>\n\n\n\n

    Em vez de usar uma configura\u00e7\u00e3o padr\u00e3o de auto-aggs, voc\u00ea tamb\u00e9m pode fornecer um objeto AutomaticAggregationOptions <\/strong>expl\u00edcito como um par\u00e2metro de entrada para o m\u00e9todo ApplyAutomaticAggregations<\/strong>. Esse \u00e9 o m\u00e9todo que o Power BI usa para enviar suas pr\u00f3prias defini\u00e7\u00f5es de configura\u00e7\u00e3o. E este \u00e9 o m\u00e9todo que permite acionar f\u00e1cil e rapidamente o treinamento de auto-aggs com diferentes defini\u00e7\u00f5es de configura\u00e7\u00e3o tamb\u00e9m. O c\u00f3digo de trecho a seguir ilustra essa abordagem.<\/p>\n\n\n\n

    Consulte a classe AutomaticAggregationOptions<\/strong> na documenta\u00e7\u00e3o da API para obter detalhes sobre as propriedades com suporte, como QueryCoverage<\/strong>, DetailTableMinRows<\/strong> e AggregationTableSizeLimit<\/strong>.<\/p>\n\n\n\n

    \n
    \"\"<\/figure>\n<\/figure>\n\n\n\n

    Chamar o m\u00e9todo ApplyAutomaticAggregations<\/strong> acima \u00e9 tudo o que \u00e9 necess\u00e1rio para acionar o treinamento auto-aggs. Talvez o treino nunca tenha ocorrido antes. No entanto, n\u00e3o se esque\u00e7a da chamada de atualiza\u00e7\u00e3o do banco de dados para manter todas as tabelas aggs geradas no conjunto de dados.<\/p>\n\n\n\n

    Ainda assim, mesmo uma conclus\u00e3o bem-sucedida do m\u00e9todo ApplyAutomaticAggregations <\/strong>n\u00e3o \u00e9 garantia de que o treinamento auto-aggs realmente gerou tabelas aggs. Como mencionado v\u00e1rias vezes, o log de consulta pode estar vazio, ent\u00e3o o treinamento de auto-aggs apenas “com sucesso” descobre que n\u00e3o h\u00e1 aggs para gerar. Ou o treinamento auto-aggs levou mais de 1 hora. Nesse caso, voc\u00ea pode realizar o treinamento repetidamente at\u00e9 que ele termine. O treinamento \u00e9 incremental e retoma de onde o ciclo anterior parou.<\/p>\n\n\n\n

    Basta treinar, treinar, treinar e, quando o treinamento da aggs for finalmente conclu\u00eddo, executar uma \u00fanica opera\u00e7\u00e3o de atualiza\u00e7\u00e3o de dados.<\/p>\n\n\n\n

    No entanto, como voc\u00ea decide que o treinamento de aggs est\u00e1 conclu\u00eddo? Para isso, voc\u00ea deve capturar o status de treinamento gerado em um evento de rastreamento AutoAggsTraining \u2013 Progress Report End<\/strong>. Isso talvez seja mais facilmente realizado usando o SQL Profiler<\/strong>. Certifique-se de incluir pelo menos a classe de evento Progress Report End<\/strong> no rastreamento. O rastreamento a seguir inclui um evento AutoAggsTraining \u2013 Progress Report End<\/strong> com algumas informa\u00e7\u00f5es importantes:<\/p>\n\n\n\n