다음을 통해 공유

Push Datasets - Datasets PutTable

  • 참조
Service:
Power BI REST APIs
API Version:
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

테이블 이름
description

string

테이블 설명
isHidden

boolean

선택 사항입니다. 이 데이터 세트 테이블이 숨겨져 있는지 여부입니다.
measures

Measure[]

이 테이블 내의 측정값
rows

Row[]

이 테이블 내의 데이터 행
source

ASMashupExpression[]

테이블 원본

응답

Name 형식 Description
200 OK

Table

정상

예제

Example

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/tables/Product
Request Body
{
  "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"
    }
  ]
}

Sample Response

Status code:
200 
{
  "name": "Product"
}

정의

Name Description
ASMashupExpression

데이터 세트 테이블 원본
Column

데이터 세트 열
Measure

Power BI 측정값
Row

데이터 세트의 데이터 행
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

선택 사항입니다. 이 열을 요약하는 데 사용할 집계 함수입니다.

Measure

Power BI 측정값

Name 형식 Description
description

string

선택 사항입니다. 측정값 설명입니다.
expression

string

유효한 DAX 식
formatString

string

선택 사항입니다. 값이 FORMAT_STRING 지정된 대로 표시될 때 형식을 지정하는 방법을 설명하는 문자열입니다.
isHidden

boolean

선택 사항입니다. 측정값이 숨겨져 있는지 여부입니다.
name

string

측정값 이름

Row

데이터 세트의 데이터 행

Name 형식 Description
id

string

고유한 행 ID

Table

데이터 세트 테이블

Name 형식 Description
columns

Column[]

이 테이블의 열 스키마
description

string

테이블 설명
isHidden

boolean

선택 사항입니다. 이 데이터 세트 테이블이 숨겨져 있는지 여부입니다.
measures

Measure[]

이 테이블 내의 측정값
name

string

테이블 이름
rows

Row[]

이 테이블 내의 데이터 행
source

ASMashupExpression[]

테이블 원본