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 |
---|---|---|---|---|
dataset
|
path | True |
string |
ID du jeu de données |
table
|
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 |
Source de la table |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
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 |
---|---|
ASMashup |
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 |
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 |
Source de la table |