Push Datasets - Datasets PutTable

Service:

Power BI REST APIs

API Version:

v1.0

Updates metadata dan skema untuk tabel yang ditentukan dalam himpunan data yang ditentukan dari Ruang kerja saya.

Cakupan yang Diperlukan

Dataset.ReadWrite.All

Batasan

Panggilan API ini hanya mendukung himpunan data push.

PUT https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/tables/{tableName}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
datasetId	path	True	string	ID himpunan data
tableName	path	True	string	Nama tabel

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
columns	True	Column[]	Skema kolom untuk tabel ini
name	True	string	Nama tabel
description		string	Deskripsi tabel
isHidden		boolean	Opsional. Apakah tabel himpunan data ini disembunyikan.
measures		Measure[]	Langkah-langkah dalam tabel ini
rows		Row[]	Baris data dalam tabel ini
source		ASMashupExpression[]	Sumber tabel

Respons

Nama	Jenis	Deskripsi
200 OK	Table	OK

Contoh

Example

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/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"
}

Definisi

Nama	Deskripsi
ASMashupExpression	Sumber tabel himpunan data
Column	Kolom himpunan data
Measure	Pengukuran Power BI
Row	Baris data dalam himpunan data
Table	Tabel himpunan data

ASMashupExpression

Sumber tabel himpunan data

Nama	Jenis	Deskripsi
expression	string	Ekspresi sumber

Column

Kolom himpunan data

Nama	Jenis	Deskripsi
dataCategory	string	Opsional. Nilai string yang akan digunakan untuk kategori data yang menjelaskan data dalam kolom ini.
dataType	string	Jenis data kolom
formatString	string	Opsional. Format kolom seperti yang ditentukan dalam FORMAT_STRING.
isHidden	boolean	Opsional. Apakah kolom disembunyikan. Defaultnya adalah false.
name	string	Nama kolom
sortByColumn	string	Opsional. Nama string kolom dalam tabel yang sama untuk digunakan untuk mengurutkan kolom saat ini.
summarizeBy	string	Opsional. Fungsi agregat yang digunakan untuk meringkas kolom ini.

Measure

Pengukuran Power BI

Nama	Jenis	Deskripsi
description	string	Opsional. Deskripsi pengukuran.
expression	string	Ekspresi DAX yang valid
formatString	string	Opsional. String yang menjelaskan bagaimana nilai harus diformat saat ditampilkan seperti yang ditentukan dalam FORMAT_STRING.
isHidden	boolean	Opsional. Apakah ukuran disembunyikan.
name	string	Nama pengukuran

Row

Baris data dalam himpunan data

Nama	Jenis	Deskripsi
id	string	ID baris unik

Table

Tabel himpunan data

Nama	Jenis	Deskripsi
columns	Column[]	Skema kolom untuk tabel ini
description	string	Deskripsi tabel
isHidden	boolean	Opsional. Apakah tabel himpunan data ini disembunyikan.
measures	Measure[]	Langkah-langkah dalam tabel ini
name	string	Nama tabel
rows	Row[]	Baris data dalam tabel ini
source	ASMashupExpression[]	Sumber tabel