ALTER STREAMLIT¶

Modifie les propriétés d’un objet Streamlit existant.

Voir aussi :: CREATE STREAMLIT, SHOW STREAMLITS, DESCRIBE STREAMLIT, DROP STREAMLIT

Syntaxe¶

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

Copy

Paramètres¶

name

Identificateur de l’objet Streamlit. Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

SET ...

Spécifie les propriétés à définir pour l’objet Streamlit :

ROOT_LOCATION = 'stage_path_and_root_directory'

Important

ROOT_LOCATION est un ancien paramètre. Snowflake recommande d’utiliser FROM source_location.

Pour les applications Streamlit créées à l’aide de ROOT_LOCATION, l’édition multi-fichiers et l’intégration Git ne sont pas prises en charge.

Spécifie le nom et le préfixe de la zone de préparation racine contenant les fichiers Streamlit Python, les fichiers média et le fichier environment.yml. Ce paramètre doit pointer vers un répertoire unique à l’intérieur d’une zone de préparation interne nommée.

MAIN_FILE = 'path_to_main_file_in_root_directory': Spécifie le nom de fichier de l’application Streamlit Python. Ce nom de fichier est relatif à la valeur de ROOT_LOCATION.
QUERY_WAREHOUSE = warehouse_name: Spécifie l’entrepôt où sont exécutées les requêtes SQL émises par l’application Streamlit.
COMMENT = 'string_literal': Ajoute un commentaire ou écrase un commentaire existant pour l’objet Streamlit.
TITLE = 'app_title': Ajoute un titre à afficher dans l’application Streamlit Snowsight.
IMPORTS = ( 'stage_path_and_file_name_to_read' [ , ... ] ): L’emplacement (zone de préparation), le chemin et le nom du ou des fichiers à importer.
EXTERNAL_ACCESS_INTEGRATIONS = ( integration_name [ , ... ] ): Les noms des intégrations d’accès externe nécessaires pour que le code de l’application Streamlit puisse accéder aux réseaux externes.

RENAME TO new_name

Indique le nouvel identifiant de l’objet Streamlit ; doit être unique pour le schéma.

Pour plus de détails sur les identificateurs, voir Exigences relatives à l’identificateur.

PUSH

Pousse les dernières modifications validées vers le référentiel Git, en utilisant la branche stockée dans la version de base si TO git_branch_uri n’est pas spécifié.

Si la version de base n’est pas basée sur une branche Git, une erreur est générée.

TO git_branch_uri: Pousse les modifications validées vers la branche spécifiée.
GIT_CREDENTIALS = snowflake_secret: Spécifie le secret Snowflake contenant les identifiants de connexion à utiliser pour s’authentifier auprès du référentiel.
USERNAME = git_username: Spécifie un nom d’utilisateur Git.
PASSWORD = git_password: Spécifie un mot de passe Git.
NAME = git_author_name: Spécifie le nom de l’auteur git à utiliser.
EMAIL = git_author_email: Spécifie une adresse électronique valide à utiliser comme nom d’auteur git.
COMMENT = git_push_comment: Spécifie un commentaire à inclure dans le push git.

ABORT

Supprime une version existante et efface ses fichiers.

PULL

Extrait les dernières modifications.

Notes sur l’utilisation¶

Si vous exécutez la commande ALTER STREAMLIT alors que l’application Streamlit est en cours d’exécution, l’application ne reflète pas les modifications que vous avez apportées.

Si vous souhaitez que vos modifications soient prises en compte dans l’application, vous devez recharger ou redémarrer l’application.
Concernant les métadonnées :

Attention

Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.