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`	Title of the Streamlit object that displays in Snowsight.
`main_file`	Name of the Streamlit app’s entrypoint file.
`query_warehouse`	Warehouse where queries issued by the Streamlit app are run.
`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`	Python packages that the user specified in the `environment.yml` file. This is empty if there is no `environment.yml` file and doesn’t apply to container runtimes.
`import_urls`	List of URLs that the Streamlit app imports. This doesn’t apply to container runtimes.
`external_access_integrations`	List of external access integrations associated with the Streamlit object.
`external_access_secrets`	List of external access secrets associated with the Streamlit object.
`name`	Unique name of the Streamlit object within its schema.
`comment`	Comment associated with the Streamlit object.
`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`	Name of the default version directory within the Streamlit object’s file system.
`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`	Name of the last version directory within the Streamlit object’s file system.
`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`	Unique name of the Streamlit object within its schema.
`title`	Title of the Stramlit object that displays in 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`	Warehouse where queries issued by the Streamlit app are run.
`url_id`	ID unique associé à l’objet Streamlit.
`default_packages`	Default Python packages for the Streamlit app.
`user_packages`	Python packages that the user specified in the `environment.yml` file. This is empty if there is no `environment.yml` file.
`import_urls`	Liste des URLs que l’application Streamlit importe.
`external_access_integrations`	List of external access integrations associated with the Streamlit object.
`external_access_secrets`	List of external access secrets associated with the Streamlit object.