CREATE STREAMLIT¶
Erstellt ein neues Streamlit-Anwendungsobjekt in Snowflake oder ersetzt ein vorhandenes Streamlit-Anwendungsobjekt in demselben Schema.
- Siehe auch:
SHOW STREAMLITS, DESCRIBE STREAMLIT, ALTER STREAMLIT, DROP STREAMLIT
Syntax¶
CREATE [ OR REPLACE ] STREAMLIT [ IF NOT EXISTS ] <name>
ROOT_LOCATION = '<stage_path_and_root_directory>'
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> [ , ... ] ) ]
Erforderliche Parameter¶
name
Gibt den Bezeichner (d. h. den Namen) des Streamlit-Objekts an. Dieser Bezeichner muss in dem Schema, in dem die Tabelle erstellt wird, eindeutig sein.
Darüber hinaus muss der Bezeichner mit einem Buchstaben beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B.
"My object"
). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.Weitere Details dazu finden Sie unter Anforderungen an Bezeichner.
ROOT_LOCATION = 'stage_path_and_root_directory'
Gibt den vollständigen Pfad zum benannten Stagingbereich an, der z. B. die Streamlit-Python-Dateien, die Mediendateien und die Datei
environment.yml
enthält:ROOT_LOCATION = '@streamlit_db.streamlit_schema.streamlit_stage'
In diesem Beispiel befinden sich die Streamlit-Dateien in einem benannten Stagingbereich namens
streamlit_stage
innerhalb einer Datenbank namensstreamlit_db
und einem Schema namensstreamlit_schema
.Bemerkung
Dieser Parameter muss auf ein einzelnes Verzeichnis innerhalb eines benannten internen Stagingbereichs verweisen.
Externe Stagingbereiche werden für Streamlit in Snowflake nicht unterstützt.
Wenn Sie ein Streamlit-Anwendungsobjekt innerhalb der Snowflake Native App Framework erstellen oder ersetzen, verwenden Sie
FROM 'relative_path_from_stage_root_directory'
und nichtROOT_LOCATION = 'stage_path_and_root_directory'
.
MAIN_FILE = 'path_to_main_file_in_root_directory'
Gibt den Dateinamen der Streamlit-Python-Anwendung an. Dieser Dateiname ist relativ zu dem Wert von
ROOT_LOCATION
.
Optionale Parameter¶
QUERY_WAREHOUSE = warehouse_name
Gibt das Warehouse an, in dem die von der Streamlit-Anwendung ausgegebenen SQL-Abfragen ausgeführt werden.
COMMENT = 'string_literal'
Gibt einen Kommentar für das Streamlit-Objekt an.
DEFAULT: Kein Wert
TITLE = 'app_title'
Gibt einen Titel für die Streamlit-App an, der in Snowsight angezeigt wird.
IMPORTS = ( 'stage_path_and_file_name_to_read' [ , ... ] )
Der Speicherort (Stagingbereich), der Pfad und der Name der zu importierenden Datei(en).
EXTERNAL_ACCESS_INTEGRATIONS = ( integration_name [ , ... ] )
Die Namen der Integrationen für den externen Zugriff, die benötigt werden, damit der Code der Streamlit-App auf externe Netzwerke zugreifen kann.
Nutzungshinweise¶
Alle Dateien in dem durch
ROOT_LOCATION
angegebenen Verzeichnis sind für die Streamlit-Laufzeitumgebung verfügbar. Dazu gehören die Python-Quelldatei,environment.yml
und Mediendateien.Wenn Sie ein Schema oder eine Datenbank klonen, die ein Streamlit-Objekt enthält, wird das Streamlit-Objekt nicht mitgeklont.
Um die von der Streamlit-Anwendung verwendeten Pakete anzugeben, verwenden Sie eine
environment.yml
-Datei im Stammverzeichnis.Metadaten:
Achtung
Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „Benutzer“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.
CREATE OR REPLACE <Objekt>-Anweisungen sind atomar. Das heißt, wenn ein Objekt ersetzt wird, erfolgt das Löschen des alten Objekts und das Erstellen des neuen Objekts in einer einzigen Transaktion.
Beispiele¶
Um ein STREAMLIT-Objekt zu erstellen, führen Sie den Befehl CREATE STREAMLIT aus, wie im folgenden Beispiel gezeigt:
CREATE STREAMLIT hello_streamlit
ROOT_LOCATION = '@streamlit_db.streamlit_schema.streamlit_stage'
MAIN_FILE = '/streamlit_main.py'
QUERY_WAREHOUSE = my_warehouse;