Push Datasets - Datasets PutTableInGroup

Service:

Power BI REST APIs

API Version:

v1.0

指定したワークスペースから、指定したデータセット内の指定したテーブルのメタデータとスキーマを更新します。

必要なスコープ

Dataset.ReadWrite.All

制限事項

この API 呼び出しでは、 プッシュ データセットのみがサポートされます。

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

URI パラメーター

名前	/	必須	型	説明
datasetId	path	True	string	データセット ID
groupId	path	True	string uuid	ワークスペース ID
tableName	path	True	string	テーブル名

要求本文

名前	必須	型	説明
columns	True	Column[]	このテーブルの列スキーマ
name	True	string	テーブル名
description		string	テーブルの説明
isHidden		boolean	省略可能。 このデータセット テーブルが非表示になっているかどうか。
measures		Measure[]	この表内のメジャー
rows		Row[]	このテーブル内のデータ行
source		ASMashupExpression[]	テーブル ソース

応答

名前	型	説明
200 OK	Table	OK

例

Example

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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[]	テーブル ソース