DESCRIBE STREAMLIT¶

Décrit les colonnes dans un objet Streamlit.

DESCRIBE peut être abrégé en DESC.

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

Syntaxe¶

DESC[RIBE] STREAMLIT <name>

Copy

Paramètres requis¶

name: Indique l’identificateur de l’objet Streamlit à décrire. 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.

Exigences en matière de contrôle d’accès¶

Si votre rôle ne possède pas les objets de la table suivante, votre rôle doit disposer des privilèges répertoriés sur ces objets :

Privilège	Objet
USAGE	Objet Streamlit que vous décrivez

Pour effectuer une opération sur un objet dans un schéma, il est nécessaire de disposer d’au moins un privilège sur la base de données parente et d’au moins un privilège sur le schéma parent.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

Pour post-traiter la sortie de cette commande, vous pouvez utiliser la syntaxe opérateur de canal (->>) ou la fonction RESULT_SCAN. Les deux constructions traitent la sortie comme un jeu de résultats que vous pouvez interroger.

Par exemple, vous pouvez utiliser l’opérateur de canal ou la fonction RESULT_SCAN pour sélectionner des colonnes spécifiques à partir de la sortie de la commande SHOW ou pour filtrer les lignes.

Lorsque vous faites référence aux colonnes de sortie, utilisez des identificateurs entre guillemets doubles pour les noms des colonnes. Par exemple, pour sélectionner la colonne de sortie type, spécifiez SELECT "type".

Vous devez utiliser des identificateurs entre guillemets doubles, car les noms des colonnes de sortie pour les commandes SHOW sont en minuscules. Les guillemets doubles garantissent que les noms des colonnes dans la liste SELECT ou dans la clause WHERE correspondent aux noms des colonnes dans la sortie de la commande SHOW qui a été analysée.

Sortie¶

La sortie de la commande fournit des informations sur un objet Streamlit dans les colonnes suivantes :

Colonne	Description
`title`	Titre de l’objet Streamlit qui s’affiche dans Snowsight.
`main_file`	Nom du fichier de point d’entrée de l’application Streamlit.
`query_warehouse`	Entrepôt où sont exécutées les requêtes émises par l’application Streamlit.
`runtime_name`	Environnement d’exécution pour l’application Streamlit, comme `SYSTEM$ST_WAREHOUSE_RUNTIME_PY3_11` ou `SYSTEM$ST_CONTAINER_RUNTIME_PY3_11`.
`compute_pool`	Pool de calcul dans lequel l’application Streamlit s’exécute. Cette colonne n’est utilisée que pour les exécutions des conteneurs et est ignorée pour les exécutions des entrepôts.
`url_id`	ID unique associé à l’objet Streamlit.
`default_packages`	Paquets Python par défaut de l’application Streamlit.
`user_packages`	Paquets Python que l’utilisateur a spécifiés dans le fichier `environment.yml`. Cette colonne est vide s’il n’y a pas de fichier `environment.yml` et ne s’applique pas aux exécutions des conteneurs.
`import_urls`	Liste des URLs que l’application Streamlit importe. Cette colonne ne s’applique pas aux exécutions des conteneurs.
`external_access_integrations`	Liste des intégrations d’accès externe associées à l’objet Streamlit.
`external_access_secrets`	Liste des secrets d’accès externe associés à l’objet Streamlit.
`name`	Nom unique de l’objet Streamlit dans son schéma.
`comment`	Commentaire associé à l’objet Streamlit.
`default_version`	Version par défaut de l’objet Streamlit à utiliser lorsqu’il n’existe pas de version en ligne. Si votre application ne dispose pas encore d’une version en ligne et que le propriétaire ouvre l’application sur Snowsight, c’est cette version qui sera copiée vers la version en ligne.
`default_version_name`	Nom du répertoire de version par défaut dans le système de fichiers de l’objet Streamlit.
`default_version_alias`	Non pris en charge et toujours nul.
`default_version_location_uri`	URI d’emplacement des fichiers d’application de la version par défaut. En lecture seule.
`default_version_source_location_uri`	URI d’emplacement des fichiers sources de la version par défaut dans son objet Git. Si l’objet Streamlit n’est pas connecté à un objet Git, cette valeur est nulle.
`default_version_git_commit_hash`	Hachage de validation Git de la version par défaut de l’objet Streamlit. Si l’objet Streamlit n’est pas connecté à un objet Git, cette valeur est nulle.
`last_version_name`	Nom du répertoire de la dernière version dans le système de fichiers de l’objet Streamlit.
`last_version_alias`	Non pris en charge et toujours nul.
`last_version_location_uri`	URI d’emplacement des fichiers d’application de la dernière version. En lecture seule.
`last_version_source_location_uri`	URI d’emplacement des fichiers sources de la dernière version dans son objet Git. Si l’objet Streamlit n’est pas connecté à un objet Git, cette valeur est nulle.
`last_version_git_commit_hash`	Hachage de validation Git de la dernière version de l’objet Streamlit. Si l’objet Streamlit n’est pas connecté à un objet Git, cette valeur est nulle.
`live_version_location_uri`	URI d’emplacement de la version en ligne de l’objet Streamlit. Cet emplacement est accessible en lecture et en écriture. Les modifications dans Snowsight sont enregistrées à cet emplacement. Vous pouvez mettre à jour une application en ligne à distance en copiant des fichiers à cet emplacement.

Pour les objets Streamlit créés à l’aide du paramètre ROOT_LOCATION, la sortie de la commande fournit des informations dans les colonnes suivantes :

Colonne	Description
`name`	Nom unique de l’objet Streamlit dans son schéma.
`title`	Titre de l’objet Streamlit qui s’affiche dans Snowsight.
`root_location`	Emplacement des fichiers de l’objet Streamlit.
`main_file`	Chemin d’accès au fichier de point d’entrée de l’application Streamlit, relatif à l’emplacement racine.
`query_warehouse`	Entrepôt où sont exécutées les requêtes émises par l’application Streamlit.
`url_id`	ID unique associé à l’objet Streamlit.
`default_packages`	Paquets Python par défaut de l’application Streamlit.
`user_packages`	Paquets Python que l’utilisateur a spécifiés dans le fichier `environment.yml`. Vide s’il n’existe pas de fichier `environment.yml`.
`import_urls`	Liste des URLs que l’application Streamlit importe.
`external_access_integrations`	Liste des intégrations d’accès externe associées à l’objet Streamlit.
`external_access_secrets`	Liste des secrets d’accès externe associés à l’objet Streamlit.