Paso 3: Creación de un conjunto de datos en Power BIStep 3: Create a dataset in Power BI

Este artículo forma parte de un tutorial paso a paso para insertar datos en un conjunto de datos.This article is part of a step-by-step walkthrough to push data into a dataset.

En el paso 2 de Insertar datos en un conjunto de datos, Obtener un token de acceso de autenticación, obtuvo un token para autenticarse en 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. En este paso, el token se usa para llamar a la operación Crear conjunto de datos.In this step, you use the token to call the Create Dataset operation.

Para realizar una llamada a un recurso de REST, se usa una dirección URL que localiza el recurso y se envía una cadena de notación de objetos JavaScript (JSON), que describe el conjunto de datos, al recurso del servicio 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. Un recurso de REST identifica la parte del servicio Power BI con la que quiere trabajar.A REST resource identifies the part of the Power BI service you want to work with. Para insertar datos en el conjunto de datos, el recurso de destino es un conjunto de datos.To push data into the dataset, the target resource is a Dataset. La dirección URL que identifica un conjunto de datos es https://api.PowerBI.com/v1.0/myorg/datasets.The URL that identifies a dataset is https://api.PowerBI.com/v1.0/myorg/datasets. Si va a insertar datos dentro de un grupo, la dirección URL es 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.

Para autenticar una operación de REST de Power BI, debe agregar el token que obtuvo en Obtener un token de acceso de autenticación a un encabezado de solicitud:To authenticate a Power BI REST operation, you add the token you got in Get an authentication access token to a request header:

Al llamar a la operación Crear conjunto de datos, se crea un nuevo conjunto de datos.When you call the Create Dataset operation, a new dataset is created.

Aquí se indica cómo crear un conjunto de datos en Power BI.Here's how to create a dataset in Power BI.

Creación de un conjunto de datos en Power BICreate a dataset in Power BI

Nota

Antes de comenzar, asegúrese de que ha seguido los pasos anteriores del tutorial Insertar datos en un conjunto de datos.Before you get started, make sure you have followed the previous steps in the push data into a dataset walkthrough.

  1. En el proyecto de aplicación de consola que creó en Paso 2: Obtener un token de acceso de autenticación, agregue using System.Net; y 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. En Program.cs, agregue el código siguiente.In Program.cs, add the code below.
  3. Ejecute la aplicación de consola e inicie sesión en su cuenta de Power BI.Run the Console App, and login to your Power BI account. Debería ver Dataset Created en la ventana de consola.You should see Dataset Created in the Console Window. También puede iniciar sesión en Power BI para ver el nuevo conjunto de datos.Also, you can login to Power BI to see the new dataset.

Ejemplo de inserción de datos en un conjunto de datosSample push data into a dataset

Agregue este código a Program.cs.Add this code into Program.cs.

  • En 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();
    }
    
  • Agregue un método 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
    

El siguiente paso muestra cómo obtener un conjunto de datos para agregar filas a una tabla de Power BI.The next step shows you how to get a dataset to add rows into a Power BI table.

A continuación se muestra la lista de código completa.Below is the complete code listing.

Lista de código completaComplete 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
    }
}

Paso siguiente >Next Step >

Pasos siguientesNext steps

Obtener un conjunto de datos para agregar filas a una tabla de Power BIGet a dataset to add rows into a Power BI table
Obtener un token de acceso de autenticaciónGet an authentication access token
Crear conjunto de datosCreate Dataset
Insertar datos en un panel de Power BIPush data into a Power BI Dashboard
Información general sobre la API de REST de Power BIOverview of Power BI REST API
Referencia de la API de REST de Power BIPower BI REST API reference

¿Tiene más preguntas?More questions? Pruebe la comunidad de Power BITry the Power BI Community