Push Datasets - Datasets PutTable
[マイ ワークスペース ] から、指定したデータセット内の指定したテーブルのメタデータとスキーマ更新します。
必要なスコープ
Dataset.ReadWrite.All
制限事項
この API 呼び出しでは、プッシュ データセットのみがサポートされます。
PUT https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/tables/{tableName}
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
データセット ID |
|
table
|
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 |
テーブル ソース |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
わかりました |
例
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"
}
]
}
応答のサンプル
{
"name": "Product"
}
定義
| 名前 | 説明 |
|---|---|
|
ASMashup |
データセット テーブル ソース |
| Column |
データセット列 |
| Measure |
Power BI メジャー |
| Row |
データセット内のデータ行 |
| Table |
データセット テーブル |
ASMashupExpression
データセット テーブル ソース
| 名前 | 型 | 説明 |
|---|---|---|
| expression |
string |
ソース式 |
Column
データセット列
| 名前 | 型 | 説明 |
|---|---|---|
| dataCategory |
string |
任意 この列内のデータを記述するデータ カテゴリに使用する文字列値。 |
| dataType |
string |
列のデータ型 |
| formatString |
string |
任意 FORMAT_STRINGで指定されている列の形式。 |
| isHidden |
boolean |
任意 列が非表示かどうか。 既定値は |
| name |
string pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$ |
列名 |
| sortByColumn |
string |
任意 現在の列の順序付けに使用する同じテーブル内の列の文字列名。 |
| summarizeBy |
string |
任意 この列の集計に使用する集計関数。 |
Measure
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
データセット内のデータ行
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string |
一意の行 ID |
Table
データセット テーブル
| 名前 | 型 | 説明 |
|---|---|---|
| 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 |
テーブル ソース |