CREATE STREAMLIT

Crée un nouvel objet d’application Streamlit dans Snowflake ou remplace un objet d’application Streamlit existant dans le même schéma.

Voir aussi :

SHOW STREAMLITS, DESCRIBE STREAMLIT, ALTER STREAMLIT, DROP STREAMLIT

Syntaxe

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

Paramètres requis

name

Spécifie l’identificateur (c’est-à-dire le nom) de l’objet Streamlit. Cet identificateur doit être unique pour le schéma dans lequel la table est créée.

De plus, l’identificateur doit commencer par un caractère alphabétique et ne peut pas contenir d’espaces ou de caractères spéciaux à moins que toute la chaîne d’identificateur soit délimitée par des guillemets doubles (p. ex. "My object"). Les identificateurs entre guillemets doubles sont également sensibles à la casse.

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

FROM source_location

Copie les fichiers source à partir de l’emplacement spécifié pour initialiser l’application. Cela se produit une fois. Par exemple, FROM @streamlit_db.streamlit_schema.streamlit_stage.

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.

Note

Si vous créez ou remplacez un objet d’application Streamlit dans Snowflake Native App Framework, le paramètre QUERY_WAREHOUSE est facultatif.

Paramètres facultatifs

COMMENT = 'string_literal'

Spécifie un commentaire pour l’objet Streamlit.

DEFAULT : aucune valeur

TITLE = 'app_title'

Spécifie un titre pour l’application Streamlit à afficher dans 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.

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 chemin complet vers la zone de préparation nommée contenant les fichiers Python Streamlit, les fichiers média et le fichier environment.yml , par exemple :

ROOT_LOCATION = '@streamlit_db.streamlit_schema.streamlit_stage'
Copy

Dans cet exemple, les fichiers Streamlit sont situés sur une zone de préparation nommée streamlit_stage au sein d’une base de données nommée streamlit_db et d’un schéma nommé streamlit_schema.

Note

  • Ce paramètre doit pointer vers un répertoire unique à l’intérieur d’une zone de préparation interne nommée.

  • Les zones de préparation externes ne sont pas prises en charge pour Streamlit in Snowflake.

  • Si vous créez ou remplacez un objet d’application Streamlit dans Snowflake Native App Framework, utilisez FROM 'relative_path_from_stage_root_directory' et non ROOT_LOCATION = 'stage_path_and_root_directory'.

Notes sur l’utilisation

  • Lorsque vous clonez un schéma ou une base de données contenant un objet Streamlit, l’objet Streamlit n’est pas cloné.

  • Pour spécifier les paquets utilisés par l’application Streamlit, utilisez un fichier environment.yml.

  • 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.

  • Les clauses OR REPLACE et IF NOT EXISTS s’excluent mutuellement. Elles ne peuvent pas être utilisées dans la même instruction.

  • Les instructions CREATE OR REPLACE <objet> sont atomiques. En d’autres termes, lorsqu’un objet est remplacé, l’ancien objet est supprimé et le nouvel objet est créé dans une seule transaction.

Exemples

Pour créer une application Streamlit à partir d’une zone de préparation, exécutez la commande CREATE STREAMLIT, comme indiqué dans l’exemple suivant :

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

Pour créer une application Streamlit à partir d’un référentiel Git, exécutez la commande CREATE STREAMLIT, comme indiqué dans l’exemple suivant :

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