Datasets - Execute Queries

제공된 데이터 세트에 대해 DAX(데이터 분석 식) 쿼리를 실행합니다. 데이터 세트는 내 작업 영역 또는 다른 작업 영역에 있어야 합니다.

DAX 쿼리 오류로 인해 다음이 발생합니다.

• 응답 오류(예: DAX query failure.
• 오류 HTTP 상태 코드(400)입니다.

둘 이상의 테이블을 요청하는 쿼리 또는 허용되는 테이블 행 수보다 많은 쿼리는 다음을 수행합니다.

• 반환되는 제한된 데이터입니다.
• 응답 오류(예: More than one result table in a query 또는 More than {allowed number} rows in a query result.
• 성공한 HTTP 상태 코드(200)입니다.

예를 들어 MyTable[MyColumn]쿼리에서 정규화된 열은 정규화된 이름으로 반환됩니다. 쿼리에서 이름을 바꾸거나 만든 열은 대괄호 안에 반환됩니다(예 [MyNewColumn]: .).

Permissions

통합 설정 아래에 있는 테넌트 설정 데이터 세트 쿼리 실행 REST API를 사용하도록 설정해야 합니다.

사용자에게 데이터 세트 읽기 및 빌드 권한이 있어야 합니다. 자세한 내용은 데이터 세트 액세스 권한 관리를 참조하세요.

필수 범위

Dataset.ReadWrite.All 또는 Dataset.Read.All

제한점

• Azure Analysis Services에서 호스트되거나 온-프레미스 Azure Analysis Services 모델에 대한 라이브 연결이 있는 데이터 세트는 지원되지 않습니다.
• API 호출당 하나의 쿼리.
• 쿼리당 하나의 테이블 요청입니다.
• 쿼리당 최대 100,000개의 행 또는 1,000,000개의 값(먼저 적중됨). 예를 들어 열 5개에 대해 쿼리하는 경우 최대 100,000개의 행을 다시 가져올 수 있습니다. 20개의 열을 쿼리하는 경우 최대 50,000개의 행(100만 행을 20으로 나눈 값)을 다시 가져올 수 있습니다.
• 쿼리당 최대 15MB의 데이터입니다. 15MB를 초과하면 현재 행이 완료되지만 추가 행은 기록되지 않습니다.
• 쿼리되는 데이터 세트에 관계없이 사용자당 분당 120개의 쿼리 요청이 제한됩니다.
• 서비스 주체를 사용하려면 관리자 테넌트 설정에서 서비스 주체가 개발자 설정에서 Power BI API를 사용하도록 설정되었는지 확인합니다. 그러나 관리 테넌트 설정에 관계없이 서비스 주체는 RLS 제한당 RLS가 있는 데이터 세트 또는 SSO 를 사용하도록 설정된 데이터 세트에 대해 지원되지 않습니다.
• 현재 DAX 쿼리만 지원됩니다. MDX, INFO 함수 및 DMV 쿼리는 지원되지 않습니다.
  
  

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/executeQueries

URI 매개 변수

요청 본문

응답

예제

Execute queries example

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/executeQueries

{
  "queries": [
    {
      "query": "EVALUATE VALUES(MyTable)"
    }
  ],
  "serializerSettings": {
    "includeNulls": true
  },
  "impersonatedUserName": "someuser@mycompany.com"
}

{
  "results": [
    {
      "tables": [
        {
          "rows": [
            {
              "MyTable[Year]": 2010,
              "MyTable[Quarter]": "Q1"
            },
            {
              "MyTable[Year]": 2010,
              "MyTable[Quarter]": "Q2"
            },
            {
              "MyTable[Year]": 2011,
              "MyTable[Quarter]": "Q1"
            }
          ]
        }
      ]
    }
  ]
}

정의

DatasetExecuteQueriesError

오류의 세부 정보(있는 경우)입니다.

DatasetExecuteQueriesInformationProtectionLabel

데이터 세트와 연결된 정보 보호 레이블(있는 경우)의 세부 정보입니다.

DatasetExecuteQueriesQuery

데이터 세트 쿼리

DatasetExecuteQueriesQueryResult

단일 데이터 세트 쿼리의 결과

DatasetExecuteQueriesRequest

데이터 세트에 대해 쿼리를 실행하는 요청

DatasetExecuteQueriesResponse

데이터 세트에 대한 응답 쿼리 요청 실행

DatasetExecuteQueriesSerializationSettings

데이터 세트 쿼리 결과에 대한 serialization 설정

DatasetExecuteQueriesTableResult

데이터 테이블