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[]	テーブル ソース