Push Datasets - Datasets PutTable

Service:

Power BI REST APIs

API Version:

v1.0

Aggiornamenti i metadati e lo schema per la tabella specificata all'interno del set di dati specificato dall'area di lavoro personale.

Ambito obbligatorio

Dataset.ReadWrite.All

Limitazioni

Questa chiamata API supporta solo set di dati push.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasetId	path	True	string	ID del set di dati
tableName	path	True	string	Il nome della tabella

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
columns	True	Column[]	Schema di colonna per questa tabella
name	True	string	Il nome della tabella
description		string	Descrizione della tabella
isHidden		boolean	Facoltativa. Indica se questa tabella del set di dati è nascosta.
measures		Measure[]	Misure all'interno di questa tabella
rows		Row[]	Righe di dati all'interno di questa tabella
source		ASMashupExpression[]	Origine tabella

Risposte

Nome	Tipo	Descrizione
200 OK	Table	OK

Esempio

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

Definizioni

Nome	Descrizione
ASMashupExpression	Origine tabella del set di dati
Column	Colonna del set di dati
Measure	Misura di Power BI
Row	Riga di dati in un set di dati
Table	Tabella del set di dati

ASMashupExpression

Origine tabella del set di dati

Nome	Tipo	Descrizione
expression	string	Espressione di origine

Column

Colonna del set di dati

Nome	Tipo	Descrizione
dataCategory	string	Facoltativa. Valore stringa da usare per la categoria di dati che descrive i dati all'interno di questa colonna.
dataType	string	Tipo di dati della colonna
formatString	string	Facoltativa. Formato della colonna come specificato in FORMAT_STRING.
isHidden	boolean	Facoltativa. Se la colonna è nascosta. Il valore predefinito è false.
name	string	Nome colonna
sortByColumn	string	Facoltativa. Nome stringa di una colonna nella stessa tabella da usare per ordinare la colonna corrente.
summarizeBy	string	facoltativo. Funzione di aggregazione da usare per riepilogare questa colonna.

Measure

Misura di Power BI

Nome	Tipo	Descrizione
description	string	Facoltativa. Descrizione della misura.
expression	string	Espressione DAX valida
formatString	string	Facoltativa. Stringa che descrive come il valore deve essere formattato quando viene visualizzato come specificato in FORMAT_STRING.
isHidden	boolean	Facoltativa. Indica se la misura è nascosta.
name	string	Nome della misura

Row

Riga di dati in un set di dati

Nome	Tipo	Descrizione
id	string	ID riga univoco

Table

Tabella del set di dati

Nome	Tipo	Descrizione
columns	Column[]	Schema di colonna per questa tabella
description	string	Descrizione della tabella
isHidden	boolean	Facoltativa. Indica se questa tabella del set di dati è nascosta.
measures	Measure[]	Misure all'interno di questa tabella
name	string	Il nome della tabella
rows	Row[]	Righe di dati all'interno di questa tabella
source	ASMashupExpression[]	Origine tabella