Поделиться через

Push Datasets - Datasets PutTable

Служба:
Power BI REST APIs
Версия API:
v1.0

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

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

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

pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$

Имя таблицы
description

string

Описание таблицы
isHidden

boolean

Необязательно. Скрыта ли эта таблица набора данных.
measures

Measure[]

Меры в этой таблице
rows

Row[]

Строки данных в этой таблице
source

ASMashupExpression[]

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

Ответы

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

Table

ХОРОШО

Примеры

Example

Образец запроса

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/tables/Product
Текст запроса
{
  "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"
    }
  ]
}

Пример ответа

Код состояния:
200 
{
  "name": "Product"
}

Определения

Имя Описание
ASMashupExpression

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

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

Мера Power BI
Row

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

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

ASMashupExpression

Object

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

Имя Тип Описание
expression

string

Исходное выражение

Column

Object

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

Имя Тип Описание
dataCategory

string

Необязательно. Строковое значение, используемое для категории данных, описывающей данные в этом столбце.
dataType

string

Тип данных столбца
formatString

string

Необязательно. Формат столбца, указанный в FORMAT_STRING.
isHidden

boolean

Необязательно. Скрыт ли столбец. Значение по умолчанию — false.
name

string

pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$

Имя столбца
sortByColumn

string

Необязательно. Строковое имя столбца в той же таблице, используемое для упорядочивания текущего столбца.
summarizeBy

string

Необязательно. Агрегатная функция, используемая для суммирования этого столбца.

Measure

Object

Мера Power BI

Имя Тип Описание
description

string

Необязательно. Описание меры.
expression

string

Допустимое выражение DAX
formatString

string

Необязательно. Строка, описывающая форматирование значения при отображении, как указано в FORMAT_STRING.
isHidden

boolean

Необязательно. Скрыта ли мера.
name

string

pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$

Имя меры

Row

Object

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

Имя Тип Описание
id

string

Уникальный идентификатор строки

Table

Object

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

Имя Тип Описание
columns

Column[]

Схема столбцов для этой таблицы
description

string

Описание таблицы
isHidden

boolean

Необязательно. Скрыта ли эта таблица набора данных.
measures

Measure[]

Меры в этой таблице
name

string

pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$

Имя таблицы
rows

Row[]

Строки данных в этой таблице
source

ASMashupExpression[]

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