Push Datasets - Datasets PutTable

Service:

Power BI REST APIs

API Version:

v1.0

Met à jour les métadonnées et le schéma de la table spécifiée dans le jeu de données spécifié à partir de Mon espace de travail.

Étendue requise

Dataset.ReadWrite.All

Limites

Cet appel d’API prend uniquement en charge les jeux de données Push.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
datasetId	path	True	string	ID du jeu de données
tableName	path	True	string	Le nom de la table

Corps de la demande

Nom	Obligatoire	Type	Description
columns	True	Column[]	Schéma de colonne pour cette table
name	True	string	Le nom de la table
description		string	Description du tableau
isHidden		boolean	facultatif. Indique si cette table de jeu de données est masquée.
measures		Measure[]	Mesures contenues dans ce tableau
rows		Row[]	Lignes de données dans cette table
source		ASMashupExpression[]	Source de la table

Réponses

Nom	Type	Description
200 OK	Table	Ok

Exemples

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

Définitions

Nom	Description
ASMashupExpression	Source de table de jeu de données
Column	Colonne de jeu de données
Measure	Une mesure Power BI
Row	Ligne de données dans un jeu de données
Table	Une table de jeu de données

ASMashupExpression

Source de table de jeu de données

Nom	Type	Description
expression	string	Expression source

Column

Colonne de jeu de données

Nom	Type	Description
dataCategory	string	facultatif. Valeur de chaîne à utiliser pour la catégorie de données qui décrit les données de cette colonne.
dataType	string	Type de données de colonne
formatString	string	facultatif. Format de la colonne tel que spécifié dans FORMAT_STRING.
isHidden	boolean	facultatif. Indique si la colonne est masquée. La valeur par défaut est false.
name	string	Nom de colonne
sortByColumn	string	facultatif. Nom de chaîne d’une colonne dans la même table à utiliser pour trier la colonne en cours.
summarizeBy	string	Optionnel. Fonction d’agrégation à utiliser pour résumer cette colonne.

Measure

Une mesure Power BI

Nom	Type	Description
description	string	facultatif. Description de la mesure.
expression	string	Expression DAX valide
formatString	string	facultatif. Chaîne décrivant comment la valeur doit être mise en forme lorsqu’elle est affichée comme spécifié dans FORMAT_STRING.
isHidden	boolean	facultatif. Indique si la mesure est masquée.
name	string	Nom de la mesure

Row

Ligne de données dans un jeu de données

Nom	Type	Description
id	string	ID de ligne unique

Table

Une table de jeu de données

Nom	Type	Description
columns	Column[]	Schéma de colonne pour cette table
description	string	Description du tableau
isHidden	boolean	facultatif. Indique si cette table de jeu de données est masquée.
measures	Measure[]	Mesures contenues dans ce tableau
name	string	Le nom de la table
rows	Row[]	Lignes de données dans cette table
source	ASMashupExpression[]	Source de la table