SQL 생성을 위해 Snowflake Cortex를 사용하는 방법

대부분의 팀은 SQL 생성을 마치 마술처럼 여깁니다. 질문을 입력하면 쿼리가 생성됩니다.

하지만 현실은 이렇습니다. Snowflake Cortex Analyst는 사용자가 먼저 구축한 의미론적 모델의 수준에 따라 성능이 결정되며, 그 설정 과정은 결코 간단하지 않습니다. Snowflake Cortex를 활용한 SQL 생성 방법을 익히면, 데이터 팀은 이제 자연어를 단 몇 초 만에 복잡하고 실행 가능한 쿼리로 변환할 수 있습니다.

이 가이드에서는 YAML 의미론 모델 정의부터 자연어를 사용하여 데이터 웨어하우스를 쿼리하는 과정에 이르기까지 실제 구현 절차를 단계별로 안내하므로, 시작하기 전에 이 기능의 장점과 필수 전제 조건을 모두 파악할 수 있습니다.

또한 Snowflake Cortex의 한계와, ClickUp이 SQL 생성을 둘러싼 더 광범위한 워크플로우를 어떻게 지원할 수 있는지 살펴보겠습니다.

Snowflake Cortex Analyst란 무엇인가요?

Snowflake Cortex Analyst는 분석 데이터를 기반으로 대화형 애플리케이션을 구축할 수 있게 해주는 완전 관리형 서비스입니다.

이 서비스는 특화된 텍스트-SQL 변환 에이전트를 사용하여 자연어 질문을 정확하고 실행 가능한 쿼리로 변환합니다. 이 서비스는 복잡한 데이터 구조와 코드를 작성하지 않고도 답변을 필요로 하는 비즈니스 사용자 간의 격차를 해소합니다.

주요 기능은 다음과 같습니다:

Snowflake Cortex SQL 생성을 위한 필수 조건

적절한 설정 없이 Snowflake Cortex를 사용하면 좌절감을 느낄 수 있습니다. 부정확한 결과를 얻거나 문제 해결에 시간을 낭비하게 될 수 있으며, 실제 문제는 기초가 미흡한 데도 불구하고 도구가 제대로 작동하지 않는다고 잘못 판단할 수도 있습니다.

이를 방지하려면 먼저 세 가지 기본 요소를 마련해야 합니다.

1. 데이터베이스 및 테이블 설정

AI의 지능은 접근할 수 있는 데이터의 수준에 따라 결정됩니다. 데이터베이스 스키마가 cust_dat_v2_final과 같이 난해한 열 이름으로 뒤엉킨 미로와 같다면, 분석가와 AI 모두 이를 이해하는 데 어려움을 겪게 될 것입니다.

이러한 혼란으로 인해 AI가 잘못된 조인을 생성하거나 잘못된 열에서 데이터를 추출하게 되며, 팀은 쿼리를 작성하기도 전에 스키마를 해독하는 데만 몇 시간을 낭비하게 됩니다.

먼저, 데이터 웨어하우스 소프트웨어에 Cortex Analyst가 쿼리할 테이블이 포함되어 있는지 확인하십시오. 가능한 한 명확하고 설명적인 열 이름을 사용하십시오. 예를 들어, customer_lifetime_value라는 열 이름은 clv_01보다 사람과 AI 모두에게 훨씬 더 직관적입니다.

설정을 진행하려면 Snowflake 역할에 다음 권한이 필요합니다:

2. 시맨틱 모델 파일 생성하기

모든 텍스트-SQL 변환 도구의 가장 큰 난관은 AI가 귀사의 고유한 용어를 이해하지 못한다는 점입니다. AI는 “ARR”이 “연간 반복 수익(Annual Recurring Revenue)”을 의미한다는 사실이나, 고객 테이블이 customer_id 필드를 통해 주문 테이블과 조인된다는 사실을 본질적으로 알지 못합니다.

이러한 맥락이 없다면, AI는 기술적으로는 유효하지만 논리적으로는 잘못된 SQL을 생성할 수 있으며, 겉보기에는 정확해 보이지만 위험할 정도로 오해의 소지가 있는 답변을 제공할 수 있습니다.

