通过

Push Datasets - Datasets PutTable

服务:
Power BI REST APIs
API 版本:
v1.0

从“我的工作区”更新指定数据集中指定表的元数据和架构。

所需范围

Dataset.ReadWrite.All

局限性

此 API 调用仅支持 推送数据集。 

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

URI 参数

名称 在 必需 类型 说明
datasetId
 path True

string

数据集 ID
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

唯一行 ID

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[]

表源