메인 콘텐츠로 건너뛰기
Snowflake 커넥터는 Enterprise 플랜에서만 사용 가능합니다.
웨어하우스 커넥터를 사용하면 Replit Agent가 조직의 데이터 웨어하우스를 쿼리할 수 있습니다. Snowflake 커넥터를 사용하면 빌더는 자연어를 사용하여 대시보드, 보고 도구 및 데이터 애플리케이션을 만들 수 있으며 SQL 전문 지식이 필요하지 않습니다. 설정은 Snowflake 관리자와 Replit 워크스페이스 관리자가 필요한 일회성 프로세스입니다. 구성이 완료되면 모든 조직 구성원이 로그인하여 Snowflake 데이터로 구축을 시작할 수 있습니다. 이 가이드는 전체 설정을 안내합니다. 세 가지 역할이 관여합니다:
  1. Snowflake 계정 관리자 — Snowflake에서 OAuth 통합을 만듭니다
  2. Replit 워크스페이스 관리자 — Replit에서 커넥터를 구성합니다
  3. 빌더 — 로그인하고 구축을 시작합니다

Snowflake에서 OAuth 통합 만들기

Snowflake 계정 관리자는 Replit이 Snowflake로 인증할 수 있게 하는 OAuth 보안 통합을 만듭니다.

사전 요구 사항

  • Snowflake의 ACCOUNTADMIN 역할
  • Snowflake 워크시트에서 SQL을 실행할 수 있는 접근 권한

설정 스크립트 실행

1

Snowflake에 로그인

Snowflake 계정을 열고 ACCOUNTADMIN 역할을 사용하고 있는지 확인합니다. 오른쪽 상단의 역할 드롭다운에서 확인할 수 있습니다.
2

SQL 워크시트 열기

왼쪽 사이드바에서 워크시트를 클릭하고 새 워크시트를 만듭니다.
3

OAuth 통합 스크립트 실행

다음 SQL 스크립트를 복사하여 붙여넣고 실행합니다:
OAuth 통합 만들기
리디렉션 URI는 정확히 https://replit.com/connectors/oauth/callback이어야 합니다. 다른 값을 사용하면 인증 중에 404 오류가 발생합니다.
BLOCKED_ROLES_LIST = ()를 설정하면 통합 사용이 차단된 역할이 없도록 보장합니다. 이 설정이 없으면 연결 시 “잘못된 동의 요청” 또는 “역할 차단” 오류가 발생할 수 있습니다.
4

OAuth 자격 증명 가져오기

다음 쿼리를 실행하여 클라이언트 ID와 클라이언트 시크릿을 가져옵니다:
OAuth 자격 증명 가져오기
출력에서 클라이언트 ID와 클라이언트 시크릿을 복사합니다. 다음 단계에서 필요합니다.

네트워크 제한이 적용될 때 커넥터 트래픽 허용

Snowflake 계정이 IP 주소로 접근을 제한하는 경우 Snowflake 관리자에게 REPLIT_OAUTH의 네트워크 정책을 확인하도록 요청하세요. 브라우저 로그인과 커넥터 요청은 서로 다른 네트워크 정책을 따릅니다:
  • 브라우저 로그인은 Snowflake 사용자의 네트워크 정책을 사용하며, 사용자 정책이 없으면 계정 정책을 사용합니다.
  • 커넥터 토큰 요청 및 쿼리는 OAuth 보안 통합의 네트워크 정책을 사용하며, 통합 정책이 없으면 계정 정책을 사용합니다.
브라우저 로그인에 성공했다고 해서 Snowflake가 커넥터의 요청을 허용한다는 의미는 아닙니다. Replit은 커넥터용 고정 IP 목록을 게시하지 않습니다. 허용 목록을 업데이트하기 전에 Replit 지원팀 또는 계정 담당 팀에 문의하여 Snowflake 커넥터의 현재 아웃바운드 IP 주소를 받으세요. Snowflake 관리자에게 해당 주소를 허용하고 조직의 보안 요구 사항을 충족하는 네트워크 정책을 만들거나 검토하도록 요청하세요. 해당 정책을 기존 OAuth 통합에 연결하려면 YOUR_CONNECTOR_NETWORK_POLICY를 정책 이름으로 바꾸세요:
OAuth 네트워크 정책 설정
이러한 커넥터 요청에 대해서는 통합 수준 정책이 계정 정책보다 우선합니다. 계정 및 사용자 정책은 그대로 유지하세요. 문제 해결을 위해 네트워크 제한을 비활성화하지 마세요. 자세한 내용은 Snowflake의 OAuth 네트워크 정책 안내를 참조하세요.

