Push Datasets - Datasets PutTable

Usługa:

Power BI REST APIs

Wersja interfejsu API:

v1.0

Aktualizuje metadane i schemat określonej tabeli w określonym zestawie danych z 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 pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$	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

Przykładowe żądanie

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/tables/Product

Treść żądania

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

Przykładowa odpowiedź

Kod stanu:

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

Objekt

Źródło tabeli zestawu danych

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

Column

Objekt

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 pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$	Nazwa kolumny
sortByColumn	string	Opcjonalny. Nazwa ciągu kolumny w tej samej tabeli, która ma być używana do zamawiania bieżącej kolumny.
summarizeBy	string	Opcjonalny. Funkcja agregacji używana do podsumowywania tej kolumny.

Measure

Objekt

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, gdy jest on wyświetlany zgodnie z opisem w FORMAT_STRING.
isHidden	boolean	Opcjonalny. Czy miara jest ukryta.
name	string pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$	Nazwa miary

Row

Objekt

Wiersz danych w zestawie danych

Nazwa	Typ	Opis
id	string	Unikatowy identyfikator wiersza

Table

Objekt

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 pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$	Nazwa tabeli
rows	Row[]	Wiersze danych w tej tabeli
source	ASMashupExpression[]	Źródło tabeli