Snowflake Python APIs 라이브러리 설치

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

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

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

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

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

Python 환경 활성화하기

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

참고

이러한 단계는 예시로만 보여주는 것이며, 예시를 따라 실습하려면 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

Snowflake Python APIs 라이브러리 설치

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

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

    pip install snowflake -U
    
    Copy

    snowflake 패키지는 Snowflake Python APIs 의 PEP 420 네임스페이스 상위 패키지입니다. 여기에는 Snowflake 리소스 오브젝트를 관리하기 위해 Python API를 제공하는 하위 패키지인 snowflake.core 가 포함됩니다.

    snowflake 패키지를 설치하면 snowflake-connector-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 클라이언트는 요청을 처리할 때 sys.tracebacklimit0 으로 설정합니다. 이 설정을 사용하면 클라이언트가 API 클라이언트와 관련된 예외뿐만 아니라 모든 유형의 예외에 대한 추적 정보를 표시하지 않고 오류 메시지만 인쇄합니다.

Python 노트북 환경에서 이 옵션을 비활성화하려면 노트북에서 다음 줄을 실행하십시오.

%env _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE=false
Copy
_SNOWFLAKE_ENABLE_RETRY_REQUEST_QUERY

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

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

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

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

기본값: 활성화됨

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

  • 202

  • 429

  • 503

  • 504