Replit에서 커넥터 구성

Replit 워크스페이스 관리자가 Replit에 Snowflake 자격 증명을 추가합니다. 구성이 완료되면 조직의 모든 사람이 로그인할 수 있습니다.
이 단계에는 관리자 접근이 있는 Enterprise 플랜이 필요합니다.
1

통합 열기

조직의 워크스페이스를 선택한 다음 설정에서 통합으로 이동합니다.
2

Snowflake 커넥터 추가

새 커넥터 추가를 클릭하고 Snowflake를 선택합니다.
3

자격 증명 입력

이전 단계의 클라이언트 ID와 클라이언트 시크릿을 입력합니다.
4

범위 설정

커넥터 범위를 refresh_token으로 설정합니다.
refresh_token 범위만 사용하세요. session:role-any 또는 session:role:PUBLIC과 같은 다른 범위는 “잘못된 범위” 오류를 일으킬 수 있습니다.
5

저장

저장을 클릭하여 커넥터를 활성화합니다.

Snowflake에 로그인

커넥터에 접근 권한이 있는 모든 조직 구성원이 로그인할 수 있습니다. Agent와 함께 사용하기 전에 통합 페이지에서 먼저 로그인하여 연결을 확인하세요.
1

Snowflake 커넥터 찾기

Replit에서 통합으로 이동합니다. 커넥터 아래에서 Snowflake를 찾습니다.
2

로그인 클릭

Snowflake 커넥터에서 로그인을 클릭합니다.
3

Snowflake 계정 ID 입력

OAuth 프롬프트에서 Snowflake 계정 ID를 요청합니다.계정 ID를 찾으려면 Snowflake URL을 확인하세요:
app.snowflake.com/ 뒤의 두 부분을 하이픈으로 연결합니다:
URL에서는 두 부분 사이에 /를 사용하지만, 계정 ID에서는 -를 사용합니다.
4

인증

Snowflake가 로그인 페이지로 리디렉션합니다. Snowflake 자격 증명을 입력하여 OAuth 흐름을 완료합니다.

Snowflake 데이터로 구축 시작

연결 후 두 가지 방법으로 Agent와 함께 Snowflake 커넥터를 사용할 수 있습니다:
  • 슬래시 명령 — 프롬프트에 /snowflake를 입력하여 커넥터 사용
  • 자연어 — Agent에게 Snowflake 데이터를 직접 사용하도록 요청
다음은 예시 프롬프트입니다:
Agent는 Snowflake 데이터에 대한 SQL 쿼리를 작성하고 실행하여 작동하는 애플리케이션을 구축합니다.

문제 해결

Snowflake 통합에 기본적으로 차단된 역할이 있을 수 있습니다.통합이 BLOCKED_ROLES_LIST = ()로 만들어졌는지 확인합니다. 이 설정 없이 이미 만든 경우 다음을 실행하세요:
차단된 역할 수정
오류가 계속되면 기본 역할이 차단되지 않았는지 확인하세요:
기본 역할 설정
Snowflake 통합의 리디렉션 URI가 정확히 다음과 같은지 확인합니다:
어떠한 불일치도 OAuth 흐름 중 404를 일으킵니다.
Replit의 커넥터 범위가 refresh_token으로만 설정되어 있는지 확인합니다. session:role-any 또는 session:role:PUBLIC과 같은 다른 범위를 제거하세요.
브라우저 로그인은 성공하지만 커넥터 연결에 실패하는 경우, 네트워크 제한이 여전히 커넥터의 요청을 차단하고 있을 수 있습니다. Snowflake 관리자에게 사용자 또는 계정 정책뿐 아니라 REPLIT_OAUTH의 정책도 확인하도록 요청하세요. 네트워크 제한이 적용될 때 커넥터 트래픽 허용을 따른 다음 커넥터에 다시 로그인해 보세요.Replit의 클라이언트 ID와 클라이언트 시크릿이 Snowflake가 생성한 것과 일치하는지 확인합니다. 다음을 실행하여 다시 확인하세요:
자격 증명 확인

관련 문서