Push Datasets - Datasets PutTable

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

必要なスコープ

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

OK

Example

Sample Request

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"
    }
  ]
}

Sample Response

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

テーブル ソース