Push Datasets - Datasets PutTable

Service:

Power BI REST APIs

API Version:

v1.0

Aktualizace metadat a schématu pro zadanou tabulku v zadané datové sadě z pracovního prostoru Můj pracovní prostor.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

Toto volání rozhraní API podporuje pouze datové sady nabízených oznámení.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string	ID datové sady
tableName	path	True	string	Název tabulky

Text požadavku

Name	Vyžadováno	Typ	Description
columns	True	Column[]	Schéma sloupce pro tuto tabulku
name	True	string	Název tabulky
description		string	Popis tabulky
isHidden		boolean	Nepovinný parametr. Určuje, jestli je tato tabulka datových sad skrytá.
measures		Measure[]	Míry v této tabulce
rows		Row[]	Datové řádky v této tabulce
source		ASMashupExpression[]	Zdroj tabulky

Odpovědi

Name	Typ	Description
200 OK	Table	OK

Příklady

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

Definice

Name	Description
ASMashupExpression	Zdroj tabulky datové sady
Column	Sloupec datové sady
Measure	Míra Power BI
Row	Řádek dat v datové sadě
Table	Tabulka datových sad

ASMashupExpression

Zdroj tabulky datové sady

Name	Typ	Description
expression	string	Zdrojový výraz

Column

Sloupec datové sady

Name	Typ	Description
dataCategory	string	Nepovinný parametr. Řetězcová hodnota, která se má použít pro kategorii dat, která popisuje data v tomto sloupci.
dataType	string	Datový typ sloupce
formatString	string	Nepovinný parametr. Formát sloupce, jak je uvedeno v FORMAT_STRING.
isHidden	boolean	Nepovinný parametr. Určuje, jestli je sloupec skrytý. Výchozí formát je false.
name	string	Název sloupce
sortByColumn	string	Nepovinný parametr. Název řetězce pro sloupec ve stejné tabulce, podle kterého se seřadí aktuální sloupec.
summarizeBy	string	Nepovinný parametr. Agregační funkce, která se má použít ke shrnutí tohoto sloupce.

Measure

Míra Power BI

Name	Typ	Description
description	string	Nepovinný parametr. Popis míry.
expression	string	Platný výraz DAX
formatString	string	Nepovinný parametr. Řetězec popisující, jak se má hodnota formátovat, když se zobrazí podle FORMAT_STRING.
isHidden	boolean	Nepovinný parametr. Jestli je míra skrytá.
name	string	Název míry

Row

Řádek dat v datové sadě

Name	Typ	Description
id	string	Jedinečné ID řádku

Table

Tabulka datových sad

Name	Typ	Description
columns	Column[]	Schéma sloupce pro tuto tabulku
description	string	Popis tabulky
isHidden	boolean	Nepovinný parametr. Určuje, jestli je tato tabulka datových sad skrytá.
measures	Measure[]	Míry v této tabulce
name	string	Název tabulky
rows	Row[]	Datové řádky v této tabulce
source	ASMashupExpression[]	Zdroj tabulky