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 參數

名稱	位於	必要	類型	Description
datasetId	path	True	string	資料集識別碼
tableName	path	True	string	資料表名稱

要求本文

名稱	必要	類型	Description
columns	True	Column[]	此資料表的資料行架構
name	True	string	資料表名稱
description		string	資料表描述
isHidden		boolean	選擇性。 此資料集資料表是否隱藏。
measures		Measure[]	此資料表內的量值
rows		Row[]	此資料表中的資料列
source		ASMashupExpression[]	資料表來源

回應

名稱	類型	Description
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"
}

定義

名稱	Description
ASMashupExpression	資料集資料表來源
Column	資料集資料行
Measure	Power BI 量值
Row	資料集中的資料列
Table	資料集資料表

ASMashupExpression

資料集資料表來源

名稱	類型	Description
expression	string	來源運算式

Column

資料集資料行

名稱	類型	Description
dataCategory	string	選擇性。 要用於資料類別目錄的字串值，描述此資料行內的資料。
dataType	string	資料行資料類型
formatString	string	選擇性。 資料行的格式，如 FORMAT_STRING中所指定。
isHidden	boolean	選擇性。 是否隱藏資料行。 預設為 false。
name	string	資料行名稱
sortByColumn	string	選擇性。 要用以排序目前資料行的相同資料表中，資料行的字串名稱。
summarizeBy	string	選擇性。 要用於摘要此資料行的彙總函式。

Measure

Power BI 量值

名稱	類型	Description
description	string	選擇性。 量值描述。
expression	string	有效的 DAX 運算式
formatString	string	選擇性。 字串，描述值在 FORMAT_STRING中所指定時，應該如何格式化。
isHidden	boolean	選擇性。 量值是否隱藏。
name	string	量值名稱

Row

資料集中的資料列

名稱	類型	Description
id	string	唯一的資料列識別碼

Table

資料集資料表

名稱	類型	Description
columns	Column[]	此資料表的資料行架構
description	string	資料表描述
isHidden	boolean	選擇性。 此資料集資料表是否隱藏。
measures	Measure[]	此資料表內的量值
name	string	資料表名稱
rows	Row[]	此資料表中的資料列
source	ASMashupExpression[]	資料表來源