Push Datasets - Datasets PutTable

Service:

Power BI REST APIs

API Version:

v1.0

Atualizações os metadados e o esquema da tabela especificada dentro do conjunto de dados especificado do meu workspace.

Escopo necessário

Dataset.ReadWrite.All

Limitações

Essa chamada de API só dá suporte a conjuntos de dados por push.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
datasetId	path	True	string	A ID do conjunto de dados
tableName	path	True	string	O nome da tabela

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
columns	True	Column[]	O esquema de coluna para esta tabela
name	True	string	O nome da tabela
description		string	A descrição da tabela
isHidden		boolean	Opcional. Se essa tabela de conjunto de dados está oculta.
measures		Measure[]	As medidas dentro desta tabela
rows		Row[]	As linhas de dados dentro desta tabela
source		ASMashupExpression[]	A origem da tabela

Respostas

Nome	Tipo	Description
200 OK	Table	OK

Exemplos

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

Definições

Nome	Description
ASMashupExpression	Uma fonte de tabela de conjunto de dados
Column	Uma coluna de conjunto de dados
Measure	Uma medida do Power BI
Row	Uma linha de dados em um conjunto de dados
Table	Uma tabela de conjunto de dados

ASMashupExpression

Uma fonte de tabela de conjunto de dados

Nome	Tipo	Description
expression	string	A expressão de origem

Column

Uma coluna de conjunto de dados

Nome	Tipo	Description
dataCategory	string	Opcional. O valor da cadeia de caracteres a ser usado para a categoria de dados que descreve os dados nessa coluna.
dataType	string	O tipo de dados de coluna
formatString	string	Opcional. O formato da coluna conforme especificado em FORMAT_STRING.
isHidden	boolean	Opcional. Se a coluna está oculta. O padrão é false.
name	string	O nome da coluna
sortByColumn	string	Opcional. Nome da cadeia de caracteres de uma coluna na mesma tabela para ser usada para classificar a coluna atual.
summarizeBy	string	Opcional. A função de agregação a ser usada para resumir esta coluna.

Measure

Uma medida do Power BI

Nome	Tipo	Description
description	string	Opcional. A descrição da medida.
expression	string	Uma expressão DAX válida
formatString	string	Opcional. Uma cadeia de caracteres que descreve como o valor deve ser formatado quando ele é exibido conforme especificado em FORMAT_STRING.
isHidden	boolean	Opcional. Se a medida está oculta.
name	string	O nome da medida

Row

Uma linha de dados em um conjunto de dados

Nome	Tipo	Description
id	string	A ID de linha exclusiva

Table

Uma tabela de conjunto de dados

Nome	Tipo	Description
columns	Column[]	O esquema de coluna para esta tabela
description	string	A descrição da tabela
isHidden	boolean	Opcional. Se essa tabela de conjunto de dados está oculta.
measures	Measure[]	As medidas dentro desta tabela
name	string	O nome da tabela
rows	Row[]	As linhas de dados dentro desta tabela
source	ASMashupExpression[]	A origem da tabela