3단계: Power BI에서 데이터 집합 만들기Step 3: Create a dataset in Power BI

이 문서는 데이터 집합에 데이터를 푸시하는 단계별 연습의 일부입니다.This article is part of a step-by-step walkthrough to push data into a dataset.

데이터 집합에 데이터 푸시의 2단계인증 액세스 토큰 가져오기에서 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. 이 단계에서는 이 토큰을 사용하여 PostDataset 작업을 호출합니다.In this step, you use the token to call the PostDataset operation.

REST 리소스를 호출하려면 리소스를 찾는 URL을 사용하여 데이터 집합을 설명하는 JSON(JavaScript Object Notation) 문자열을 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. REST 리소스는 작업할 Power BI 서비스 부분을 식별합니다.A REST resource identifies the part of the Power BI service you want to work with. 데이터 집합에 데이터를 푸시하려면 대상 리소스는 데이터 집합입니다.To push data into the dataset, the target resource is a Dataset. 데이터 집합을 식별하는 URL은 https://api.PowerBI.com/v1.0/myorg/datasets입니다.The URL that identifies a dataset is https://api.PowerBI.com/v1.0/myorg/datasets. 그룹 내의 데이터를 푸시하는 경우 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.

Power BI REST 작업을 인증하려면 인증 액세스 토큰 가져오기에서 가져온 토큰을 요청 헤더에 추가합니다.To authenticate a Power BI REST operation, you add the token you got in Get an authentication access token to a request header:

PostDataset 작업을 호출하면 새 데이터 집합이 만들어집니다.When you call the PostDataset operation, a new dataset is created.

Power BI에서 데이터 집합을 만드는 방법은 다음과 같습니다.Here's how to create a dataset in Power BI.

Power BI에서 데이터 집합 만들기Create a dataset in Power BI

참고

시작하기 전에 데이터 집합에 데이터 푸시의 이전 단계를 수행해야 합니다.Before you get started, make sure you have followed the previous steps in the push data into a dataset walkthrough.

  1. 2단계 - 인증 액세스 토큰 가져오기에서 만든 콘솔 응용 프로그램 프로젝트에서 using System.Net;using System.IO; 를 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. Program.cs에서 아래 코드를 추가합니다.In Program.cs, add the code below.
  3. 콘솔 앱을 실행하고 Power BI 계정에 로그인합니다.Run the Console App, and login to your Power BI account. 만든 데이터 집합 이 콘솔 창에 표시됩니다.You should see Dataset Created in the Console Window. Power BI에 로그인하여 새 데이터 집합을 볼 수도 있습니다.Also, you can login to Power BI to see the new dataset.

데이터 집합에 데이터 푸시 샘플Sample push data into 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();
    }
    
  • 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
    

다음 단계에서는 Power BI 테이블에 행을 추가할 데이터 집합을 가져오는 방법을 보여 줍니다.The next step shows you how to get a dataset to add rows into 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;

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
    }
}

다음 단계 >Next Step >

다음 단계Next steps

Power BI 테이블에 행을 추가할 데이터 집합 가져오기Get a dataset to add rows into a Power BI table
인증 액세스 토큰 가져오기Get an authentication access token
PostDatasetPostDataset
PostDatasetInGroupPostDatasetInGroup
Power BI 대시보드에 데이터 푸시Push data into a Power BI Dashboard
Power BI REST API 개요Overview of Power BI REST API
Power BI REST API 참조Power BI REST API reference

궁금한 점이 더 있나요?More questions? Power BI 커뮤니티를 이용하세요.Try the Power BI Community