Push Datasets - Datasets PutTable

Service:

Power BI REST APIs

API Version:

v1.0

Aktualizacje metadanych i schematu dla określonej tabeli w określonym zestawie danych z obszaru Mój obszar roboczy.

Wymagany zakres

Dataset.ReadWrite.All

Ograniczenia

To wywołanie interfejsu API obsługuje tylko zestawy danych wypychania.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
datasetId	path	True	string	Identyfikator zestawu danych
tableName	path	True	string	Nazwa tabeli

Treść żądania

Nazwa	Wymagane	Typ	Opis
columns	True	Column[]	Schemat kolumny dla tej tabeli
name	True	string	Nazwa tabeli
description		string	Opis tabeli
isHidden		boolean	Opcjonalny. Czy ta tabela zestawów danych jest ukryta.
measures		Measure[]	Miary w tej tabeli
rows		Row[]	Wiersze danych w tej tabeli
source		ASMashupExpression[]	Źródło tabeli

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Table	OK

Przykłady

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

Definicje

Nazwa	Opis
ASMashupExpression	Źródło tabeli zestawu danych
Column	Kolumna zestawu danych
Measure	Miara usługi Power BI
Row	Wiersz danych w zestawie danych
Table	Tabela zestawu danych

ASMashupExpression

Źródło tabeli zestawu danych

Nazwa	Typ	Opis
expression	string	Wyrażenie źródłowe

Column

Kolumna zestawu danych

Nazwa	Typ	Opis
dataCategory	string	Opcjonalny. Wartość ciągu, która ma być używana dla kategorii danych, która opisuje dane w tej kolumnie.
dataType	string	Typ danych kolumny
formatString	string	Opcjonalny. Format kolumny określony w FORMAT_STRING.
isHidden	boolean	Opcjonalny. Czy kolumna jest ukryta. Wartość domyślna to false.
name	string	Nazwa kolumny
sortByColumn	string	Opcjonalny. Nazwa ciągu kolumny w tej samej tabeli, która ma być używana do porządkowania bieżącej kolumny.
summarizeBy	string	Opcjonalny. Funkcja agregacji do użycia do podsumowania tej kolumny.

Measure

Miara usługi Power BI

Nazwa	Typ	Opis
description	string	Opcjonalny. Opis miary.
expression	string	Prawidłowe wyrażenie języka DAX
formatString	string	Opcjonalny. Ciąg opisujący sposób formatowania wartości po wyświetleniu jej zgodnie z FORMAT_STRING.
isHidden	boolean	Opcjonalny. Czy miara jest ukryta.
name	string	Nazwa miary

Row

Wiersz danych w zestawie danych

Nazwa	Typ	Opis
id	string	Unikatowy identyfikator wiersza

Table

Tabela zestawu danych

Nazwa	Typ	Opis
columns	Column[]	Schemat kolumny dla tej tabeli
description	string	Opis tabeli
isHidden	boolean	Opcjonalny. Czy ta tabela zestawów danych jest ukryta.
measures	Measure[]	Miary w tej tabeli
name	string	Nazwa tabeli
rows	Row[]	Wiersze danych w tej tabeli
source	ASMashupExpression[]	Źródło tabeli