Partilhar via


Push Datasets - Datasets PutTableInGroup

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

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
datasetId
path True

string

A ID do conjunto de dados

groupId
path True

string

uuid

A ID do workspace

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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/tables/Product
{
  "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

{
  "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 nesta 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