Instalar o Power BI Connector para usar modelos de consulta CQDInstall Power BI Connector to use CQD query templates

Antes de usar os modelos de consulta do Power BI (arquivos PBIX) para o CQD (Painel de Qualidade de Chamadas do Microsoft Teams), você precisará instalar o Conector do Power BI para Microsoft CQD, usando o arquivo MicrosoftCallQuality.pqx incluído no download.Before you can use the Power BI query templates (PBIX files) for Microsoft Teams Call Quality Dashboard (CQD), you'll need to install the Power BI Connector for Microsoft CQD, using the MicrosoftCallQuality.pqx file included in the download.

Leia Use o Power BI para analisar dados do CQD para o Teams para saber mais sobre esses modelos.Read Use Power BI to analyze CQD data for Teams to learn about these templates.

Certifique-se de ter a função de acesso CQD correta para acessar os relatórios do Power BI.Make sure you have the right CQD access role to access the Power BI reports.

Observação

O Conector do CQD Power BI só dá suporte ao DirectQuery no Power BI; O modo de importação não é suportado.The CQD Power BI Connector only supports DirectQuery in Power BI; Import mode is not supported.

InstalaçãoInstallation

O processo para instalar um conector personalizado e ajustar a segurança para habilitar o uso do conector é descrito em detalhes na documentação do Power BI.The process for installing a custom connector and adjusting security to enable use of the connector is described in detail in the Power BI documentation. Para simplificar, aqui está uma explicação rápida:For the sake of simplicity, here's a quick explanation:

  1. Verifique se o computador já tem uma pasta [ Conectores ] \ \ Personalizados da Área de Trabalho do Power BI.Check to see if your computer already has a [Documents]\Power BI Desktop\Custom Connectors folder. Caso não seja, crie essa pasta. 1If not, create this folder.1

  2. Baixe o arquivo do conector (um * arquivo .mez ou * .pqx) e coloque-o no diretório Conectores Personalizados.Download the connector file (either a *.mez or *.pqx file) and place it in the Custom Connectors directory.

  3. Se o arquivo do conector for * um arquivo .mez, você também precisará ajustar suas configurações de segurança, conforme descrito na documentação de instalação do conector personalizado.If the connector file is a *.mez file, you will also need to adjust your security settings as described in the custom connector setup documentation.

Se uma nova versão desse Conector do Power BI para o Microsoft Teams for lançada, basta substituir o arquivo do conector antigo no diretório Conectores Personalizados pelo novo arquivo.If a new version of this Power BI Connector for Microsoft Teams is released, simply replace the old connector file in the Custom Connectors directory with the new file.

InstalaçãoSetup

Para criar um relatório e executar consultas, primeiro você precisará se conectar à fonte de dados CQD.In order to build a report and run queries, you will first need to connect to the CQD data source. Siga as etapas abaixo para se conectar:Follow the steps below in order to connect:

  1. Na guia Página Base da Área de Trabalho do Power BI, clique em Obter Dados.In the Home tab of Power BI Desktop, click on Get Data.

    Captura de tela: Conector do Power BI

  2. A janela Obter Dados deve aparecer neste ponto.The Get Data window should appear at this point. Navegue até Serviços Online, selecione Qualidade de Chamada da Microsoft (Beta) e clique em Conectar.Navigate to Online Services, then select Microsoft Call Quality (Beta) and hit Connect.

    Captura de tela: Conector do Power BI

  3. Você será solicitado a entrar em seguida.You will be prompted to sign in next. Use as mesmas credenciais que você usa para CQD. 2Use the same credentials that you use for CQD.2

  4. O próximo prompt dará a opção entre dois modos de Conectividade de Dados.The next prompt will give you the option between two Data Connectivity modes. Selecione DirectQuery e clique em OK.Select DirectQuery and hit OK.

  5. Por fim, você receberá um prompt final mostrando todo o modelo de dados para CQD.Finally, you will be given a final prompt showing you the entire data model for CQD. Nenhum dado será visível neste ponto, apenas o modelo de dados para CQD.No data will be visible at this point, only the data model for CQD. Selecione Carregar para concluir o processo de instalação.Select Load to complete the setup process.

  6. Neste ponto, o Power BI carregará o modelo de dados no lado direito da janela.At this point, Power BI will load the data model onto the right side of the window. A página permanecerá em branco, e nenhuma consulta será carregada por padrão.The page will remain otherwise blank, and no queries will be loaded by default. Prossiga para a criação de consultas abaixo para criar uma consulta e retornar dados.Proceed to Building Queries below in order to build a query and return data.

