눈송이 커넥터

Snowflake에서 정보를 쿼리하여 Tulip 앱에 사용하기

스노우플레이크 커넥터는 스노우플레이크 데이터 클라우드에서 정보를 쿼리하는 방법을 간소화합니다. Snowflake SQL REST API 설명서는 여기에서 확인할 수 있습니다.

지원 연락처

이 커넥터는 스파울딩 릿지와 협력하여 만들었습니다. 자세한 정보나 질문이 있는 경우 스파울딩 릿지(info@spauldingridge.com)로 문의하세요.

커넥터 참고 사항

눈송이 커넥터는 단일 레코드를 비교적 쉽게 조작할 수 있습니다. 여러 행의 데이터를 쿼리하거나 Tulip(대화형 테이블 등)에서 출력을 조작하려면 사용자 정의 위젯이 필요할 수 있습니다.

Snowflake OAuth는 Snowflake의 기본 제공 OAuth 서비스를 사용하며, 사용자 정의 클라이언트로서 Tulip을 지원합니다. Snowflake OAuth 문서는 여기에서 확인할 수 있습니다. 사용자 지정 클라이언트 구성 세부 정보는 여기에서 확인할 수 있습니다.

설정

이 섹션에서는 클라이언트로서 Tulip과의 연결을 설정하기 위해 Snowflake의 OAuth 서버에서 OAuth 토큰을 구성하는 절차와 Tulip에서 Snowflake 커넥터를 설정하는 단계에 대해 설명합니다.

Snowflake에서 Tulip을 클라이언트 애플리케이션으로 등록하기

1. 보안 연동 서비스를 만들고 관리할 수 있는 역할/권한을 가진 사용자(계정 관리자)로 Snowflake 인스턴스에 로그인합니다.
2. COMPUTE_WH 웨어하우스에서 새 SQL 워크시트를 만듭니다.
3. 다음 스크립트를 실행하여 OAuth 유형의 보안 연동을 만듭니다. INTEGRATION_NAME, TULIP_INSTANCE_NAME 및 TIME_IN_SECONDS의 값을 업데이트하는 것을 잊지 마세요.

보안 통합 만들기 또는 바꾸기 <INTEGRATION_NAME>TYPE = OAUTHENABLE = TRUEOAUTH_CLIENT = CUSTOMOAUTH_CLIENT_TYPE = 'CONFIDENTIAL'OAUTH_REDRECT_URI = 'https://<TULIP_INSTANCE_NAME>.tulip.co/oauth-redirect-handler'OAUTH_ISSUE_REFRESH_TOKENS = TRUEOAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = <TIME_IN_SECONDS>;

참고: 새로 고침 토큰 유효기간은 최대 1일(86400초)까지 가능합니다.

Tulip에서 OAuth 구성에 대한 세부 정보 수집하기

1. 다음 명령을 실행하여 방금 만든 보안 통합에 대해 설명합니다. ;
2. 아래 세부 정보를 기록합니다.OAUTH_CLIENT_IDOAUTH_REDIRECT_URIOAUTH_AUTHORIZATION_ENDPOINTOAUTH_TOKEN_ENDPOINT
3. 실행:SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('<통합_이름>');

완전히 대문자화해야 합니다(예: TULIP_INTEGRATION이 아닌 TULIP_INTEGRATION).

1. 적어두세요:OAUTH_CLIENT_SECRET

눈송이 커넥터 구성

1. Tulip에 로그인하고 여기 (웹 또는 임베디드)의 Tulip 라이브러리에서 Snowflake 커넥터를 추가합니다.
2. 프로덕션 환경을 클릭합니다.
3. 다음 설정을 설정합니다:

실행 대상: 클라우드 커넥터 호스트 서버 주소: 눈송이 계정 서버 URL 형식( .snowflakecomputing).com기본 경로: api/v2인증서비스 또는 사용자 OAuth 중 선택인증 코드 URL - 2단계의 OAUTH_AUTHORIZATION_ENDPOINT인증 토큰 URL - 2단계의 OAUTH_TOKEN_ENDPOINT 클라이언트 ID - 2단계의 OAUTH_CLIENT_ID 클라이언트 비밀 - 2단계의 OAUTH_CLIENT_SECRET인증 헤더 보내기인증 시 클라이언트 ID 인코딩에 대한 체크 박스 선택

1. 테스트를 클릭합니다. 스노우플레이크 계정의 로그인 창으로 이동합니다.

사용자가 로그인해야 합니다. 기본 역할이 계정 관리자, 보안 관리자 또는 조직 관리자이어서는 안 됩니다. 이 Snowflake 리소스에 자세히 설명된 대로 OAuth에 대한 사용자의 기본 역할을 변경할 수 있습니다: OAuth에 대한 사용자 동의 관리하기.

1. 인증에 성공하면 동의를 요청하는 메시지가 표시됩니다. 메시지를 주의 깊게 읽고 수행되는 작업을 이해한 다음 허용을 클릭하세요.

이제 튤립에서 스노우플레이크에 안전하게 연결할 수 있습니다!

사용 방법

커넥터 사용을 시작하려면 두 가지 옵션이 있습니다:

커넥터 템플릿 기능을 특정 요구 사항에 맞게 사용자 지정하여 시작하세요.

눈송이 단위 테스트 지침에 따라 Tulip의 눈송이 테이블에서 모든 테이블 레코드 검색, 새 레코드 만들기, 기존 레코드 업데이트, 레코드 삭제 등의 작업에 커넥터를 사용하는 방법에 대한 실제 데모를 살펴보세요.

템플릿 함수

라이브러리 커넥터에는 다음과 같은 템플릿 함수가 포함되어 있습니다:템플릿: 데이터베이스 쿼리설명: 실행을 위해 하나 이상의 SQL 문을 제출할 수 있습니다.메서드: 끝점 /api/v2/statements참조: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statementsTemplate: 쿼리 상태 확인설명: 문 실행 상태를 확인할 수 있습니다.Method: GETEndpoint: /api/v2/statements/{statementHandle}Reference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandleTemplate: 취소 쿼리 설명: statement.Method의 실행을 취소할 수 있습니다: POSTEndpoint: /api/v2/statements/{statementHandle}/cancelReference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements-statementhandle-cancel

추가 참조

이 눈송이 커뮤니티 가이드는 눈송이 통합에 대한 추가 컨텍스트를 제공합니다.