Snowflake Python APIs 라이브러리 설치

Conda 또는 가상 환경에서 사용할 Snowflake Python APIs 라이브러리를 설치할 수 있습니다. 시작하기 전에 지원되는 Python 버전 을 검토해야 합니다.

Snowflake Python APIs 라이브러리를 설정하려면 다음 단계를 완료합니다.

  1. Python 환경을 활성화합니다.

  2. 라이브러리를 설치합니다.

  3. Python API 클라이언트의 옵션을 설정 합니다.

Python 환경 활성화하기

Python 코드를 실행할 환경을 설정하려면 Python 환경을 활성화해야 합니다. 예를 들어, conda 또는 가상 환경 을 사용할 수 있습니다.

Conda 사용하기

참고

이러한 단계는 예시로만 보여주는 것이며, 예시를 따라 실습하려면 Snowflake가 소유하거나 제공하지 않는 서드 파티 데이터, 제품 또는 서비스에 대한 권한이 추가로 필요할 수 있습니다. 계속하기 전에 서드 파티 데이터, 제품 또는 서비스에 대한 적절한 권리가 있는지 확인하십시오.

conda 를 사용하여 Python 코드 실행을 위한 환경을 만들 수 있습니다. Conda가 없으면 conda 웹사이트에서 conda를 설치할 수 있습니다.

conda에 대한 내용은 Conda 설명서 를 참조하십시오. conda를 다운로드하고 설치하려면 conda 설치하기 섹션을 참조하십시오.

  1. Conda 환경을 만듭니다.

    conda create -n <env_name> python==3.10
    Copy

  2. 환경을 활성화합니다.

    conda activate <env_name>
    Copy

가상 환경 사용하기

venv를 사용하여 Python 코드 실행을 위한 가상 환경을 만들 수 있습니다. 아직 Python이 없으면 Python을 다운로드하고 설치한 다음 가상 환경을 만들 수 있습니다.

venv에 대한 내용은 venv — 가상 환경 만들기 섹션을 참조하십시오. Python을 다운로드하려면 Python 다운로드 섹션을 참조하십시오.

  1. venv 를 사용하여 가상 환경을 만듭니다.

    cd <your Python project root folder>
python3 -m venv '.venv'
    Copy

  2. 환경을 활성화합니다.

    source '.venv/bin/activate'
    Copy

Snowflake Python APIs 라이브러리 설치

Python Package Index(PyPI)에서 Snowflake Python APIs 라이브러리를 설치할 수 있습니다.

  • 자신이 만든 conda 또는 가상 환경에서 다음 pip 명령을 실행하여 라이브러리를 설치합니다.

    pip install snowflake -U
    Copy

snowflake 패키지를 설치하면 Snowflake Python 커넥터, Snowpark Python 라이브러리, snowflake.core 를 포함한 모든 하위 패키지가 종속성으로 자동으로 설치됩니다.

  • Snowpark ML 라이브러리를 추가 패키지 종속성으로 설치하려면 다음 pip 명령을 실행합니다.

    pip install "snowflake[ml]" -U
    Copy

라이브러리를 설치한 후 API를 사용하려면 먼저 Snowflake에 대한 연결을 생성해야 합니다. 연결에 대한 자세한 내용은 Snowflake Python APIs 을 사용하여 Snowflake에 연결 섹션을 참조하십시오.

Python API 클라이언트 옵션 설정

다음 환경 변수를 설정하여 Snowflake Python APIs 에 대한 클라이언트 옵션을 제어할 수 있습니다.

_SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE

출력된 오류 메시지에서 전체 스택 추적을 활성화할지 여부를 지정합니다.

가능한 값은 다음과 같습니다.

  • 활성화됨: true, t, yes, y, on

  • 비활성화됨: 다른 값 또는 정의되지 않음

기본값: 비활성화됨

이 옵션을 비활성화하면 API 클라이언트는 오류 메시지에 전체 스택 추적 대신 축소된 스택 추적을 출력합니다.

Python 노트북 환경에서 이 옵션을 비활성화하려면 노트북에서 다음 줄을 실행해야 합니다. 이 줄을 1회 실행하면 환경 변수가 스택 추적 동작을 자체적으로 제어합니다.

%xmode minimal
Copy
_SNOWFLAKE_ENABLE_RETRY_REQUEST_QUERY

특정 상태 코드가 있는 쿼리 요청에 대해 자동 재시도를 활성화할지 여부를 지정합니다.

가능한 값은 다음과 같습니다.

  • 활성화됨: true, t, yes, y, on

  • 비활성화됨: 다른 값 또는 정의되지 않음

기본값: 활성화됨

이 옵션을 활성화하면 API 클라이언트는 쿼리 요청에 다음 상태 코드가 있을 때 자동으로 재시도합니다.

  • 202

  • 429

  • 503

  • 504

언어: 한국어