Se qualquer uma das etapas durante esse processo de instalação não tiver sido completamente clara, uma explicação mais detalhada sobre o processo poderá ser encontrada em Início Rápido: Conectar-se aos dados na Área de Trabalho do Power BI.If any of the steps during this setup process were not completely clear, a more detailed explanation of the process can be found in Quickstart: Connect to data in Power BI Desktop.

Criando consultasBuilding Queries

Depois que a instalação for concluída, você deverá ver os nomes de várias centenas de dimensões e medidas carregadas no painel Campos.Once setup is complete, you should see the names of several hundred dimensions and measures load in the Fields pane. A construção de consultas reais a partir daqui é simples, basta selecionar as dimensões e medidas que você deseja para sua consulta e arraste e solte-as na página.Constructing actual queries from here is simple, just select the dimensions and measures you want for your query, then drag and drop them onto the page. Aqui está uma explicação mais detalhada, com um exemplo simples:Here's a more detailed explanation, with a simple example:

  1. Selecione a visualização que você deseja usar no painel Visualizações.Select the visualization you want to use from the Visualizations pane. Uma versão em branco dessa visualização deve aparecer na página.A blank version of that visualization should appear on the page. Para os fins deste exemplo, vamos usar a visualização tabela.For the purposes of this example, we will be using the Table visualization.

    Captura de tela: Conector do Power BI

  2. Determine quais dimensões e medidas (denotadas por um símbolo de agregação pelo nome) que você deseja usar para sua consulta e selecione-as manualmente e arraste-as para a visualização em preto.Determine which dimensions and measures (denoted by an aggregation symbol by their name) you wish to use for your query, then manually select them and drag them onto the black visualization. Como alternativa, arraste-os para o campo Valores abaixo das opções de visualização.Alternately, drag them onto the Values field beneath the visualization options.

    Captura de tela: Conector do Power BI

    Importante

    O Painel de Qualidade de Chamada requer uma medida para que qualquer consulta seja executado.Call Quality Dashboard requires a measure for any query to run. A falha ao adicionar uma medida a uma consulta fará com que essa consulta falhe.Failure to add a measure to a query will cause that query to fail.

  3. Em seguida, selecione as dimensões que você deseja filtrar e arraste-as para o Filtros neste campo visual no painel Filtros.Next, select any dimensions you want to filter on and drag them to the Filters on this visual field in the Filters pane. O CQD Power BI Connector atualmente dá suporte à filtragem básica (selecione valores de uma lista de valores de dimensão possíveis), filtragem avançada (especificar manualmente valores e operands para filtrar, semelhante ao CQD avançado) e filtragem de data relativa (disponível apenas para as dimensões Hora de Término e Hora de Início). The CQD Power BI Connector currently supports Basic filtering (select values from a list of possible dimension values), Advanced filtering (manually specify values and operands to filter on, similar to Advanced CQD), and Relative date filtering (only available for the End Time and Start Time dimensions). A filtragem de acordo com o Top N não é suportada pelo CQD.Filtering according to Top N is not supported by CQD.

    Captura de tela: Conector do Power BI

  4. Por fim, selecione a guia Formatar no painel Visualizações para estilizar e formatar sua consulta.Finally, select the Format tab within the Visualizations pane to style and format your query.

    Observação

    As consultas CQD exigem pelo menos uma medida para ser executado.CQD queries require at least one measure in order to run. Se a consulta não for carregada, verifique duas vezes se você incluiu uma medida na consulta.If your query does not load, double check that you have included a measure in the query.

Criando um relatório passo a passoCreating a Drillthrough Report