해결책은 바로 시맨틱 모델입니다. 이 모델은 맞춤형 “번역 계층” 역할을 하는 YAML 파일로, Cortex Analyst에 해당 비즈니스의 특정 용어와 논리를 가르쳐 줍니다. 이 파일을 구축하고 유지 관리하는 노력은 스키마를 파악하기 위해 ETL tools를 사용하는 데이터 엔지니어와 용어를 잘 아는 비즈니스 분석가 간의 협업을 통해 이루어집니다.

의미론적 모델 파일에는 다음과 같은 키 구성 요소가 포함되어야 합니다:

3. Cortex Search Service 구성 (선택 사항)

때로는 제품 설명, 지원 티켓, 통화 기록과 같은 비정형 텍스트 속에 필요한 답이 숨겨져 있습니다. 표준 SQL 쿼리로는 이러한 데이터를 처리할 수 없기 때문에, 종종 ‘무엇’ 뒤에 숨겨진 ‘왜’를 놓치게 됩니다.

원하는 경우 여기에 Snowflake Cortex Search Service를 추가할 수 있습니다. 이는 ‘서비스형 검색(search-as-a-service) ’ 계층으로, AI 에이전트를 활용하여 데이터 분석을 수행하면서 구조화된 테이블과 비정형 텍스트 데이터를 동시에 쿼리할 수 있게 해줍니다.

분석가가 SQL을 생성하기 전에 텍스트에서 맥락을 추출해야 하는 질문을 해야 하는 경우, Cortex Search를 구성해야 합니다. 예시: 먼저 ‘배터리 문제’라는 문구가 포함된 모든 제품 리뷰를 검색한 다음, 해당 제품에 대한 판매 데이터만 집계하는 SQL 쿼리를 생성할 수 있습니다.

구조화된 테이블을 대상으로 순수한 SQL을 생성하는 경우에는 이 서비스가 필요하지 않습니다.

Cortex Analyst를 사용하여 SQL을 생성하는 단계별 가이드

사전 준비는 완료되었지만, 이제 빈 화면을 마주하고 있어 실제 워크플로우가 어떻게 진행되는지 막막하신가요? 머릿속에 떠오른 질문을 실행 가능한 SQL 쿼리로 전환하려면 어떻게 해야 할까요? 워크플로우 관리가 명확하지 않으면 새로운 도구는 종종 활용되지 못하고, 설정에 들인 투자도 헛되이 끝나기 마련입니다.

실습 과정은 놀라울 정도로 간단합니다. 자세히 살펴보겠습니다!

1단계: Snowflake에서 데이터 준비하기

무엇보다 먼저, 구조화된 데이터가 Snowflake 내에 저장되어 있어야 합니다. 각 Cortex Analyst 애플리케이션은 단일 테이블이나 하나 이상의 테이블로 구성된 보기를 대상으로 합니다. 테이블이 생성되고 데이터가 채워져 있는지 확인하십시오.

플랫 파일에서 데이터를 불러오는 경우:

2단계: 시맨틱 모델(또는 시맨틱 보기) 구축

이 단계는 설정 과정에서 가장 중요한 단계입니다. Cortex Analyst의 강력한 성능은 대규모 언어 모델 (LLM)과 의미론적 모델을 결합한 데서 비롯되며, 이 의미론적 모델은 데이터베이스 스키마와 함께 배치되어 비즈니스 컨텍스트를 인코딩하는 YAML 파일입니다.

이제 시맨틱 뷰(Semantic Views)는 Snowflake가 Cortex Analyst에 권장하는 방법입니다. 시맨틱 뷰는 비즈니스 메트릭, 관계 및 정의를 Snowflake 내에 직접 저장합니다. 레거시 YAML 시맨틱 모델 파일도 여전히 작동하지만, Snowflake는 새로운 구현에 대해 시맨틱 뷰를 권장하고 있습니다.

의미론적 모델 또는 보기에는 다음이 포함되어야 합니다:

3단계: 시맨틱 모델을 Snowflake 단계로 업로드하기

