Push Datasets - Datasets PutTable

서비스:

Power BI REST APIs

API 버전:

v1.0

내 작업 영역지정된 데이터 세트 내의 지정된 테이블에 대한 메타데이터 및 스키마를 업데이트합니다.

필수 범위

Dataset.ReadWrite.All

제한점

이 API 호출은 푸시 데이터 세트만 지원합니다.

PUT https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/tables/{tableName}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasetId	path	True	string	데이터 세트 ID
tableName	path	True	string	테이블 이름

요청 본문

Name	필수	형식	Description
columns	True	Column[]	이 테이블의 열 스키마
name	True	string pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$	테이블 이름
description		string	테이블 설명
isHidden		boolean	선택 사항. 이 데이터 세트 테이블이 숨겨져 있는지 여부입니다.
measures		Measure[]	이 테이블 내의 측정값
rows		Row[]	이 테이블 내의 데이터 행
source		ASMashupExpression[]	테이블 원본

응답

Name	형식	Description
200 OK	Table	그래

예제

Example

샘플 요청

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/tables/Product

요청 본문

{
  "name": "Product",
  "columns": [
    {
      "name": "ProductID",
      "dataType": "Int64"
    },
    {
      "name": "Name",
      "dataType": "string"
    },
    {
      "name": "Category",
      "dataType": "string"
    },
    {
      "name": "IsCompete",
      "dataType": "bool"
    },
    {
      "name": "ManufacturedOn",
      "dataType": "DateTime"
    },
    {
      "name": "NewColumn",
      "dataType": "string"
    }
  ]
}

샘플 응답

상태 코드:

200

{
  "name": "Product"
}

정의

Name	Description
ASMashupExpression	데이터 세트 테이블 원본
Column	데이터 세트 열
Measure	Power BI 측정값
Row	데이터 세트의 데이터 행
Table	데이터 세트 테이블

ASMashupExpression

Object

데이터 세트 테이블 원본

Name	형식	Description
expression	string	원본 식

Column

Object

데이터 세트 열

Name	형식	Description
dataCategory	string	선택 사항. 이 열 내의 데이터를 설명하는 데이터 범주에 사용할 문자열 값입니다.
dataType	string	열 데이터 형식
formatString	string	선택 사항. FORMAT_STRING지정된 열의 형식입니다.
isHidden	boolean	선택 사항. 열이 숨겨져 있는지 여부입니다. 기본값은 false입니다.
name	string pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$	열 이름
sortByColumn	string	선택 사항. 현재 열을 정렬하는 데 사용할 동일한 테이블에 있는 열의 문자열 이름입니다.
summarizeBy	string	선택 사항. 이 열을 요약하는 데 사용할 집계 함수입니다.

Measure

Object

Power BI 측정값

Name	형식	Description
description	string	선택 사항. 측정값 설명입니다.
expression	string	유효한 DAX 식
formatString	string	선택 사항. FORMAT_STRING지정된 대로 표시될 때 값의 서식을 지정하는 방법을 설명하는 문자열입니다.
isHidden	boolean	선택 사항. 측정값이 숨겨져 있는지 여부입니다.
name	string pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$	측정값 이름

Row

Object

데이터 세트의 데이터 행

Name	형식	Description
id	string	고유한 행 ID

Table

Object

데이터 세트 테이블

Name	형식	Description
columns	Column[]	이 테이블의 열 스키마
description	string	테이블 설명
isHidden	boolean	선택 사항. 이 데이터 세트 테이블이 숨겨져 있는지 여부입니다.
measures	Measure[]	이 테이블 내의 측정값
name	string pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$	테이블 이름
rows	Row[]	이 테이블 내의 데이터 행
source	ASMashupExpression[]	테이블 원본