다음을 통해 공유

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[]

테이블 원본