Snowflake Cortex로 설명 생성하기

Snowsight 및 Snowflake Cortex의 기능을 사용하여 열, 테이블 또는 뷰에 대한 설명을 자동으로 생성할 수 있습니다. Snowflake Cortex는 Snowflake에서 호스팅하는 대규모 언어 모델(LLMs)을 활용하여 오브젝트 메타데이터를 평가하고, 원하는 경우 샘플 데이터를 사용하여 설명을 생성합니다.

생성된 설명은 열, 테이블 또는 뷰의 COMMENT 속성에 저장됩니다. COMMENT 속성이 표시되는 모든 곳에서 설명을 볼 수 있으며, 여기에는 다음이 포함됩니다.

  • Snowsight 의 Table Details 및 View Details 탭.

  • Snowsight 에서 테이블 또는 뷰의 Columns 탭을 클릭합니다.

  • DESCRIBE TABLE 명령의 출력입니다.

  • Account Usage TABLES 뷰의 출력입니다.

테이블 또는 뷰에 대한 권한 이 있는 사용자는 소유자가 설명을 생성한 후 테이블, 뷰 또는 열의 설명을 볼 수 있습니다.

기능 액세스하기

Snowflake Cortex로 설명을 생성할 수 있는 기능을 사용하려면 다음 두 가지가 모두 true여야 합니다.

  • 필수 액세스 제어 권한 이 있어야 합니다.

  • 해당 리전은 설명을 생성하기 위해 Snowflake Cortex에서 사용하는 LLM 을 지원해야 합니다. 요구 사항이 있는 권한이 있지만 이 함수가 표시되지 않는 경우 COMPLETE 함수의 가용성 을 확인하십시오. COMPLETE 함수가 리전에서 지원되지 않는 경우 리전 간 추론 함수를 사용하도록 설정해야 합니다.

지원되는 오브젝트

다음 오브젝트에 대한 설명을 생성할 수 있습니다.

  • 테이블

  • 뷰

  • 구체화된 뷰

  • 테이블 및 뷰에 있는 열입니다.

Snowflake Cortex로 설명 만들기 및 편집하기

열, 테이블 및 뷰에 대한 Snowflake Cortex 기반 설명을 생성하고 편집하는 단계는 다음 하위 섹션에 나와 있습니다.

테이블 및 뷰에 대한 설명 만들기

테이블 또는 뷰에 대한 설명을 생성하려면 다음을 수행합니다.

  1. 요구 사항 권한이 있는 사용자로 |sf-web-interface| 에 로그인 합니다.

  2. 설명을 생성할 테이블 또는 뷰로 이동합니다.

  3. 메시지가 나타나면 웨어하우스를 선택합니다.

  4. Table Details 탭 또는 View Details 탭에서 Generate with Cortex 를 선택합니다.

  5. 설명을 수정하려면 연필 아이콘을 선택하고 설명을 수정합니다.

  6. Save 을 선택합니다.

모든 열에 대해 한 번에 설명 만들기

Snowsight 를 사용하면 한 번에 50개 열로 제한되는 여러 열에 대한 설명을 한 번에 생성할 수 있습니다. 한 번의 작업으로 테이블 또는 뷰의 모든 열에 대한 설명을 생성하려면 다음을 수행합니다.

  1. 요구 사항 권한이 있는 사용자로 |sf-web-interface| 에 로그인 합니다.

  2. 열이 포함된 테이블 또는 뷰로 이동합니다.

  3. 메시지가 나타나면 웨어하우스를 선택합니다.

  4. Columns 탭을 선택합니다.

  5. 도구 모음에서 Generate Descriptions 을 선택합니다.

  6. 메시지가 표시되면 샘플 데이터 를 사용할지 여부를 결정합니다.

  7. 설명을 수정하려면 연필 아이콘을 선택합니다.

  8. 저장하려는 열을 선택합니다.

  9. Save 을 선택합니다.

  10. 테이블 또는 뷰에 50개 이상의 열이 있고 나머지 열에 대한 설명을 생성하려는 경우 이 과정을 반복합니다.

단일 열에 대한 설명 만들기