O drillthrough no Power BI permite que você crie relatórios focados que você pode filtrar rapidamente usando os valores de outros relatórios como contexto.Drillthrough in Power BI allows you to create focused reports that you can quickly filter using the values of other reports as context. Depois de saber como criar sua primeira consulta com o Conector CQD, criar um drillthrough é ainda mais simples.Once you know how to create your first query with the CQD Connector, creating a drillthrough is even simpler.

  1. Crie outra página para o relatório focado e adicione suas consultas a essa página.Create another page for the focused report, and then add your queries to that page.

  2. Selecione a dimensão que você deseja usar como um filtro passo a passo e arraste-os para o campo Drillthrough no painel Visualizações.Select the dimension you want to use as a drillthrough filter and drag them onto the Drillthrough field under on the Visualizations pane.

    Captura de tela: Conector do Power BI

  3. É isso.!That's it! Qualquer outra consulta em outra página que use essa dimensão agora pode ser passo a passo nessa página, aplicando automaticamente o valor da dimensão drillthrough como um filtro.Any other query on another page that uses that dimension can now drillthrough to that page, automatically applying the drillthrough dimension's value as a filter.

    Captura de tela: Conector do Power BI

Ao contrário do CQD avançado, o Power BI oferece suporte a drillthrough não sequencial.Unlike Advanced CQD, Power BI supports non-sequential drillthrough. Desde que uma consulta inclua a dimensão necessária, ela pode ser passo a passo para qualquer outra página.So long as a query includes the necessary dimension, it can drillthrough to any other page.

Prática prática práticaBest practice

As consultas do conector de qualidade de chamada devem ser projetadas com a funcionalidade drillthrough em mente.Call Quality connector queries should be designed with drillthrough functionality in mind. Em vez de tentar carregar todos os dados de uma só vez e cortar com filtros, comece com consultas mais amplas e de baixa cardinalidade e faça uma pesquisa até consultas de alta cardinalidade.Instead of trying to load all the data at once, and then slicing down with filters, start with broader, low-cardinality queries and drill down to high-cardinality queries. Por exemplo, ao tentar diagnosticar quais sub-redes contribuem mais para problemas de qualidade, é útil primeiro identificar essas regiões e países que contribuem para o problema e, em seguida, detalhar as sub-redes nessa região ou país.For instance, when attempting to diagnose which subnets contribute most to quality issues, it's helpful to first identify those regions and countries which contribute to the problem, then drill down to the subnets in that region or country. Os modelos de conector de Qualidade de Chamada foram projetados dessa maneira para atuar como um exemplo.The Call Quality connector templates have been designed in this manner in order to act as an example.

LimitaçõesLimitations

