Étape 3 : Créer un jeu de données dans Power BIStep 3: Create a dataset in Power BI

Cet article fait partie d’une procédure pas à pas pour transmettre des données à un jeu de données.This article is part of a step-by-step walkthrough to push data into a dataset.

À l’étape 2 de la procédure de transmission des données à un jeu de données intitulée Obtenir un jeton d’accès d’authentification, vous avez obtenu un jeton pour vous authentifier auprès d’Azure AD.In step 2 of Push data into a dataset, Get an authentication access token, you got a token to authenticate to Azure AD. Pendant cette étape, vous utilisez le jeton pour appeler l’opération Créer un jeu de données.In this step, you use the token to call the Create Dataset operation.

Pour appeler une ressource REST, vous utilisez une URL qui localise la ressource et vous envoyez une chaîne JSON (JavaScript Objet Notation), qui décrit le jeu de données, à la ressource du service Power BI.To make a call to a REST resource, you use a url that locates the resource, and you send a JavaScript Object Notation (JSON) string, which describes the dataset, to the Power BI service resource. Une ressource REST identifie la partie du service Power BI que vous voulez utiliser.A REST resource identifies the part of the Power BI service you want to work with. Pour transmettre des données au jeu de données, la ressource cible est un jeu de données.To push data into the dataset, the target resource is a Dataset. L’URL qui identifie un jeu de données est https://api.PowerBI.com/v1.0/myorg/datasets.The URL that identifies a dataset is https://api.PowerBI.com/v1.0/myorg/datasets. Si vous transmettez les données dans un groupe, l’URL est https://api.PowerBI.com/v1.0/myorg/groups/{id_groupe}/datasets.If you are pushing data within a group, the url is https://api.PowerBI.com/v1.0/myorg/groups/{group_id}/datasets.

Pour authentifier une opération REST Power BI, vous ajoutez le jeton que vous avez obtenu à l’étape Obtenir un jeton d’accès d’authentification à un en-tête de demande :To authenticate a Power BI REST operation, you add the token you got in Get an authentication access token to a request header:

Quand vous appelez l’opération Créer un jeu de données, un jeu de données est créé.When you call the Create Dataset operation, a new dataset is created.

Voici comment créer un jeu de données dans Power BI.Here's how to create a dataset in Power BI.

Créer un jeu de données dans Power BICreate a dataset in Power BI

Note

Avant de commencer, veillez à suivre les étapes précédentes de la procédure pas à pas Transmettre des données à un jeu de données.Before you get started, make sure you have followed the previous steps in the push data into a dataset walkthrough.

  1. Dans le projet Application console que vous avez créé à l’étape 2 : obtenir un jeton d’accès d’authentification, ajoutez using System.Net; et using System.IO; au fichier Program.cs.In the Console Application project you created in Step 2 - Get an authentication access token, add using System.Net;, and using System.IO; to Program.cs.
  2. Dans le fichier Program.cs, ajoutez le code suivant.In Program.cs, add the code below.
  3. Exécutez l’application console, puis connectez-vous à votre compte Power BI.Run the Console App, and login to your Power BI account. Le jeu de données créé doit apparaître dans la fenêtre de console.You should see Dataset Created in the Console Window. De plus, vous pouvez vous connecter à Power BI pour voir le nouveau jeu de données.Also, you can login to Power BI to see the new dataset.

Exemple de transmission de données à un jeu de donnéesSample push data into a dataset

Ajoutez ce code dans le fichier Program.cs.Add this code into Program.cs.

  • Dans static void Main(string[] args) :In static void Main(string[] args):

    static void Main(string[] args)
    {
        //Get an authentication access token
        token = GetToken();
    
        //Create a dataset in Power BI
        CreateDataset();
    }
    
  • Ajoutez une méthode CreateDataset() :Add a CreateDataset() method:

    #region Create a dataset in Power BI
    private static void CreateDataset()
    {
        //TODO: Add using System.Net and using System.IO
    
        string powerBIDatasetsApiUrl = "https://api.powerbi.com/v1.0/myorg/datasets";
        //POST web request to create a dataset.
        //To create a Dataset in a group, use the Groups uri: https://api.PowerBI.com/v1.0/myorg/groups/{group_id}/datasets
        HttpWebRequest request = System.Net.WebRequest.Create(powerBIDatasetsApiUrl) as System.Net.HttpWebRequest;
        request.KeepAlive = true;
        request.Method = "POST";
        request.ContentLength = 0;
        request.ContentType = "application/json";
    
        //Add token to the request header
        request.Headers.Add("Authorization", String.Format("Bearer {0}", token));
    
        //Create dataset JSON for POST request
        string datasetJson = "{\"name\": \"SalesMarketing\", \"tables\": " +
            "[{\"name\": \"Product\", \"columns\": " +
            "[{ \"name\": \"ProductID\", \"dataType\": \"Int64\"}, " +
            "{ \"name\": \"Name\", \"dataType\": \"string\"}, " +
            "{ \"name\": \"Category\", \"dataType\": \"string\"}," +
            "{ \"name\": \"IsCompete\", \"dataType\": \"bool\"}," +
            "{ \"name\": \"ManufacturedOn\", \"dataType\": \"DateTime\"}" +
            "]}]}";
    
        //POST web request
        byte[] byteArray = System.Text.Encoding.UTF8.GetBytes(datasetJson);
        request.ContentLength = byteArray.Length;
    
        //Write JSON byte[] into a Stream
        using (Stream writer = request.GetRequestStream())
        {
            writer.Write(byteArray, 0, byteArray.Length);
    
            var response = (HttpWebResponse)request.GetResponse();
    
            Console.WriteLine(string.Format("Dataset {0}", response.StatusCode.ToString()));
    
            Console.ReadLine();
        }
    }
    #endregion
    

