Snowflake REST APIs 자습서의 일반 설정

소개

이 항목에서는 이 설명서에서 제공되는 모든 Snowflake REST APIs 자습서에 필요한 공통 설정에 대한 지침을 제공합니다.

Snowflake REST APIs 개요

설정을 시작하기 전에 Snowflake REST APIs 를 살펴보십시오.

Snowflake REST APIs 는 해당 APIs를 통해 다음 리소스를 지원합니다. APIs는 해당 리소스에 대한 CREATE OR ALTER 작업을 지원합니다.

APIs 및 해당 엔드포인트에 대한 참조 정보는 Snowflake REST APIs 참조 섹션을 참조하십시오.

팁

Python 애플리케이션을 작성하는 것을 선호하는 경우 Snowflake Python APIs 을 사용하여 Snowflake 오브젝트를 관리할 수 있습니다. 자세한 내용은 Snowflake Python APIs: Python으로 Snowflake 오브젝트 관리하기 섹션을 참조하십시오.

Snowflake REST APIs 컬렉션 가져오기

이 자습서에서는 Postman에서 Snowflake REST APIs 컬렉션을 가져오는 과정을 안내합니다.

  1. API 컬렉션을 Git 리포지토리 에서 폴더로 다운로드합니다.

    ../../../_images/api-collections-git.png

  2. Postman 애플리케이션을 열고, 필요한 경우 계정을 생성합니다.

  3. Postman에서 원하는 작업 영역을 엽니다.

    ../../../_images/postman-workspace.png

  4. Import 를 선택합니다.

    ../../../_images/postman-import-workspace.png

  5. folders 를 선택합니다.

    ../../../_images/postman-download-collections.png

  6. 대화 상자에서 컬렉션을 추출한 폴더를 선택하고 Open 을 선택합니다.

    ../../../_images/postman-import-elements.png

  7. 모든 항목이 선택되었는지 확인하고 Import 를 선택합니다.

    다음과 같이 왼쪽 패널에 컬렉션이 나열되어야 합니다.

    ../../../_images/postman-verify-import.png

Postman에 전달자 토큰 지정

REST 요청은 요청 헤더에 JWT 토큰이 있어야 요청을 인증할 수 있습니다. JWT 토큰이 없는 경우 JWT 토큰 생성하기 섹션을 참조하십시오.

Postman에서는 다음과 같이 JWT 토큰을 bearerToken 헤더 속성에 복사할 수 있습니다.

../../../_images/postman-bearer-token.png

그런 다음, 다음과 같이 각 요청 헤더에서 x-snowflake-authorization-token-type 키를 KEYPAIR_JWT 로 설정할 수 있습니다.

../../../_images/postman-set-header.png

참고

자습서 전제 조건 에서 설명한 바와 같이 AUTHENTICATION POLICY를 정의해야 합니다. { "code": "390202", "message": "Authentication attempt rejected by the current authentication policy." } 와 유사한 오류 메시지가 표시되는 경우 다음 SQL 명령을 실행하여 정책을 정의할 수 있습니다.

SHOW AUTHENTICATION POLICIES; alter AUTHENTICATION POLICY <your authentication policy> set AUTHENTICATION_METHODS = ('KEYPAIR', 'PASSWORD', 'OAUTH');
Copy

Postman 환경에서 환경 변수 설정

Postman 환경에서 환경 변수를 설정할 수 있습니다. 그런 다음 이러한 변수를 Postman에서 {{variable_name}} 형식으로 사용할 수 있습니다.

모든 엔드포인트 URLs는 Snowflake 계정을 식별하는 baseURL 로 시작됩니다. baseURL의 형식은 <account_locator>.snowflakecomputing.com 이며, 여기서 <account_locator> 는 사용자의 Snowflake 계정 이름입니다.

baseURL 변수와 다른 변수를 설정하려면 다음과 같이 Postman에서 각 매개 변수를 활성화하고 해당 값을 설정합니다.

../../../_images/postman-env-vars.png

설정한 각 값에 대해 Save 를 선택해야 새 값을 저장할 수 있습니다.

다음에는 무엇을 해야 합니까?

축하합니다! 이 자습서에서는 Snowflake REST APIs 를 사용하여 Snowflake 데이터베이스, 스키마 및 테이블 리소스를 관리하기 위한 기본 사항에 대해 알아봤습니다.

요약

이 과정에서 다음 단계를 완료했습니다.

  • Snowflake REST APIs 컬렉션을 가져옵니다.

  • Postman에서 전달자 토큰을 지정합니다.

  • Postman 환경에서 환경 변수를 설정합니다.

다음 자습서

이제 Snowflake 데이터베이스, 스키마 및 테이블을 생성하고 관리하는 방법을 보여주는 자습서 1: 데이터베이스, 스키마, 테이블 만들기 및 관리 을 진행할 수 있습니다.

언어: 한국어