Push Datasets - Datasets PutTable

Aktualisierungen die Metadaten und das Schema für die angegebene Tabelle innerhalb des angegebenen Datasets aus meinem 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 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/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"
    }
  ]
}

Sample Response

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