내장된 대시보드 및 시각적 개체의 런타임 시 데이터 필터링 - 아마존 QuickSight
용어 및 개념설정SDK메서드 인터페이스

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

내장된 대시보드 및 시각적 개체의 런타임 시 데이터 필터링

Amazon QuickSight SDK 임베딩의 필터 메서드를 사용하여 SaaS (Software as a Service) 애플리케이션 내에서 런타임에 QuickSight 필터 기능을 활용할 수 있습니다. 비즈니스 소유자는 런타임 필터를 사용하여 애플리케이션을 내장된 QuickSight 대시보드 및 시각 자료와 통합할 수 있습니다. 이를 위해서는 애플리케이션에서 사용자 지정 필터 컨트롤을 만들고 애플리케이션의 데이터를 기반으로 필터 프리셋을 적용해야 합니다. 그러면 개발자가 런타임에 최종 사용자를 위한 필터 구성을 개인화할 수 있습니다.

개발자는 QuickSight 임베딩을 SDK 사용하여 임베디드 대시보드 또는 애플리케이션의 비주얼에서 필터를 만들고, 쿼리하고, 업데이트하고, 제거할 수 있습니다. FilterGroup데이터 모델을 사용하여 애플리케이션에서 QuickSight 필터 개체를 만들고 필터 방법을 사용하여 내장된 대시보드 및 시각적 개체에 적용할 수 있습니다. QuickSight 임베딩 사용에 대한 자세한 내용은 SDK on을 참조하십시오. amazon-quicksight-embedding-sdk GitHub

사전 조건 

시작하기 전에 QuickSight 임베딩 SDK 버전 2.5.0 이상을 사용하고 있는지 확인하십시오.

용어 및 개념

다음 용어는 내장된 런타임 필터링을 사용할 때 유용할 수 있습니다.

설정

시작하기 전에 다음 자산과 정보를 준비했는지 확인하십시오.

  • 범위를 지정하려는 시트의 시트 ID. FilterGroup 이는 SDK 임베딩의 getSheets 메서드를 사용하여 얻을 수 있습니다.

  • 필터링하려는 데이터셋의 데이터셋 및 열 식별자. 이는 작업을 통해 확인할 수 있습니다. DescribeDashboardDefinitionAPI

    사용하는 열 유형에 따라 임베디드 에셋에 추가할 수 있는 필터 유형에 제한이 있을 수 있습니다. 필터 제한에 대한 자세한 내용은 필터를 참조하십시오.

  • 적용 범위를 지정하려는 시각적 개체의 시각적 ID (해당하는 경우). FilterGroup 이는 SDK 임베딩의 getSheetVisuals 방법을 사용하여 얻을 수 있습니다.

    getSheetVisuals메서드 외에도 추가한 FilterGroup 항목의 범위를 현재 선택한 시트에만 적용할 수 있습니다.

이 기능을 사용하려면 QuickSight 임베딩을 SDK 통해 애플리케이션에 대시보드 또는 시각적 기능이 이미 내장되어 있어야 합니다. QuickSight 임베딩 SDK 사용에 대한 자세한 내용은 [Quip의 잘못된 링크] 를 참조하십시오.

SDK메서드 인터페이스

대시보드 임베딩 게터 메서드

다음 표에서는 개발자가 사용할 수 있는 다양한 대시보드 임베딩 게터 메서드에 대해 설명합니다.

메서드 설명

getFilterGroupsForSheet(sheetId: string)

FilterGroups 파라미터에 제공된 시트로 현재 범위가 지정된 모든 항목을 반환합니다.

getFilterGroupsForVisual(sheetId: string, visualId: string)

매개 변수에 제공된 비주얼로 범위가 지정된 모든 FilterGroups 항목을 반환합니다.

매개 변수에 제공된 시트가 내장 대시보드에서 현재 선택한 시트가 아닌 경우 위 메서드는 오류를 반환합니다.

비주얼 임베딩 게터 메서드

다음 표에서는 개발자가 사용할 수 있는 다양한 시각적 임베딩 게터 메서드에 대해 설명합니다.

메서드 설명

getFilterGroups()

현재 임베디드 비주얼로 범위가 지정된 모든 FilterGroups 것을 반환합니다.

세터 메서드

다음 표에는 개발자가 대시보드 또는 시각적 임베딩에 사용할 수 있는 다양한 setter 메서드가 설명되어 있습니다.

메서드 설명

addFilterGroups(filterGroups: FilterGroup[])

제공된 내용을 임베디드 대시보드 또는 FilterGroups비주얼에 추가하고 적용합니다. 추가 성공 여부를 ResponseMessage 나타내는 A가 반환됩니다.

updateFilterGroups(filterGroups: FilterGroup[])

매개 변수에 제공된 FilterGroupId 것과 동일한 내용을 포함하는 내장된 환경에서 를 업데이트합니다. FilterGroups FilterGroup 업데이트 성공 여부를 ResponseMessage 나타내는 A가 반환됩니다.

removeFilterGroups(filterGroupsOrIds: FilterGroup[] | string[])

FilterGroups 대시보드에서 제공된 항목을 제거하고 제거 시도의 성공 여부를 ResponseMessage 나타내는 a를 반환합니다.

제공되는 FilterGroup 파일의 범위는 현재 선택된 포함된 시트 또는 시각적 시트에만 적용되어야 합니다.