Compartilhar via

Push Datasets - Datasets PutTable

Serviço:
Power BI REST APIs
Versão da API:
v1.0

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

Escopo necessário

Dataset.ReadWrite.All

Limitações

Essa chamada de API dá suporte apenas 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

pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$

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

OKEY

Exemplos

Example

Solicitação de exemplo

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/tables/Product
Corpo da solicitação
{
  "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"
    }
  ]
}

Resposta de exemplo

Código de status:
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

Objeto

Uma fonte de tabela de conjunto de dados

Nome Tipo Description
expression

string

A expressão de origem

Column

Objeto

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

pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$

O nome da coluna
sortByColumn

string

Opcional. Nome da cadeia de caracteres de uma coluna na mesma tabela a ser usada para ordenar a coluna atual.
summarizeBy

string

Opcional. A função de agregação a ser usada para resumir esta coluna.

Measure

Objeto

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

pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$

O nome da medida

Row

Objeto

Uma linha de dados em um conjunto de dados

Nome Tipo Description
id

string

A ID de linha exclusiva

Table

Objeto

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

pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$

O nome da tabela
rows

Row[]

As linhas de dados dentro desta tabela
source

ASMashupExpression[]

A origem da tabela