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

テーブル ソース