Apesar de usar o Power BI, nem todas as funcionalidades do Power BI são compatíveis com o Conector CQD, seja como resultado de limitações no modelo de dados CQD ou em conectores DirectQuery em geral.Despite making use of Power BI, not all Power BI functionality is support by the CQD Connector, either as a result of limitations on CQD data model or on DirectQuery connectors in general. A lista abaixo observa algumas das limitações mais notáveis do Conector, mas essa lista não deve ser considerada exaustiva:The list below notes some of the Connector's more noteworthy limitations, but this list should not be considered exhaustive:

  1. Colunas Calculadas – Os conectores do DirectQuery em geral têm suporte limitado para colunas calculadas no Power BI.Calculated Columns – DirectQuery connectors in general have limited support for calculated columns in Power BI. Embora algumas colunas calculadas possam funcionar com o Conector, elas devem ser consideradas exceções.While some calculated columns may work with the Connector, these should be considered exceptions. Como regra geral, as colunas calculadas não funcionarão.As a general rule, calculated columns will not function.

  2. Agregaçãos – O modelo de dados CQD é criado em um modelo de cubo, o que significa que as agregação já têm suporte na forma de medidas.Aggregations – The CQD data model is built on a cube model, meaning that aggregations are already supported in the form of measures. A tentativa de adicionar agregação manualmente a dimensões diferentes ou alterar o tipo de agregação de uma medida não funcionará com o Conector, e isso geralmente resultará em um erro.Attempting to manually add aggregations to different dimensions or changing the aggregation type of a measure will not work with the Connector, and it will generally result in an error.

  3. Elementos visuais personalizados – Embora o Conector CQD funcione com uma variedade de elementos visuais personalizados, não é possível garantir a compatibilidade com todos os elementos visuais personalizados.Custom Visuals – While the CQD Connector does work with a range of custom visuals, we are unable to guarantee compatibility with all custom visuals. Muitos elementos visuais personalizados dependem do uso de colunas calculadas ou dados importados, nem que são suportados por conectores do DirectQuery.Many custom visuals rely on the use of calculated columns or imported data, neither or which are supported by DirectQuery connectors.

  4. Fazendo referência a dados armazenados em cache – No momento, o Power BI não dá suporte a fazer referência a dados armazenados em cache de um conector DirectQuery de qualquer maneira.Referencing Cached Data – Power BI currently does not support referencing cached data from a DirectQuery connector in any way. Qualquer tentativa de referenciar os resultados de uma consulta resultará em uma nova consulta.Any attempt to reference the results of a query will result in a new query.

  5. Filtragem de Dados Relativos – Tem suporte no Conector CQD, mas somente com as dimensões Hora de Início e Hora de Término.Relative Data Filtering – Is supported in the CQD Connector, but only with the Start Time and End Time dimensions. Embora a dimensão Date possa ser a escolha óbvia para filtragem de data relativa, Date não é armazenada como um objeto de data e, portanto, não dá suporte à filtragem de data relativa no Power BI.Although the Date dimension may be the obvious choice for relative date filtering, Date is not stored as a date time object and thus does not support relative date filtering in Power BI.

  6. Suporte à Nuvem da Comunidade Governamental (GCC) – Para clientes no ambiente GCC, o Conector do CQD Power BI funcionará ao usar a Área de Trabalho do Power BI.Government Community Cloud (GCC) Support – For customers in the GCC environment, the CQD Power BI Connector will work when using Power BI Desktop. O conector do CQD Power BI atualmente não é compatível com o serviço Power BI para clientes GCC.The CQD Power BI connector is not presently compatible with the Power BI service for GCC customers.

A maioria desses problemas são restrições ao design do conector DirectQuery no Power BI ou fundamentais para o design do modelo de dados CQD.Most of these issues are either restrictions to DirectQuery connector design in Power BI or fundamental to the design of the CQD data model.

Solução de problemasTroubleshooting

Estou tentando usar a coluna Data como uma slicer Date.I'm trying to use the Date column as a Date slicer. Assim que eu converter o tipo de dados dessa coluna em Data, eu receber esse erroAs soon as I convert the data type of this column to Date, I get this error

Não foi necessário carregar os dados para este visual : erro OLE DB ou ODBC: [Expressão.Erro] Não foi foi conseguida dobrável a expressão para a fonte de dados.Couldn't load the data for this visual: OLE DB or ODBC error: [Expression.Error] We couldn't fold the expression to the data source. Tente uma expressão mais simples.Please try a simpler expression.

As slicers de data não são suportadas com o Power BI Connector.Date slicers aren't supported with the Power BI Connector. Para especificar um intervalo de datas, aplique dois filtros ao relatório, especificando uma data menor do que e maior do que a data.To specify a date range, apply two filters to the report, specifying a less than and greater than date.

Como alternativa, se as datas que você deseja exibir são recentes, aplique um filtro de data relativa para mostrar apenas os dados dos últimos N dias/semanas/meses.Alternatively, if the dates you want to view are recent, apply a relative date filter to show only data for the last N days/weeks/months.

Códigos de erroError Codes

