Push Datasets - Datasets PostDatasetInGroup

참조

Service:: Power BI REST APIs

API Version:: v1.0

지정된 작업 영역에 새 데이터 세트를 만듭니다.

필수 범위

Dataset.ReadWrite.All

제한 사항

이 API 호출은 푸시 데이터 세트만 지원합니다. 제한 사항의 전체 목록은 푸시 데이터 세트 제한 사항을 참조하세요.

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets

With optional parameters:

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets?defaultRetentionPolicy={defaultRetentionPolicy}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
groupId	path	True	string uuid	작업 영역 ID
defaultRetentionPolicy	query		DefaultRetentionPolicy	기본 보존 정책

요청 본문

Name	필수	형식	Description
name	True	string	데이터 세트 이름
tables	True	Table[]	데이터 세트 테이블
datasources		Datasource[]	이 데이터 세트와 연결된 데이터 원본
defaultMode		DatasetMode	데이터 세트 모드 또는 형식
relationships		Relationship[]	데이터 세트 관계

응답

Name	형식	Description
201 Created	Dataset	생성일
202 Accepted	Dataset	수락됨

예제

Push example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets?defaultRetentionPolicy=basicFIFO

Request Body

{
  "name": "SalesMarketing",
  "defaultMode": "Push",
  "tables": [
    {
      "name": "Product",
      "columns": [
        {
          "name": "ProductID",
          "dataType": "Int64"
        },
        {
          "name": "Name",
          "dataType": "string"
        },
        {
          "name": "Category",
          "dataType": "string"
        },
        {
          "name": "IsCompete",
          "dataType": "bool"
        },
        {
          "name": "ManufacturedOn",
          "dataType": "DateTime"
        },
        {
          "name": "Sales",
          "dataType": "Int64",
          "formatString": "Currency"
        }
      ]
    }
  ]
}

Sample Response

Status code:: 201

{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "name": "SalesMarketing",
  "defaultRetentionPolicy": "basicFIFO"
}

정의

Name	Description
ASMashupExpression	데이터 세트 테이블 원본
Column	데이터 세트 열
CreateDatasetRequest	Power BI 데이터 세트
CrossFilteringBehavior	관계의 필터 방향
Dataset	Power BI 데이터 세트입니다. API는 다음 데이터 세트 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.
DatasetMode	데이터 세트 모드 또는 형식
DatasetQueryScaleOutSettings	데이터 세트의 스케일 아웃 설정 쿼리
DatasetUser	데이터 세트에 대한 Power BI 사용자 액세스 권한 항목
DatasetUserAccessRight	사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)
Datasource	Power BI 데이터 원본
DatasourceConnectionDetails	Power BI 데이터 원본 연결 세부 정보입니다. 데이터 원본 가져오기 또는 그룹 내 데이터 원본 가져오기의 예제를 참조하세요.
DefaultRetentionPolicy	기본 보존 정책
DependentDataflow	Power BI 종속 데이터 흐름
Encryption	데이터 세트에 대한 암호화 정보
EncryptionStatus	데이터 세트 암호화 상태
Measure	Power BI 측정값
PrincipalType	보안 주체 유형
Relationship	데이터 세트의 테이블 간 관계
Row	데이터 세트의 데이터 행
ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.
Table	데이터 세트 테이블

ASMashupExpression

데이터 세트 테이블 원본

Name	형식	Description
expression	string	원본 식

Column

데이터 세트 열

Name	형식	Description
dataCategory	string	선택 사항입니다. 이 열 내의 데이터를 설명하는 데이터 범주에 사용할 문자열 값입니다.
dataType	string	열 데이터 형식
formatString	string	선택 사항입니다. FORMAT_STRING 지정된 열의 형식입니다.
isHidden	boolean	선택 사항입니다. 열이 숨겨져 있는지 여부입니다. 기본값은 `false`입니다.
name	string	열 이름
sortByColumn	string	선택 사항입니다. 현재 열을 정렬하는 데 사용하기 위해 동일 테이블에 있는 열의 문자열 이름입니다.
summarizeBy	string	선택 사항입니다. 이 열을 요약하는 데 사용할 집계 함수입니다.

CreateDatasetRequest

Power BI 데이터 세트

Name	형식	Description
datasources	Datasource[]	이 데이터 세트와 연결된 데이터 원본
defaultMode	DatasetMode	데이터 세트 모드 또는 형식
name	string	데이터 세트 이름
relationships	Relationship[]	데이터 세트 관계
tables	Table[]	데이터 세트 테이블

CrossFilteringBehavior

관계의 필터 방향

Name	형식	Description
Automatic	string	교차 필터링 동작이 자동으로 정의됨
BothDirections	string	필터링을 위해 두 테이블은 모두 단일 테이블로 처리됩니다.
OneDirection	string	필터링을 위해 값이 집계되는 테이블에 필터가 적용됩니다.