YAML 기반 시맨틱 모델을 사용하는 경우, Cortex Analyst가 런타임에 해당 모델을 참조할 수 있도록 스테이징해야 합니다.

시맨틱 보기를 사용하는 경우, 이 단계는 Snowflake 내에서 기본적으로 처리되므로 별도로 업로드할 필요가 없습니다.

4단계: REST API를 통해 자연어 질문을 전송합니다.

이제 본격적인 SQL 생성이 시작됩니다. REST API는 요청에 포함된 시맨틱 모델 또는 시맨틱 보기를 사용하여 주어진 질문에 대한 SQL 쿼리를 생성합니다.

다음과 같이 API 요청을 구성하십시오:

이전 쿼리를 바탕으로 후속 질문을 던질 수 있는 다단계 대화를 나눌 수 있습니다.

5단계: API 응답 분석하기

응답의 각 메시지에는 서로 다른 유형의 여러 콘텐츠 블록이 포함될 수 있습니다. 현재 type 필드에서 지원되는 세 가지 값은 텍스트, suggestions, SQL입니다.

각 유형의 의미는 다음과 같습니다:

6단계: Snowflake에서 생성된 SQL 실행하기

응답에서 SQL 블록을 가져온 후, Snowflake 가상 웨어하우스에서 이를 실행하십시오. 생성된 SQL 쿼리는 Snowflake 가상 웨어하우스에서 실행되어 최종 출력을 생성합니다. 데이터는 Snowflake의 거버넌스 경계 내에서 유지됩니다.

실행 시 알아야 할 주요 사항:

7단계: 다듬고 반복하기

첫 시도에서 완벽한 쿼리를 얻을 수 있다고 항상 보장되는 것은 아닙니다. 시간이 지남에 따라 결과를 개선하는 방법은 다음과 같습니다.

Snowflake 텍스트-SQL 변환 정확도를 높이기 위한 최고의 실행 방식

의미 모델의 품질은 생성되는 쿼리의 정확도를 직접적으로 좌우합니다. 정확도를 높이는 최고의 실행 방식은 다음과 같습니다. 🛠️

ClickUp: Snowflake Cortex보다 더 간편한 대안

Snowflake Cortex는 팀이 SQL을 생성하고 구조화된 데이터에 대해 쿼리를 실행하고자 할 때 효과적입니다. 팀은 스키마를 정의하고, 관계를 매핑하며, 쿼리를 작성하여 인사이트를 도출합니다. 이러한 설정은 데이터가 방대한 환경, 특히 분석가가 직접 보고를 작성하는 경우에 적합합니다.

하지만 많은 팀은 일상적인 운영 관련 질문에 답하기 위해 완전한 SQL 계층이 필요하지 않습니다. 제품 관리자, 프로그램 리더, 운영 팀은 종종 진행 중인 일과 관련된 신속한 답변을 원합니다.

ClickUp은 더 간편한 방법을 제공합니다. Teams는 SQL을 작성하거나 의미론적 모델을 구축할 필요 없이 평이한 언어로 질문을 하고, 실시간 대시보드를 확인하며, 인사이트를 바탕으로 조치를 취할 수 있습니다.

SQL을 더 빠르게 생성하고 다듬으세요

Snowflake Cortex는 웨어하우스 환경 내의 구조화된 데이터 세트에서 SQL 쿼리를 생성하는 데 중점을 둡니다. 이 기능은 데이터가 이미 Snowflake에 저장되어 있고 스키마가 정의되어 있는 경우에 효과적입니다.

ClickUp Brain은 보다 유연하고 실행 중심의 방식으로 SQL 생성을 지원합니다. 팀은 분석, 논의, 의사결정이 이미 이루어지고 있는 작업 공간 내에서 직접 SQL 쿼리를 생성, 수정 및 저장할 수 있습니다.

한 제품 분석가가 ClickUp 내에서 고객 유지율 분석 작업을 수행하고 있다고 가정해 봅시다. 이 분석가는 쿼리를 작성하기 위해 다른 도구로 전환하는 대신 ClickUp Brain에 다음과 같이 질문합니다:

