Push Datasets - Datasets PutTableInGroup

Service:

Power BI REST APIs

API Version:

v1.0

Aktualisierungen die Metadaten und das Schema für die angegebene Tabelle innerhalb des angegebenen Datasets aus dem angegebenen Arbeitsbereich.

Erforderlicher Bereich

Dataset.ReadWrite.All

Einschränkungen

Dieser API-Aufruf unterstützt nur Push-Datasets.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string	Die Dataset-ID
groupId	path	True	string uuid	Arbeitsbereich-ID
tableName	path	True	string	Der Tabellenname

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
columns	True	Column[]	Das Spaltenschema für diese Tabelle
name	True	string	Der Tabellenname
description		string	Die Tabellenbeschreibung
isHidden		boolean	Optional. Ob diese Datasettabelle ausgeblendet ist.
measures		Measure[]	Die Maßnahmen in dieser Tabelle
rows		Row[]	Die Datenzeilen in dieser Tabelle
source		ASMashupExpression[]	Die Tabellenquelle

Antworten

Name	Typ	Beschreibung
200 OK	Table	OK

Beispiele

Example

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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"
}

Definitionen

Name	Beschreibung
ASMashupExpression	Eine Datensatztabellenquelle
Column	Eine Datasetspalte
Measure	Ein Power BI-Maß
Row	Eine Datenzeile in einem Dataset
Table	Eine Datasettabelle

ASMashupExpression

Eine Datensatztabellenquelle

Name	Typ	Beschreibung
expression	string	Der Quellausdruck

Column

Eine Datasetspalte

Name	Typ	Beschreibung
dataCategory	string	Optional. Der für die Datenkategorie zu verwendende Zeichenfolgenwert, der die Daten in dieser Spalte beschreibt.
dataType	string	Der Spaltendatentyp
formatString	string	Optional. Das Format der Spalte, wie in FORMAT_STRING angegeben.
isHidden	boolean	Optional. Ob die Spalte ausgeblendet ist. Der Standardwert ist false.
name	string	Der Spaltenname
sortByColumn	string	Optional. Zeichenfolgenname einer Spalte in der gleichen Tabelle, die zum Sortieren der aktuellen Spalte verwendet werden soll.
summarizeBy	string	Dies ist optional. Die Aggregatfunktion, die für die Zusammenfassung dieser Spalte verwendet werden soll.

Measure

Ein Power BI-Maß

Name	Typ	Beschreibung
description	string	Optional. Die Maßbeschreibung.
expression	string	Ein gültiger DAX-Ausdruck
formatString	string	Optional. Eine Zeichenfolge, die beschreibt, wie der Wert formatiert werden soll, wenn er in FORMAT_STRING angegeben wird.
isHidden	boolean	Optional. Ob das Maß ausgeblendet ist.
name	string	Der Maßname

Row

Eine Datenzeile in einem Dataset

Name	Typ	Beschreibung
id	string	Die eindeutige Zeilen-ID

Table

Eine Datasettabelle

Name	Typ	Beschreibung
columns	Column[]	Das Spaltenschema für diese Tabelle
description	string	Die Tabellenbeschreibung
isHidden	boolean	Optional. Ob diese Datasettabelle ausgeblendet ist.
measures	Measure[]	Die Maßnahmen in dieser Tabelle
name	string	Der Tabellenname
rows	Row[]	Die Datenzeilen in dieser Tabelle
source	ASMashupExpression[]	Die Tabellenquelle