사용자 지정 가능한 쿼리에서 데이터 제품 만들기
사용자 지정 가능한 매개변수와 쿼리를 사용하여 데이터의 동적 보기가 있는 데이터 제품을 만들 수 있습니다. 소비자는 데이터 제품을 생성하는 데 사용되는 결과를 반환하는 사용자 지정 쿼리 역할을 하는 매개변수를 지정할 수 있습니다. 사용자 지정 가능한 쿼리를 사용하면 데이터 제품을 더 자주 재사용할 수 있고 소비자는 필요한 특정 데이터를 받을 수 있습니다.
사용자 지정 가능한 쿼리를 지원하는 데이터 제품을 만들려면 필요한 매개변수를 추가하고 정의한 다음, 해당 매개변수를 변수로 사용하는 SQL 쿼리를 만들어야 합니다. 소비자는 데이터 상품을 구독하고 구독 세부 정보에 필요한 매개 변수를 표시합니다.
- 필수 역할
- 공동 작업자 역할 편집자
이 동영상은 이 설명서의 개념과 작업을 시각적으로 학습할 수 있는 방법을 제공합니다.
데이터 원본 연결 추가
프로젝트에 데이터 소스 연결을 추가하여 원격 데이터에 연결합니다.
- 프로젝트 내에서 자산 페이지로 이동하여 새 자산 > 데이터 소스에 연결을 클릭합니다.
- 데이터 소스 연결을 선택하고 필요한 자격 증명을 입력합니다. 이러한 자격 증명은 구독 후 소비자에게 데이터 제품을 제공하는 데 사용되므로 적절한 자격 증명 집합을 사용해야 합니다.
- 만들기을 클릭하여 데이터 소스 연결의 유효성을 검사합니다.
매개변수 세트 작성
매개변수 세트에서 필요한 매개변수를 추가하고 정의합니다. 데이터 제품 요청 세부 정보를 확인하여 매개변수를 만들 수 있습니다.
- 에셋 페이지에서 새 에셋 > 재사용 가능한 파라미터 세트 정의를 클릭합니다.
- 필요한 각 매개변수에 대해 다음 속성을 정의합니다:
- 이름: 매개변수의 이름을 입력합니다.
- 유형: 입력을 어떤 데이터 유형으로 제출할지 표시합니다.
Email및Encrypted유형의 매개변수는 현재 사용자 지정 가능한 쿼리에서 지원되지 않습니다. - 프롬프트: 사용자에게 매개변수를 묻는 프롬프트를 정의합니다.
- 기본값: 비슷한 응답이 예상되는 경우 속성을 미리 채울 수 있습니다.
- 저장를 클릭하여 매개변수를 확인합니다.
사용자 지정 가능한 매개 변수를 사용하여 SQL 쿼리 만들기
지정된 매개 변수를 사용하여 데이터 제품을 생성하는 SQL 쿼리를 정의합니다.
- 프로젝트 페이지에서 새 자산 > 데이터의 동적 보기 만들기를 클릭합니다.
- 다음 필드를 작성하여 데이터 자산을 정의합니다:
- 이름: 데이터 자산의 이름을 입력합니다.
- 설명: 쿼리의 목적을 설명합니다.
- 연결: SQL 쿼리를 지원하는 연결을 선택합니다. 지원되는 연결에 대해서는 SQL에서 데이터 제품 만들기를 참조하세요.
- 매개 변수 집합: 쿼리를 생성할 매개 변수 집합을 선택합니다.
- 태그(선택 사항): 자산을 더 쉽게 찾을 수 있도록 태그를 추가합니다.
- SQL 쿼리에서 각 매개변수를 데이터 값으로 연결합니다. 쿼리의 모든 매개변수 이름이 매개변수 집합의 해당 이름과 일치하는지 확인합니다. 다음 구문을 사용하여 매개변수를 지정합니다:
'#{parameter_1_name}#'.
.
다음 코드 샘플과 그래픽을 매개변수가 있는 SQL 쿼리 작성의 예로 사용하세요:
SELECT * FROM {DATABASE.NAME}
WHERE
{DATABASE.NAME.COLUMN1} = '#{parameter_1_name}#' AND
{DATABASE.NAME.COLUMN2} = '#{parameter_2_name}#';

- 각 매개변수에 대한 샘플 값을 입력하여 데이터 미리 보기를 생성합니다. 쿼리 필드에 정의된 모든 매개변수에는 샘플 값이 포함되어야 합니다. 샘플 값을 비워두려면 쿼리 필드에서 매개변수를 제거합니다.
- 생성를 클릭하여 매개변수 집합을 SQL 쿼리와 연결합니다. 프로젝트의 에셋 페이지에서 쿼리가 성공적으로 유효성 검사되었는지 확인할 수 있습니다.
데이터 제품에 사용자 지정 가능한 쿼리 추가하기
프로젝트 옵션을 사용하여 데이터 제품을 만듭니다.
- Data Product Hub 탐색 메뉴에서 데이터 제품 만들기를 클릭합니다.
- 데이터 제품의 이름을 입력하고 프로젝트에서 추가 타일을 클릭합니다.
- 항목 선택를 클릭하고 검색어를 추가합니다. 고급 필터를 사용하여 데이터 자산 목록에서 쿼리를 빠르고 쉽게 찾아 추가할 수 있습니다.
- 연결 상태가 확인되었는지 확인하고 초안을 작성합니다. 초안이 성공적으로 생성되면 데이터 제품의 정적 시각화가 생성되어 게시 후 소비자가 볼 수 있습니다.
다음 단계
데이터 제품 초안을 만든 후 데이터 제품 완성하기을 참조하여 게시할 데이터 제품 준비를 마칩니다.