Como o Conector do CQD Power BI é menos restrito do que o aplicativo do navegador em termos de tipos de consultas que você pode construir, você pode ocasionalmente encontrar vários erros ao criar suas consultas.Because the CQD Power BI Connector is less restricted than the browser app in terms of kinds of queries you can construct, you may occasionally encounter a number of errors while building your queries. Caso você receba uma mensagem de erro do tipo "CQDError.In the event that you receive an error message of the type "CQDError. RunQuery – Erro de Execução de Consulta", consulte a lista abaixo com o número ErrorType fornecido para solucionar o possível problema com a consulta.RunQuery – Query Execution Error", reference the list below with the ErrorType number provided in order to troubleshoot the possible issue with the query. Veja a seguir os códigos de Tipo de Erro mais comuns que você pode encontrar com o Conector do Power BI do CQD:The following are the most common Error Type codes you may encounter with the CQD Power BI Connector:

  • ErrorType 1 - Erro de Estrutura de Consulta: Um erro de estrutura de consulta geralmente é causado pela falha do Conector ao criar uma consulta formatada corretamente.ErrorType 1 - Query Structure Error: A query structure error is typically caused by the Connector failing to build a properly formatted query. Isso acontece com mais frequência ao usar a funcionalidade sem suporte, conforme especificado nas Limitações acima.This happens most often when using unsupported functionality, as specified in the Limitations above. Verifique duas vezes se você não está usando colunas calculadas ou elementos visuais personalizados para essa consulta.Double check that you are not using any calculated columns or custom visuals for that query.

    • ErrorType 2 - Erro de construção de consulta: Um erro de construção de consulta é causado pelo conector CQD não poder analisar corretamente a consulta que você está tentando criar.ErrorType 2 - Query Building Error: A query building error is caused by the CQD Connector being unable to properly parse the query you are attempting to build. Isso acontece com mais frequência ao usar a funcionalidade sem suporte, conforme especificado nas Limitações acima.This happens most often when using unsupported functionality, as specified in the Limitations above. Verifique duas vezes se você não está usando colunas calculadas ou elementos visuais personalizados para essa consulta.Double check that you are not using any calculated columns or custom visuals for that query.

    • ErrorType 5 - Tempo de execução: A consulta atingiu o tempo de execução máximo possível antes do tempo limite. Tente adicionar mais filtros à consulta para limitar seu escopo.ErrorType 5 - Execution Timeout: The query has reached the maximum possible runtime before timing out. Try adding more filters to the query in order to limit its scope. Restringir o intervalo de dados geralmente é a maneira mais eficaz de fazer isso.Narrowing the data range is often the most effective way to achieve this.

    • ErrorType 7 - Nenhum erro de medição: As consultas CQD exigem uma medida para funcionar.ErrorType 7 - No Measurements Error: CQD queries require a measure in order to function. Verifique se sua consulta inclui medida.Double check that your query includes measure. As medidas no Conector CQD são anotadas pelo símbolo de agregação (soma) antes de seu nome.Measures in the CQD Connector are denoted by the aggregation (sum) symbol before their name.

Se você encontrar erros adicionais fora desse escopo, notifique a equipe do CQD para que possamos ajudar a solucionar o problema e atualizar a documentação conforme apropriado.If you encounter any additional errors outside of this scope, please notify the CQD team so that we can help troubleshoot the issue and update the documentation as appropriate.

Notas de rodapéFootnotes

1 Determinados processos e aplicativos (por exemplo, OneDrive) podem fazer com que a pasta raiz documentos seja mudada; certifique-se de que o diretório Conectores \ Personalizados da Área de Trabalho do Power BI seja colocado dentro da pasta raiz atual Documentos.1 Certain processes and apps (e.g., OneDrive) may cause your Documents root folder to change; make sure that the Power BI Desktop\Custom Connectors directory is placed inside of the current root folder Documents folder.

2 As credenciais de logon que você usa para o CQD não precisam ser as mesmas que você usa para fazer logon no próprio aplicativo da Área de Trabalho do Power BI.2 The login credentials you use for CQD do not need to be the same credentials you use for logging into the Power BI Desktop app itself.

Perguntas frequentesFrequently asked questions

Quando o Conector do Power BI será atualizado a partir do status "Beta"When will the Power BI Connector be updated from "Beta" status

