Freigeben über

Push Datasets - Datasets PutTable

Dienst:
Power BI REST APIs
API-Version:
v1.0

Aktualisiert die Metadaten und das Schema für die angegebene Tabelle innerhalb des angegebenen Datasets aus "Mein Arbeitsbereich".

Erforderlicher Bereich

Dataset.ReadWrite.All

Einschränkungen

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

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
 path True

string

Die Dataset-ID
tableName
 path True

string

Der Name der Tabelle

Anforderungstext

Name Erforderlich Typ Beschreibung
columns True

Column[]

Das Spaltenschema für diese Tabelle
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}$

Der Name der Tabelle
description

string

Die Tabellenbeschreibung
isHidden

boolean

Wahlfrei. Gibt an, ob diese Datasettabelle ausgeblendet ist.
measures

Measure[]

Die Measures in dieser Tabelle
rows

Row[]

Die Datenzeilen in dieser Tabelle
source

ASMashupExpression[]

Die Tabellenquelle

Antworten

Name Typ Beschreibung
200 OK

Table

OKAY

Beispiele

Example

Beispielanforderung

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/tables/Product
Anforderungstext
{
  "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"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "name": "Product"
}

Definitionen

Name Beschreibung
ASMashupExpression

Eine Datensatztabellenquelle
Column

Eine Datasetspalte
Measure

Ein Power BI-Measure
Row

Eine Datenzeile in einem Dataset
Table

Eine Datasettabelle

ASMashupExpression

Objekt

Eine Datensatztabellenquelle

Name Typ Beschreibung
expression

string

Der Quellausdruck

Column

Objekt

Eine Datasetspalte

Name Typ Beschreibung
dataCategory

string

Wahlfrei. Der für die Datenkategorie zu verwendende Zeichenfolgenwert, der die Daten in dieser Spalte beschreibt.
dataType

string

Der Spaltendatentyp
formatString

string

Wahlfrei. Das Format der Spalte, wie in FORMAT_STRINGangegeben.
isHidden

boolean

Wahlfrei. Gibt an, ob die Spalte ausgeblendet ist. Der Standardwert ist false.
name

string

pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$

Der Spaltenname
sortByColumn

string

Wahlfrei. Zeichenfolgenname einer Spalte in derselben Tabelle, die zum Sortieren der aktuellen Spalte verwendet werden soll.
summarizeBy

string

Wahlfrei. Die Aggregatfunktion, die zum Zusammenfassen dieser Spalte verwendet werden soll.

Measure

Objekt

Ein Power BI-Measure

Name Typ Beschreibung
description

string

Wahlfrei. Die Measurebeschreibung.
expression

string

Ein gültiger DAX-Ausdruck
formatString

string

Wahlfrei. Eine Zeichenfolge, die beschreibt, wie der Wert formatiert werden soll, wenn er wie in FORMAT_STRINGangegeben angezeigt wird.
isHidden

boolean

Wahlfrei. Gibt an, ob das Measure ausgeblendet ist.
name

string

pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$

Der Measurename

Row

Objekt

Eine Datenzeile in einem Dataset

Name Typ Beschreibung
id

string

Die eindeutige Zeilen-ID

Table

Objekt

Eine Datasettabelle

Name Typ Beschreibung
columns

Column[]

Das Spaltenschema für diese Tabelle
description

string

Die Tabellenbeschreibung
isHidden

boolean

Wahlfrei. Gibt an, ob diese Datasettabelle ausgeblendet ist.
measures

Measure[]

Die Measures in dieser Tabelle
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}$

Der Name der Tabelle
rows

Row[]

Die Datenzeilen in dieser Tabelle
source

ASMashupExpression[]

Die Tabellenquelle