CREATE STREAMLIT

Snowflake에서 새로운 Streamlit 애플리케이션 오브젝트를 생성하거나 동일한 스키마의 기존 Streamlit 애플리케이션 오브젝트를 대체합니다.

참고 항목:

SHOW STREAMLITS, DESCRIBE STREAMLIT, ALTER STREAMLIT, DROP STREAMLIT

구문

CREATE [ OR REPLACE ] STREAMLIT [ IF NOT EXISTS ] <name>
  FROM <source_location>
  MAIN_FILE = '<path_to_main_file_in_root_directory>'
  QUERY_WAREHOUSE = <warehouse_name>
  [ COMMENT = '<string_literal>' ]
  [ TITLE = '<app_title>' ]
  [ IMPORTS = ( '<stage_path_and_file_name_to_read>' [ , ... ] ) ]
  [ EXTERNAL_ACCESS_INTEGRATIONS = ( <integration_name> [ , ... ] ) ]
  [ ROOT_LOCATION = '<stage_path_and_root_directory>' ]
Copy

필수 매개 변수

name

Streamlit 오브젝트의 식별자(즉, 이름)를 지정합니다. 이 식별자는 테이블이 생성되는 스키마에 대해 고유한 식별자여야 합니다.

또한, 식별자는 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예: "My object")로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

FROM source_location

지정된 위치에서 원본 파일을 복사하여 앱을 초기화합니다. 이런 일이 한 번 발생합니다. 예: FROM @streamlit_db.streamlit_schema.streamlit_stage.

MAIN_FILE = 'path_to_main_file_in_root_directory'

Streamlit Python 애플리케이션의 파일 이름을 지정합니다. 이 파일 이름은 ROOT_LOCATION 의 값에 상대적입니다.

QUERY_WAREHOUSE = warehouse_name

Streamlit 애플리케이션에서 발행한 SQL 쿼리를 실행할 웨어하우스를 지정합니다.

참고

Snowflake Native App Framework 내에서 Streamlit 애플리케이션 오브젝트를 생성하거나 교체하는 경우 QUERY_WAREHOUSE 매개 변수는 선택 사항입니다.

선택적 매개 변수

COMMENT = 'string_literal'

Streamlit 오브젝트에 대한 설명을 명시합니다.

DEFAULT: 값 없음

TITLE = 'app_title'

Snowsight 에 표시할 Streamlit 앱의 명칭을 지정합니다.

IMPORTS = ( 'stage_path_and_file_name_to_read' [ , ... ] )

가져올 파일의 위치(스테이지), 경로, 이름입니다.

EXTERNAL_ACCESS_INTEGRATIONS = ( integration_name [ , ... ] )

Streamlit 앱 코드가 외부 네트워크에 액세스하려면 필요한 외부 액세스 통합 의 이름입니다.

ROOT_LOCATION = 'stage_path_and_root_directory'

중요

ROOT_LOCATION 은 레거시 매개 변수입니다. Snowflake에서는 FROM source_location 을 사용할 것을 권장합니다.

ROOT_LOCATION 을 사용하여 만든 Streamlit 앱의 경우 다중 파일 편집 및 Git 통합이 지원되지 않습니다.

예를 들어 Streamlit Python 파일, 미디어 파일, environment.yml 파일을 포함하는 명명된 스테이지의 전체 경로를 지정합니다.

ROOT_LOCATION = '@streamlit_db.streamlit_schema.streamlit_stage'
Copy

이 예에서 Streamlit 파일은 streamlit_db 라는 데이터베이스와 streamlit_schema 라는 스키마 내의 streamlit_stage 로 명명된 스테이지에 있습니다.

참고

  • 이 매개 변수는 명명된 내부 스테이지 내의 단일 디렉터리를 가리켜야 합니다.

  • Streamlit in Snowflake 에 대한 외부 스테이지는 지원되지 않습니다.

  • Snowflake Native App Framework 내에서 Streamlit 애플리케이션 오브젝트를 만들거나 바꾸는 경우 ROOT_LOCATION = 'stage_path_and_root_directory' 가 아닌 FROM 'relative_path_from_stage_root_directory' 를 사용하십시오.

사용법 노트

  • Streamlit 오브젝트가 포함된 스키마 또는 데이터베이스를 복제할 때 Streamlit 오브젝트는 복제되지 않습니다.

  • Streamlit 애플리케이션에서 사용하는 패키지를 지정하려면 environment.yml 파일을 사용합니다.

  • 메타데이터 관련:

    주의

    고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

  • OR REPLACE 및 IF NOT EXISTS 절은 상호 배타적입니다. 두 문자를 같은 문에 함께 사용할 수 없습니다.

  • CREATE OR REPLACE <오브젝트> 문은 원자성입니다. 즉, 오브젝트가 바뀔 때 단일 트랜잭션으로 이전 오브젝트가 삭제되고 새 오브젝트가 생성됩니다.

예

스테이지에서 Streamlit 앱을 만들려면 다음 예시와 같이 CREATE STREAMLIT 명령을 실행합니다.

CREATE STREAMLIT hello_streamlit
  FROM @streamlit_db.streamlit_schema.streamlit_stage
  MAIN_FILE = 'streamlit_main.py'
  QUERY_WAREHOUSE = my_warehouse;
Copy

Git 리포지토리에서 Streamlit 앱을 만들려면 다음 예시와 같이 CREATE STREAMLIT 명령을 실행합니다.

CREATE STREAMLIT hello_streamlit
  FROM @streamlit_db.streamlit_schema.streamlit_repo/branches/streamlit_branch/
  MAIN_FILE = 'streamlit_main.py'
  QUERY_WAREHOUSE = my_warehouse;
Copy
언어: 한국어