L’étape suivante vous montre comment obtenir un jeu de données pour ajouter des lignes à une table Power BI.The next step shows you how to get a dataset to add rows into a Power BI table.

Ci-après figure le listing du code complet.Below is the complete code listing.

Listing du code completComplete code listing

using System;
using Microsoft.IdentityModel.Clients.ActiveDirectory;
using System.Net;
using System.IO;

namespace walkthrough_push_data
{
    class Program
    {
        private static string token = string.Empty;

        static void Main(string[] args)
        {

            //Get an authentication access token
            token = GetToken();

            //Create a dataset in Power BI
            CreateDataset();

        }

        #region Get an authentication access token
        private static string GetToken()
        {
            // TODO: Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory -Version 2.21.301221612
            // and add using Microsoft.IdentityModel.Clients.ActiveDirectory

            //The client id that Azure AD created when you registered your client app.
            string clientID = "{Client_ID}";

            //RedirectUri you used when you register your app.
            //For a client app, a redirect uri gives Azure AD more details on the application that it will authenticate.
            // You can use this redirect uri for your client app
            string redirectUri = "https://login.live.com/oauth20_desktop.srf";

            //Resource Uri for Power BI API
            string resourceUri = "https://analysis.windows.net/powerbi/api";

            //OAuth2 authority Uri
            string authorityUri = "https://login.windows.net/common/oauth2/authorize";

            //Get access token:
            // To call a Power BI REST operation, create an instance of AuthenticationContext and call AcquireToken
            // AuthenticationContext is part of the Active Directory Authentication Library NuGet package
            // To install the Active Directory Authentication Library NuGet package in Visual Studio,
            //  run "Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory" from the nuget Package Manager Console.

            // AcquireToken will acquire an Azure access token
            // Call AcquireToken to get an Azure token from Azure Active Directory token issuance endpoint
            AuthenticationContext authContext = new AuthenticationContext(authorityUri);
            string token = authContext.AcquireToken(resourceUri, clientID, new Uri(redirectUri)).AccessToken;

            Console.WriteLine(token);
            Console.ReadLine();

            return token;
        }

        #endregion


        #region Create a dataset in Power BI
        private static void CreateDataset()
        {
            //TODO: Add using System.Net and using System.IO

            string powerBIDatasetsApiUrl = "https://api.powerbi.com/v1.0/myorg/datasets";
            //POST web request to create a dataset.
            //To create a Dataset in a group, use the Groups uri: https://api.PowerBI.com/v1.0/myorg/groups/{group_id}/datasets
            HttpWebRequest request = System.Net.WebRequest.Create(powerBIDatasetsApiUrl) as System.Net.HttpWebRequest;
            request.KeepAlive = true;
            request.Method = "POST";
            request.ContentLength = 0;
            request.ContentType = "application/json";

            //Add token to the request header
            request.Headers.Add("Authorization", String.Format("Bearer {0}", token));

            //Create dataset JSON for POST request
            string datasetJson = "{\"name\": \"SalesMarketing\", \"tables\": " +
                "[{\"name\": \"Product\", \"columns\": " +
                "[{ \"name\": \"ProductID\", \"dataType\": \"Int64\"}, " +
                "{ \"name\": \"Name\", \"dataType\": \"string\"}, " +
                "{ \"name\": \"Category\", \"dataType\": \"string\"}," +
                "{ \"name\": \"IsCompete\", \"dataType\": \"bool\"}," +
                "{ \"name\": \"ManufacturedOn\", \"dataType\": \"DateTime\"}" +
                "]}]}";

            //POST web request
            byte[] byteArray = System.Text.Encoding.UTF8.GetBytes(datasetJson);
            request.ContentLength = byteArray.Length;

            //Write JSON byte[] into a Stream
            using (Stream writer = request.GetRequestStream())
            {
                writer.Write(byteArray, 0, byteArray.Length);

                var response = (HttpWebResponse)request.GetResponse();

                Console.WriteLine(string.Format("Dataset {0}", response.StatusCode.ToString()));

                Console.ReadLine();
            }
        }
        #endregion
    }
}

Étape suivante >Next Step >

Étapes suivantesNext steps

Obtenir un jeu de données pour ajouter des lignes à une table Power BIGet a dataset to add rows into a Power BI table
Obtenir un jeton d’accès d’authentificationGet an authentication access token
Créer un jeu de donnéesCreate Dataset
Transmettre des données à un tableau de bord Power BIPush data into a Power BI Dashboard
Vue d’ensemble de l’API REST Power BIOverview of Power BI REST API
Référence de l’API REST de Power BIPower BI REST API reference

D’autres questions ?More questions? Posez vos questions à la communauté Power BITry the Power BI Community