Streamlit 앱 만들기¶

전제 조건¶

Snowflake CLI 를 사용하여 Streamlit 앱을 생성하기 전에 다음 전제 조건을 충족해야 합니다.

Ensure that your account has the correct privileges as described in Streamlit 앱 생성 및 사용에 필요한 권한.
Streamlit 앱 파일을 업로드할 수 있는 명명된 스테이지를 생성하거나 이 스테이지에 액세스할 수 있는지 확인하십시오.

Streamlit 앱 부트스트랩¶

snow init 명령은 Streamlit 앱 만들기를 시작하는 데 유용한 샘플 파일 세트가 있는 로컬 디렉터리를 만듭니다. 이 명령을 실행하면 Snowflake CLI 는 다음과 같은 디렉터리 구조를 생성합니다.

example_streamlit/            - project name (default: example_streamlit)
  snowflake.yml               - configuration for snow streamlit commands
  environment.yml             - additional config for Streamlit, for example installing packages
  streamlit_app.py            - entrypoint file of the app
  pages/                      - directory name for Streamlit pages (default pages)
  common/                     - example “shared library”

Streamlit 앱을 초기화하려면 다음 명령을 입력합니다.

snow init new_streamlit_project --template example_streamlit -D query_warehouse=dev_warehouse -D stage=testing

조심

프로젝트 디렉터리 내의 파일은 Snowflake CLI 에 의해 처리되며 다른 snow streamlit 명령을 실행할 때 Snowflake에 업로드될 수 있습니다. 프로젝트 디렉터리의 파일에 민감한 정보를 포함하는 경우에는 주의해야 합니다.

For more information about the file structure, see Streamlit 앱 파일 구성하기.

Streamlit 앱에 대한 프로젝트 정의를 만듭니다.¶

Snowflake의 각 Streamlit 앱에는 반드시 snowflake.yml 프로젝트 정의 파일이 포함되어야 합니다. Streamlit은 프로젝트 정의 파일당 1개의 애플리케이션으로 제한됩니다.

snowflake.yml 프로젝트 정의 파일 샘플은 다음과 같습니다.

definition_version: 2
entities:
  my_streamlit:
    type: streamlit
    identifier: streamlit_app
    stage: my_streamlit_stage
    query_warehouse: my_streamlit_warehouse
    main_file: streamlit_app.py
    pages_dir: pages/
    external_access_integrations:
      - test_egress
    secrets:
      dummy_secret: "db.schema.dummy_secret"
    imports:
      - "@my_stage/foo.py"
    artifacts:
      - common/hello.py
      - environment.yml
    grants:
      - privilege: USAGE
        role: streamlit_role

다음 테이블은 Streamlit 프로젝트 정의의 속성을 설명합니다.

Streamlit 프로젝트 정의 속성¶
속성	정의
식별자 선택 사항, 문자열	엔터티에 대한 선택적 Snowflake 식별자입니다. 값은 다음 형식일 수 있습니다. 문자열 식별자 텍스트 identifier: my-streamlit-id 따옴표로 묶지 않은 식별자와 따옴표로 묶은 식별자가 모두 지원됩니다. 따옴표로 묶인 식별자를 사용하려면 YAML 값에 따옴표(예: `’”My Streamlit Application”’`)를 포함합니다. 오브젝트 identifier: name: my-streamlit-id schema: my-schema # optional database: my-db # optional 참고 `schema` 또는 `database` 를 지정하고 `name` 속성에 정규화된 이름(예: `mydb.schema1.my-app`)을 사용하면 오류가 발생합니다.
유형 선택 사항, 문자열	`streamlit` 이어야 합니다.
comment 선택 사항, 문자열	Streamlit 대시보드에 대한 설명.
제목 선택 사항, 문자열	Streamlit 대시보드의 사람이 읽을 수 있는 제목입니다.
스테이지 선택 사항, 문자열	앱의 아티팩트가 저장되는 스테이지입니다. 기본값: 없음.
query_warehouse 필수, 문자열	앱을 호스팅하는 Snowflake 웨어하우스입니다.
main_file 선택 사항, 문자열	Streamlit 앱의 진입점 파일 입니다. 기본값: “streamlit_app.py”.
pages_dir 선택 사항, 문자열	Streamlit 페이지 입니다. 기본값: “pages”.
external_access_integrations 선택 사항, 문자열 시퀀스	이 Streamlit 애플리케이션 코드가 외부 네트워크에 액세스하는 데 필요한 외부 액세스 통합 의 이름입니다. 자세한 내용은 CREATE STREAMLIT 의 선택적 매개 변수 섹션을 참조하십시오.
시크릿 선택 사항, 사전	애플리케이션 코드의 시크릿에서 정보를 검색할 때 변수를 사용하여 시크릿을 참조할 수 있도록 시크릿 이름을 변수에 할당합니다.
가져오기 선택 사항, 문자열 시퀀스	가져올 이전에 업로드한 파일의 스테이지와 경로를 입력합니다. 자세한 내용은 CREATE STREAMLIT 의 선택적 매개 변수 섹션을 참조하십시오.
아티팩트 필수, 문자열 시퀀스	배포 루트에 추가할 파일 소스 및 대상 쌍 목록입니다. 다음 아티팩트 속성을 사용할 수 있습니다. `src`: Path to the code source file or files. `dest`: 아티팩트를 배포할 디렉터리의 경로입니다. 디렉터리를 참조하는 대상 경로는 `/` 로 끝나야 합니다. GLOB 패턴의 대상이 `/` 로 끝나지 않으면 오류가 발생합니다. 생략하면, `dest` 는 기본적으로 `src` 와 동일한 문자열로 설정됩니다. `dict` 대신 각 항목에 대한 문자열을 전달할 수도 있으며, 이 경우 해당 값은 `src` 및 `dest` 로 모두 처리됩니다. `src` 가 1개의 파일(GLOB가 아닌)만 참조하는 경우, `dest` 는 대상 `<경로>` 또는 `<경로/이름>` 을 참조할 수 있습니다. You can also pass in a string for each item instead of a `dict`; in that case, the value is treated as both `src` and `dest`.
grants optional, grant sequence	Grants that should be given for the Streamlit app. Each grant must specify the privilege and target role. For more details, see the optional parameters for CREATE STREAMLIT.