Power BI 데이터 집합에 데이터 푸시Push data into a Power BI dataset

Power BI API를 사용하여 데이터를 Power BI 데이터 집합에 푸시할 수 있습니다.With the Power BI API, you can push data into a Power BI dataset. 예를 들어 기존 비즈니스 워크플로를 확장하여 키 데이터를 데이터 집합에 푸시하고자 한다고 가정합니다.For example, you want to extend an existing business workflow to push key data into your dataset. 여기서는 Product 테이블을 포함하는 Sales Marketing 데이터 집합을 데이터 집합에 푸시하려고 합니다.In this case, you want to push a Sales Marketing dataset which has a Product table into a dataset.

데이터 집합에 데이터 푸시를 시작하기 전에 Azure AD(Azure Active Directory) 및 Power BI 계정이 필요합니다.Before you get started pushing data into a dataset, you need an Azure Active Directory (Azure AD) and a Power BI account.

데이터 집합에 데이터를 푸시하는 단계Steps to push data into a dataset

다음 섹션에서는 데이터를 푸시하는 Power BI API 작업에 대한 일반적인 내용을 설명합니다.The next section is a general discussion of Power BI API operations that push data.

데이터를 푸시하는 Power BI API 작업Power BI API operations to push data

Power BI REST API를 사용하여 데이터 원본을 Power BI로 푸시할 수 있습니다.With the Power BI REST API, you can push data sources to Power BI. 앱이 데이터 집합에 행을 추가하면 대시보드의 타일이 업데이트된 데이터와 함께 자동으로 업데이트됩니다.When an app adds rows to a dataset, tiles on the dashboard are updated automatically with the updated data. 데이터를 푸시하려면 데이터 집합 만들기 작업과 함께 행 추가 작업을 사용합니다.To push data, you use the Create Dataset operation along with the Add Rows operation. 데이터 집합을 찾으려면 데이터 집합 가져오기 작업을 사용합니다.To find a dataset, you use the Get Datasets operation. 이러한 작업에서는 그룹 ID를 전달하여 그룹으로 작업할 수 있습니다.For any of these operations, you can pass a group id to work with a group. 그룹 ID 목록을 가져오려면 그룹 가져오기 작업을 사용합니다.Use the Get Groups operation to get a list of group id's.

데이터 집합에 데이터를 푸시하는 작업은 다음과 같습니다.Here are the operations to push data into a dataset:

Power BI에서 데이터 집합을 만들려면 Power BI 서비스에 JSON(JavaScript Object Notation) 문자열을 전달합니다.You create a dataset in Power BI by passing a JavaScript Object Notation (JSON) string to the Power BI service. JSON에 대한 자세한 내용은 JSON 소개를 참조하세요.To learn more about JSON, see Introducing JSON.

데이터 집합에 대한 JSON 문자열의 형식은 다음과 같습니다.The JSON string for a dataset has the following format:

Power BI 데이터 집합 JSON 개체Power BI Dataset JSON object

{"name": "dataset_name", "tables":
    [{"name": "", "columns":
        [{ "name": "column_name1", "dataType": "data_type"},
         { "name": "column_name2", "dataType": "data_type"},
         { ... }
        ]
      }
    ]
}

여기의 Sales Marketing 데이터 집합 예제에서는 아래 예제와 같은 JSON 문자열을 전달합니다.So, for our Sales Marketing dataset example, you would pass a JSON string such as the example below. 이 예제에서 SalesMarketing 은 데이터 집합의 이름이고 Product 는 테이블의 이름입니다.In this example, SalesMarketing is the name of the dataset, and Product is the name of the table. 테이블을 정의한 후 테이블 스키마를 정의합니다.After you define the table, you define the table schema. SalesMarketing 데이터 집합의 경우 테이블 스키마는 ProductID, Manufacturer, Category, Segment, Product 및 IsCompete 열을 포함합니다.For the SalesMarketing dataset, the table schema has these columns: ProductID, Manufacturer, Category, Segment, Product, and IsCompete.

예제 데이터 집합 개체 JSONExample dataset object JSON

{
    "name": "SalesMarketing",
    "tables": [
        {
            "name": "Product",
            "columns": [
            {
                "name": "ProductID",
                "dataType": "int"
            },
            {
                "name": "Manufacturer",
                "dataType": "string"
            },
            {
                "name": "Category",
                "dataType": "string"
            },
            {
                "name": "Segment",
                "dataType": "string"
            },
            {
                "name": "Product",
                "dataType": "string"
            },
            {
                "name": "IsCompete",
                "dataType": "bool"
            }
            ]
        }
    ]
}

Power BI 테이블 스키마에는 다음과 같은 데이터 형식을 사용할 수 있습니다.For a Power BI table schema, you can use the following data types.

Power BI 테이블 데이터 형식Power BI table data types

데이터 형식Data type 제한 사항Restrictions
Int64Int64 Int64.MaxValue 및 Int64.MinValue는 허용되지 않습니다.Int64.MaxValue and Int64.MinValue not allowed.
DoubleDouble Double.MaxValue 및 Double.MinValue 값은 허용되지 않습니다.Double.MaxValue and Double.MinValue values not allowed. NaN은 지원되지 않습니다.+Infinity 및 -Infinity는 일부 함수(예: Min, Max)에서 지원되지 않습니다.NaN not supported.+Infinity and -Infinity not supported in some functions (e.g. Min, Max).
부울 값Boolean 없음None
날짜/시간Datetime 데이터 로드 동안 일 분수가 포함된 값을 1/300초(3.33ms)의 배수로 양자화합니다.During data loading we quantize values with day fractions to whole multiples of 1/300 seconds (3.33ms).
문자열String 현재 최대 128K자를 허용합니다.Currently allows up to 128K characters.

Power BI에 데이터 푸시에 대해 자세히 알아보기Learn more about pushing data into Power BI

데이터 집합에 데이터 푸시를 시작하려면 왼쪽 탐색 창에서 1단계: Azure AD에 앱 등록을 참조하세요.To get started pushing data into a dataset, see Step 1: Register an app with Azure AD in the left navigation pane.

다음 단계 >Next Step >

다음 단계Next steps

Power BI에 등록Sign up for Power BI
데이터 집합 만들기Create Dataset
데이터 집합 가져오기Get Datasets
행 추가Add Rows
그룹 가져오기Get Groups
JSON 개요Introducing JSON
Power BI REST API 개요Overview of Power BI REST API
궁금한 점이 더 있나요?More questions? Power BI 커뮤니티를 이용하세요.Try the Power BI Community