Passaggio 3: Creare un set di dati in Power BIStep 3: Create a dataset in Power BI

Questo articolo fa parte di una procedura dettagliata per il push dei dati in un set di dati.This article is part of a step-by-step walkthrough to push data into a dataset.

Nel passaggio 2 Ottenere un token di accesso per l'autenticazione della procedura per il push dei dati in un set di dati è stato ottenuto un token per l'autenticazione in 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. In questo passaggio il token viene usato per chiamare l'operazione Create Dataset.In this step, you use the token to call the Create Dataset operation.

Per effettuare una chiamata a una risorsa REST, si usa un URL che individua la risorsa e si invia una stringa JSON (JavaScript Object Notation), che descrive il set di dati, alla risorsa del servizio 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. Una risorsa REST identifica la parte del servizio Power BI con cui si vuole lavorare.A REST resource identifies the part of the Power BI service you want to work with. Per il push dei dati nel set di dati, la risorsa di destinazione è un set di dati.To push data into the dataset, the target resource is a Dataset. L'URL che identifica un set di dati è https://api.PowerBI.com/v1.0/myorg/datasets.The URL that identifies a dataset is https://api.PowerBI.com/v1.0/myorg/datasets. Se si esegue il push dei dati all'interno di un gruppo, l'url è https://api.PowerBI.com/v1.0/myorg/groups/{group_id}/datasets.If you are pushing data within a group, the url is https://api.PowerBI.com/v1.0/myorg/groups/{group_id}/datasets.

Per autenticare un'operazione REST di Power BI, si aggiunge il token ottenuto in Ottenere un token di accesso per l'autenticazione a un'intestazione della richiesta:To authenticate a Power BI REST operation, you add the token you got in Get an authentication access token to a request header:

Quando si chiama l'operazione Create Dataset, viene creato un nuovo set di dati.When you call the Create Dataset operation, a new dataset is created.

Ecco come creare un set di dati in un dashboard in Power BI.Here's how to create a dataset in Power BI.

Creare un set di dati in Power BICreate a dataset in Power BI

Nota

Prima di iniziare, assicurarsi di aver seguito i passaggi precedenti della procedura dettagliata per il push dei dati in un set di dati.Before you get started, make sure you have followed the previous steps in the push data into a dataset walkthrough.

  1. Nel progetto Applicazione console creato nel Passaggio 2: Ottenere un token di accesso per l'autenticazione aggiungere using System.Net; e using System.IO; a 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. In Program.cs aggiungere il codice seguente.In Program.cs, add the code below.
  3. Eseguire l'app console e accedere al proprio account di Power BI.Run the Console App, and login to your Power BI account. Nella finestra della console dovrebbe comparire Set di dati creato .You should see Dataset Created in the Console Window. È anche possibile accedere a Power BI per visualizzare il nuovo set di dati.Also, you can login to Power BI to see the new dataset.

Push di dati di esempio in un set di datiSample push data into a dataset

Aggiungere questo codice in Program.cs.Add this code into Program.cs.

  • In 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();
    }
    
  • Aggiungere un metodo 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
    

Il passaggio successivo illustra come ottenere un set di dati per aggiungere righe in una tabella di Power BI.The next step shows you how to get a dataset to add rows into a Power BI table.

Di seguito è riportato il listato di codice completo.Below is the complete code listing.

Listato di codice completoComplete 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
    }
}

Passaggio successivo >Next Step >

Passaggi successiviNext steps

Ottenere un set di dati per aggiungere righe in una tabella di Power BIGet a dataset to add rows into a Power BI table
Ottenere un token di accesso per l'autenticazioneGet an authentication access token
Crea set di datiCreate Dataset
Eseguire il push dei dati in un dashboard di Power BIPush data into a Power BI Dashboard
Panoramica dell'API REST di Power BIOverview of Power BI REST API
Riferimento all'API REST di Power BIPower BI REST API reference

Altre domande?More questions? Provare la community di Power BITry the Power BI Community