Transmission de données à un jeu de données Power BIPush data into a Power BI dataset

Avec l’API Power BI, vous pouvez transmettre des données à un jeu de données Power BI.With the Power BI API, you can push data into a Power BI dataset. Par exemple, vous voulez étendre un workflow d’entreprise existant pour transmettre des données clés à votre jeu de données.For example, you want to extend an existing business workflow to push key data into your dataset. Dans ce cas, vous voulez transmettre un jeu de données Sales Marketing qui possède une table Product à un jeu de données.In this case, you want to push a Sales Marketing dataset which has a Product table into a dataset.

Avant de commencer à transmettre des données à un jeu de données, vous devez disposer d’un annuaire Azure Active Directory (Azure AD) et d’un compte Power BI.Before you get started pushing data into a dataset, you need an Azure Active Directory (Azure AD) and a Power BI account.

Étapes de transmission de données à un jeu de donnéesSteps to push data into a dataset

La section suivante est une présentation générale des opérations de l’API Power BI qui transmettent des données.The next section is a general discussion of Power BI API operations that push data.

Opérations de l’API Power BI permettant de transmettre des donnéesPower BI API operations to push data

Avec l’API REST Power BI, vous pouvez transmettre des sources de données à Power BI.With the Power BI REST API, you can push data sources to Power BI. Lorsqu’une application ajoute des lignes à un jeu de données, les vignettes du tableau de bord sont automatiquement mises à jour avec les données modifiées.When an app adds rows to a dataset, tiles on the dashboard are updated automatically with the updated data. Pour transmettre des données, vous utilisez l’opération Créer un jeu de données avec l’opération Ajouter des lignes.To push data, you use the Create Dataset operation along with the Add Rows operation. Pour trouver un jeu de données, vous utilisez l’opération Obtenir des jeux de données.To find a dataset, you use the Get Datasets operation. Pour chacune de ces opérations, vous pouvez passer un ID de groupe pour utiliser un groupe.For any of these operations, you can pass a group id to work with a group. Utilisez l’opération Obtenir des groupes pour obtenir la liste des ID de groupe.Use the Get Groups operation to get a list of group id's.

Voici les opérations permettant de transmettre des données à un jeu de données :Here are the operations to push data into a dataset:

Vous créez un jeu de données dans Power BI en passant une chaîne JSON (JavaScript Objet Notation) au service Power BI.You create a dataset in Power BI by passing a JavaScript Object Notation (JSON) string to the Power BI service. Pour en savoir plus sur JSON, consultez Présentation de JSON.To learn more about JSON, see Introducing JSON.

La chaîne JSON d’un jeu de données est au format suivant :The JSON string for a dataset has the following format:

Objet JSON de jeu de données Power BIPower BI Dataset JSON object

{"name": "dataset_name", "tables":
    [{"name": "", "columns":
        [{ "name": "column_name1", "dataType": "data_type"},
         { "name": "column_name2", "dataType": "data_type"},
         { ... }
        ]
      }
    ]
}

Ainsi, pour notre exemple de jeu de données Sales Marketing, vous transmettriez une chaîne JSON, comme dans l’exemple ci-dessous.So, for our Sales Marketing dataset example, you would pass a JSON string such as the example below. Dans cet exemple, SalesMarketing est le nom du jeu de données et Product le nom de la table.In this example, SalesMarketing is the name of the dataset, and Product is the name of the table. Après avoir défini la table, vous définissez le schéma de table.After you define the table, you define the table schema. Pour le jeu de données SalesMarketing , le schéma de table comporte ces colonnes : ProductID, Manufacturer, Category, Segment, Product et IsCompete.For the SalesMarketing dataset, the table schema has these columns: ProductID, Manufacturer, Category, Segment, Product, and IsCompete.

Exemple d’objet JSON de jeu de donnéesExample dataset object JSON

{
    "name": "SalesMarketing",
    "tables": [
        {
            "name": "Product",
            "columns": [
            {
                "name": "ProductID",
                "dataType": "int"
            },
            {
                "name": "Manufacturer",
                "dataType": "string"
            },
            {
                "name": "Category",
                "dataType": "string"
            },
            {
                "name": "Segment",
                "dataType": "string"
            },
            {
                "name": "Product",
                "dataType": "string"
            },
            {
                "name": "IsCompete",
                "dataType": "bool"
            }
            ]
        }
    ]
}

Pour un schéma de table Power BI, vous pouvez utiliser les types de données suivants.For a Power BI table schema, you can use the following data types.

Types de données de table Power BIPower BI table data types

Type de donnéesData type RestrictionsRestrictions
Int64Int64 Valeurs Int64.MaxValue et Int64.MinValue non autorisées.Int64.MaxValue and Int64.MinValue not allowed.
DoubleDouble Les valeurs Double.MaxValue et Double.MinValue ne sont pas autorisées.Double.MaxValue and Double.MinValue values not allowed. NAN non pris en charge. + Infinity et - Infinity non pris en charge dans certaines fonctions (par exemple, Min, Max).NaN not supported.+Infinity and -Infinity not supported in some functions (e.g. Min, Max).
BooleanBoolean AucunNone
DateTimeDatetime Lors du chargement des données nous quantifions les valeurs avec des fractions de jour en multiples de 1/300ème de seconde (3.33ms).During data loading we quantize values with day fractions to whole multiples of 1/300 seconds (3.33ms).
StringString Autorise actuellement jusqu’à 128 Ko de caractères.Currently allows up to 128K characters.

En savoir plus sur la transmission de données à Power BILearn more about pushing data into Power BI

Pour commencer à transmettre des données à un jeu de données, consultez Étape 1 : Inscrire une application auprès d’Azure AD dans le volet de navigation gauche.To get started pushing data into a dataset, see Step 1: Register an app with Azure AD in the left navigation pane.

Étape suivante >Next Step >

Étapes suivantesNext steps

S’inscrire à Power BISign up for Power BI
Créer un jeu de donnéesCreate Dataset
Obtenir des jeux de donnéesGet Datasets
Ajouter des lignesAdd Rows
Obtenir des groupesGet Groups
Présentation de JSONIntroducing JSON
Vue d’ensemble de l’API REST Power BIOverview of Power BI REST API
D’autres questions ?More questions? Posez vos questions à la communauté Power BITry the Power BI Community