Установка соединителя Power BI для использования шаблонов запросов CQDInstall Power BI Connector to use CQD query templates

Прежде чем использовать шаблоны запросов Power BI (PBIX-файлы) для панели мониторинга качества звонков Microsoft Teams (CQD), вам потребуется установить соединитель Power BI для Microsoft CQD с помощью файла MicrosoftCallQuality. PQx , включенного в файл для скачивания.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.

Читайте в статье Power BI, чтобы проанализировать CQD данные для Teams , чтобы узнать об этих шаблонах.Read Use Power BI to analyze CQD data for Teams to learn about these templates.

Убедитесь в том, что у вас есть права доступа CQD для доступа к отчетам Power BI.Make sure you have the right CQD access role to access the Power BI reports.

УстановкаInstallation

Процесс установки настраиваемого соединителя и настройки безопасности для включения использования соединителя подробно описан в документации по 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. Вот краткое описание простоты:For the sake of simplicity, here's a quick explanation:

  1. Убедитесь, что на вашем компьютере уже есть папка " * [ документы" ] \ \ настраиваемых соединителей Power BI для настольных систем*   .Check to see if your computer already has a [Documents]\Power BI Desktop\Custom Connectors folder. В противном случае создайте эту папку. 1If not, create this folder.1

  2. Скачайте файл соединителя (файл с * * расширением MEZ* или * * PQx* ) и поместите его в каталог Custom Connectors .Download the connector file (either a *.mez or *.pqx file) and place it in the Custom Connectors directory.

  3. Если файл соединителя является файлом * * . MEZ ,* вам также потребуется настроить параметры безопасности, как описано в документации по настройке настраиваемого соединителя.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.

Если вы выпускает новую версию этого соединителя Power BI для Microsoft Teams, просто замените старый файл соединителя в каталоге Custom Connectors новым файлом.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.

УстановкаSetup

Для создания отчета и выполнения запросов сначала необходимо подключиться к источнику данных CQD.In order to build a report and run queries, you will first need to connect to the CQD data source. Выполните указанные ниже действия, чтобы выполнить подключение.Follow the steps below in order to connect:

  1. На вкладке Главная на рабочем столе Power BI нажмите кнопку получить данные.In the Home tab of Power BI Desktop, click on Get Data.

    Снимок экрана: соединитель Power BI

  2. На этом этапе появится окно " Получение данных ".The Get Data window should appear at this point. Перейдите к веб-службам, а затем выберите качество связи Майкрософт (Beta) и нажмите кнопку Подключиться.Navigate to Online Services, then select Microsoft Call Quality (Beta) and hit Connect.

    Снимок экрана: соединитель Power BI

  3. Вам будет предложено войти далее.You will be prompted to login next. Используйте те же учетные данные, которые вы используете для CQD. 2Use the same credentials that you use for CQD.2

  4. В следующем запросе вы сможете выбрать два режима подключения к данным.The next prompt will give you the option between two Data Connectivity modes. Выберите DirectQuery и нажмите ОК.Select DirectQuery and hit OK.

  5. Наконец, вам будет предложено выполнить Последнее предложение, показывающее всю модель данных для CQD.Finally, you will be given a final prompt showing you the entire data model for CQD. На этом этапе данные не будут видны, а только модель данных для CQD.No data will be visible at this point, only the data model for CQD. Нажмите кнопку загрузить , чтобы завершить процесс настройки.Select Load to complete the setup process.

  6. На этом этапе Power BI загрузит модель данных в правой части окна.At this point, Power BI will load the data model onto the right side of the window. Страница останется пустой, и никакие запросы не будут загружаться по умолчанию.The page will remain otherwise blank, and no queries will be loaded by default. Чтобы создать запрос и вернуть данные, перейдите к созданию запросов ниже.Proceed to Building Queries below in order to build a query and return data.

Если какие-либо из действий, описанных в этом процессе настройки, не были полностью очищены, вы можете найти болееподробное описание процесса.If any of the steps during this setup process were not completely clear, a more detailed explanation of the process can be found here.

