Power BI에서 템플릿 콘텐츠 팩 작성Author template content packs in Power BI

템플릿 콘텐츠 팩 작성 시에는 Power BI Desktop 및 PowerBI.com을 사용합니다. 콘텐츠 팩에는 네 가지 구성 요소가 있습니다.Authoring a template content pack uses the Power BI Desktop and PowerBI.com. There are four components to your content pack:

  • 쿼리를 사용하면 데이터를 연결변환할 수 있으며 매개 변수도 정의할 수 있습니다.Queries allow you to connect and transform the data, as well as define parameters
  • 데이터 모델로 관계, 측정값 및 Q&A 개선을 만들 수 있습니다.Data model to create relationships, measures, and Q&A improvements
  • 보고서 페이지는 데이터에 대한 정보를 제공하는 시각적 개체 및 필터가 포함됩니다.Report pages include visuals and filters to provide insights into your data
  • 대시보드타일은 포함된 Insights에 대한 개요를 제공합니다.Dashboard and tiles offer an overview of the insights included

기존 Power BI 기능으로 각 구성 요소에 익숙할 수 있습니다.You may be familiar with each piece as existing Power BI features. 콘텐츠 팩을 빌드할 때는 각 측면에 대해 추가 고려 사항이 있습니다. 자세한 내용은 아래 각 섹션을 참조하세요.When building a content pack, there are additional things to consider for each aspect, see each section below for more details.

쿼리Queries

템플릿 콘텐츠 팩의 경우 Power BI Desktop에서 개발된 쿼리를 사용하여 데이터 원본에 연결하고 데이터를 가져옵니다.For template content packs, queries developed in the Power BI Desktop are used to connect to your data source and import data. 이러한 쿼리는 일관된 스키마를 반환하는 데 필요하며 예약된 데이터 새로 고침에 대해 지원됩니다(직접 쿼리는 지원되지 않음).These queries are required to return a consistent schema and are supported for Scheduled Data refresh (direct query is not supported).

템플릿 콘텐츠 팩은 콘텐츠 팩당 하나의 데이터 원본만 지원하므로 쿼리를 신중하게 정의합니다.Template content packs only support one data source per content pack so define your queries carefully. 단일 데이터 원본은 동일한 인증을 요구하는 원본으로 정의됩니다.A single data source is defined as a source that requires the same authentication. 모든 호출이 동일한 API 끝점을 향하며 동일한 인증을 사용하는 경우 다른 쿼리에서 여러 API 호출을 만들 수 있습니다.You can make multiple API calls in different queries if all the calls are to the same API endpoint and use the same authentication. Power BI 콘텐츠 팩은 서로 다른 인증을 요구하는 여러 원본을 지원하지 않습니다.Power BI content packs do not support multiple sources that require different authentications.

API에 연결Connect to your API

시작하려면 Power BI Desktop에서 API에 연결하여 쿼리 작성을 시작해야 합니다.To get started, you will need to connect to your API from Power BI Desktop to start building your queries.

API에 연결하려면 Power BI Desktop에서 바로 사용할 수 있는 데이터 커넥터를 사용할 수 있습니다.You can use the Data Connectors that are available out of the box in Power BI Desktop to connect to your API. 웹 데이터 커넥터(데이터 가져오기 -> 웹)를 사용하여 OData 피드에 연결하도록 Rest API 또는 OData 커넥터(데이터 가져오기 -> OData 피드)에 연결할 수 있습니다.You can use the Web Data Connector (Get Data -> Web) to connect to your Rest API or the OData connector (Get Data -> OData feed) to connect to your OData feed. API가 기본 인증을 지원하는 경우에만 이러한 커넥터는 즉시 작동합니다.Please note that these connectors will work out of the box only if your API supports Basic Authentication.

참고

API가 OAuth 2.0 또는 웹 API 키와 같은 다른 인증 유형을 사용하는 경우 Power BI Desktop이 성공적으로 API에 연결하고 인증하도록 사용자 고유의 데이터 커넥터를 개발해야 합니다.If your API uses any other authentication types, like OAuth 2.0 or Web API Key, then you will need to develop your own Data Connector to allow Power BI Desktop to successfully connects and authenticates to your API. 콘텐츠 팩에 대한 고유한 데이터 커넥터를 개발하는 방법에 대한 내용은 여기에서 데이터 커넥터 설명서를 참조하세요.For details on how to develop your own Data Connector for your Content Pack, check the Data Connectors documentation here.

소스 고려Consider the source

쿼리는 데이터 모델에 포함될 데이터를 정의합니다.The queries define the data that will be included in the data model. 시스템의 크기에 따라 이러한 쿼리는 고객이 비즈니스 시나리오에 따라 관리하기 쉬운 크기를 처리하도록 해주는 필터도 포함합니다.Depending on the size of your system, these queries should also include filters to ensure your customers are dealing with a manageable size that fits your business scenario.

