Snowflake Marketplace에 앱을 제출하기 위한 가이드라인¶

Snowflake Native App 제출 준비하기¶

애플리케이션 패키지를 Snowflake Marketplace 에 게시할 준비가 되면 Snowflake에 제출해 승인을 받아야 합니다.

목록을 작성하기 전에 필수 요구 사항 을 이해하고 애플리케이션 패키지가 각 요구 사항을 준수하는지 확인하십시오. 애플리케이션 패키지가 이러한 요구 사항을 따르지 않으면 제출이 거부될 수 있습니다.

제출한 애플리케이션 패키지에 대한 거부 알림을 받은 경우 권장 변경 사항을 실행하고 애플리케이션 패키지를 다시 제출하여 승인을 받으십시오.

필수 요구 사항¶

Snowflake Marketplace 에 게시할 애플리케이션 패키지의 승인을 받으려고 제출할 때 다음 요구 사항을 확인하는 절차를 거칩니다.

• Snowflake Native App 에 필요한 모든 계정 수준 권한과 참조는 애플리케이션 패키지의 매니페스트 파일 에 나열해야 합니다.

• 목록에 매니페스트 파일의 security 섹션에 계정 수준 권한 또는 참조가 포함되어 있고 애플리케이션 패키지에 Streamlit 앱이 포함되는 경우 Python Permission SDK 를 사용하여 컨슈머로부터 권한과 참조를 요청하는 사용자 인터페이스를 만들어야 합니다.

• 애플리케이션 패키지가 Streamlit 앱을 앱의 사용자 인터페이스로 제공하지 않는 경우 애플리케이션 패키지의 readme 파일에는 다음 정보가 포함되어야 합니다.

  • 앱의 기능에 대한 설명.

  • 컨슈머가 앱을 설치한 후에 구성하기 위해 수행해야 하는 단계.

  • 앱이 사용하는 저장 프로시저와 사용자 정의 함수.

  • 앱에 필요한 권한.

  • 컨슈머에게 앱 사용 방법을 보여주는 예제 SQL 명령.

• readme 파일에 SQL 문이나 코드 예제가 포함되는 경우 코드 블록을 사용해야 합니다.

• 가능하다면 별도의 Streamlit 앱 여러 개가 아니라 다중 페이지의 단일 Streamlit 앱을 사용하십시오. 여기에는 다중 사용자 Streamlit 앱 등이 포함됩니다.

• 앱이 샘플 데이터를 제공하는 경우 필요하다면 데이터베이스를 생성하는 데 필요한 코드를 포함하여 샘플 데이터를 사용하는 방법에 대한 절차를 포함해야 합니다.

Snowflake Native App 을 게시할 경우의 모범 사례¶

애플리케이션 패키지를 Snowflake Marketplace 에 제출하기 위한 요구 사항 외에도 Snowflake에서는 Snowflake Native App 을 게시할 때 다음 모범 사례를 권장합니다.

• 다음을 포함하여 제출하는 앱 버전에 대해 지정된 스테이지에 필요한 모든 파일이 업로드되었는지 확인하십시오.

  • manifest.yml 파일.

  • 설정 스크립트.

  • readme.md 파일.

  • 애플리케이션 패키지에 필요한 외부 저장 프로시저 또는 사용자 정의 함수.

  • 애플리케이션 패키지에 필요한 모든 Streamlit 파일.

  • Python, Java 등을 포함한 모든 외부 소스 코드.

• 개발 중인 앱 버전이 자동 보안 검사 를 통과하는지 확인하십시오.

• CREATE APPLICATION 명령을 사용하여 로컬에서 애플리케이션 오브젝트를 생성하여 애플리케이션 패키지의 새 버전을 테스트합니다.

  • 앱을 개발하고 테스트하는 동안 애플리케이션 패키지에 새 버전을 추가하거나 DISTRIBUTION 속성을 EXTERNAL로 설정하지 마십시오. 이러한 작업은 개발 주기를 지연시키는 자동화된 보안 검사 를 트리거합니다.

    대신, 명명된 스테이지의 파일 을 사용하여 애플리케이션 오브젝트를 생성하십시오.

  • 앱에 Streamlit 앱이 포함된 경우 Snowsight 에서 애플리케이션을 테스트하여 Streamlit 앱이 예상대로 작동하는지 확인하십시오.

  • Streamlit 앱과 Snowflake Worksheets 간의 상호 작용이 원활하고 컨슈머가 둘 사이를 과도하게 탐색할 필요가 없는지 확인하십시오.

• 승인을 위해 제출하기 전에 목록의 모든 부분을 검토하십시오.

• 목록, readme 파일 및 Streamlit 앱에 오타나 기타 텍스트 오류가 없는지 확인하십시오.