Cortex Analyst 의 사용자 지정 지침

사용자 지정 지침을 사용하면 SQL 생성을 더욱 효과적으로 제어할 수 있습니다. 자연어를 사용하여 Cortex Analyst 에 시맨틱 모델 YAML 파일 내에서 SQL 쿼리를 생성하는 방법을 정확히 알려줄 수 있습니다. 예를 들어, 사용자 지정 지침을 사용하여 Cortex Analyst 에 성과 또는 회계 연도 가 무엇을 의미하는지 알려줍니다. 이러한 방식으로 사용자 지정 논리 또는 추가 요소를 통합하여 생성된 SQL 의 정확도를 향상시킬 수 있습니다.

사용자 지정 지침 작동 방식

Cortex Analyst 는 custom_instructions 필드를 의미 체계 모델 YAML 파일에 도입합니다. 이 필드에서는 SQL 생성에 정의 수정 또는 추가 사항을 적용할 수 있습니다.

의미 체계 모델 구문에 대한 자세한 내용은 Cortex Analyst 의미 체계 모델 사양 섹션을 참조하십시오.

예

사용자 지정 지침의 가능한 사용 사례를 살펴보려면 다음 예를 살펴보십시오.

데이터 출력 형식 지정하기

출력의 모든 숫자가 소수점 이하 두 자리로 반올림되었는지 확인합니다.

의미 체계 모델 YAML 파일의 custom_instructions 필드

custom_instructions: "Ensure that all numeric columns are rounded to 2 decimal points in the output."
Copy

생성된 SQL 쿼리

SELECT
  ROUND(column_name, 2) AS column_name,
  ...
FROM
  your_table;
Copy

백분율 조정

일관성을 위해 백분율 또는 요율 계산에 100을 자동으로 곱합니다.

의미 체계 모델 YAML 파일의 custom_instructions 필드

custom_instructions: "For any percentage or rate calculation, multiply the result by 100."
Copy

생성된 SQL 쿼리

SELECT
  (column_a / column_b) * 100 AS percentage_rate,
  ...
FROM
  your_table;
Copy

기본 필터 추가하기

사용자가 필터를 지정하지 않은 경우 필터를 적용합니다(예: 기본값은 최근 연도).

의미 체계 모델 YAML 파일의 custom_instructions 필드

custom_instructions: "If no date filter is provided, apply a filter for the last year."
Copy

생성된 SQL 쿼리

SELECT
  ...
FROM
  your_table
WHERE
  date_column >= DATEADD(YEAR, -1, CURRENT_DATE);
Copy

열 필터 링크하기

사용자 입력에 따라 관련 열에 추가 필터를 적용합니다.

의미 체계 모델 YAML 파일의 custom_instructions 필드

custom_instructions: "If a filter is applied on column X, ensure that the same filter is applied to dimension Y."
Copy

생성된 SQL 쿼리

SELECT
  ...
FROM
  your_table
WHERE
  column_x = 'filter_value' AND
  dimension_y = 'filter_value';
Copy

모범 사례

구체적으로 설명하십시오.

예를 들어, “42로 수정된 값을 가진 열 추가” 또는 “X 열에 대한 합계 계산 포함”과 같이 수정 사항을 명확하게 설명합니다

작게 시작하십시오.

더 복잡한 시나리오로 이동하기 전에 정적 열 또는 기본 필터 추가와 같은 간단한 수정부터 시작하십시오.

생성된 SQL 쿼리 미리 보기.

지침이 의도한 대로 적용되고 생성된 SQL 쿼리가 올바른지 확인합니다.

점진적으로 반복합니다.

기능에 익숙해지면 더 복잡한 사용 사례를 실험해 보십시오.

언어: 한국어