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

名稱	位於	必要	類型	Description
datasetId	path	True	string	數據集標識碼
tableName	path	True	string	表格名稱

要求本文

名稱	必要	類型	Description
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[]	數據表來源

回應

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

定義

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

ASMashupExpression

Object

數據集數據表來源

名稱	類型	Description
expression	string	來源表達式

Column

Object

數據集數據行

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

數據集中的數據列

名稱	類型	Description
id	string	唯一的數據列標識碼

Table

Object

數據集數據表

名稱	類型	Description
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[]	數據表來源