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 パラメーター

名前 / 必須 型 説明
datasetId
 path True

string

データセット ID
tableName
 path True

string

テーブル名

要求本文

名前 必須 型 説明
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[]

テーブル ソース

応答

名前 型 説明
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"
}

定義

名前 説明
ASMashupExpression

データセット テーブル ソース
Column

データセット列
Measure

Power BI メジャー
Row

データセット内のデータ行
Table

データセット テーブル

ASMashupExpression

Object

データセット テーブル ソース

名前 型 説明
expression

string

ソース式

Column

Object

データセット列

名前 型 説明
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

string

任意 メジャーの説明。
expression

string

有効な DAX 式
formatString

string

任意 FORMAT_STRINGで指定されているように値を表示する場合の書式設定方法を説明する文字列。
isHidden

boolean

任意 メジャーが非表示かどうか。
name

string

pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$

メジャー名

Row

Object

データセット内のデータ行

名前 型 説明
id

string

一意の行 ID

Table

Object

データセット テーブル

名前 型 説明
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[]

テーブル ソース