이 문서에서는 지니 공간에서 예제 SQL 지침을 작성할 때 매개 변수를 사용하는 방법을 설명합니다.
매개 변수를 사용하는 이유
매개 변수를 사용하면 런타임에 대체될 특정 값에 대한 자리 표시자를 사용하여 예제 쿼리를 작성할 수 있습니다. 매개 변수를 사용하면 Genie는 사용자 질문의 특정 입력을 받아 예제 쿼리의 구조를 다시 사용하여 확인된 답변을 신뢰할 수 있는 자산으로 제공할 수 있습니다. 예를 들어 o.forecastcategory 값으로 필터링하는 매개 변수를 포함하도록 이전 SQL 쿼리를 조정하여 쿼리가 다른 예측 범주에 태그가 지정된 기회에 대한 질문을 처리할 수 있도록 할 수 있습니다. 매개 변수가 있는 쿼리를 사용하여 신뢰할 수 있는 자산으로 레이블이 지정된 응답을 생성하는 방법에 대한 자세한 내용은 AI/BI Genie 공간신뢰할 수 있는 자산 사용을 참조하세요.
다음 예제 쿼리는 지역별 열려 있는 총 파이프라인 값 판매 기회를 계산합니다.
o.forecastcategory 값에 대한 매개 변수를 포함합니다. 매개 변수는 명명된 매개 변수 표식과 동일한 구문을 사용합니다. 지니 공간에서 매개 변수를 사용하는 방법에 대한 자세한 지침은 쿼리 매개 변수 및명명된 매개 변수 표식 사용참조하세요.
-- Return our current pipeline at a stage by region.
-- Opportunities are only considered pipelines if they are tagged as such.
SELECT
a.region__c AS `Region`,
sum(o.amount) AS `Open Pipeline`
FROM
sales.crm.opportunity o
JOIN sales.crm.accounts a ON o.accountid = a.id
WHERE
o.forecastcategory = :forecast_category AND
o.stagename NOT ILIKE '%closed%'
GROUP BY ALL;
쿼리에 매개 변수를 추가하려면 다음을 수행합니다.
쿼리에 매개 변수를 배치할 위치에 커서를 놓습니다.
"매개 변수 추가를 클릭하여 새 매개 변수를 삽입합니다."
그러면 기본 이름이
parameter새 매개 변수가 만들어집니다. 기본 이름을 변경하려면 쿼리 편집기에서 바꿉다. 콜론과 매개 변수 이름(:parameter_name)을 편집기에 입력하여 매개 변수를 추가할 수도 있습니다.
쿼리 매개 변수 편집
매개 변수를 편집하려면 다음을 수행합니다.
을 클릭합니다. 매개 변수 이름 옆에 있습니다.
매개 변수 세부 정보 대화 상자가 나타나고 다음 구성 옵션이 포함됩니다.키워드: 쿼리의 매개 변수를 나타내는 키워드입니다. 키워드는 쿼리의 텍스트를 직접 업데이트해야만 변경할 수 있습니다.
표시 이름: Genie가 채팅 환경에서 사용하는 사람이 읽을 수 있는 이름입니다. Genie가 매개 변수가 있는 쿼리를 사용하여 응답을 생성하는 경우 응답에 표시 이름 및 연결된 값이 포함됩니다.
형식: 지원되는 형식에는 문자열, 날짜, 날짜 및 시간및 숫자포함됩니다.
- 기본 형식은 String.
-
숫자 데이터 형식을 사용하면 10진수정수지정할 수 있습니다. 기본 숫자 형식은 10진수
.
비고
실제 입력 값이 선택한 매개 변수 형식과 일치하지 않으면 Genie는 입력 값을 잘못된 형식으로 처리하므로 결과가 정확하지 않을 수 있습니다.
UI의 다른 부분을 클릭하여 대화 상자를 닫습니다.
매개 변수가 있는 쿼리 응답
응답에 매개 변수의 정확한 텍스트가 사용되는 경우 응답은 신뢰할 수 있는 것으로 표시됩니다. 즉, 지니는 공간의 컨텍스트에 따라 사용자 질문이 예제 질문 또는 쿼리의 의도와 일치한다고 식별했습니다.
신뢰할 수 있는 레이블을 사용하면 공간 사용자가 Genie의 응답이 검증된 SQL 쿼리를 기반으로 한다는 것을 알 수 있습니다. 응답에 사용되는 생성된 SQL 및 매개 변수 값을 볼 수 있습니다.