단일 열에 대한 설명을 생성하려면 다음을 수행합니다.

  1. 요구 사항 권한이 있는 사용자로 |sf-web-interface| 에 로그인 합니다.

  2. 열이 포함된 테이블 또는 뷰로 이동합니다.

  3. 메시지가 나타나면 웨어하우스를 선택합니다.

  4. Columns 탭을 선택합니다.

  5. 열을 찾아 Description 열에서 해당 행 위로 마우스를 가져간 다음 Generate with Cortex 를 선택합니다.

  6. 메시지가 표시되면 샘플 데이터 를 사용할지 여부를 결정합니다.

  7. 설명을 수정하려면 연필 아이콘을 선택합니다.

  8. Save 을 선택합니다.

기존 설명 덮어쓰기

사용자가 지정한 설명을 생성된 설명으로 바꾸려면 다음을 수행합니다.

  1. 요구 사항 권한이 있는 사용자로 |sf-web-interface| 에 로그인 합니다.

  2. 설명을 수정하려는 테이블 또는 뷰로 이동합니다.

  3. 아직 사용 중인 웨어하우스가 없는 경우 웨어하우스를 선택합니다.

  4. 테이블, 뷰 및 열에 대한 설명을 편집합니다.

    • 테이블 및 뷰: Table Details 탭에서 연필 아이콘을 선택하여 기존 설명을 편집하고 Generate with Cortex 를 선택합니다.

    • 열: Columns 탭에서 기존 설명의 연필 아이콘을 선택하고 Generate with Cortex 를 선택합니다.

  5. Save 을 선택합니다.

액세스 제어 요구 사항

사용자는 Snowflake Cortex로 설명을 생성하려면 다음이 모두 필요합니다.

예를 들어, 계정 관리자는 다음을 실행하여 table_owner_role 역할을 가진 사용자가 자신의 테이블에 대한 설명을 생성하도록 할 수 있습니다.

USE ROLE ACCOUNTADMIN;
GRANT USAGE ON WAREHOUSE ai_wh TO ROLE table_owner_role;
GRANT DATABASE ROLE SNOWFLAKE.CORTEX_USER TO ROLE table_owner_role;
Copy

샘플 데이터 입력

열에 대한 설명을 생성할 때 메타데이터에만 의존하거나 샘플 데이터를 사용하여 Snowflake Cortex Powered Description을 개선하도록 선택할 수 있습니다. 샘플 데이터는 특정 열 내의 데이터로, 설명을 생성하기 위해 Snowflake Cortex를 사용할 때 평가되는 데이터를 말합니다. 샘플 데이터를 사용하도록 선택하면 Snowflake가 샘플 데이터의 일부를 사용하여 설명을 생성하므로 더 정확한 설명이 생성됩니다. 샘플 데이터는 사용량 데이터로 Snowflake에 저장되지 않습니다.

샘플 데이터 사용 여부는 개별 사용자가 결정합니다. 브라우저 세션에서 열 설명을 처음 생성하면 샘플 데이터를 사용할지 여부를 결정하라는 메시지가 표시됩니다. 팝업 상자의 기본값은 예이며 계속 진행하기 전에 샘플 데이터를 비활성화하도록 선택할 수 있습니다. 브라우저는 이 질문에 대한 응답을 Snowflake 세션 기간 동안 저장하며 다음 세션이 시작될 때까지 다시 질문하지 않습니다. 사용자 프로필 을 사용하여 샘플 데이터 사용 여부에 대한 기본 설정을 설정할 수도 있습니다.

참고

샘플 데이터는 해당 리전이 Snowflake Cortex를 지원하는 경우 리전 경계를 넘을 수 있습니다. 자세한 내용은 기능 액세스하기 섹션을 참조하십시오.

비용 고려 사항

설명을 생성하는 데는 다음과 같은 비용이 발생합니다.

  • 사용 중인 웨어하우스에서 소비한 크레딧입니다.

  • Mistral-7b 및 Llama 3.1-8b와 같이 더 작은 LLMs 에서 Snowflake Cortex를 사용할 경우 크레딧이 청구됩니다. 이러한 요금은 청구서에 AI 서비스로 표시되며, 여기에는 Snowflake Cortex의 모든 사용이 포함됩니다.

언어: 한국어