Push Datasets - Datasets PutTable

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

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