Создание запросовBuilding Queries

После завершения установки на панели поля должны отобразиться названия нескольких сотен измерений и показателей нагрузки.Once setup is complete, you should see the names of several hundred dimensions and measures load in the Fields pane. Создание реальных запросов с помощью этой функции очень просто: выберите нужные размеры и меры для запроса, а затем перетащите их на страницу.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. Ниже приведено более подробное описание, а вот простой пример.Here's a more detailed explanation, with a simple example:

  1. Выберите визуализацию, которую вы хотите использовать, в области зрительных образов .Select the visualization you want to use from the Visualizations pane. На странице должна появиться пустая версия этого зрительного образа.A blank version of that visualization should appear on the page. Для целей этого примера мы будем использовать визуализацию таблицы .For the purposes of this example, we will be using the Table visualization.

    Снимок экрана: соединитель Power BI

  2. Определите, какие измерения и меры (обозначенные символом агрегирования по имени), которые вы хотите использовать для запроса, выбери их вручную и перетащите их на черную визуализацию.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. Кроме того, перетащите их в поле значения под параметрами зрительных образов.Alternately, drag them onto the Values field beneath the visualization options.

    Снимок экрана: соединитель Power BI

    Важно!

    Для выполнения запроса на панели мониторинга качества звонков требуется мера.Call Quality Dashboard requires a measure for any query to run. Ошибка при добавлении меры в запрос приведет к сбою запроса.Failure to add a measure to a query will cause that query to fail.

  3. Затем выберите измерения, по которым вы хотите отфильтровать, и перетащите их в фильтры для этого визуального поля в области фильтров .Next, select any dimensions you want to filter on and drag them to the Filters on this visual field in the Filters pane. Соединитель Power BI CQD в настоящее время поддерживает базовую фильтрацию (выбирайте значения из списка возможных значений измерения), расширенную фильтрацию (вручную указывайте значения и операнды для фильтрации, как в расширенном CQD) и относительную фильтрацию по дате (только для измерений время окончания и начала ).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). Фильтрация в соответствии с Top N не поддерживается CQD.Filtering according to Top N is not supported by CQD.

    Снимок экрана: соединитель Power BI

  4. Наконец, выберите вкладку Формат в области зрительные образы для стиля и форматирования запроса.Finally, select the Format tab within the Visualizations pane to style and format your query.

    Примечание

    Для выполнения запросов CQD требуется хотя бы одна мера.CQD queries require at least one measure in order to run. Если запрос не загружается, дважды убедитесь, что вы включили в запрос меру.If your query does not load, double check that you have included a measure in the query.

Создание детализированного отчетаCreating a Drillthrough Report

Детализация в Power BI позволяет создавать отсортированные отчеты, которые можно быстро отфильтровать с использованием значений других отчетов в качестве контекста.Drillthrough in Power BI allows you to create focused reports that you can quickly filter using the values of other reports as context. После того как вы знаете, как создать первый запрос с помощью соединителя CQD, создание детализации стало еще проще.Once you know how to create your first query with the CQD Connector, creating a drillthrough is even simpler.

  1. Создайте другую страницу для отчета с фокусом, а затем добавьте на эту страницу запросы.Create another page for the focused report, and then add your queries to that page.

  2. Выберите измерение, которое вы хотите использовать в качестве фильтра детализации, и перетащите его в поле Детализация в области зрительные образы .Select the dimension you want to use as a drillthrough filter and drag them onto the Drillthrough field under on the Visualizations pane.

    Снимок экрана: соединитель Power BI

  3. Ну вот!That's it! Любой другой запрос на другой странице, использующий это измерение, теперь может иметь детализацию на эту страницу, автоматически применяя значение измерения детализации в качестве фильтра.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.

    Снимок экрана: соединитель Power BI