Dataset

Power BI 데이터 세트입니다. API는 다음 데이터 세트 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.

Name	형식	Description
ContentProviderType	string	데이터 세트의 콘텐츠 공급자 형식
CreateReportEmbedURL	string	데이터 세트 만들기 보고서 포함 URL
CreatedDate	string	데이터 세트 만들기 날짜 및 시간
Encryption	Encryption	데이터 세트 암호화 정보. 가 지정된 경우에만 `$expand` 적용됩니다.
IsEffectiveIdentityRequired	boolean	데이터 세트에 GenerateToken API 호출로 보내야 하는 유효 ID가 필요한지 여부입니다.
IsEffectiveIdentityRolesRequired	boolean	Power BI .pbix 파일 내에서 행 수준 보안이 정의되는지 여부입니다. 그렇다면 역할을 지정해야 합니다.
IsInPlaceSharingEnabled	boolean	데이터 세트를 외부 사용자와 공유하여 자체 테넌트에서 사용할 수 있는지 여부
IsOnPremGatewayRequired	boolean	데이터 세트에 온-프레미스 데이터 게이트웨이가 필요한지 여부
IsRefreshable	boolean	데이터 세트를 새로 고칠 수 있는지 여부입니다. Power BI 새로 고칠 수 있는 데이터 세트는 한 번 이상 새로 고쳐졌거나 유효한 새로 고침 일정이 있는 데이터 세트입니다.
QnaEmbedURL	string	데이터 세트 Q&포함 URL
addRowsAPIEnabled	boolean	데이터 세트에서 새 행을 추가할 수 있는지 여부
configuredBy	string	데이터 세트 소유자
description	string	데이터 세트 설명
id	string	데이터 세트 ID
name	string	데이터 세트 이름
queryScaleOutSettings	DatasetQueryScaleOutSettings	데이터 세트의 스케일 아웃 설정 쿼리
targetStorageMode	string	데이터 세트 스토리지 모드
upstreamDataflows	DependentDataflow[]	이 항목이 사용하는 모든 데이터 흐름 목록
users	DatasetUser[]	(빈 값) 데이터 세트 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 데이터 세트 사용자를 관리 API로 가져오기 또는 매개 변수를 사용하여 PostWorkspaceInfo API `getArtifactUsers` 를 사용하여 Power BI 항목(예: 보고서 또는 dashboard)에서 사용자 정보를 검색할 수 있습니다.
webUrl	string	데이터 세트의 웹 URL

DatasetMode

데이터 세트 모드 또는 형식

Name	형식	Description
AsAzure	string	Azure Analysis Services 대한 라이브 연결이 있는 데이터 세트
AsOnPrem	string	온-프레미스 Azure Analysis Services 대한 라이브 연결이 있는 데이터 세트
Push	string	Power BI에 데이터를 푸시하기 위한 프로그래밍 방식 액세스를 허용하는 데이터 세트
PushStreaming	string	데이터 스트리밍을 지원하고 Power BI에 데이터를 푸시하기 위한 프로그래밍 방식 액세스를 허용하는 데이터 세트
Streaming	string	데이터 스트리밍을 지원하는 데이터 세트입니다. 자세한 내용은 Power BI의 실시간 스트리밍을 참조하세요.

DatasetQueryScaleOutSettings

데이터 세트의 스케일 아웃 설정 쿼리

Name	형식	Description
autoSyncReadOnlyReplicas	boolean	데이터 세트가 읽기 전용 복제본을 자동으로 동기화하는지 여부
maxReadOnlyReplicas	integer	데이터 세트의 최대 읽기 전용 복제본 수(자동 복제본 수의 경우 0-64, -1)

DatasetUser

데이터 세트에 대한 Power BI 사용자 액세스 권한 항목

Name	형식	Description
datasetUserAccessRight	DatasetUserAccessRight	사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소입니다.
graphId	string	Microsoft Graph의 보안 주체 식별자입니다. 관리 API에만 사용할 수 있습니다.
identifier	string	보안 주체의 식별자
principalType	PrincipalType	보안 주체 유형
profile	ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.
userType	string	사용자의 유형입니다.

DatasetUserAccessRight

사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)

Name	형식	Description
None	string	데이터 세트의 콘텐츠에 대한 사용 권한을 제거합니다.
Read	string	데이터 세트의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadExplore	string	데이터 세트의 콘텐츠에 대한 읽기 및 탐색 액세스 권한 부여
ReadReshare	string	데이터 세트의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadReshareExplore	string	데이터 세트의 콘텐츠에 대한 읽기, 다시 공유 및 탐색 액세스 권한 부여
ReadWrite	string	데이터 세트의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여
ReadWriteExplore	string	데이터 세트의 콘텐츠에 대한 읽기, 쓰기 및 탐색 액세스 권한 부여
ReadWriteReshare	string	데이터 세트의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
ReadWriteReshareExplore	string	데이터 세트의 콘텐츠에 대한 읽기, 쓰기, 다시 공유 및 탐색 액세스 권한 부여

