눈송이 커넥터

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

대상

스노우플레이크 통합은 기술적인 작업이므로 적절한 개체, 역할 및 권한을 만들려면 IT 지원팀의 도움이 필요할 수 있습니다.

지원 연락처

이 커넥터는 스폴딩 릿지와 협력하여 만들었습니다. 자세한 정보나 질문이 있으면 스폴딩 릿지(info@spauldingridge.com)로 문의하시기 바랍니다.

목적

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

커넥터 참고 사항

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

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

설정

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

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

보안 연동 서비스를 만들고 관리할 수 있는 역할/권한(계정 관리자)을 가진 사용자로 Snowflake 인스턴스에 로그인합니다.

COMPUTE_WH 웨어하우스에서 새 SQL 워크시트를 만듭니다.

다음 스크립트를 실행하여 OAuth 유형의 보안 연동을 만듭니다. INTEGRATION_NAME, TULIP_INSTANCE_NAME 및 TIME_IN_SECONDS의 값을 업데이트하는 것을 잊지 마세요.

보안 통합 만들기 또는 바꾸기 <INTEGRATION_NAME>TYPE = OAUTHENABLE = TRUEOOTH_CLIENT = CUSTOMOOTH_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>;

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

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

다음 명령을 실행하여 방금 만든 보안 연동을 설명하고 아래 세부 정보를 기록합니다.OAUTH_CLIENT_IDOAUTH_REDIRECT_URIOAUTH_AUTHORIZATION_ENDPOINTOAUTH_TOKEN_ENDPOINTOAUTH_CLIENT_SECRET.

보안 통합 설명 ;select system$show_oauth_client_secrets('');

3단계: Snowflake 커넥터 구성하기

Tulip에 로그인하고 Tulip 라이브러리(웹 또는 임베디드)에서 Snowflake 커넥터를 추가합니다.

"프로덕션 및 테스트 및 개발" 버튼을 클릭하여 아래와 같이 연결 세부 정보를 편집합니다. 스노우플레이크 계정 이름은 2단계의 OAUTH_인증_엔디포인트 또는 OAUTH_토큰_엔디포인트에서 찾을 수 있습니다.

"테스트" 및 "저장"을 클릭합니다. 커넥터가 온라인 상태가 됩니다.

4단계: 눈송이 커넥터의 인증 세부 정보 편집하기

"프로덕션 및 테스트 및 개발" 버튼과 "헤더 편집" 버튼을 클릭합니다.

요구 사항에 따라 인증 유형을 "OAuth 2(관리자)" 또는 "OAuth 2(운영자)"로 선택합니다. 이에 대한 자세한 내용은 커넥터 구성 방법 문서의 인증 섹션에서 확인할 수 있습니다.

2단계의 세부 정보를 사용하여 인증 필드를 편집합니다. 인증 코드 URL = OAUTH_AUTHORIZATION_ENDPOINTAccess 토큰 URL = OAUTH_TOKEN_ENDPOINTClient ID = OAUTH_CLIENT_ID클라이언트 비밀 = OAUTH_CLIENT_SECRET

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

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

인증에 성공하면 동의를 요청하는 메시지가 표시됩니다. 이 메시지를 주의 깊게 읽고 수행되는 작업을 이해한 후 "허용"을 클릭하시면 이제 Tulip에서 Snowflake에 안전하게 연결할 수 있습니다!

사용 방법

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

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

눈송이 단위 테스트 지침에 따라 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

추가 참조

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