Принудительная отправка данных набор данных Power BIPush data into a Power BI dataset

API Power BI позволяет принудительно отправлять данные в набор данных Power BI.With the Power BI API, you can push data into a Power BI dataset. Например, вам нужно расширить существующий бизнес-процесс для отправки ключевых данных в набор данных.For example, you want to extend an existing business workflow to push key data into your dataset. В этом случае необходимо отправить набор данных "Продажи и маркетинг", содержащий таблицу "Продукт".In this case, you want to push a Sales Marketing dataset which has a Product table into a dataset.

Для принудительной передачи данных в набор данных требуется Azure Active Directory (Azure AD) и учетная запись Power BI.Before you get started pushing data into a dataset, you need an Azure Active Directory (Azure AD) and a Power BI account.

Принудительная отправка данных в набор данныхSteps to push data into a dataset

В следующем разделе приводятся общие сведения об операциях API Power BI для отправки данных.The next section is a general discussion of Power BI API operations that push data.

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

REST API Power BI позволяет принудительно отправлять источники данных в панель мониторинга Power BI.With the Power BI REST API, you can push data sources to Power BI. Когда приложение добавляет строки в набор данных, плитки на панели мониторинга обновляются автоматически обновленными данными.When an app adds rows to a dataset, tiles on the dashboard are updated automatically with the updated data. Для отправки данных используйте операцию Создание набора данных вместе с операцией Добавление строк.To push data, you use the Create Dataset operation along with the Add Rows operation. Чтобы найти набор данных, используйте операцию Получение наборов данных.To find a dataset, you use the Get Datasets operation. С помощью каждой из этих операций можно передать идентификатор группы для работы с группой.For any of these operations, you can pass a group id to work with a group. Чтобы получить список идентификаторов групп, используйте операцию Получение групп.Use the Get Groups operation to get a list of group id's.

Ниже перечислены операции по отправке данных в набор данных.Here are the operations to push data into a dataset:

Набор данных в Power BI создается путем передачи строки JavaScript Object Notation (JSON) в службу Power BI.You create a dataset in Power BI by passing a JavaScript Object Notation (JSON) string to the Power BI service. Дополнительную информацию о JSON см. в статье Введение в JSON.To learn more about JSON, see Introducing JSON.

Строка JSON для набора данных имеет следующий формат.The JSON string for a dataset has the following format:

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

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

Таким образом, в нашем примере с набором данных "Продажи и маркетинг" нужно передать строку JSON, аналогичную показанной ниже.So, for our Sales Marketing dataset example, you would pass a JSON string such as the example below. В этом примере SalesMarketing — это имя набора данных, а Product — имя таблицы.In this example, SalesMarketing is the name of the dataset, and Product is the name of the table. После определения таблицы следует определить схему таблицы.After you define the table, you define the table schema. В случае набора данных SalesMarketing схема таблицы содержит следующие столбцы: ProductID, Manufacturer, Category, Segment, Product и IsCompete.For the SalesMarketing dataset, the table schema has these columns: ProductID, Manufacturer, Category, Segment, Product, and IsCompete.

Пример объекта JSON набора данныхExample dataset object 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 можно использовать следующие типы данных.For a Power BI table schema, you can use the following data types.

Типы данных таблицы Power BIPower BI table data types

Тип данныхData type ОграниченияRestrictions
Int64Int64 Int64.MaxValue и Int64.MinValue не допускаются.Int64.MaxValue and Int64.MinValue not allowed.
DoubleDouble Значения Double.MaxValue и Double.MinValue не допускается.Double.MaxValue and Double.MinValue values not allowed. NaN не поддерживается. В некоторых функциях не поддерживаются +Infinity и -Infinity (например, Min, Max).NaN not supported.+Infinity and -Infinity not supported in some functions (e.g. Min, Max).
BooleanBoolean НетNone
DateTimeDatetime Во время загрузки данных мы квантуем значения с частями суток на целые значения, кратные 1/300 секунды (3,33 мс).During data loading we quantize values with day fractions to whole multiples of 1/300 seconds (3.33ms).
StringString В настоящее время вмещает до 128 000 знаков.Currently allows up to 128K characters.

Дополнительные сведения о принудительной отправке данных в Power BILearn more about pushing data into Power BI

Чтобы приступить к отправке данных в набор данных, см. сведения в левой области навигации — Шаг 1. Регистрация приложения в Azure AD.To get started pushing data into a dataset, see Step 1: Register an app with Azure AD in the left navigation pane.

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

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

Регистрация бесплатной учетной записи Power BI с пользовательским клиентом каталога Azure Active DirectorySign up for Power BI
Создание набора данныхCreate Dataset
Получение наборов данныхGet Datasets
Добавление строкAdd Rows
Получение группGet Groups
Общие сведения о JSONIntroducing JSON
Обзор интерфейса REST API Power BIOverview of Power BI REST API
Появились дополнительные вопросы?More questions? Ответы на них см. в сообществе Power BI.Try the Power BI Community