📌 다음 프롬프트를 사용해 보세요: 가입 코호트별로 그룹화된 사용자의 7일 유지율을 계산하는 SQL 쿼리를 작성하세요.

ClickUp Brain은 코호트 그룹화, 날짜 필터, 유지율 로직이 포함된 구조화된 쿼리를 생성합니다. 분석가는 이 쿼리를 Snowflake나 다른 데이터 웨어하우스에 붙여넣고 즉시 실행할 수 있습니다.

다음과 같은 이점이 있습니다:

예를 들어, 성장 실험 검토 과정에서 마케터가 “지난 14일 동안 두 랜딩 페이지의 전환율을 비교하는 SQL 쿼리를 작성해 주세요”라고 요청한다고 가정해 봅시다.

ClickUp Brain은 조건부 집계 및 날짜 필터를 사용하여 쿼리를 생성합니다. 팀은 이 쿼리를 Snowflake에서 실행하고 실험 결과를 검증합니다.

📌 다음 프롬프트를 사용해 보세요: 조인 작업으로 인해 행이 중복되는 이 SQL 쿼리를 수정하고, 문제의 원인을 설명해 주세요.

ClickUp Brain은 조인 문제를 식별하고, 쿼리를 수정하며, 잘못된 조인 조건으로 인해 중복 행이 발생한 원인을 설명합니다.

SQL 기반 보고 방식을 대체하세요

Snowflake Cortex 워크플로우에서는 대개 별도의 단계에서 SQL을 생성하고, 쿼리를 실행하며, 결과를 시각화하는 과정이 포함됩니다. ClickUp 대시보드는 이러한 여러 단계를 거치는 과정을 생략하고, 실시간 작업에서 얻은 인사이트를 바로 제공합니다.

릴리스 준비 상태를 추적하는 프로그램 관리 팀은 쿼리를 작성하지 않고도 대시보드를 구축할 수 있습니다. 예를 들어, 릴리스 대시보드에는 다음이 포함될 수 있습니다:

릴리스 회의 전에 프로그램 리더가 이 대시보드를 검토한다고 가정해 봅시다. 리더는 백엔드 서비스의 지연율이 높아진 것을 즉시 파악합니다. 그런 다음 작업 목록 카드를 열어 위험을 초래하는 구체적인 작업을 확인합니다.

실제 ClickUp 사용자의 경험 공유:

ClickUp을 사용하면 프로젝트를 서로 신속하게 전달하고, 프로젝트 상태를 손쉽게 확인할 수 있을 뿐만 아니라, 상사가 우리의 업무를 방해하지 않고도 언제든지 업무량을 파악할 수 있습니다. ClickUp을 사용함으로써 일주일에 적어도 하루, 어쩌면 그 이상은 확실히 시간을 절약했습니다. 이메일 수도 상당히 줄었습니다.

파이프라인 없이 인사이트를 바탕으로 조치를 취하세요

Snowflake Cortex는 데이터에서 인사이트를 도출하는 데 중점을 둡니다. Teams는 여전히 결과를 해석하고 트리거를 실행하는 과정을 별도로 수행해야 합니다.

ClickUp AI 슈퍼 에이전트는 이러한 격차를 해소하고 인사이트를 실행으로 전환합니다. 이들은 작업 공간 데이터를 지속적으로 모니터링하고 조건에 따라 조치를 취하는 AI 팀원으로서 활동합니다.

한 프로그램 관리자가 여러 제품 이니셔티브를 총괄한다고 가정해 봅시다. 슈퍼 에이전트는 다음과 같은 작업을 수행할 수 있습니다:

예를 들어, 릴리스 주기 중에 슈퍼 에이전트가 두 팀에서 10개 이상의 우선순위가 높은 작업이 마감 기한을 넘긴 것을 감지합니다. 그러면 ‘릴리스 위험: 마감 기한 미준수’라는 제목의 ClickUp 작업을 생성하고, 관련 작업들을 모두 첨부 파일로 첨부한 뒤, 프로그램 관리자에게 할당하여 즉시 검토하도록 합니다.

