Push Datasets - Datasets PutTable

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

Обновления метаданные и схему для указанной таблицы в указанном наборе данных из моей рабочей области.

Требуемая область

Dataset.ReadWrite.All

Ограничения

Этот вызов API поддерживает только push-наборы данных.

PUT https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/tables/{tableName}

Параметры URI

Имя	В	Обязательно	Тип	Описание
datasetId	path	True	string	Идентификатор набора данных
tableName	path	True	string	имя таблицы;

Текст запроса

Имя	Обязательно	Тип	Описание
columns	True	Column[]	Схема столбца для этой таблицы
name	True	string	имя таблицы;
description		string	Описание таблицы
isHidden		boolean	Необязательный элемент. Скрыта ли эта таблица набора данных.
measures		Measure[]	Меры в этой таблице
rows		Row[]	Строки данных в этой таблице
source		ASMashupExpression[]	Источник таблицы

Ответы

Имя	Тип	Описание
200 OK	Table	ОК

Примеры

Example

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/tables/Product

Request Body

{
  "name": "Product",
  "columns": [
    {
      "name": "ProductID",
      "dataType": "Int64"
    },
    {
      "name": "Name",
      "dataType": "string"
    },
    {
      "name": "Category",
      "dataType": "string"
    },
    {
      "name": "IsCompete",
      "dataType": "bool"
    },
    {
      "name": "ManufacturedOn",
      "dataType": "DateTime"
    },
    {
      "name": "NewColumn",
      "dataType": "string"
    }
  ]
}

Sample Response

Status code:: 200

{
  "name": "Product"
}

Определения

Имя	Описание
ASMashupExpression	Источник таблицы набора данных
Column	Столбец набора данных
Measure	Мера Power BI
Row	Строка данных в наборе данных
Table	Таблица набора данных

ASMashupExpression

Источник таблицы набора данных

Имя	Тип	Описание
expression	string	Исходное выражение

Column

Столбец набора данных

Имя	Тип	Описание
dataCategory	string	Необязательный элемент. Строковое значение, используемое для категории данных, описывающей данные в этом столбце.
dataType	string	Тип данных столбца
formatString	string	Необязательный элемент. Формат столбца, как указано в FORMAT_STRING.
isHidden	boolean	Необязательный элемент. Скрыт ли столбец. Значение по умолчанию — `false`.
name	string	Имя столбца
sortByColumn	string	Необязательный элемент. Строка, представляющая собой название столбца в той же таблице, который нужно использовать для сортировки текущего столбца.
summarizeBy	string	Необязательный элемент. Агрегатная функция, используемая для суммирования этого столбца.

Measure

Мера Power BI

Имя	Тип	Описание
description	string	Необязательный элемент. Описание меры.
expression	string	Допустимое выражение DAX
formatString	string	Необязательный элемент. Строка, описывающая форматирование значения при отображении, как указано в FORMAT_STRING.
isHidden	boolean	Необязательный элемент. Скрыта ли мера.
name	string	Имя меры

Row

Строка данных в наборе данных

Имя	Тип	Описание
id	string	Уникальный идентификатор строки

Table

Таблица набора данных

Имя	Тип	Описание
columns	Column[]	Схема столбца для этой таблицы
description	string	Описание таблицы
isHidden	boolean	Необязательный элемент. Скрыта ли эта таблица набора данных.
measures	Measure[]	Меры в этой таблице
name	string	имя таблицы;
rows	Row[]	Строки данных в этой таблице
source	ASMashupExpression[]	Источник таблицы