메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

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 통합 만들기
-- 기존 통합이 있는 경우 삭제
DROP INTEGRATION IF EXISTS REPLIT_OAUTH;

-- Replit용 OAuth 통합 만들기
CREATE SECURITY INTEGRATION REPLIT_OAUTH
  TYPE = OAUTH
  ENABLED = TRUE
  OAUTH_CLIENT = CUSTOM
  OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
  OAUTH_REDIRECT_URI = 'https://replit.com/connectors/oauth/callback'
  OAUTH_ISSUE_REFRESH_TOKENS = TRUE
  OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
  OAUTH_ALLOW_NON_TLS_REDIRECT_URI = FALSE
  BLOCKED_ROLES_LIST = ()
  COMMENT = 'OAuth integration for Replit connector';
리디렉션 URI는 정확히 https://replit.com/connectors/oauth/callback이어야 합니다. 다른 값을 사용하면 인증 중에 404 오류가 발생합니다.
BLOCKED_ROLES_LIST = ()를 설정하면 통합 사용이 차단된 역할이 없도록 보장합니다. 이 설정이 없으면 연결 시 “잘못된 동의 요청” 또는 “역할 차단” 오류가 발생할 수 있습니다.
4

OAuth 자격 증명 가져오기

다음 쿼리를 실행하여 클라이언트 ID와 클라이언트 시크릿을 가져옵니다:
OAuth 자격 증명 가져오기
-- 통합 세부 정보 보기
DESCRIBE INTEGRATION REPLIT_OAUTH;

-- 클라이언트 ID 및 시크릿 가져오기
WITH secrets AS (
  SELECT PARSE_JSON(
    SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('REPLIT_OAUTH')
  ) as creds
)
SELECT
  creds:OAUTH_CLIENT_ID::STRING as CLIENT_ID,
  creds:OAUTH_CLIENT_SECRET::STRING as CLIENT_SECRET
FROM secrets;
출력에서 클라이언트 ID와 클라이언트 시크릿을 복사합니다. 다음 단계에서 필요합니다.

​
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을 확인하세요:
https://app.snowflake.com/myorg/myaccount
app.snowflake.com/ 뒤의 두 부분을 하이픈으로 연결합니다:
myorg-myaccount
URL에서는 두 부분 사이에 /를 사용하지만, 계정 ID에서는 -를 사용합니다.
4

인증

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

​
Snowflake 데이터로 구축 시작

연결 후 두 가지 방법으로 Agent와 함께 Snowflake 커넥터를 사용할 수 있습니다:
  • 슬래시 명령 — 프롬프트에 /snowflake를 입력하여 커넥터 사용
  • 자연어 — Agent에게 Snowflake 데이터를 직접 사용하도록 요청
다음은 예시 프롬프트입니다: 
내 Snowflake 데이터를 사용하여 대시보드를 만들어 주세요. 지역별 총 매출을
막대 차트로, 분기별 트렌드 라인으로, 상위 10개 고객의 테이블로 표시해 주세요.
다크 테마, 깔끔하고 모던하게.
Agent는 Snowflake 데이터에 대한 SQL 쿼리를 작성하고 실행하여 작동하는 애플리케이션을 구축합니다.

​
문제 해결

Snowflake 통합에 기본적으로 차단된 역할이 있을 수 있습니다.통합이 BLOCKED_ROLES_LIST = ()로 만들어졌는지 확인합니다. 이 설정 없이 이미 만든 경우 다음을 실행하세요:
차단된 역할 수정
CREATE OR REPLACE SECURITY INTEGRATION REPLIT_OAUTH
  TYPE = OAUTH
  ENABLED = TRUE
  OAUTH_CLIENT = CUSTOM
  OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
  OAUTH_REDIRECT_URI = 'https://replit.com/connectors/oauth/callback'
  OAUTH_ISSUE_REFRESH_TOKENS = TRUE
  OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
  OAUTH_ALLOW_NON_TLS_REDIRECT_URI = FALSE
  BLOCKED_ROLES_LIST = ()
  COMMENT = 'OAuth integration for Replit connector';
오류가 계속되면 기본 역할이 차단되지 않았는지 확인하세요:
기본 역할 설정
ALTER USER "YOUR_USERNAME" SET DEFAULT_ROLE = 'PUBLIC';
Snowflake 통합의 리디렉션 URI가 정확히 다음과 같은지 확인합니다:
https://replit.com/connectors/oauth/callback
어떠한 불일치도 OAuth 흐름 중 404를 일으킵니다.
Replit의 커넥터 범위가 refresh_token으로만 설정되어 있는지 확인합니다. session:role-any 또는 session:role:PUBLIC과 같은 다른 범위를 제거하세요.
Replit의 클라이언트 ID와 클라이언트 시크릿이 Snowflake가 생성한 것과 일치하는지 확인합니다. 다음을 실행하여 다시 확인하세요:
자격 증명 확인
WITH secrets AS (
  SELECT PARSE_JSON(
    SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('REPLIT_OAUTH')
  ) as creds
)
SELECT
  creds:OAUTH_CLIENT_ID::STRING as CLIENT_ID,
  creds:OAUTH_CLIENT_SECRET::STRING as CLIENT_SECRET
FROM secrets;

​
관련 문서