В отличие от Advanced CQD, Power BI поддерживает непоследовательную детализацию.Unlike Advanced CQD, Power BI supports non-sequential drillthrough. Пока запрос содержит необходимое измерение, оно может быть детализировано до любой другой страницы.So long as a query includes the necessary dimension, it can drillthrough to any other page.

Практические рекомендацииBest practice

Запросы на соединитель качества звонков должны быть спроектированы с учетом функциональных возможностей детализации.Call Quality connector queries should be designed with drillthrough functionality in mind. Вместо того, чтобы загружать сразу все данные, а затем разбить их на части с помощью фильтров, начните с запросов с большим количеством элементов, а также детализировать запросы с большим количеством запросов.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. Например, при попытке выявить подсети, которые применяют наиболее высокое качество, полезно сначала определить регионы и страны, которые применяют проблему, а затем перейти к подсетям в этой стране или регионе.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. Шаблон соединителя качества звонков разработан таким образом, чтобы действовать как пример.The Call Quality connector templates have been designed in this manner in order to act as an example.

ПределLimitations

Несмотря на использование Power BI, не все функции Power BI поддерживаются соединителем CQD в результате ограничений на модель данных CQD или соединители DirectQuery в целом.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. В списке ниже описаны некоторые более заметные ограничения для соединителя, но этот список не должен считаться исчерпывающим:The list below notes some of the Connector's more noteworthy limitations, but this list should not be considered exhaustive:

  1. Вычисляемые столбцы — Соединители DirectQuery в общем имеют ограниченную поддержку для вычисляемых столбцов в Power BI.Calculated Columns – DirectQuery connectors in general have limited support for calculated columns in Power BI. Хотя некоторые вычисляемые столбцы могут работать с соединительной линией, они должны считаться исключениями.While some calculated columns may work with the Connector, these should be considered exceptions. В качестве общего правила вычисляемые столбцы не будут работать.As a general rule, calculated columns will not function.

  2. Агрегаты — Модель данных CQD строится на основе модели Куба, то есть агрегаты уже поддерживаются в форме мер.Aggregations – The CQD data model is built on a cube model, meaning that aggregations are already supported in the form of measures. При попытке вручную добавить агрегаты в различные измерения или изменить тип статистической обработки для меры не будет работать с соединительной линией, а обычно это приведет к ошибке.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. Пользовательские визуальные элементы: Несмотря на то, что соединитель CQD работает с диапазоном настраиваемых визуальных элементов, мы не можем гарантировать совместимость со всеми пользовательскими визуальными элементами.Custom Visuals – While the CQD Connector does work with a range of custom visuals, we are unable to guarantee compatibility with all custom visuals. Многие пользовательские визуальные элементы основываются на использовании вычисляемых столбцов или импортированных данных, которые не поддерживаются соединителями DirectQuery.Many custom visuals rely on the use of calculated columns or imported data, neither or which are supported by DirectQuery connectors.

  4. Обращение к кэшированным данным — Power BI в настоящее время не поддерживает ссылки на кэшированные данные из соединительной линии DirectQuery каким-либо способом.Referencing Cached Data – Power BI currently does not support referencing cached data from a DirectQuery connector in any way. Любая попытка сослаться на результаты запроса будет приводить к новому запросу.Any attempt to reference the results of a query will result in a new query.

  5. Фильтрация относительных данных — Поддерживается в соединителе CQD, но только с измерениями " время начала " и " время окончания ".Relative Data Filtering – Is supported in the CQD Connector, but only with the Start Time and End Time dimensions. Несмотря на то, что измерение дат может быть очевидным вариантом относительной фильтрации по дате, Дата не сохраняется как объект даты и времени, поэтому не поддерживает относительную фильтрацию по дате в 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. Поддержка облачных сообществ для государственных организаций (GCC) – Для пользователей в среде GCC соединитель Power BI CQD будет работать при использовании Power BI Desktop.Government Community Cloud (GCC) Support – For customers in the GCC environment, the CQD Power BI Connector will work when using Power BI Desktop. Соединитель Power BI CQD в настоящее время не совместим с службой Power BI для пользователей GCC.The CQD Power BI connector is not currently compatible with the Power BI service for GCC customers.

