웹 커넥터 문제 해결

아티클
02/24/2024

Web.Contents, Web.BrowserContents 및 Web.Page 간의 차이점은 무엇인가요?

Web.Contents

Web.Contents 는 CSV 파일, JSON API 결과 등과 같이 브라우저를 통해 액세스할 필요가 없는 웹 콘텐츠를 검색하는 데 사용됩니다.
가장 다양한 인증 옵션을 지원합니다.
게이트웨이 없이 파워 쿼리 온라인과 같은 클라우드 환경에서 사용할 수 있습니다.

Web.Page

Web.Page 는 HTML 페이지와 같은 브라우저를 통해 액세스해야 하는 웹 콘텐츠를 검색하기 위한 레거시 함수입니다.
Internet Explorer를 기반으로 합니다. 이 요구 사항으로 인해 UI에서 .로 Web.BrowserContents대체됩니다. 그러나 Web.Page 이전 버전과의 호환성을 위해 엔진 수준에서 계속 사용할 수 있습니다.
게이트웨이는 파워 쿼리 온라인과 같은 클라우드 환경에서 사용해야 합니다.

Web.BrowserContents

Web.BrowserContents 는 HTML 페이지와 같은 브라우저를 통해 액세스해야 하는 웹 콘텐츠를 검색하기 위한 업데이트된 함수입니다.
Internet Explorer를 기반으로 하므로 UI Web.BrowserContents 에서 대체 Web.PageWeb.Page 됩니다.
Web.BrowserContents 는 처음에 Chromium을 기반으로 빌드되었지만 이제는 Microsoft Edge의 WebView2 컨트롤을 사용합니다.
게이트웨이는 파워 쿼리 온라인과 같은 클라우드 환경에서 사용해야 합니다.

다음 표에서는 차이점을 요약합니다.

	Web.Contents	Web.Page	Web.BrowserContents
비 브라우저 콘텐츠(.txt/.csv 파일, JSON 등)	x
브라우저 콘텐츠(HTML)		x	x
지원되는 인증 유형	익명 Windows 기본 웹 API 조직 계정	익명 Windows(현재 사용자의 자격 증명만 해당) 웹 API	익명 Windows 기본 웹 API
클라우드 호스트에 게이트웨이 필요	N	Y	Y
현재 생성자	모든 호스트	Excel 및 파워 쿼리 온라인	Power BI Desktop
기본 제공	.NET	Internet Explorer	Microsoft Edge의 WebView2 컨트롤

참고 항목

POST 요청은 .를 사용하는 Web.Contents경우에만 익명으로 수행할 수 있습니다.

웹 보기의 "이 브라우저는 더 이상 지원되지 않습니다." 경고

웹 페이지를 가져올 때 파워 쿼리의 탐색기 대화 상자에서 웹 보기 탭을 사용하여 페이지의 미리 보기를 볼 수 있습니다. 이 미리 보기에는 "이 브라우저는 더 이상 지원되지 않습니다."와 같은 경고가 표시될 수 있습니다. 이 경우 웹 보기는 현재 일부 웹 사이트에서 더 이상 지원되지 않는 Internet Explorer를 사용하여 웹 보기 미리 보기를 렌더링하기 때문입니다. 그러나 이는 웹 보기에만 영향을 줍니다. 웹 커넥터 자체에는 영향을 주지 않습니다. Web.Contents 또는 Web.BrowserContents (Web.Page 아님)를 기반으로 하는 커넥터를 사용하는 한 이러한 경고를 안전하게 무시할 수 있습니다. 다양한 웹 커넥터와 해당 기본 기술에 대한 자세한 내용은 Web.Contents, Web.BrowserContents 및 Web.Page 차이점을 참조하세요.

동적 웹 페이지 처리

콘텐츠를 동적으로 로드하는 웹 페이지에는 특별한 처리가 필요할 수 있습니다. 웹 쿼리에서 간헐적인 오류를 발견하면 동적 웹 페이지에 액세스하려고 할 수 있습니다. 이러한 유형의 오류의 일반적인 예는 다음과 같습니다.

