ALTER STREAMLIT¶
Modifies the properties of an existing Streamlit object.
Syntax¶
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>
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
Parameters¶
name
Identifier for the Streamlit object. If the identifier contains spaces or special characters, the entire string must be enclosed in double quotes. Identifiers enclosed in double quotes are also case-sensitive.
SET ...
Specifies the property to set for the Streamlit object:
ROOT_LOCATION = 'stage_path_and_root_directory'
Important
ROOT_LOCATION
is a legacy parameter. Snowflake recommends usingFROM source_location
.For Streamlit apps created using ROOT_LOCATION, multi-file editing and Git integration are not supported.
Specifies the root stage name and prefix containing the Streamlit Python files, media files and
environment.yml
file. This parameter must point to a single directory inside a named internal stage.MAIN_FILE = 'path_to_main_file_in_root_directory'
Specifies the filename of the Streamlit Python application. This filename is relative to the value of
ROOT_LOCATION
.QUERY_WAREHOUSE = warehouse_name
Specifies the warehouse where SQL queries issued by the Streamlit application are run.
COMMENT = 'string_literal'
Adds a comment or overwrites an existing comment for the Streamlit object.
TITLE = 'app_title'
Adds a title for the Streamlit app to display in Snowsight.
IMPORTS = ( 'stage_path_and_file_name_to_read' [ , ... ] )
The location (stage), path, and name of the file(s) to import.
EXTERNAL_ACCESS_INTEGRATIONS = ( integration_name [ , ... ] )
The names of external access integrations needed in order for the Streamlit app code to access external networks.
RENAME TO new_name
Specifies the new identifier for the Streamlit object; must be unique for the schema.
For more details about identifiers, see Identifier requirements.
PUSH
Pushes the latest committed changes to the Git repo, using the branch stored in the base version if
TO git_branch_uri
is not specified.If the base version is not based on a Git branch, throws an error.
TO git_branch_uri
Pushes committed changes to the specified branch.
GIT_CREDENTIALS = snowflake_secret
Specifies the Snowflake secret containing the credentials to use for authenticating with the repository.
USERNAME = git_username
Specifies a Git username.
PASSWORD = git_password
Specifies a Git password.
NAME = git_author_name
Specifies the name of the git author to use.
EMAIL = git_author_email
Specifies a valid e-mail address to use as the git author’s name.
COMMENT = git_push_comment
Specifies a comment to include in the git push.
ABORT
Removes an existing version and deletes its files.
PULL
Pulls latest changes.
Usage notes¶
If you run the ALTER STREAMLIT command while the Streamlit app is running, the app does not reflect the changes that you made.
If you want your changes reflected in the app, you must reload or reboot the app.
Regarding metadata:
Attention
Customers should ensure that no personal data (other than for a User object), sensitive data, export-controlled data, or other regulated data is entered as metadata when using the Snowflake service. For more information, see Metadata fields in Snowflake.