Power BI connector (REST API)
Power BI REST API 커넥터를 사용하면 GET, POST를 사용해 Cognite의 OData 서비스 또는 기타 Cognite API를 사용하여 데이터를 가져오고, Cognite 데이터 모델에 대한 GraphQL 쿼리를 통해 데이터를 가져올 수 있습니다.
이 섹션에서 설명하는 기능들은 현재 일부 고객을 대상으로 베타 테스트 중이며 변경될 수 있습니다.
Cognite Data Fusion(CDF) 연결 설정
Power BI에서 Cognite Data Fusion (CDF) 프로젝트를 데이터 원본으로 연결하려면 다음 단계에 따르십시오.
-
~~Power BI Desktop~~에서 조직 계정을 사용하여 로그인합니다.
-
홈 탭에서 데이터 가져오기를 선택한 다음 자세히를 선택합니다. 데이터 가져오기 대화 상자에서 Cognite를 검색하고 Cognite Data Fusion (REST API) 커넥터를 선택합니다.
-
대화 상자에서 세부 정보를 입력하여
CDF에 대한 연결을 구성합니다.-
CDF project: 연결하려는
CDF프로젝트의 이름을 입력합니다. -
CDF organization:
CDF에 로그인하는 데 사용할 조직을 입력합니다.
-
-
메시지가 표시되면 계정 자격 증명을 사용하여 로그인합니다.
-
Connect을 선택하여 Navigator 창을 엽니다.
-
사용하려는 함수를 선택한 다음 데이터 변환을 선택하여
Power Query Editor를 열고CDF에서 데이터를 검색합니다.
페이지 매김을 지원하는 요청을 수행하는 경우 지원되는 최대 페이지 크기를 사용하십시오(GET/POST 요청의 limit 매개 변수 또는 GraphQL 쿼리의 first 매개 변수 사용). 페이지 크기가 작을수록 API 호출 수가 증가하며 로드 시간에 큰 영향을 미칠 수 있습니다. 각 엔드포인트에서 지원되는 최대 페이지 크기에 대해서는 Cognite API 설명서를 참조하십시오. GraphQL 쿼리의 경우 최대 한도는 페이지당 1,000개 인스턴스입니다.
데이터 필터링
REST API 함수를 사용할 때 서버 측 필터를 적용하여 Power BI에 로드되는 초기 데이터를 줄일 수 있습니다.
OData를 사용하는 경우 Power Query 편집기를 사용할 때 Power BI에서 일부 필터를 OData 서비스로 푸시다운할 수 있습니다.
GraphQL 쿼리의 경우 쿼리에서 직접 필터를 적용하여 Power BI에 로드되는 데이터의 양을 줄일 수 있습니다. 또한 GraphQL 쿼리 변수를 사용하여 쿼리를 매개 변수화하여 재사용성을 높일 수 있습니다.
예약된 새로 고침
Power BI 서비스에 보고서를 게시한 후 데이터 새로 고침 일정을 예약하여 데이터를 최신 상태로 유지할 수 있습니다.
오류 처리
사용자 지정 GET 및 POST 요청을 작성할 때 잘못된 URL이나 본문을 제공하면 오류가 발생할 수 있습니다. CogniteAPIError 오류 메시지가 표시되면 Cognite API 참조 설명서를 참조하여 요청을 조정하십시오.