Power BI REST API 함수

이 문서에서는 사용 가능한 Power BI REST API 함수에 대해 자세히 설명합니다.

베타

이 섹션에서 설명하는 기능들은 현재 일부 고객을 대상으로 베타 테스트 중이며 변경될 수 있습니다.

GetCDF

이 함수를 사용하면 HTTP GET 메서드를 사용하여 CDF API에서 데이터를 가져올 수 있습니다. 이 함수는 요청 커서가 소진될 때까지 CDF를 자동으로 페이지 매김합니다. 최적의 성능을 보장하려면 Cognite API 사양에서 이 HTTP 메서드를 지원하는 엔드포인트와 각 엔드포인트에 대해 지원되는 최대 페이지 크기를 참조하십시오.

매개 변수	Type	Description
url	텍스트	프로젝트 이름 바로 뒤부터 시작하는 요청을 수행할 URL 경로입니다. 예: "/timeseries", "/assets"

PostCDF

이 함수를 사용하면 HTTP POST 메서드를 사용하여 CDF API에서 데이터를 가져올 수 있습니다. 이 함수는 요청 커서가 소진될 때까지 CDF를 자동으로 페이지 매김합니다. 최적의 성능을 보장하려면 Cognite API 사양에서 이 HTTP 메서드를 지원하는 엔드포인트를 참조하십시오.

매개 변수	Type	Description
url	텍스트	프로젝트 이름 바로 뒤부터 시작하는 요청을 수행할 URL 경로입니다. 예: "/timeseries/list", "/assets/list"
body	텍스트	요청과 함께 전송할 JSON 본문의 텍스트 표현입니다. 예: "{}", "{"limit": 1000}". 가능한 경우 limit 매개 변수를 엔드포인트에서 지원하는 최대값으로 설정합니다. 최적의 성능에 대해서는 Cognite API 사양을 참조하십시오. Power BI에서 이 함수를 호출할 때 쿼리는 여러 줄 텍스트 영역으로 표시되며, 큰따옴표 문자를 이스케이프 처리할 필요가 없습니다. 잘못된 JSON 본문을 제공하면 이 함수는 CogniteConnectorError 유형의 오류를 반환합니다.

참고

PostCDF 함수는 요청 본문의 최상위에 커서가 있다고 예상되는 간단한 요청에 대해 자동 페이지 매김 기능을 제공합니다. 보다 복잡한 요청의 경우 Power Query M 언어를 사용하여 사용자 지정 페이지 매김 로직을 작성해야 합니다. Power Query 함수 및 예제 쿼리 문서를 참조하십시오.

GraphQL

이 함수를 사용하면 GraphQL을 사용하여 CDF 데이터 모델에서 데이터를 가져올 수 있습니다.

매개 변수	Type	Description
space	텍스트	데이터 모델 공간의 외부 ID입니다.
datamodel	텍스트	데이터 모델의 외부 ID입니다.
version	텍스트	데이터 모델의 버전입니다.
query	텍스트	요청을 수행할 때 전송할 GraphQL 쿼리의 텍스트 표현입니다. 자동 페이지 매김을 사용하려면 쿼리에 after:$cursor and pageInfo { hasNextPage endCursor }를 포함하십시오. 최적의 성능을 위해 first 매개 변수를 1000(지원되는 최대 한도)으로 설정하는 것이 좋습니다. 예: "query MyQuery($cursor: String) { listMovies(first: 1000, after: $cursor) { items { name } pageInfo { endCursor hasNextPage }}}". Power BI에서 이 함수를 호출할 때 쿼리는 여러 줄 텍스트 영역으로 표시됩니다. 큰따옴표 문자를 이스케이프 처리할 필요가 없습니다. 잘못된 GraphQL 쿼리를 제공하면 이 함수는 CogniteAPIError 유형의 오류를 반환합니다.
variables	텍스트	요청을 수행할 때 전송할 JSON 변수의 텍스트 표현입니다. 예: "{""country"": ""Norway""}". variables 매개 변수에 cursor 변수를 포함하지 마십시오. 이 변수는 커넥터에서 자동으로 관리합니다. 잘못된 JSON 본문을 제공하면 이 함수는 CogniteConnectorError 유형의 오류를 반환합니다.

참고

GraphQL 함수는 after: $cursor 및 pageInfo { hasNextPage endCursor }로 식별되는 페이지 매김 대상이 하나뿐인 쿼리 식을 하나만 포함하는 GraphQL 쿼리에 대해 자동 페이지 매김 기능을 제공합니다. 보다 복잡한 쿼리의 경우 Power Query M 언어를 사용하여 사용자 지정 페이지 매김 로직을 작성해야 합니다. Power Query 함수 및 예제 쿼리 문서도 참조하십시오. Power BI에서 쿼리 및 변수를 사용하기 전에 항상 CDF Query Explorer로 테스트하여 올바른지 확인하십시오.

ODataCDF

이 함수를 사용하면 Cognite OData서비스에서 데이터를 가져올 수 있습니다.

매개 변수	Type	Description
url	텍스트	프로젝트 이름을 포함하는 OData 요청에 대한 URL 경로입니다. 예: "publicdata", "publicdata/Timeseries".
apiVersion	텍스트(선택 사항)	요청에 사용할 OData 서비스의 API 버전입니다. 기본값: "v1". asset-centric OData 서비스의 최신 버전은 "v1"입니다. 데이터 모델링 OData 서비스의 경우 최신 버전은 "20230821"입니다.

ODataDataModel

데이터 모델링 OData 서비스를 사용하여 CDF의 데이터 모델에서 데이터를 가져옵니다.

매개 변수	Type	Description
space	텍스트	데이터 모델 공간의 외부 ID입니다.
datamodel	텍스트	데이터 모델의 외부 ID입니다.
version	텍스트	데이터 모델의 버전입니다.
apiVersion	텍스트(선택 사항)	요청을 수행할 때 사용할 OData 서비스의 API 버전입니다. 기본값: "20230821". 데이터 모델링 OData 서비스의 최신 버전은 "20230821"입니다.