Compartir a través de

Push Datasets - Datasets PutTable

Servicio:
Power BI REST APIs
Versión de la API:
v1.0

Actualiza los metadatos y el esquema de la tabla especificada dentro del conjunto de datos especificado desde Mi área de trabajo.

Ámbito requerido

Dataset.ReadWrite.All

Limitaciones

Esta llamada API solo admite conjuntos de datos de inserción. 

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
datasetId
 path True

string

Identificador del conjunto de datos
tableName
 path True

string

Nombre de la tabla

Cuerpo de la solicitud

Nombre Requerido Tipo Description
columns True

Column[]

Esquema de columna para esta tabla
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}$

Nombre de la tabla
description

string

Descripción de la tabla
isHidden

boolean

Opcional. Si esta tabla de conjunto de datos está oculta.
measures

Measure[]

Las medidas de esta tabla
rows

Row[]

Filas de datos dentro de esta tabla
source

ASMashupExpression[]

Origen de la tabla

Respuestas

Nombre Tipo Description
200 OK

Table

De acuerdo

Ejemplos

Example

Solicitud de ejemplo

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/tables/Product
Cuerpo de la solicitud
{
  "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"
    }
  ]
}

Respuesta de muestra

status code:
200 
{
  "name": "Product"
}

Definiciones

Nombre Description
ASMashupExpression

Origen de una tabla de conjunto de datos
Column

Una columna de conjunto de datos
Measure

Una medida de Power BI
Row

Fila de datos de un conjunto de datos
Table

Una tabla de conjunto de datos

ASMashupExpression

Object

Origen de una tabla de conjunto de datos

Nombre Tipo Description
expression

string

Expresión de origen

Column

Object

Una columna de conjunto de datos

Nombre Tipo Description
dataCategory

string

Opcional. Valor de cadena que se va a usar para la categoría de datos que describe los datos de esta columna.
dataType

string

Tipo de datos de columna
formatString

string

Opcional. Formato de la columna tal como se especifica en FORMAT_STRING.
isHidden

boolean

Opcional. Indica si la columna está oculta. El valor predeterminado es false.
name

string

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

Nombre de columna
sortByColumn

string

Opcional. Nombre de cadena de una columna de la misma tabla que se usará para ordenar la columna actual.
summarizeBy

string

Opcional. Función de agregado que se va a usar para resumir esta columna.

Measure

Object

Una medida de Power BI

Nombre Tipo Description
description

string

Opcional. Descripción de la medida.
expression

string

Expresión DAX válida
formatString

string

Opcional. Cadena que describe cómo se debe dar formato al valor cuando se muestra como se especifica en FORMAT_STRING.
isHidden

boolean

Opcional. Indica si la medida está oculta.
name

string

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

Nombre de la medida

Row

Object

Fila de datos de un conjunto de datos

Nombre Tipo Description
id

string

Identificador de fila único

Table

Object

Una tabla de conjunto de datos

Nombre Tipo Description
columns

Column[]

Esquema de columna para esta tabla
description

string

Descripción de la tabla
isHidden

boolean

Opcional. Si esta tabla de conjunto de datos está oculta.
measures

Measure[]

Las medidas de esta tabla
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}$

Nombre de la tabla
rows

Row[]

Filas de datos dentro de esta tabla
source

ASMashupExpression[]

Origen de la tabla