Большинство из этих проблем являются ограничениями проектирования соединителей DirectQuery в Power BI или основы для разработки модели данных 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.

Устранение неполадокTroubleshooting

Я пытаюсь использовать столбец "Дата" в качестве среза даты.I'm trying to use the Date column as a Date slicer. После преобразования типа данных этого столбца в дату появляется это сообщение об ошибкеAs soon as I convert the data type of this column to Date, I get this error

Не удалось загрузить данные для этого визуальногоэлемента: OLE DB или ODBC Error: [expression. Error] нам не удалось сложить это выражение с источником данных.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. Пожалуйста, попробуйте более простое выражение.Please try a simpler expression.

Срезы дат не поддерживаются с помощью соединителя Power BI.Date slicers aren't supported with the Power BI Connector. Чтобы задать диапазон дат, примените к отчету два фильтра, указав значение меньше или больше даты.To specify a date range, apply two filters to the report, specifying a less than and greater than date.

Кроме того, если вы хотите просмотреть последние даты, примените относительный фильтр по дате, чтобы отобразить только данные за последние N дней/недель/месяцев.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.

Коды ошибокError Codes

Поскольку соединитель Power BI CQD менее ограничен, чем приложение браузера, в том числе типов запросов, которые вы можете конструировать, при построении запросов может возникнуть ряд ошибок.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. В том случае, если вы получаете сообщение об ошибке с типом "CQDError.In the event that you receive an error message of the type "CQDError. RunQuery — ошибка выполнения запроса. для устранения возможной проблемы с запросом щелкните приведенный ниже список, чтобы указать номер ErrorType.RunQuery – Query Execution Error", reference the list below with the ErrorType number provided in order to troubleshoot the possible issue with the query. Ниже перечислены наиболее распространенные коды ошибок, которые могут возникать при использовании соединителя Power BI CQD:The following are the most common Error Type codes you may encounter with the CQD Power BI Connector:

  • ErrorType 1 — ошибка в структуре запроса: Ошибка структуры запроса обычно возникает из-за того, что соединитель не завершил создание правильно отформатированного запроса.ErrorType 1 - Query Structure Error: A query structure error is typically caused by the Connector failing to build a properly formatted query. Это происходит чаще всего при использовании неподдерживаемой функции, как указано в описанных выше ограничениях.This happens most often when using unsupported functionality, as specified in the Limitations above. Убедитесь, что вы не используете вычисляемые столбцы или пользовательские визуальные элементы для этого запроса.Double check that you are not using any calculated columns or custom visuals for that query.

    • ErrorType 2 — ошибка построения запроса: Ошибка построения запроса, вызванная тем, что соединитель CQD не смог правильно разобрать запрос, который вы пытаетесь построить.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. Это происходит чаще всего при использовании неподдерживаемой функции, как указано в описанных выше ограничениях.This happens most often when using unsupported functionality, as specified in the Limitations above. Убедитесь, что вы не используете вычисляемые столбцы или пользовательские визуальные элементы для этого запроса.Double check that you are not using any calculated columns or custom visuals for that query.

    • ErrorType 5 — время ожидания выполнения: Запрос достиг максимально возможного времени выполнения. Попробуйте добавить в запрос дополнительные фильтры, чтобы ограничить их область.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. Чтобы добиться этого, очень удобно сузить диапазон данных.Narrowing the data range is often the most effective way to achieve this.

    • ErrorType 7 — ошибки без единиц измерения: Для функционирования запросов CQD требуется измерение.ErrorType 7 - No Measurements Error: CQD queries require a measure in order to function. Дважды убедитесь, что запрос содержит меру.Double check that your query includes measure. Меры в соединителе CQD обозначаются символом агрегирования (SUM) перед его именем.Measures in the CQD Connector are denoted by the aggregation (sum) symbol before their name.