Apesar da marca Beta, o Conector de Qualidade de Chamada para Power BI é a versão de lançamento do conector e foi oficialmente assinado pela equipe do Power BI para refletir isso.Despite the Beta tag, the Call Quality Connector for Power BI is the release version of the connector and has been officially security signed by the Power BI team to reflect this. O processo de certificação para remover essa marca Beta é abrangente e requer um compromisso da equipe do Power BI para fornecer suporte direto ao conector também.The certification process to remove that Beta tag is an extensive one and requires a commitment from the Power BI team to provide direct support to the connector as well. Devido às restrições de tempo, a equipe do Power BI não consegue fornecer esse suporte e uma certificação mais ampla, mas ainda está preparada para atestar a segurança, a autenticidade e a funcionalidade geral do conector de Qualidade de Chamada da Microsoft.Due to time constraints, the Power BI team is currently unable to provide that support and broader certification, but is still prepared to attest to the security, authenticity, and general functionality of the Microsoft Call Quality connector.

Por que o conector parece mais lento em comparação com o CQD avançado no navegador?Why does the connector seem slower compared to Advanced CQD in the browser? O que posso fazer para melhorar o desempenhoWhat can I do to improve performance

O desempenho da consulta para os vários modelos é, na verdade, o mesmo no navegador e no conector.Query performance for the various templates is actually the same in both the browser and in the connector. Assim como qualquer outro aplicativo autônomo, o Power BI adiciona seu tempo de autenticação e renderização ao nosso desempenho.Just like any other standalone app, Power BI adds its authentication and rendering time to our performance. Além disso, a diferença vem no número de consultas simultâneas sendo executados.In addition, the difference comes in the number of concurrent queries being run. Como a versão no navegador do CQD tinha opções de visualização menos desenvolvidas e densas de informações, a maioria dos nossos relatórios estava limitada ao carregamento de consultas de 2 a 3 por vez.Because the in-browser version of CQD had less well-developed and information-dense visualization options, most of our reports were limited to loading 2-3 queries at a time. Por outro lado, os modelos de conector geralmente exibem mais de 20 consultas simultâneas.On the other hand, the connector templates often display 20+ concurrent queries. Se você deseja criar relatórios que sejam tão responsivos quanto os mais antigos aos quais você estava acostumado, tente criar relatórios com no máximo 2 a 3 consultas por guia.If you wish to build reports that are just as responsive as the older ones you were used to, try creating reports with no more than 2-3 queries per tab.

Para obter mais informações, consulte os seguintes artigos:For more information, see the following articles:

Eu acho que eu corro rotineiramente para o limite de 10.000 linhas ao executar consultas.I find that I routinely run into the 10,000-row limit when running queries. Como fazer com que o conector retorne mais de 10.000 linhasHow can I get the connector to return more than 10,000 rows

O limite de 10.000 linhas é realmente especificado no final da API e foi projetado para ajudar a melhorar significativamente o desempenho e reduzir o risco de erros de execução de consulta resultantes de condições de memória baixa.The 10,000-row limit is actually specified on the API end, and it is designed to help significantly improve performance and reduce the risk of query execution errors resulting from low memory conditions.

Em vez de tentar aumentar a contagem de linhas de resultados, é melhor reestruturar seus relatórios de acordo com as práticas recomendadas do conector.Instead of attempting to increase the result row count, it is best to restructure your reports according to connector best practices. Os modelos que incluímos foram projetados para demonstrar essas práticas recomendadas.The templates we have included are designed to demonstrate these best practices. Sempre que possível, comece olhando para seus KPIs usando dimensões mais amplas e de menor cardinalidade, como Mês, Ano, Data, Região, País, etc. A partir daí, você pode detalhar as dimensões cada vez mais elevadas.Where possible, start by looking at your KPIs using broader, lower-cardinality dimensions, such as Month, Year, Date, Region, Country, etc. From there, you can drill down into increasingly higher-cardinality dimensions. O Helpdesk e Location-Enhanced relatórios fornecem bons exemplos desse fluxo de trabalho de detalhamento.The Helpdesk and Location-Enhanced Reports both provide good examples of this drill down workflow.

Usar o Power BI para analisar dados CQD para o TeamsUse Power BI to analyze CQD data for Teams