Power BI 콘텐츠 팩에서는 여러 쿼리를 병렬로, 여러 사용자에 대해 동시에 실행할 수 있습니다.Power BI content packs can execute multiple queries in parallel and for multiple users concurrently. 제한 및 동시성 전략을 미리 계획하고 콘텐츠 팩을 내결함성 있게 만드는 방법을 문의하세요.Plan ahead your throttling and concurrency strategy and ask us how to make your content pack fault tolerant.

스키마 적용Schema enforcement

쿼리는 시스템 변경에 대해 복원력이 있어야 하며 새로 고침 시 스키마 변경으로 모델이 손상될 수 있습니다.Ensure your queries are resilient to changes in your system, changes in schema on refresh can break the model. 소스에서 일부 쿼리에 대해 Null/누락된 스키마 결과를 반환할 수 있는 경우 빈 테이블을 반환하는 것을 고려하거나 사용자에게 의미 있는 사용자 지정 오류 메시지를 throw합니다.If the source could return null/missing schema result for some queries, consider returning an empty table or throw a custom error messages that is meaningful to your user.

매개 변수Parameters

Power BI Desktop에서 매개 변수를 통해 사용자는 사용자가 검색한 데이터를 사용자 지정하는 입력 값을 제공할 수 있습니다.Parameters in Power BI Desktop allow your users to provide input values that customize the data retrieved by the user. 자세한 쿼리 또는 보고서를 작성하는 데 시간을 투자한 후 재작업을 방지하도록 매개 변수를 미리 생각합니다.Think of the parameters upfront to avoid rework after investing time to build detailed queries or reports.

참고

템플릿 콘텐츠 팩에서는 현재 텍스트 매개 변수만 지원합니다.Template content packs only support text parameters currently. 개발 중에 다른 매개 변수 형식을 사용할 수 있지만 테스트 부분 중에는 사용자가 제공한 모든 값이 리터럴입니다.Other parameter types can be used during development but during the testing portion all values provided by the users will be literal.

추가 쿼리 팁Additional query tips

  • 모든 열은 적절하게 형식화되어야 합니다.Ensure all columns are typed appropriately
  • 열에는 정보를 전달하는 이름을 사용합니다(Q&A 참조).Columns have informative names (see Q&A)
  • 공유 논리의 경우 함수 또는 쿼리를 사용하는 것이 좋습니다.For shared logic, consider using functions or queries
  • 개인 정보 수준은 현재 서비스에서 지원되지 않습니다. 개인 정보 수준에 대한 프롬프트를 받으면 상대 경로를 사용하도록 쿼리를 다시 작성해야 할 수 있습니다.Privacy levels are not currently supported in the service - if you get a prompt about privacy levels, you may need to re-write the query to use relative paths

데이터 모델Data Model

잘 정의된 데이터 모델을 통해 고객은 콘텐츠 팩과 쉽고 직관적으로 상호 작용할 수 있습니다.A well-defined data model will ensure your customers can easily and intuitively interact with the content pack. Power BI Desktop에서 데이터 모델을 생성합니다.Create the data model in the Power BI Desktop.

참고

대부분의 기본 모델링(형식 지정, 열 이름)은 쿼리에서 수행됩니다.Much of the basic modelling (typing, column names) should be done in the queries.

Q&AQ&A

모델링은 또한 Q&A에서 고객에게 얼마나 잘 결과를 제공할 수 있는지에도 영향을 줍니다.The modelling will also affect how well Q&A can provide results for your customers. 자주 사용되는 열에 동의어를 추가하고 해당 열이 쿼리에서 적절하게 이름 지정되도록 해야 합니다.Ensure you add synonyms to commonly used columns and that your columns are properly named in the queries.

추가 데이터 모델 팁Additional data model tips

  • 모든 값 열에 형식이 적용됩니다.All value columns have formatting applied >[!NOTE] >형식은 쿼리에 적용되어야 합니다.Types should be applied in the query.
  • 모든 측정값에 형식이 적용됩니다.All measures have formatting applied
  • 기본 요약이 설정됩니다.Default Summarization is set. 특히 해당하는 경우 "요약 안 함"(예를 들어 고유 값인 경우).Especially "Do Not Summarize", when applicable (for unique values for example)
  • 데이터 범주가 설정되었습니다(해당하는 경우).Data Category has been set, when applicable
  • 필요에 따라 관계가 설정됩니다.Relationships are set, as necessary

보고서Reports

보고서 페이지는 콘텐츠 팩에 포함된 데이터에 대한 추가 정보를 제공합니다.The report pages offer additional insight into the data included in your content pack. 보고서의 페이지를 사용하여 콘텐츠 팩에서 해결 시도 중인 주요 비즈니스 질문에 대답할 수 있습니다.Use the pages of the reports to answer the key business questions your content pack is trying to address. Power BI Desktop을 사용하여 보고서를 만듭니다.Create the report using the Power BI Desktop.

참고

