개요
Snowflake 커넥터를 사용하면 Perplexity에서 Snowflake 데이터 웨어하우스의 데이터를 직접 쿼리할 수 있습니다. SQL을 직접 작성하거나 Snowflake 콘솔로 전환하지 않고도 Snowflake 데이터베이스, 연결된 다른 앱, 웹 전반의 정보를 검색하고 결합할 수 있습니다. Snowflake 연결은 사용자별로 이루어집니다. 데이터를 공유 프로젝트에 동기화하지 않는 한 조직 내 다른 누구도 사용자의 데이터를 쿼리할 수 없습니다.Snowflake 커넥터는 Pro, Max, Enterprise Pro, Enterprise Max 요금제에서 사용할 수
있습니다. 데이터 맵을 생성하려면 Enterprise Pro 또는 Enterprise Max가 필요합니다.
모든 요금제에서 ACCOUNTADMIN 역할을 보유한 Snowflake 관리자가 보안 통합 또는 서비스
계정을 생성하며, Enterprise 요금제에서는 Perplexity 관리자가 조직을 위해 User OAuth
커넥터를 한 번 구성합니다.
개인정보 보호 및 데이터 보안
커넥터는 사용자가 제어하는 Snowflake 역할로 Snowflake 계정을 쿼리하므로, Perplexity가 접근할 수 있는 범위는 Snowflake 권한에 의해 결정됩니다. 해당 역할에는 읽기 권한만 부여하세요.- 액세스 범위 — 각 사용자가 자신의 계정을 연결합니다. 데이터를 공유 프로젝트에 동기화하지 않는 한 조직 내 다른 누구도 사용자의 데이터를 쿼리할 수 없습니다.
- 데이터 저장 위치 — Perplexity는 사용자의 Snowflake 데이터를 저장하지 않습니다. 쿼리는 사용자 본인의 Snowflake 계정에서 실행되며, 커넥터는 Perplexity가 제품 운영을 위해 수집하는 운영 데이터 외에 자체적으로 저장하는 데이터가 없습니다.
- 보존 — 커넥터는 캐시를 운영하지 않으므로, 보존하거나 삭제할 Snowflake 데이터의 별도 사본이 존재하지 않습니다.
- 관리자 제어 — Enterprise 요금제에서는 조직 관리자가 조직에서 Snowflake 커넥터를 비활성화할 수 있으며, 이 경우 커넥터가 사용자의 커넥터 설정에 표시되지 않습니다.
- 읽기 전용 적용 — 읽기 전용 액세스는 Snowflake 권한을 통해 적용하세요. Perplexity가 사용하는 역할에는 쓰기 권한이나 객체 생성 권한을 부여하지 마세요.
- 학습 용도 — Snowflake 커넥터를 통해 액세스한 데이터는 Perplexity의 모델이나 서드파티 모델의 학습에 절대 사용되지 않습니다.
- 하위 처리자 — 이 커넥터의 인증 및 API 트래픽은 Perplexity의 하위 처리자인 Merge API, Inc.가 운영하는 Merge Agent Handler를 통해 전달됩니다. 최신 목록은 Perplexity Trust Center에 게시되어 있습니다.
- 암호화 — 커넥터 자격 증명 및 연결된 데이터는 전송 중에는 TLS로, 저장 시에는 AES-256으로 암호화됩니다.
- 컴플라이언스 — Perplexity의 통제 항목은 SOC 2 Type II에 따라 감사를 받습니다. 보안 및 컴플라이언스 문서는 Perplexity Trust Center에서 확인할 수 있습니다.
활성화 방법
인증 방식 선택하기
Perplexity는 두 가지 Snowflake 커넥터를 제공합니다. 사용자의 인증 방식에 해당하는 커넥터만 구성하세요.
표 1 — 두 가지 Snowflake 커넥터와 각각의 사용 시점.
Perplexity는 User OAuth 커넥터를 강력히 권장합니다. 쿼리는 각 사용자의 Snowflake
권한으로 실행되며 Snowflake 감사 로그에 해당 사용자로 기록됩니다.
시작하기 전에
- Pro, Max, Enterprise Pro 또는 Enterprise Max 요금제를 사용하고 있어야 합니다.
- Enterprise 요금제에서는 조직 관리자가 Snowflake 커넥터를 비활성화하지 않았어야 합니다.
- Snowflake 관리자가 ACCOUNTADMIN 액세스 권한 또는 이에 상응하는 권한을 보유해야 합니다.
- 서비스 계정 설정에만 해당하며, 로컬에 OpenSSL이 설치되어 있어야 합니다.
User OAuth 커넥터 설정하기
-
Snowflake 관리자에게 보안 통합을 생성하도록 요청하세요. 추가 매개변수는
Snowflake OAuth 보안 통합
문서를
참조하세요.
-
클라이언트 ID와 클라이언트 시크릿을 확인하세요.
- 해당 자격 증명을 Perplexity의 OAuth 설정 창에 입력하세요.
사용자가 기본 역할 외에 보조 역할에도 접근할 수 있도록 OAUTH_USE_SECONDARY_ROLES =
IMPLICIT를 사용하세요. 사용자를 Snowflake의 DEFAULT_ROLE로만 제한해야 하는 경우에는
NONE을 사용하세요.
서비스 계정 커넥터 설정하기
서비스 계정은 하나의 특정 역할로 실행되는 전용 Snowflake 사용자입니다. 공유 계정을 사용하는 모든 사람이 동일한 액세스 권한을 갖게 되므로, 해당 역할에는 Perplexity에 필요한 데이터 액세스 권한만 부여하세요.-
로컬 터미널에서 개인 키와 이에 대응하는 공개 키를 생성하세요.
-
전용 역할과 웨어하우스를 생성하고, 쿼리 규모에 맞는 웨어하우스 크기를 선택하세요.
새로 생성하는 대신 기존 웨어하우스를 사용할 수도 있습니다.
-
서비스 계정 사용자를 생성하세요. RSA_PUBLIC_KEY 값을 snowflake_computer_key.pub
파일의 내용으로 교체하되, BEGIN PUBLIC KEY 및 END PUBLIC KEY 행은 제외하세요.
-
Perplexity가 쿼리할 데이터에 대한 액세스 권한을 부여하세요. MY_DATABASE를 사용 중인
데이터베이스로 교체하세요. 아래 권한 부여는 해당 데이터베이스의 현재 및 향후 스키마,
테이블, 뷰에 대한 읽기 액세스를 제공합니다. 더 좁은 범위로 제한하려면 특정 스키마나
객체에 권한을 부여하세요. Snowflake GRANT
문서를 참조하세요.
-
커넥터 설정 과정에서 데이터 맵을 생성하기로 선택한 경우, 데이터 맵이 읽는 두 개의
계정 사용량 뷰에 대한 액세스 권한을 부여하세요. 데이터 맵 생성에는 Enterprise Pro
또는 Enterprise Max가 필요합니다. 이 권한 부여는 해당 두 뷰뿐만 아니라 Snowflake
계정 메타데이터 전반에 더 넓은 액세스를 제공하므로, 실행하기 전에 내용을
검토하세요.
표 2 — 데이터 맵이 읽는 계정 사용량 뷰.
- 사이드바에서 플러그인 (아직 Plugins가 보이지 않는다면 Customize → Connectors)을 열고 발견 또는 검색으로 Snowflake (Service Account)를 찾아 해당 페이지를 엽니다.
- 연결을 선택합니다.
- Snowflake 계정 식별자, 사용자 이름 PERPLEXITY_USER, 개인 키 snowflake_computer_key.p8을 입력하세요.
- 허용을 선택해 설정을 완료하세요.
Snowflake 계정 연결하기
관리자 설정이 완료되면 각 사용자가 자신의 계정을 연결합니다.- 사이드바에서 플러그인 (아직 Plugins가 보이지 않는다면 Customize → Connectors)을 열고 발견 또는 검색으로 Snowflake (User OAuth)를 찾아 해당 페이지를 엽니다.
- 연결을 선택합니다.
- 안내가 표시되면 Snowflake에 로그인하세요.
- 허용을 선택해 연결을 완료하세요.
이 커넥터는 플러그인에 포함될 수도 있습니다. 어디서든 연결하면 사용자 계정의 모든 곳에 연결이 적용되며, 연결 상태와 조직의 커넥터 설정은 모든 플러그인 안에서도 적용됩니다. 플러그인이란?
정상 작동 확인 방법
새 세션을 열고@Snowflake를 멘션한 후, 이미 Snowflake에서 읽을 수 있는 테이블의 행
개수처럼 간단한 정보를 요청하세요. 답변에 Snowflake 데이터가 포함되지 않는다면 가장
먼저 Snowflake 역할을 확인하세요. 해당 역할에는 언급한 객체에 대한 SELECT 권한이
필요합니다.
사용해 보기
Snowflake를 연결한 후에는 새 세션에서 Snowflake를 멘션하세요.-
@Snowflakeorders 테이블에는 행이 몇 개 있나요? -
@Snowflakecustomers 테이블에는 어떤 열이 있나요? -
@SnowflakeMY_DATABASE에서 내가 쿼리할 수 있는 스키마를 알려 주세요
권한 및 범위
커넥터에는 읽기 권한만 필요합니다. 기존 분석가 역할이 아닌 전용 역할에 권한을 부여하세요.
표 3 — 커넥터가 요청하는 Snowflake 권한과 그 이유.
권한 적용의 경계는 Snowflake 권한입니다. 커넥터가 어떤 작업을 요청받더라도 부여된
역할로 실행되므로, 쓰기 권한이 없는 역할은 쓰기를 수행할 수 없습니다.
문제 해결
표 4 — 가장 흔한 Snowflake 커넥터 문제의 증상, 원인, 해결 방법.
서비스 계정의 경우, 다음 예시는 현재 게시된 미국 주소를 사용해 사용자 수준 네트워크
정책을 생성합니다. 정책을 적용하기 전에 Merge 테넌트 IP 주소 페이지에서 최신 목록을
확인하세요.
자주 묻는 질문
이 커넥터는 어떤 데이터에 액세스하나요?
사용자가 권한을 부여한 Snowflake 역할이 읽을 수 있는 데이터베이스, 스키마, 테이블, 뷰입니다. 해당 역할이 접근할 수 없는 항목에는 접근할 수 없습니다.제 Snowflake 데이터가 AI 모델 학습에 사용되나요?
아니요. Snowflake 커넥터를 통해 액세스한 데이터는 Perplexity의 모델이나 서드파티 모델의 학습에 절대 사용되지 않습니다.관리자가 이 커넥터를 활성화할 수 있는 사용자를 제한할 수 있나요?
네, Enterprise 요금제에서는 가능합니다. 조직 관리자는 조직 전체에서 Snowflake 커넥터를 비활성화할 수 있으며, 이 경우 커넥터가 사용자의 커넥터 설정에 표시되지 않습니다.Perplexity가 제 Snowflake 데이터에 쓰기를 할 수 있나요?
Snowflake에서 이를 적용한다면 그렇지 않습니다. Perplexity가 사용하는 역할에 USAGE와 SELECT만 부여하면, Perplexity가 어떤 작업을 요청받더라도 Snowflake가 모든 쓰기를 거부합니다.이 커넥터를 제 요금제에서 사용할 수 있나요?
네, Pro, Max, Enterprise Pro, Enterprise Max 요금제에서 사용할 수 있습니다. 데이터 맵을 생성하려면 Enterprise Pro 또는 Enterprise Max가 필요합니다.관련 문서
- Data Map 이해하기
- Perplexity와 Databricks 연결
- 엔터프라이즈 커넥터 문제 해결 가이드
- 기업 조직 및 사용자를 위한 데이터 보존 및 개인정보 보호
- Enterprise 역할 및 권한
도움이 더 필요하신가요?
문의하실 때는 커넥터 이름, 정확한 오류 메시지, 발생 시각, 이 문서에서 시도했지만 해결되지 않은 단계를 함께 알려 주세요.담당 계정 팀에 연락하시거나 Help 메뉴의 고객 지원
문의를 통해 문의해 주세요.
보안 및 컴플라이언스 문서는 Trust Center에서 확인할 수
있습니다.