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

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.

FROM source_location

Kopiert die Quelldateien vom angegebenen Speicherort, um die Anwendung zu initialisieren. Dies geschieht einmal. Zum Beispiel FROM @streamlit_db.streamlit_schema.streamlit_stage.

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.

QUERY_WAREHOUSE = warehouse_name

Gibt das Warehouse an, in dem die von der Streamlit-Anwendung ausgegebenen SQL-Abfragen ausgeführt werden.

Bemerkung

Wenn Sie ein Streamlit-Anwendungsobjekt innerhalb des Snowflake Native App Framework erstellen oder ersetzen, ist der Parameter QUERY_WAREHOUSE optional.

Optionale Parameter

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.

ROOT_LOCATION = 'stage_path_and_root_directory'

Wichtig

ROOT_LOCATION ist ein Legacy-Parameter. Snowflake empfiehlt die Verwendung von FROM source_location.

Für Streamlit-Anwendungen, die mit ROOT_LOCATION erstellt wurden, werden die Bearbeitung mehrerer Dateien und die Git-Integration nicht unterstützt.

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

Nutzungshinweise

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

  • Metadaten:

    Achtung

    Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „User“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.

  • Die OR REPLACE- und IF NOT EXISTS-Klauseln schließen sich gegenseitig aus. Sie können nicht beide in derselben Anweisung verwendet werden.

  • 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 eine Streamlit-App aus einem Stagingbereich zu erstellen, führen Sie den Befehl CREATE STREAMLIT aus, wie im folgenden Beispiel gezeigt:

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

Um eine Streamlit-App aus einem Git-Repository zu erstellen, führen Sie den Befehl CREATE STREAMLIT aus, wie im folgenden Beispiel gezeigt:

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