Шаг 4. Получение набора данных для добавления строк в таблицу Power BIStep 4: Get a dataset to add rows into a Power BI table

Эта статья является частью пошагового руководства по принудительной отправке данных в набор данных.This article is part of a step-by-step walkthrough to push data into a dataset.

На шаге 3 (Создание набора данных в панели мониторинга Power BI) руководства по принудительной отправке данных в набор данных вы вызвали операцию Создание набора данных, чтобы создать набор данных в Power BI.In step 3 of Push data into a dataset, Create a dataset in Power BI, you called the Create Dataset operation to create a dataset in Power BI. На этом шаге вы будете использовать операцию Получение наборов данных и Newtonsoft.Json, чтобы получить идентификатор набора данных. Идентификатор набора данных потребуется на шаге 4 для добавления строк в набор данных.In this step, you use the Get Datasets operation and Newtonsoft.Json to get a dataset id. You use the dataset id in step 4 to add rows to a dataset.

Чтобы принудительно отправить данные в набор данных Power BI, необходимо сослаться на таблицу в наборе данных.To push data into a Power BI dataset, you need to reference the table in the dataset. Для этого сначала потребуется получить идентификатор набора данных.To reference a table in a dataset, you first need to get a Dataset ID. Получение идентификатора набора данных выполняется с помощью операции Получение набора данных.You get a Dataset ID using the Get Dataset operation. Операция Получение набора данных возвращает строку JSON, содержащую список всех наборов данных в Power BI.The Get Dataset operation returns a JSON string containing a list of all datasets in Power BI. Для десериализации строки JSON рекомендуется использовать Newtonsoft.Json.The recommended way to deserialize a JSON string is with Newtonsoft.Json.

Вот как получить набор данных.Here's how you get a dataset.

Получение набора данных Power BIGet a Power BI dataset

ПРИМЕЧАНИЕ. Перед началом работы убедитесь, что выполнены предыдущие шаги из пошагового руководства по принудительной отправке данных в набор данных.NOTE: Before you get started, make sure you have followed the previous steps in the push data into a dataset walkthrough.

  1. В проекте консольного приложения, созданного на шаге 2 Получение токена доступа для проверки подлинности пошагового руководства по принудительной отправке данных, установите пакет NuGet Newtonsoft.Json.In the Console Application project you created in Step 2: Walkthrough to push data, Get an authentication access token, install the Newtonsoft.Json NuGet package. Ниже приведены действия по установке пакета.Here's how to install the package:

    а.a. В Visual Studio 2015 выберите пункты Сервис > Диспетчер пакетов NuGet > Консоль диспетчера пакетов.In Visual Studio 2015, choose Tools > NuGet Package Manager > Package Manager Console.

    б.b. В консоли диспетчера пакетоввведите команду Install-Package Newtonsoft.Json.In Package Manager Console, enter Install-Package Newtonsoft.Json.

  2. После установки пакета добавьте директиву using Newtonsoft.Json; в файл Program.cs.After the package is installed, add using Newtonsoft.Json; to Program.cs.
  3. В Program.cs добавьте приведенный ниже код для получения идентификатора набора данных.In Program.cs, add the code below to get a Dataset ID.
  4. Запустите консольное приложение и войдите в свою учетную запись Power BI.Run the Console App, and login to your Power BI account. В окне консоли вы должны увидеть идентификатор набора данных .You should see Dataset ID: followed by an id in the Console Window.

Пример получения набора данныхSample get a dataset

Добавьте следующий код в Program.cs.Add this code into Program.cs.

  • В методе 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();
    
      //Get a dataset to add rows into a Power BI table
      string datasetId = GetDataset();
    }
    
  • Добавьте метод GetDatset():Add a GetDatset() method:

      #region Get a dataset to add rows into a Power BI table
      private static string GetDataset()
      {
          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 = "GET";
          request.ContentLength = 0;
          request.ContentType = "application/json";
    
          //Add token to the request header
          request.Headers.Add("Authorization", String.Format("Bearer {0}", token));
    
          string datasetId = string.Empty;
          //Get HttpWebResponse from GET request
          using (HttpWebResponse httpResponse = request.GetResponse() as System.Net.HttpWebResponse)
          {
              //Get StreamReader that holds the response stream
              using (StreamReader reader = new System.IO.StreamReader(httpResponse.GetResponseStream()))
              {
                  string responseContent = reader.ReadToEnd();
    
                  //TODO: Install NuGet Newtonsoft.Json package: Install-Package Newtonsoft.Json
                  //and add using Newtonsoft.Json
                  var results = JsonConvert.DeserializeObject<dynamic>(responseContent);
    
                  //Get the first id
                  datasetId = results["value"][0]["id"];
    
                  Console.WriteLine(String.Format("Dataset ID: {0}", datasetId));
                  Console.ReadLine();
    
                  return datasetId;
              }
          }
      }
      #endregion
    

Следующим шагом является добавление строк в таблицу Power BI.The next step shows you how to add rows to a Power BI table.

Ниже приведен полный листинг кода.Below is the complete code listing.

Полный листинг кодаComplete code listing

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

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();

            //Get a dataset to add rows into a Power BI table
            string datasetId = GetDataset();

        }

        #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

        #region Get a dataset to add rows into a Power BI table
        private static string GetDataset()
        {
            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 = "GET";
            request.ContentLength = 0;
            request.ContentType = "application/json";

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

            string datasetId = string.Empty;
            //Get HttpWebResponse from GET request
            using (HttpWebResponse httpResponse = request.GetResponse() as System.Net.HttpWebResponse)
            {
                //Get StreamReader that holds the response stream
                using (StreamReader reader = new System.IO.StreamReader(httpResponse.GetResponseStream()))
                {
                    string responseContent = reader.ReadToEnd();

                    //TODO: Install NuGet Newtonsoft.Json package: Install-Package Newtonsoft.Json
                    //and add using Newtonsoft.Json
                    var results = JsonConvert.DeserializeObject<dynamic>(responseContent);

                    //Get the first id
                    datasetId = results["value"][0]["id"];

                    Console.WriteLine(String.Format("Dataset ID: {0}", datasetId));
                    Console.ReadLine();

                    return datasetId;
                }
            }
        }
        #endregion
    }
}

Дальнейшие действия >Next Step >

Дальнейшие действияNext steps

Добавление строк в таблицу Power BIAdd rows to a Power BI table
Newtonsoft.JsonNewtonsoft.Json
Получение наборов данныхGet Datasets
Принудительная отправка данных в панель мониторинга Power BIPush data into Power BI
Обзор интерфейса REST API Power BIOverview of Power BI REST API
Справочник по REST API Power BIPower BI REST API reference

Появились дополнительные вопросы?More questions? Ответы на них см. в сообществе Power BI.Try the Power BI Community