하나의 보고서만 콘텐츠 팩에 포함될 수 있으며 다양한 페이지를 활용하여 시나리오의 특정 섹션을 호출합니다.Only one report may be included in a content pack, take advantage of the different pages to call out particular sections of your scenario.

추가 보고서 팁Additional report tips

  • 교차 필터링을 위해 페이지당 두 개 이상의 시각적 개체를 사용합니다.Use more than one visual per page for cross-filtering
  • 시각적 개체를 신중하게 맞춥니다(겹치지 않게).Align the visuals carefully (no overlapping)
  • 페이지 레이아웃을 "4:3" 또는 "16:9" 모드로 설정합니다.Page is set to "4:3" or "16:9" mode for layout
  • 제시된 모든 집계는 숫자로 인식됩니다(평균, 고유 값).All of the aggregations presented make numeric sense (averages, unique values)
  • 조각화를 통해 관계형 결과가 생성됩니다.Slicing produces rational results
  • 로고는 최상위 보고서 이상에 있습니다.Logo is present on at least the top report
  • 요소는 색 구성표에 가능한 범위 내에 있습니다.Elements are in the client's color scheme to the extent possible

대시보드Dashboard

대시보드는 고객에 대해 콘텐츠 팩과 상호 작용하는 주요 지점입니다.The dashboard is the main point of interaction with your content pack for your customers. 포함된 콘텐츠에 대한 개요를 포함하며 특히 비즈니스 시나리오에 대한 중요한 메트릭이 포함됩니다.It should include an overview of the content included, especially the important metrics for your business scenario.

템플릿 콘텐츠 팩에 대한 대시보드를 만들려면 데이터 가져오기 > 파일을 통해 PBIX를 업로드하거나 Power BI Desktop에서 직접 게시합니다.To create a dashboard for your template content pack, simply upload your PBIX through Get Data > Files or publish directly from the Power BI Desktop.

참고

템플릿 콘텐츠 팩에는 현재 콘텐츠 팩당 단일 보고서 및 데이터 집합이 필요합니다.Template content packs currently require a single report and dataset per content pack. 여러 보고서/데이터 집합의 콘텐츠를 콘텐츠 팩에 사용되는 대시보드에 고정하지 마세요.Do not pin content from multiple reports/datasets onto the dashboard used in the content pack.

추가 대시보드 팁Additional dashboard tips

  • 고정할 때는 동일한 테마를 유지하여 대시보드의 타일이 일관되게 합니다.Maintain the same theme when pinning so that the tiles on your dashboard are consistent
  • 로고를 테마에 고정하여 소비자가 팩의 출처를 알 수 있도록 합니다.Pin a logo to the theme so consumers know where the pack is from
  • 대부분의 화면 해상도에 작동하는 추천 레이아웃은 너비가 5-6개의 작은 타일입니다.Suggested layout to work with most screen resolutions is 5-6 small tiles wide
  • 모든 대시보드 타일에는 적절한 제목/부제가 있어야 합니다.All dashboard tiles should have appropriate titles/subtitles
  • 가로 또는 세로로 다양한 시나리오에 맞는 대시보드 그룹화를 사용하는 것이 좋습니다.Consider groupings in the dashboard for different scenarios, either vertically or horizontally

제한 사항 요약Summary of restrictions

위의 섹션에 나열된 것처럼 현재 템플릿 콘텐츠 팩에는 일련의 제한 사항이 있습니다.As listed in the above sections, currently the template content packs have a set of restrictions:

지원됨Supported 지원되지 않음Not Supported
PBI Desktop에 기본 제공되는 데이터 집합Datasets built in PBI Desktop 다른 콘텐츠 팩 또는 Excel 파일 등의 입력의 데이터 집합Datasets from other content packs or inputs such as Excel files
클라우드 예약된 데이터 새로 고침에 대해 지원되는 데이터 원본Data source supported for cloud Scheduled Data refresh 직접 쿼리 또는 온-프레미스 연결은 지원되지 않음Direct query or on-prem connecitivty is not supported
해당 위치에서 일관된 스키마 또는 오류를 반환하는 쿼리Queries returning consistent schema or errors where appropriate 동적 또는 사용자 지정 스키마Dynamic or custom schemas
데이터 집합당 한 개의 데이터 원본One data source per dataset 여러 데이터 원본으로 감지되는 매시업 또는 URL 등의 여러 데이터 원본Multiple data sources such as mashups or URLs that are detected as mutliple data sources
텍스트 형식의 매개 변수Parameters of type text 기타 매개 변수 형식(예: 날짜) 또는 "허용되는 값 목록"Other parameter types (such as date) or "list allowed of values"
한 개 대시보드, 보고서 및 데이터 집합One dashboard, report and dataset 여러 개의 대시보드, 보고서 또는 데이터 집합Multiple dashboards, reports or datasets

다음 단계Next step

콘텐츠 팩 테스트 및 제출Content Pack Testing and Submission