Push Datasets - Datasets PutTable

Service:

Power BI REST APIs

API Version:

v1.0

Çalışma alanım'dan belirtilen veri kümesinde belirtilen tablo için meta verileri ve şemayı Güncelleştirmeler.

Gerekli Kapsam

Dataset.ReadWrite.All

Sınırlamalar

Bu API çağrısı yalnızca gönderme veri kümelerini destekler.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasetId	path	True	string	Veri kümesi kimliği
tableName	path	True	string	Tablo adı

İstek Gövdesi

Name	Gerekli	Tür	Description
columns	True	Column[]	Bu tablonun sütun şeması
name	True	string	Tablo adı
description		string	Tablo açıklaması
isHidden		boolean	İsteğe bağlı. Bu veri kümesi tablosunun gizli olup olmadığı.
measures		Measure[]	Bu tablodaki ölçüler
rows		Row[]	Bu tablodaki veri satırları
source		ASMashupExpression[]	Tablo kaynağı

Yanıtlar

Name	Tür	Description
200 OK	Table	Tamam

Örnekler

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

Tanımlar

Name	Description
ASMashupExpression	Veri kümesi tablosu kaynağı
Column	Veri kümesi sütunu
Measure	Power BI ölçüsü
Row	Veri kümesindeki veri satırı
Table	Veri kümesi tablosu

ASMashupExpression

Veri kümesi tablosu kaynağı

Name	Tür	Description
expression	string	Kaynak ifade

Column

Veri kümesi sütunu

Name	Tür	Description
dataCategory	string	İsteğe bağlı. Bu sütundaki verileri açıklayan veri kategorisi için kullanılacak dize değeri.
dataType	string	Sütun veri türü
formatString	string	İsteğe bağlı. FORMAT_STRING'de belirtilen sütunun biçimi.
isHidden	boolean	İsteğe bağlı. Sütunun gizlenip gizlenmediği. Varsayılan değer: false.
name	string	Sütun adı
sortByColumn	string	İsteğe bağlı. Geçerli sütunu sıralamak için kullanılacak, aynı tablodaki bir sütunun dize adı.
summarizeBy	string	İsteğe bağlı. Bu sütunu özetlemek için kullanılacak toplama işlevi.

Measure

Power BI ölçüsü

Name	Tür	Description
description	string	İsteğe bağlı. Ölçü açıklaması.
expression	string	Geçerli bir DAX ifadesi
formatString	string	İsteğe bağlı. değerin FORMAT_STRING'de belirtildiği gibi görüntülendiğinde nasıl biçimlendirilmesi gerektiğini açıklayan bir dize.
isHidden	boolean	İsteğe bağlı. Ölçünün gizlenip gizlenmediği.
name	string	Ölçü adı

Row

Veri kümesindeki veri satırı

Name	Tür	Description
id	string	Benzersiz satır kimliği

Table

Veri kümesi tablosu

Name	Tür	Description
columns	Column[]	Bu tablonun sütun şeması
description	string	Tablo açıklaması
isHidden	boolean	İsteğe bağlı. Bu veri kümesi tablosunun gizli olup olmadığı.
measures	Measure[]	Bu tablodaki ölçüler
name	string	Tablo adı
rows	Row[]	Bu tablodaki veri satırları
source	ASMashupExpression[]	Tablo kaynağı