Datasource

Power BI 데이터 원본

Name	형식	Description
connectionDetails	DatasourceConnectionDetails	데이터 원본 연결 세부 정보
connectionString	string	(사용되지 않음) 데이터 원본 연결 문자열. DirectQuery에만 사용할 수 있습니다.
datasourceId	string	게이트웨이에 바인딩되지 않은 경우 비어 있는 바인딩된 데이터 원본 ID
datasourceType	string	데이터 원본 형식
gatewayId	string	게이트웨이에 바인딩되지 않은 경우 비어 있는 바인딩된 게이트웨이 ID입니다. 게이트웨이 클러스터를 사용하는 경우 게이트웨이 ID는 클러스터의 기본(첫 번째) 게이트웨이를 참조하며 게이트웨이 클러스터 ID와 유사합니다.
name	string	(사용되지 않음) 데이터 원본 이름입니다. DirectQuery에만 사용할 수 있습니다.

DatasourceConnectionDetails

Power BI 데이터 원본 연결 세부 정보입니다. 데이터 원본 가져오기 또는 그룹 내 데이터 원본 가져오기의 예제를 참조하세요.

Name	형식	Description
account	string	연결 계정
classInfo	string	연결 클래스 정보
database	string	연결 데이터베이스
domain	string	연결 도메인
emailAddress	string	연결 전자 메일 주소
kind	string	연결 종류
loginServer	string	연결 로그인 서버
path	string	연결 경로
server	string	연결 서버
url	string	연결 URL

DefaultRetentionPolicy

기본 보존 정책

Name	형식	Description
None	string	없음
basicFIFO	string	basicFIFO

DependentDataflow

Power BI 종속 데이터 흐름

Name	형식	Description
groupId	string	대상 그룹 ID
targetDataflowId	string	대상 데이터 흐름 ID

Encryption

데이터 세트에 대한 암호화 정보

Name	형식	Description
EncryptionStatus	EncryptionStatus	데이터 세트 암호화 상태

EncryptionStatus

데이터 세트 암호화 상태

Name	형식	Description
InSyncWithWorkspace	string	암호화가 지원되며 암호화 설정과 동기화됩니다.
NotInSyncWithWorkspace	string	암호화가 지원되지만 암호화 설정과 동기화되지 않음
NotSupported	string	이 데이터 세트에 대해 암호화가 지원되지 않습니다.
Unknown	string	데이터 세트 손상으로 인해 암호화 상태 알 수 없음

Measure

Power BI 측정값

Name	형식	Description
description	string	선택 사항입니다. 측정값 설명입니다.
expression	string	유효한 DAX 식
formatString	string	선택 사항입니다. 값이 FORMAT_STRING 지정된 대로 표시될 때 형식을 지정하는 방법을 설명하는 문자열입니다.
isHidden	boolean	선택 사항입니다. 측정값이 숨겨져 있는지 여부입니다.
name	string	측정값 이름

PrincipalType

보안 주체 유형

Name	형식	Description
App	string	서비스 주체 유형
Group	string	그룹 보안 주체 유형
None	string	보안 주체 유형이 없습니다. 전체 organization 수준 액세스에 사용합니다.
User	string	사용자 계정 유형

Relationship

데이터 세트의 테이블 간 관계

Name	형식	기본값	Description
crossFilteringBehavior	CrossFilteringBehavior	OneDirection	관계의 필터 방향
fromColumn	string		외래 키 열의 이름
fromTable	string		외래 키 테이블의 이름
name	string		관계 이름 및 식별자
toColumn	string		기본 키 열의 이름
toTable	string		기본 키 테이블의 이름

Row

데이터 세트의 데이터 행

Name	형식	Description
id	string	고유한 행 ID

ServicePrincipalProfile

Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.

Name	형식	Description
displayName	string	서비스 주체 프로필 이름
id	string	서비스 주체 프로필 ID

Table

데이터 세트 테이블

Name	형식	Description
columns	Column[]	이 테이블의 열 스키마
description	string	테이블 설명
isHidden	boolean	선택 사항입니다. 이 데이터 세트 테이블이 숨겨져 있는지 여부입니다.
measures	Measure[]	이 테이블 내의 측정값
name	string	테이블 이름
rows	Row[]	이 테이블 내의 데이터 행
source	ASMashupExpression[]	테이블 원본