SQL API 소개

Snowflake SQL API는 Snowflake 데이터베이스의 데이터에 액세스하고 업데이트하는 데 사용할 수 있는 REST API 입니다. 이 API를 사용하여 다음과 같은 사용자 지정 애플리케이션 및 통합을 개발할 수 있습니다.

  • 쿼리를 수행합니다.

  • 배포를 관리합니다(예: 사용자 및 역할 프로비저닝, 테이블 만들기 등).

이 항목의 내용:

SQL API의 기능

Snowflake SQL API는 다음을 위해 사용할 수 있는 작업을 제공합니다.

  • 실행할 SQL 문을 제출합니다.

  • 문 실행 상태를 확인합니다.

  • 문 실행을 취소합니다.

  • 쿼리 결과를 동시에 가져옵니다.

이 API를 사용하여 표준 쿼리 와 대부분의 DDLDML 문을 실행할 수 있습니다. 지원되지 않는 문 유형은 SQL API의 제한 사항 을 참조하십시오.

쿼리의 경우 SQL API는 파티션의 데이터를 반환합니다. Snowflake는 반환되는 파티션 수와 각 파티션의 크기를 결정합니다.

SQL API의 엔드포인트(/api/v2/statements)는 API가 활성화된 계정에 대한 액세스를 제한하는 네트워크 정책 에 의해 보호됩니다.

참고

AUTOCOMMIT 매개 변수는 사용자 또는 계정 수준에서 설정된 값과 관계없이 쿼리 또는 문 수준마다 TRUE 로 설정해야 합니다.

SQL API의 제한 사항

SQL API에는 다음과 같은 제한 사항이 있습니다.

  • 다음 명령은 지원되지 않습니다.

    • PUT 명령(Snowflake SQL에서)

    • GET 명령(Snowflake SQL에서)

다음 명령 및 문은 여러 문을 지정하는 요청 내에서만 지원됩니다.

  • 명시적 트랜잭션을 수행하는 명령(다음 포함):

  • 세션의 컨텍스트를 변경하는 명령(다음 포함):

  • 세션 변수를 설정하는 문.

  • 임시 테이블 및 스테이지(현재 세션에서만 사용 가능한 테이블 및 스테이지)를 만드는 문.

SQL API는 현재 Python 저장 프로시저 를 지원하지 않습니다.

SQL API 사용 시 청구 고려 사항

SQL API는 일부 쿼리 결과를 가져올 때 클라우드 서비스 계층을 활용합니다. 클라우드 서비스에 대한 자세한 내용은 클라우드 서비스 크레딧 사용 을 참조하십시오.