Partager via

Push Datasets - Datasets PutTable

Service:
Power BI REST APIs
Version d'API:
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 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

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

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

Nom de la table
description

string

Description du tableau
isHidden

boolean

Optionnel. 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 de cette table
source

ASMashupExpression[]

Source de la table

Réponses

Nom Type Description
200 OK

Table

D’ACCORD

Exemples

Example

Exemple de requête

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

Exemple de réponse

Code d’état:
200 
{
  "name": "Product"
}

Définitions

Nom Description
ASMashupExpression

Source d’une table de jeux de données
Column

Colonne de jeu de données
Measure

Une mesure Power BI
Row

Une ligne de données dans un jeu de données
Table

Table de jeux de données

ASMashupExpression

Object

Source d’une table de jeux de données

Nom Type Description
expression

string

Expression source

Column

Object

Colonne de jeu de données

Nom Type Description
dataCategory

string

Optionnel. 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

Optionnel. Format de la colonne comme spécifié dans FORMAT_STRING.
isHidden

boolean

Optionnel. Indique si la colonne est masquée. La valeur par défaut est false.
name

string

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

Nom de la colonne
sortByColumn

string

Optionnel. Nom de chaîne d’une colonne dans la même table à utiliser pour classer la colonne active.
summarizeBy

string

Optionnel. Fonction d’agrégation à utiliser pour résumer cette colonne.

Measure

Object

Une mesure Power BI

Nom Type Description
description

string

Optionnel. Description de la mesure.
expression

string

Expression DAX valide
formatString

string

Optionnel. Chaîne décrivant la façon dont la valeur doit être mise en forme lorsqu’elle est affichée comme spécifié dans FORMAT_STRING.
isHidden

boolean

Optionnel. Indique si la mesure est masquée.
name

string

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

Nom de la mesure

Row

Object

Une ligne de données dans un jeu de données

Nom Type Description
id

string

ID de ligne unique

Table

Object

Table de jeux de données

Nom Type Description
columns

Column[]

Schéma de colonne pour cette table
description

string

Description du tableau
isHidden

boolean

Optionnel. Indique si cette table de jeu de données est masquée.
measures

Measure[]

Mesures contenues dans ce tableau
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}$

Nom de la table
rows

Row[]

Lignes de données de cette table
source

ASMashupExpression[]

Source de la table