Если вы столкнулись с дополнительными ошибками за пределами этой области, пожалуйста, уведомите группу CQD, чтобы мы смогли устранить эту проблему и при необходимости обновить документацию.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.

ОбычныхFootnotes

1 . Некоторые процессы и приложения (например, OneDrive) могут привести к изменению корневой папки "документы". Убедитесь в том, что каталог * \ настраиваемых соединителей на рабочем СТОЛЕ Power BI* помещен в текущую папку "документы корневой папки".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 . учетные данные для входа, используемые для CQD, не должны совпадать с учетными данными, которые используются для входа в классическое приложение 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.

Вопросы и ответыFrequently asked questions

Когда будет обновлен соединитель Power BI с "бета-состояние"When will the Power BI Connector be updated from "Beta" status

Несмотря на метку бета-версии, соединитель качества связи для Power BI является выпускной версией соединителя и является официальной безопасностью, подписанной командой Power BI, для ее отражения.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. Процесс сертификации для удаления этого тега бета-версии является значительным и требует подтверждения от команды Power BI для обеспечения прямой поддержки соединительной линии.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. Из-за ограничений по времени группа Power BI не может предоставить такую техническую поддержку и более обширную сертификацию, но по-прежнему готова к утверждению безопасности, подлинности и общей функциональности соединителя качества звонков 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.

Почему соединительная линия кажется медленнее по сравнению с расширенными CQD в браузере?Why does the connector seem slower compared to Advanced CQD in the browser? Что можно сделать, чтобы улучшить производительностьWhat can I do to improve performance

Производительность запросов для различных шаблонов в действительности одинакова в браузере и в соединительной линии.Query performance for the various templates is actually the same in both the browser and in the connector. Так же, как и любое другое автономное приложение, Power BI добавляет проверку подлинности и время отрисовки к нашему снижению производительности.Just like any other standalone app, Power BI adds its authentication and rendering time to our performance. Кроме того, разница определяется количеством выполняемых параллельных запросов.In addition, the difference comes in the number of concurrent queries being run. Поскольку версия CQD в браузере имеет менее качественно разработанные и более сжатые параметры визуализации, большая часть наших отчетов была ограничена загрузкой запросов 2-3 за один раз.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. С другой стороны, шаблоны соединителей часто отображают 20 + параллельных запросов.On the other hand, the connector templates often display 20+ concurrent queries. Если вы хотите, чтобы вы работали с отчетами, а не более ранними, чем вы использовались, попробуйте создавать отчеты, не превышающие 2-3 запросов на каждую вкладку.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.

Дополнительные сведения можно найти в следующих статьях:For more information, see the following articles:

Я могу присоединиться к ограничению строки 10 000 при выполнении запросов.I find that I routinely run into the 10,000-row limit when running queries. Как сделать так, чтобы соединитель возвращал больше 10 000 строкHow can I get the connector to return more than 10,000 rows

Ограничение на количество строк в 10 000 в действительности задается на окончании API-интерфейса, и оно предназначено для повышения производительности и снижения риска ошибок при выполнении запроса, полученных из-за нехватки памяти.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.

Вместо того, чтобы попытаться увеличивать количество строк результатов, лучше структурировать отчеты согласно рекомендациям по соединительной линии.Instead of attempting to increase the result row count, it is best to restructure your reports according to connector best practices. Шаблоны, которые мы включили, предназначены для демонстрации этих рекомендаций.The templates we have included are designed to demonstrate these best practices. Там, где это возможно, начните с просмотра ключевых показателей эффективности с помощью более широкой и более узкой размерности, например месяц, год, Дата, регион, страна и т. д. В этом случае вы можете детализировать все более высокие измерения.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. В справочных службах и расширенных отчетах о местонахождении есть хорошие примеры этого рабочего процесса детализации.The Helpdesk and Location-Enhanced Reports both provide good examples of this drill down workflow.

Анализ данных CQD для Teams с помощью Power BIUse Power BI to analyze CQD data for Teams