이 페이지에서는 대시보드를 외부 애플리케이션에 iframe으로 포함하는 방법을 보여줍니다. 뷰어는 Azure Databricks 자격 증명을 사용하여 대시보드에 액세스합니다.
embed 코드 생성
외부 애플리케이션에 붙여넣을 수 있는 포함 코드를 생성하려면 다음을 수행합니다.
포함하려는 게시된 대시보드를 엽니다. 작업 영역에서 대시보드를 보고 액세스하는 방법을 알아보려면 대시보드 보기 및 구성 을 참조하세요.
오른쪽 위 모서리에서 공유 를 클릭합니다.
공유 대화 상자에서 대시보드 포함을 클릭합니다.
포함 코드 복사 대화 상자가 열립니다. 허용된 포함 도메인 목록이 있는 경우 도메인이 나열됩니다.
을 클릭하여 코드 조각을 복사합니다.
HTML 포함을 지원하고 iframe 콘텐츠를 렌더링할 수 있는 플랫폼 또는 애플리케이션에 포함 코드를 삽입합니다. 예제참조하세요.
비고
포함 코드 복사 대화 상자에 대상 도메인을 포함하지 않는 허용된 도메인 목록이 포함된 경우 작업 영역 관리자가 추가할 수 있습니다. 대시보드 및 Genie 액세스 관리를 참조하세요.
포함된 대시보드는 항상 조명 모드를 사용하여 표시됩니다. '다크 모드가 표시되지 않음'을 참조하십시오.
예시
다음 예제에는 애플리케이션에 대시보드를 포함하기 위한 단계별 지침이 포함됩니다. 각 지침 집합은 이전 섹션에 설명된 embed 코드를 이미 복사했다고 가정합니다.
Confluence에 포함
생성된 embed 코드는 Confluence의 요구 사항을 충족하기 위해 약간의 조정이 필요합니다. Confluence 페이지에 대시보드를 포함하려면 다음 단계를 완료합니다.
iframe 태그 또는 추가 태그 값이 아닌 생성된 URL만 포함하도록 포함 코드를 편집합니다.
편집하기 전에 포함 코드에는 iframe HTML 태그, iframe의 원본을 사용하기 위한 대시보드 링크 및 다음 코드 조각과 같이 높이, 너비 및 테두리에 대한 추가 사양이 포함됩니다. 대시보드의 경우 예제 자리 표시자
<databricks-instance-name>이며 작업 영역 및<dashboard-and-workspace-ID>대시보드와 연결된 실제 값을 포함합니다. 다음과 같습니다.-
<databricks-instance-name>작업 영역에 로그인할 때 URL의 첫 번째 부분입니다. 작업 영역 개체대한 식별자 가져오기참조하세요. - 대시보드
<dashboard-and-workspace-ID>를 가리키는 URL의 마지막 부분입니다. 다음과 같습니다a4bf23c498752e79f1a2d6b4c9087e31?o=3498561237865447.
<iframe src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>" width="100%" height="600" frameborder="0"></iframe>다음 예제와 같이 링크 텍스트만 포함되도록 문자열을 편집합니다.
https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>-
페이지에 iframe 요소를 삽입합니다. 페이지에 iframe을 삽입하는 방법을 알아보려면 Confluence의 설명서를 참조하세요.
URL 텍스트 필드에 편집된 포함 URL을 붙여넣고 너비를 100%설정합니다.
기본 설정에 따라 다른 설정을 조정합니다.
Salesforce 지식에 포함
Salesforce 기술 페이지에 대시보드를 포함하려면 다음 단계를 완료합니다.
Visualforce 페이지를 만듭니다. 자세한 내용은 Salesforce의 설명서를 참조하세요.
페이지 편집 화면에서 커서를 Visualforce 태그 편집기로 이동합니다.
두
<apex:page></apex:page>태그 사이에 복사한 embed 코드를 붙여넣습니다.포함 코드 주위에 두 개의 단락 태그(
<p></p>)를 추가합니다.다음 예제에서는 자리 표시자를
<dashboard-embed-code>사용하여 Visualforce 태그의 모양을 보여 줍니다. 인스턴스에는 복사한 전체 포함 코드가 포함되어야 합니다.<apex:page > <p><dashboard-embed-code></p> </apex:page>저장을 클릭하여 변경 내용을 저장합니다.
미리 보기를 클릭하고 대시보드가 렌더링되는지 확인합니다.
구성 요소 미리 보기의 URL을 복사하고 새 iframe 구성 요소를 만듭니다. 다음 코드 조각과 같습니다. 자리 표시자를
<your-salesforce-domain>Salesforce 도메인으로 바꿔야 합니다.<iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>대시보드를 포함하려는 지식 페이지로 이동합니다.
미디어 구성 요소 추가 편집 > 을 클릭합니다.
이전 단계의 iframe 코드를 포함 텍스트 필드에 붙여 넣습니다.
SharePoint에 포함
SharePoint에 대시보드를 포함하려면 SharePoint에 포함된 콘텐츠에 대해 허용 가능한 사이트 목록에 Azure Databricks URL을 추가해야 할 수 있습니다. 지침은 Microsoft의 설명서를 참조하세요. 그런 다음, 다음 단계를 완료합니다.
- 포함된 대시보드를 호스트하려는 SharePoint 페이지로 이동합니다.
- Embed 요소를 페이지에 추가합니다.
- 전체 포함 코드를 웹 사이트 주소에 붙여넣거나 화면 오른쪽에 있는 코드 필드를 포함합니다.
- 멀리 클릭하여 확인합니다.
단일 위젯 포함
대시보드에서 단일 위젯을 포함하려면 대시보드 포함 코드와 표시하려는 위젯의 고유 식별자가 필요합니다.
고유 식별자 복사
단일 위젯의 식별자는 페이지 name 값과 위젯 name 값의 조합으로, tilda(~)로 구분됩니다.
비고
키는 name 대시보드를 정의하고 Azure Databricks UI에서 액세스할 수 없는 직렬화된 파일에 나타납니다. UI에 displayName 표시된 페이지 이름을 정의하는 값과는 별개입니다.
대시보드 파일 편집을 참조하세요.
고유 식별자를 복사하려면 다음을 수행합니다.
Azure Databricks 작업 영역에서 게시된 대시보드를 엽니다.
을 클릭합니다. 포함하려는 위젯의 케밥 메뉴입니다.
전체 화면 보기 또는 위젯에 대한 링크 복사를 클릭합니다. URL에는 관련 페이지 및 위젯 값이
name포함됩니다.등호(
fullscreenWidget) 뒤의 검색 매개 변수=와 모든 항목을 복사합니다.다음 예제에서는 전체 화면 위젯에 대한 URL의 마지막 부분을 보여줍니다.
fullscreenWidget=53eadf26~3490f286
생성된 embed 코드 조정
- 대시보드 의 embed 태그 를 생성하는 단계를 찾으려면 embed 코드 생성을 참조하세요.
- 결합
&fullscreenWidget=<ID>된 값으로 대체<ID>하여 포함 URL에 추가<page-name>~<widget-name>합니다.
예를 들어 기본 포함 URL이 다음과 같은 경우입니다.
src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=<ID>"
고유 식별자를 사용하여 업데이트된 포함 URL은 다음과 같아야 합니다.
src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=53eadf26~82f66691"
포함된 대시보드 보기
포함된 대시보드는 뷰어에서 Azure Databricks 외부에서 대시보드 데이터에 액세스할 수 있는 안전한 방법을 제공합니다. 모든 기존 공유 설정이 적용됩니다. 의도한 뷰어에는 대시보드에 대한 액세스 권한이 부여되어야 합니다. 대시보드에 액세스할 수 있는 사용자를 참조하세요. 포함된 대시보드에 액세스할 때 뷰어는 최근 로그인에서 동일한 작업 영역으로의 활성 세션이 없는 한 Azure Databricks에 로그인하라는 메시지가 표시됩니다.
포함된 대시보드를 보려면 다음을 수행합니다.
- 대시보드가 포함된 페이지로 이동합니다.
- 필요한 경우 Azure Databricks 자격 증명으로 로그인합니다.
포함된 대시보드에서 Genie에게 질문하기
연결된 지니 공간과 함께 게시된 포함된 대시보드를 볼 때 뷰어는 지니 질문 단추에 액세스하여 자연어 질문을 사용하여 데이터를 탐색할 수 있습니다.
포함된 대시보드에서 Genie를 사용하려면 다음을 수행합니다.
- 포함된 대시보드 페이지로 이동합니다.
- 필요한 경우 Databricks 자격 증명으로 로그인합니다.
- 대시보드 인터페이스에서 지니에게 물어보 기를 클릭합니다.
- 대시보드 데이터에 대한 자연어 질문을 입력합니다.
Genie는 게시된 대시보드와 동일한 권한 및 데이터 액세스를 사용합니다. 대시보드에서 Genie를 설정하고 사용하는 방법에 대한 자세한 내용은 대시보드가 있는 Genie 공간을 참조하세요.
비고
대시보드에 대한 액세스 권한이 부여되지 않은 등록된 사용자가 대시보드를 보려고 하면 대시보드를 사용할 수 없다는 오류가 표시됩니다. 공유 설정을 조정하는 방법을 알아보려면 게시된 대시보드 공유 를 참조하세요.
포함된 대시보드 새로 고침
포함된 대시보드의 모든 뷰어는 요청 시 대시보드를 수동으로 새로 고칠 수 있습니다. 대시보드를 주기적으로 새로 고치도록 일정을 설정할 수도 있습니다.
예약된 대시보드 업데이트 및 구독 관리를 참조하세요.
포함된 대시보드 문제 해결
테마 표시 문제 및 빈 iframe을 포함하여 포함된 대시보드로 작업할 때 발생하는 일반적인 문제 및 해결 방법은 포함된 대시보드 문제 해결을 참조하세요.
다음 단계
- 외부 사용자에 대한 포함 구성: 외부 사용자에 대한 포함이란?을 참조하세요.
- 포함 권한 관리: 포함된 대시보드를 호스트할 수 있는 도메인을 제어하고 작업 영역 수준 포함 설정을 구성합니다. 대시보드 포함 관리를 참조하세요.
- 게시된 대시보드 공유: 다른 사용자 그룹과 게시된 대시보드에 대한 공유 설정 및 권한을 구성합니다. 대시보드 공유를 참조하세요.