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> [ , ... ] ) ]
Copy

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'
Copy

In diesem Beispiel befinden sich die Streamlit-Dateien in einem benannten Stagingbereich namens streamlit_stage innerhalb einer Datenbank namens streamlit_db und einem Schema namens streamlit_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 nicht ROOT_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;
Copy