제한 사항 및 지원되지 않는 기능

주의

이 기능은 AWS 및 Microsoft Azure 상업 리전 의 계정에서 사용할 수 있습니다. AWS PrivateLink 는 지원되지 않습니다.

이 항목에서는 Streamlit in Snowflake 에 대한 제한 사항을 설명합니다. 또한 지원되지 않는 Streamlit 기능도 나열되어 있습니다.

Streamlit in Snowflake 사용 시 계정 제한 사항

Streamlit in Snowflake 에는 다음과 같은 계정 제한 사항이 있습니다.

  • Snowflake 계정은 AWS(Amazon Web Services) 또는 Microsoft Azure 리전에 있어야 합니다.

  • 다음 리전의 계정은 현재 지원되지 않습니다.

    • GCP(Google Cloud Platform)

    • Virtual Private Snowflake(VPS)

    • FedRAMP를 지원하는 US 정부 리전

  • AWS PrivateLink 사용은 지원되지 않습니다.

  • 계정 이름과 조직 이름을 합친 길이가 41자 미만이어야 합니다.

  • 계정 이름은 조직 내에서 고유해야 합니다.

Streamlit in Snowflake 사용 시 추가 제한 사항

다음 섹션에서는 Streamlit in Snowflake 를 사용할 때의 추가 제한 사항을 설명합니다.

Streamlit 앱의 데이터 제한 사항

Streamlit in Snowflake 및 Snowflake Native App 에서 실행되는 Streamlit 앱에서는 단일 쿼리에서 불러올 수 있는 데이터의 양이 32MB로 제한됩니다. 32MB를 초과하는 쿼리는 다음 오류를 발생시킵니다.

MessageSizeError: Data Size exceeds message limit

이 제한을 방지하려면 Streamlit 앱이 32MB보다 작은 증분 단위로 데이터를 불러오도록 설계하십시오.

Streamlit in Snowflake 편집기는 서버 측 암호화를 사용하는 스테이지를 지원하지 않습니다.

Streamlit in Snowflake 편집기는 서버 측 암호화를 사용하는 명명된 스테이지의 파일에서 STREAMLIT 오브젝트 생성 을 지원하지 않습니다. 이 상황에서는 Snowsight 에서 오류를 반환합니다.

Streamlit in Snowflake 에서 st.map 및 st.pydeck_chart 사용 시 제한 사항

st.map 또는 st.pydeck_chart Streamlit 명령을 사용하는 경우 Mapbox는 지도 콘텐츠 렌더링 시 지도 타일을 제공합니다. Mapbox는 서드 파티 애플리케이션으로, Snowflake의 서드 파티 약관 이 적용됩니다.

다중 페이지 Streamlit 앱

다중 페이지 Streamlit 앱은 다음 사항을 고려하여 지원됩니다.

  • 다중 페이지 Streamlit 앱은 SQL 명령으로만 생성할 수 있습니다. SQL을 사용하여 Streamlit 앱 만들기 섹션을 참조하십시오.

  • 개별 페이지 URL은 지원되지 않습니다.

  • /pages 디렉터리에 업로드된 파일은 명명된 스테이지의 ROOT_LOCATION 내에 표시됩니다.

일부 Snowflake 컨텍스트 함수는 빈 필드 또는 NONE 반환

CURRENT_ (CURRENT_*)로 시작하는 Snowflake 컨텍스트 함수 는 Streamlit in Snowflake 에서 사용 시 빈 필드 또는 NONE을 반환합니다.

사용자 지정 구성 요소가 지원되지 않음

사용자 지정 구성 요소는 지원되지 않습니다.

통합 버전 제어 또는 CI/CD 시스템이 지원되지 않음

Streamlit 앱은 버전 제어 시스템과 통합되지 않습니다. 앱 기록 또는 코드 변경 사항은 영구적이며 롤백할 수 없습니다.

GitHub, GitLab 또는 기타 버전 제어 벤더와의 통합은 없습니다.

앱 뷰어로 앱 편집 내용을 볼 수 있음

개발자가 편집하는 동안 Streamlit 앱을 실행하면 변경 사항이 실제로 적용되고 앱 뷰어에서 즉시 사용할 수 있습니다.

지원되지 않는 Streamlit 기능

다음 Streamlit 기능은 Streamlit in Snowflake 에서 지원되지 않습니다.

Streamlit in Snowflake 문제 해결하기

다음 시나리오는 Streamlit in Snowflake 에서 작업 시 발생할 수 있는 문제를 해결하는 데 도움이 될 수 있습니다.

Streamlit 앱을 로드할 수 없음

Streamlit in Snowflake 에서 실행되는 각 Streamlit 앱은 고유한 하위 도메인을 사용합니다.

*.snowflake.app 이 네트워크의 허용 목록에 있고 Snowflake에 연결할 수 있는지 확인하십시오. 이 도메인이 허용 목록에 있으면 앱이 아무런 제한 없이 Snowflake 서버와 통신할 수 있습니다.

Streamlit in Snowflake 에서는 WebSockets를 사용합니다. 네트워크 구성에서 WebSockets가 차단되지 않는지 확인해야 합니다.

오류

 
Could not reload streamlit files.
Error: 092806 (P0002): The specified Streamlit was not found.

원인

Snowflake WebSocket 연결이 애플리케이션과 연결된 엔드포인트에 도달할 수 없습니다.

해결책

조직의 방화벽 구성에 대한 허용 목록에 *.snowflake.app 을 추가합니다.

외부 API에 액세스할 수 없습니다.

외부 API에 액세스하려면 외부 액세스 통합을 지정하는 UDF를 생성하고 Streamlit 앱에서 해당 UDF를 호출해야 합니다. 자세한 내용은 함수 또는 프로시저에서 외부 액세스 통합 사용하기 섹션을 참조하십시오.

데이터를 보거나 데이터베이스를 변경할 수 없음

Streamlit 앱은 소유자 권한으로 실행되므로 데이터를 보거나 데이터베이스, 웨어하우스 또는 역할을 변경하지 못할 수도 있는데, 이는 곧 호출자의 권한이 아닌 소유자의 권한으로 앱이 실행된다는 의미입니다. Streamlit 앱은 호출자가 현재 사용 중인 데이터베이스와 스키마가 아니라, Streamlit in Snowflake 앱이 생성된 데이터베이스와 스키마를 사용합니다.

자세한 내용은 소유자 권리 및 Streamlit in Snowflake 앱 이해하기 섹션을 참조하십시오.

Streamlit 라이브러리 기능이 작동하지 않음

Streamlit in Snowflake 에서 지원하는 Streamlit 라이브러리 버전과 기능을 사용하고 있는지 확인하십시오. 자세한 내용은 지원되는 Streamlit 라이브러리 버전 및 지원되지 않는 Streamlit 기능 섹션을 참조하십시오.

Streamlit 앱용 코드 작성에 대한 지원은 Streamlit 커뮤니티 포럼 을 참조하십시오.

언어: 한국어