ALTER STREAMLIT

기존 Streamlit 오브젝트의 속성을 수정합니다.

참고 항목:

CREATE STREAMLIT, SHOW STREAMLITS, DESCRIBE STREAMLIT, DROP STREAMLIT

구문

ALTER STREAMLIT [ IF EXISTS ] <name> SET
  [ MAIN_FILE = '<filename>']
  [ QUERY_WAREHOUSE = <warehouse_name> ]
  [ COMMENT = '<string_literal>']
  [ TITLE = '<app_title>' ]
  [ IMPORTS = ( '<stage_path_and_file_name_to_read>' [ , ... ] ) ]
  [ EXTERNAL_ACCESS_INTEGRATIONS = ( <integration_name> [ , ... ] ) ]

ALTER STREAMLIT [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER STREAMLIT <name> COMMIT

ALTER STREAMLIT <name> PUSH [ TO <git_branch_uri> ]
  [
    {
      GIT_CREDENTIALS = <snowflake_secret>
      | USERNAME = <git_username> PASSWORD = <git_password>
    }
    NAME = <git_author_name>
    EMAIL = <git_author_email>
  ]
  [ COMMENT = <git_push_comment> ]

ALTER STREAMLIT <name> ABORT

ALTER STREAMLIT <name> PULL

ALTER STREAMLIT <name> ADD LIVE VERSION FROM LAST
Copy

ROOT_LOCATION으로 생성된 Streamlit 오브젝트의 경우 다음 구문만 지원됩니다.

중요

ROOT_LOCATION은 레거시 매개 변수이며 향후 릴리스에서 더 이상 사용되지 않을 수 있습니다. ROOT_LOCATION을 사용하여 만든 Streamlit 앱의 경우 다중 파일 편집 및 Git 통합은 지원되지 않습니다.

ALTER STREAMLIT [ IF EXISTS ] <name> SET
  [ ROOT_LOCATION = '<stage_path_and_root_directory>' ]
  [ MAIN_FILE = '<path_to_main_file>']
  [ QUERY_WAREHOUSE = <warehouse_name> ]
  [ COMMENT = '<string_literal>']
  [ TITLE = '<app_title>' ]
  [ IMPORTS = ( '<stage_path_and_file_name_to_read>' [ , ... ] ) ]
  [ EXTERNAL_ACCESS_INTEGRATIONS = ( <integration_name> [ , ... ] ) ]

ALTER STREAMLIT [ IF EXISTS ] <name> RENAME TO <new_name>
Copy

매개 변수

name

Streamlit 오브젝트의 식별자입니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

SET ...

Streamlit 오브젝트에 대해 설정할 속성을 지정합니다.

MAIN_FILE = 'filename'

Streamlit 진입점 파일의 파일 이름을 지정합니다. 파일은 앱 디렉터리의 루트에 있어야 하며 .py 확장명을 포함합니다.

FROM 대신 ROOT_LOCATION으로 앱을 만든 경우 MAIN_FILE은 ROOT_LOCATION에 상대적인 경로일 수 있습니다.

QUERY_WAREHOUSE = warehouse_name

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

COMMENT = 'string_literal'

Streamlit 오브젝트에 대한 설명을 추가하거나 기존 설명을 덮어씁니다.

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'

Streamlit Python 파일, 미디어 파일 및 environment.yml 파일이 포함된 루트 스테이지 이름과 접두사를 지정합니다. 이 매개 변수는 명명된 내부 스테이지 내의 단일 디렉터리를 가리켜야 합니다.

RENAME TO new_name

Streamlit 오브젝트의 새 식별자를 지정합니다. 식별자는 오브젝트가 생성된 스키마에 대해 고유해야 합니다.

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

COMMIT

LIVE 버전의 보류 중인 편집을 새 LAST 버전으로 커밋합니다. 커밋 직후, LIVE 버전이 LAST 버전과 동일합니다.

검은색 Snowflake 로고(텍스트 없음) 미리 보기 기능 — 공개

모든 계정에서 사용 가능합니다.

PUSH

TO git_branch_uri 를 지정하지 않으면 기본 버전에 저장된 브랜치를 사용하여 최신 커밋된 변경 내용을 Git 리포지토리에 푸시합니다.

기본 버전이 Git 브랜치를 기반으로 하지 않으면 오류를 발생시킵니다.

검은색 Snowflake 로고(텍스트 없음) 미리 보기 기능 — 공개

모든 계정에서 사용 가능합니다.

TO git_branch_uri

커밋된 변경 내용을 지정된 분기에 푸시합니다.

GIT_CREDENTIALS = snowflake_secret

리포지토리 인증에 사용할 자격 증명이 포함된 Snowflake 시크릿을 지정합니다.

USERNAME = git_username

Git 사용자 이름을 지정합니다.

PASSWORD = git_password

Git 비밀번호를 지정합니다.

NAME = git_author_name

사용할 git 작성자의 이름을 지정합니다.

EMAIL = git_author_email

Git 작성자의 이름으로 사용할 유효한 이메일 주소를 지정합니다.

COMMENT = git_push_comment

Git 푸시에 포함할 설명을 지정합니다.

ABORT

|sf-web-interface|에서 수행되었지만 커밋되지 않은 모든 편집 사항을 포함하여 앱의 현재 라이브 버전을 제거합니다.

검은색 Snowflake 로고(텍스트 없음) 미리 보기 기능 — 공개

모든 계정에서 사용 가능합니다.

PULL

최신 변경 사항을 가져옵니다. 끌어오기 전에 현재 라이브 버전을 중단해야 합니다.

검은색 Snowflake 로고(텍스트 없음) 미리 보기 기능 — 공개

모든 계정에서 사용 가능합니다.

ADD LIVE VERSION FROM LAST

마지막으로 커밋된 버전을 기준으로 앱의 새 라이브 버전을 만듭니다.

Streamlit 앱의 소유자가 |sf-web-interface|에서 앱을 열 때 라이브 버전이 없는 경우 이 명령은 자동으로 실행됩니다. 다른 사용자가 앱을 방문하고 라이브 버전이 없는 경우 오류가 반환됩니다.

액세스 제어 요구 사항

역할에는 오브젝트에 대해 다음 :ref:`권한<label-access_control_overview_privileges>`이 있어야 합니다.

권한

오브젝트

OWNERSHIP

변경하는 Streamlit 오브젝트

스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한. 스키마에 대한 모든 권한이 부여된 역할은 스키마를 확인할 수 있습니다. 예를 들어, 스키마에 대해 CREATE 권한을 부여받은 역할은 해당 스키마에 대한 USAGE 권한을 함께 부여받지 않더라도 해당 스키마에 대한 오브젝트를 생성할 수 있습니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트

  • 앱의 라이브 버전을 제거하면 다음 작업 중 하나를 수행할 때까지 사용자가 앱을 방문할 수 없습니다.

    • Streamlit 오브젝트에 대해 ALTER STREAMLIT … ADD LIVE VERSION FROM LAST를 실행합니다.

    • 앱을 소유한 역할을 사용하여 |sf-web-interface|에서 앱을 방문합니다.

  • Streamlit 앱이 실행되는 동안 ALTER STREAMLIT 명령을 실행하면 변경 사항이 앱에 반영되지 않습니다.

    변경 사항을 앱에 반영하려면 앱을 다시 로딩하거나 다시 부팅해야 합니다.

  • 메타데이터 관련:

    주의

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

언어: 한국어