Push Datasets - Datasets PutTableInGroup

Služba:

Power BI REST APIs

Verze rozhraní API:

v1.0

Aktualizuje metadata a schéma pro zadanou tabulku v zadané datové sadě ze zadaného pracovního prostoru.

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/groups/{groupId}/datasets/{datasetId}/tables/{tableName}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string	ID datové sady
groupId	path	True	string (uuid)	ID pracovního prostoru
tableName	path	True	string	Název tabulky

Text požadavku

Name	Vyžadováno	Typ	Description
columns	True	Column[]	Schéma sloupců pro tuto tabulku
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}$	Název tabulky
description		string	Popis tabulky
isHidden		boolean	Volitelný. Určuje, jestli je tato tabulka datové sady skrytá.
measures		Measure[]	Míry v této tabulce
rows		Row[]	Řádky dat v této tabulce
source		ASMashupExpression[]	Zdroj tabulky

Odpovědi

Name	Typ	Description
200 OK	Table	OK

Příklady

Example

Ukázkový požadavek

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/tables/Product

Text požadavku

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

Ukázková odpověď

Stavový kód:

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

Objekt

Zdroj tabulky datové sady

Name	Typ	Description
expression	string	Zdrojový výraz

Column

Objekt

Sloupec datové sady

Name	Typ	Description
dataCategory	string	Volitelný. Řetězcová hodnota, která se má použít pro kategorii dat, která popisují data v tomto sloupci.
dataType	string	Datový typ sloupce
formatString	string	Volitelný. Formát sloupce, jak je uvedeno v FORMAT_STRING.
isHidden	boolean	Volitelný. Určuje, jestli je sloupec skrytý. Výchozí hodnota je false.
name	string pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$	Název sloupce
sortByColumn	string	Volitelný. Název řetězce sloupce ve stejné tabulce, který se má použít k seřazení aktuálního sloupce.
summarizeBy	string	Volitelný. Agregační funkce, která se má použít pro souhrn tohoto sloupce.

Measure

Objekt

Míra Power BI

Name	Typ	Description
description	string	Volitelný. Popis míry.
expression	string	Platný výraz DAX
formatString	string	Volitelný. Řetězec popisující, jak má být hodnota formátována, když je zobrazena, jak je uvedeno v FORMAT_STRING.
isHidden	boolean	Volitelný. Určuje, jestli je míra skrytá.
name	string pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$	Název míry

Row

Objekt

Řádek dat v datové sadě

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

Table

Objekt

Tabulka datových sad

Name	Typ	Description
columns	Column[]	Schéma sloupců pro tuto tabulku
description	string	Popis tabulky
isHidden	boolean	Volitelný. Určuje, jestli je tato tabulka datové sady skrytá.
measures	Measure[]	Míry v této tabulce
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}$	Název tabulky
rows	Row[]	Řádky dat v této tabulce
source	ASMashupExpression[]	Zdroj tabulky