API Power BI позволяет принудительно отправлять данные в набор данных Power BI. Например, вам нужно расширить существующий бизнес-процесс для отправки ключевых данных в набор данных. В этом случае необходимо отправить набор данных "Продажи и маркетинг", содержащий таблицу "Продукт".

Для принудительной передачи данных в набор данных требуется Azure Active Directory (Azure AD) и учетная запись Power BI.

Принудительная отправка данных в набор данных

В следующем разделе приводятся общие сведения об операциях API Power BI для отправки данных.

Операции API Power BI для отправки данных

REST API Power BI позволяет принудительно отправлять источники данных в панель мониторинга Power BI. Когда приложение добавляет строки в набор данных, плитки на панели мониторинга обновляются автоматически обновленными данными. Для отправки данных используйте операцию Создание набора данных вместе с операцией Добавление строк. Чтобы найти набор данных, используйте операцию Получение наборов данных. С помощью каждой из этих операций можно передать идентификатор группы для работы с группой. Чтобы получить список идентификаторов групп, используйте операцию Получение групп. Примеры использования REST API Power BI см. в документации Power BI REST API on APIARY (Справочник по REST API Power BI на APIARY).

Ниже перечислены операции по отправке данных в набор данных.

Набор данных в Power BI создается путем передачи строки JavaScript Object Notation (JSON) в службу Power BI. Дополнительную информацию о JSON см. в статье Введение в JSON.

Строка JSON для набора данных имеет следующий формат.

Объект JSON набора данных Power BI

{"name": "dataset_name", "tables":
    [{"name": "", "columns":
        [{ "name": "column_name1", "dataType": "data_type"},
         { "name": "column_name2", "dataType": "data_type"},
         { ... }
        ]
      }
    ]
}

Таким образом, в нашем примере с набором данных "Продажи и маркетинг" нужно передать строку JSON, аналогичную показанной ниже. В этом примере SalesMarketing — это имя набора данных, а Product — имя таблицы. После определения таблицы следует определить схему таблицы. В случае набора данных SalesMarketing схема таблицы содержит следующие столбцы: ProductID, Manufacturer, Category, Segment, Product и IsCompete.

Пример объекта JSON набора данных

{
    "name": "SalesMarketing",
    "tables": [
        {
            "name": "Product",
            "columns": [
            {
                "name": "ProductID",
                "dataType": "int"
            },
            {
                "name": "Manufacturer",
                "dataType": "string"
            },
            {
                "name": "Category",
                "dataType": "string"
            },
            {
                "name": "Segment",
                "dataType": "string"
            },
            {
                "name": "Product",
                "dataType": "string"
            },
            {
                "name": "IsCompete",
                "dataType": "bool"
            }
            ]
        }
    ]
}

Для схемы таблицы Power BI можно использовать следующие типы данных.

Типы данных таблицы Power BI

Тип данных Ограничения
Int64 Int64.MaxValue и Int64.MinValue не допускаются.
Double Значения Double.MaxValue и Double.MinValue не допускается. NaN не поддерживается. В некоторых функциях не поддерживаются +Infinity и -Infinity (например, Min, Max).
Boolean Нет
DateTime Во время загрузки данных мы квантуем значения с частями суток на целые значения, кратные 1/300 секунды (3,33 мс).
String В настоящее время вмещает до 128 000 знаков.

Дополнительные сведения о принудительной отправке данных в Power BI

Чтобы приступить к отправке данных в набор данных, см. сведения в левой области навигации — Шаг 1. Регистрация приложения в Azure AD.

Дальнейшие действия >

См. также:

Регистрация бесплатной учетной записи Power BI с пользовательским клиентом каталога Azure Active Directory
Создание набора данных
Получение наборов данных
Добавление строк
Получение групп
Общие сведения о JSON
Обзор интерфейса REST API Power BI
Power BI REST API on APIARY (Справочник по REST API Power BI на APIARY)
Появились дополнительные вопросы? Ответы на них см. в сообществе Power BI.