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

주의

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

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

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

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

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

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

    • GCP(Google Cloud Platform)

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

  • AWS PrivateLink 또는 Azure Private Link 사용은 지원되지 않습니다.

  • 계정 이름과 조직 이름을 합친 길이가 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.mapst.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을 반환합니다.

개인 맞춤 설정, 로깅 또는 데이터 필터링을 위해 앱에서 CURRENT_USER를 사용해야 하는 경우 st.experimental_user 를 대신 사용하십시오.

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

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

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

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

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

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

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

복제는 지원되지 않습니다.

Streamlit in Snowflake 앱의 경우 복제가 지원되지 않습니다.

지원되지 않는 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 커뮤니티 포럼 을 참조하십시오.