팀은 슈퍼 에이전트와 직접 상호작용할 수도 있습니다. ‘모든 진행 중인 프로젝트를 분석하고 이번 스프린트의 delivery risks를 강조 표시해 주세요’.

슈퍼 에이전트는 마감일, 의존성 및 작업 상태를 검토한 후, 작업 공간 내에 구조화된 요약 내용을 게시합니다.

ClickUp에서 나만의 슈퍼 에이전트를 설정하는 방법은 다음과 같습니다:

ClickUp으로 데이터 워크플로우를 중앙 집중화하세요

Snowflake Cortex와 같은 텍스트-투-SQL tools는 데이터에 대한 접근성을 높여줍니다. 하지만 동시에 신뢰할 수 있는 결과를 얻기 위해서는 여전히 노력이 필요합니다.

팀은 정확한 결과를 도출하기 위해 깔끔한 스키마, 강력한 의미론적 모델, 그리고 지속적인 반복 작업이 필요합니다. 올바른 쿼리를 생성한 후에도 일은 거기서 끝나지 않습니다. 여전히 누군가가 결과를 해석하고, 인사이트를 공유하며, 이를 의사 결정으로 전환해야 합니다.

ClickUp은 색다른 접근 방식을 제시합니다. 분석과 실행을 분리하는 대신, ClickUp은 이 두 가지를 하나로 연결합니다. Teams는 동일한 작업 공간 내에서 SQL을 생성하고, 인사이트를 문서화하며, 분석 결과를 바탕으로 협업하고, 이를 바탕으로 조치를 취할 수 있습니다.

ClickUp Brain은 쿼리 작성과 개선을 지원하며, 대시보드와 AI 에이전트는 팀이 여러 도구를 오가지 않고도 결과를 추적하고 업무를 원활하게 진행할 수 있도록 돕습니다.

Snowflake Cortex는 답변을 얻는 데 도움을 줍니다. ClickUp은 그 답변을 활용해 무언가를 이루는 데 도움을 줍니다. 지금 바로 ClickUp에 가입하세요!

자주 묻는 질문

Snowflake Cortex Analyst란 무엇이며, Cortex AI와는 어떻게 다른가요?

Snowflake Cortex Analyst는 광범위한 Snowflake Cortex AI 제품군 내의 전문 서비스입니다. Cortex Analyst는 의미론적 모델을 활용한 텍스트-SQL 생성에 특화되어 있는 반면, Cortex AI는 더 광범위한 LLM 기능, 머신러닝 모델 추론 및 검색 기능을 포함하고 있습니다.

Snowflake Cortex Analyst는 Iceberg 테이블과 같은 외부 데이터 소스와 연동되나요?

네, Cortex Analyst는 Snowflake를 통해 관리되는 Apache Iceberg 테이블에 쿼리를 실행할 수 있습니다. 해당 테이블이 Snowflake 환경 내에서 접근 가능하고 시맨틱 모델에 올바르게 정의되어 있다면, 해당 테이블을 대상으로 쿼리를 생성할 수 있습니다.

복잡한 쿼리에 대해 Snowflake의 텍스트-SQL 변환 기능은 얼마나 정확한가요?

복잡한 쿼리의 정확도는 거의 전적으로 의미론적 모델의 품질에 달려 있습니다. 테이블 간의 관계가 명확하게 정의되어 있고, 검증된 쿼리가 다수 포함되며, 설명적인 메타데이터를 갖춘 모델은 다중 테이블 조인 및 복잡한 집계 작업에서 훨씬 더 정확한 결과를 산출합니다.

Snowflake Cortex의 SQL 생성 기능 이용 요금은 얼마인가요?

Snowflake Cortex Analyst의 요금제는 Snowflake의 사용량 기반 모델을 따르며, 이는 쿼리 생성 과정에서 사용된 컴퓨팅 크레딧을 기준으로 요금이 청구됨을 의미합니다. 최신 요금을 확인하려면 항상 Snowflake의 공식 요금 문서를 참조하시기 바랍니다.