Snowflake Python APIs 라이브러리 설치¶

Python 환경 활성화하기¶

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

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.tracebacklimit 를 0 으로 설정합니다. 이 설정을 사용하면 클라이언트가 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