Push Datasets - Datasets PutTable

Service:

Power BI REST APIs

API Version:

v1.0

Novedades los metadatos y el esquema de la tabla especificada dentro del conjunto de datos especificado de 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	El nombre de la tabla

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
columns	True	Column[]	Esquema de columna de esta tabla
name	True	string	El 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	Aceptar

Ejemplos

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

Definiciones

Nombre	Description
ASMashupExpression	Un origen de 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

Un origen de tabla de conjunto de datos

Nombre	Tipo	Description
expression	string	Expresión de origen

Column

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 y como se especifica en FORMAT_STRING.
isHidden	boolean	Opcional. Si la columna está oculta. De manera predeterminada, es false.
name	string	Nombre de columna
sortByColumn	string	Opcional. Nombre de cadena de una columna de la misma tabla que se va a usar para ordenar la columna actual.
summarizeBy	string	Opcional. Función de agregado que se va a usar para resumir esta columna.

Measure

Una medida de Power BI

Nombre	Tipo	Description
description	string	Opcional. Descripción de la medida.
expression	string	Una 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. Si la medida está oculta.
name	string	Nombre de la medida

Row

Fila de datos de un conjunto de datos

Nombre	Tipo	Description
id	string	Identificador de fila único

Table

Una tabla de conjunto de datos

Nombre	Tipo	Description
columns	Column[]	Esquema de columna de 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	El nombre de la tabla
rows	Row[]	Filas de datos dentro de esta tabla
source	ASMashupExpression[]	Origen de la tabla