Push Datasets - Datasets PutTable

Service:

Power BI REST APIs

API Version:

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	表名称
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	唯一行 ID

Table

数据集表

名称	类型	说明
columns	Column[]	此表的列架构
description	string	表说明
isHidden	boolean	可选。 是否隐藏此数据集表。
measures	Measure[]	此表中的度量值
name	string	表名称
rows	Row[]	此表中的数据行
source	ASMashupExpression[]	表源