사이트에 연결하는 쿼리를 새로 고칩니다.
오류가 표시됩니다(예: "테이블의 열 'Foo'를 찾을 수 없습니다.").
쿼리를 다시 새로 고칩니다.
오류가 발생하지 않습니다.

이러한 종류의 문제는 일반적으로 타이밍 때문입니다. 브라우저에서 로드가 완료된 것으로 간주한 후 콘텐츠가 변경될 수 있으므로 콘텐츠를 동적으로 로드하는 페이지가 일치하지 않을 수 있습니다. 경우에 따라 웹 커넥터는 모든 동적 콘텐츠가 로드된 후 HTML을 다운로드합니다. HTML을 다운로드할 때 변경 내용이 계속 진행되어 간헐적인 오류가 발생하는 경우도 있습니다.

솔루션은 HTML을 다운로드하기 전에 기다려야 하는 선택기 또는 시간 길이를 나타내는 Web.BrowserContents 옵션을 사용하는 WaitFor 것입니다.

페이지가 동적인지 어떻게 알 수 있나요? 일반적으로 매우 간단합니다. 브라우저에서 페이지를 열고 로드를 확인합니다. 콘텐츠가 바로 표시되는 경우 일반 HTML 페이지입니다. 동적으로 표시되거나 시간이 지남에 따라 변경되는 경우 동적 페이지입니다.

웹 커넥터에서 게이트웨이 사용

Web.BrowserContents와 Web.Page 모두 Power BI 의미 체계 모델 또는 데이터 흐름 또는 Power Apps 데이터 흐름과 같은 클라우드 서비스에 게시할 때 온-프레미스 데이터 게이트웨이를 사용해야 합니다. (현재 Dynamics 365 Customer Insights는 게이트웨이 사용을 지원하지 않습니다.)

Web.Page 사용하고 오류가 발생하는 Please specify how to connect 경우 온-프레미스 데이터 게이트웨이를 호스트하는 컴퓨터에 Internet Explorer 10 이상이 설치되어 있는지 확인합니다.

Web.BrowserContents를 사용하고 오류가 발생하는 We were unable to find the WebView2 runtime 경우 온-프레미스 데이터 게이트웨이를 호스트하는 컴퓨터에 WebView2 런타임이 설치되어 있는지 확인합니다. 오류 메시지는 WebView2 런타임 설치 관리자에 대한 링크를 제공해야 합니다. 런타임을 설치했지만 여전히 오류가 표시되는 경우 게이트웨이 서비스 계정(일반적으로 PBIEgwService)이 WebView2 런타임의 설치 위치(예: C:\Program Files (x86)\Microsoft\EdgeWebView)에 액세스할 수 있는지 확인합니다.

Web.BrowserContents를 사용할 때 "웹 브라우저를 초기화할 때 오류가 발생했습니다." 오류

WebView2는 현재 관리자 권한으로 실행을 지원하지 않으므로 Web.BrowserContents를 호출하는 프로세스가 관리자 모드에서 실행되는 경우 이 오류가 발생할 수 있습니다.

Web.BrowserContents 대신 Web.Page 사용

대신 Web.BrowserContents사용해야 Web.Page 하는 경우 수동으로 사용할 Web.Page수 있습니다.

Power BI Desktop에서 웹 테이블 유추 사용 옵션을 선택 취소하여 이전 Web.Page 함수를 사용할 수 있습니다.

파일 탭에서 옵션 및 설정>옵션을 선택합니다.
전역 섹션에서 Power Query 편집기 선택합니다.
웹 테이블 유추 사용 옵션을 선택 취소한 다음 확인을 선택합니다.
Power BI Desktop을 다시 시작합니다.

참고 항목

현재 Power BI Report Server에 최적화된 Power BI Desktop에서는 Web.BrowserContents 사용을 끌 수 없습니다.

Excel에서 쿼리 복사본을 Web.Page 가져올 수도 있습니다. Excel에서 코드를 복사하려면 다음을 수행합니다.

