Udostępnij przez

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