데이터 탭에서 웹에서 선택합니다.
웹에서 보낸 사용자 대화 상자에 주소를 입력한 다음 확인을 선택합니다.
탐색기에서 로드할 데이터를 선택한 다음 데이터 변환을 선택합니다.
파워 쿼리의 홈 탭에서 고급 편집기 선택합니다.
고급 편집기 M 수식을 복사합니다.
사용하는 Web.BrowserContents앱에서 빈 쿼리 커넥터를 선택합니다.
Power BI Desktop으로 복사하는 경우:
1. 홈 탭에서 고급 편집기 선택합니다.
2. 복사 Web.Page 한 쿼리를 편집기에서 붙여넣은 다음 완료를 선택합니다.
파워 쿼리 온라인으로 복사하는 경우:
1. 빈 쿼리에서 복사 Web.Page 한 쿼리를 빈 쿼리에 붙여넣습니다.
2. 사용할 온-프레미스 데이터 게이트웨이를 선택합니다.
3. 다음을 선택합니다.

빈 쿼리에 다음 코드를 수동으로 입력할 수도 있습니다. 로드할 웹 페이지의 주소를 입력해야 합니다.

let
  Source = Web.Page(Web.Contents("<your address here>")),
  Navigation = Source{0}[Data]
in
  Navigation

웹 요청 및 인증서 해지 캡처

데이터를 보호하기 위해 웹 연결의 보안을 강화했습니다. 그러나 이는 Fiddler를 사용하여 웹 요청을 캡처하는 것과 같은 특정 시나리오가 더 이상 기본적으로 작동하지 않음을 의미합니다. 이러한 시나리오를 사용하도록 설정하려면 다음을 수행합니다.

Power BI Desktop을 실행합니다.
파일 탭에서 옵션 및 설정>옵션을 선택합니다.
옵션의 전역>보안에서 인증서 해지 검사 검사 해제합니다.
확인을 선택합니다.
Power BI Desktop을 다시 시작합니다.

Important

인증서 해지 검사 검사 해제하면 웹 연결의 보안이 떨어지게 됩니다.

그룹 정책에서 이 시나리오를 설정하려면 레지스트리 경로 "Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft Power BI Desktop"에서 "DisableCertificateRevocationCheck" 키를 사용합니다. "DisableCertificateRevocationCheck"를 0으로 설정하면 항상 검사 사용하도록 설정하고(Fiddler 및 유사한 소프트웨어 작동 중지) "DisableCertificateRevocationCheck"를 1로 설정하면 항상 검사 사용하지 않도록 설정합니다(Fiddler 및 유사한 소프트웨어 사용).

인증 방법 변경

경우에 따라 특정 사이트에 액세스하는 데 사용하는 인증 방법을 변경해야 할 수 있습니다. 이 변경이 필요한 경우 인증 방법 변경으로 이동합니다.

임의 서비스에 인증

일부 서비스는 웹 커넥터가 OAuth/Microsoft Entra ID 인증을 사용하여 인증하는 기능을 지원합니다. 그러나 대부분의 경우 작동하지 않습니다.

인증을 시도할 때 다음 오류가 표시되는 경우:

We were unable to connect because this credential type isn’t supported for this resource. Please choose another credential type.

웹 커넥터를 사용하여 OAuth를 지원하지 않는 엔드포인트에 연결하는 동안 오류가 발생했습니다.

서비스 소유자에게 문의하세요. 인증 구성을 변경하거나 사용자 지정 커넥터를 빌드해야 합니다.

웹 커넥터는 HTTP 1.1을 사용하여 통신합니다.

파워 쿼리 웹 커넥터는 HTTP 1.1을 사용하여 데이터 원본과 통신합니다. 데이터 원본이 HTTP 1.0을 사용하여 통신해야 하는 경우 다음과 같은 500 Internal Server Error오류가 발생할 수 있습니다.

파워 쿼리를 HTTP 1.0을 사용하도록 전환할 수 없습니다. 파워 쿼리는 초기 호출 자체가 실패할 수 있는 경우(예: 권한 부족으로 인해) 큰 페이로드를 전달하지 않도록 본문이 있는 경우 항상 전송 Expect:100-continue 합니다. 현재 이 동작은 변경할 수 없습니다.

Microsoft Graph에 커넥트

파워 쿼리는 현재 Microsoft Graph REST API에 대한 연결을 지원하지 않습니다. 추가 정보: 파워 쿼리에서 Microsoft Graph에 대한 지원 부족

다음을 통해 공유