ALTER STREAMLIT¶

Ändert die Eigenschaften eines vorhandenen Streamlit-Objekts.

Siehe auch:: CREATE STREAMLIT, SHOW STREAMLITS, DESCRIBE STREAMLIT, DROP STREAMLIT

Syntax¶

ALTER STREAMLIT [ IF EXISTS ] <name> SET
  [ MAIN_FILE = '<filename>']
  [ QUERY_WAREHOUSE = <warehouse_name> ]
  [ COMMENT = '<string_literal>']
  [ TITLE = '<app_title>' ]
  [ IMPORTS = ( '<stage_path_and_file_name_to_read>' [ , ... ] ) ]
  [ EXTERNAL_ACCESS_INTEGRATIONS = ( <integration_name> [ , ... ] ) ]

ALTER STREAMLIT [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER STREAMLIT <name> COMMIT

ALTER STREAMLIT <name> PUSH [ TO <git_branch_uri> ]
  [
    {
      GIT_CREDENTIALS = <snowflake_secret>
      | USERNAME = <git_username> PASSWORD = <git_password>
    }
    NAME = <git_author_name>
    EMAIL = <git_author_email>
  ]
  [ COMMENT = <git_push_comment> ]

ALTER STREAMLIT <name> ABORT

ALTER STREAMLIT <name> PULL

ALTER STREAMLIT <name> ADD LIVE VERSION FROM LAST

Copy

Für Streamlit-Objekte, die mit ROOT_LOCATION erstellt wurden, wird nur die folgende Syntax unterstützt:

Wichtig

ROOT_LOCATION ist ein Legacy-Parameter und kann in einem zukünftigen Release veraltet sein. Für Streamlit-Apps, die mit ROOT_LOCATION erstellt wurden, wird die Bearbeitung mehrerer Dateien und die Git-Integration nicht unterstützt.

ALTER STREAMLIT [ IF EXISTS ] <name> SET
  [ ROOT_LOCATION = '<stage_path_and_root_directory>' ]
  [ MAIN_FILE = '<path_to_main_file>']
  [ QUERY_WAREHOUSE = <warehouse_name> ]
  [ COMMENT = '<string_literal>']
  [ TITLE = '<app_title>' ]
  [ IMPORTS = ( '<stage_path_and_file_name_to_read>' [ , ... ] ) ]
  [ EXTERNAL_ACCESS_INTEGRATIONS = ( <integration_name> [ , ... ] ) ]

ALTER STREAMLIT [ IF EXISTS ] <name> RENAME TO <new_name>

Copy

Parameter¶

name

Bezeichner für das Streamlit-Objekt. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

SET ...

Gibt die Eigenschaft an, die für das Streamlit-Objekt festgelegt werden soll:

MAIN_FILE = 'filename'

Gibt den Dateinamen der Streamlit-Einstiegspunkt-Datei an. Die Datei muss sich im Stammverzeichnis des Verzeichnisses der App befinden und die .py-Erweiterung enthalten.

Wenn Ihre App mit ROOT_LOCATION anstelle von FROM erstellt wurde, dann kann MAIN_FILE ein Pfad relativ zu ROOT_LOCATION sein.

QUERY_WAREHOUSE = warehouse_name

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

COMMENT = 'string_literal'

Fügt einen Kommentar hinzu oder überschreibt einen vorhandenen Kommentar für das Streamlit-Objekt.

TITLE = 'app_title'

Fügt einen Titel für die Streamlit-App hinzu, 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'

Gibt den Namen und das Präfix des Stagingbereichs an, der die Streamlit-Python-Dateien, die Mediendateien und die Datei environment.yml enthält. Dieser Parameter muss auf ein einzelnes Verzeichnis innerhalb eines benannten internen Stagingbereichs verweisen.

RENAME TO new_name

Gibt den neuen Bezeichner des Streamlit-Objekts an. Der Bezeichner muss für das Schema, in dem das Objekt erstellt wurde, eindeutig sein.

Weitere Informationen zu Bezeichnern finden Sie unter Anforderungen an Bezeichner.

COMMIT

Führt ein Commit für die ausstehenden Änderungen in der LIVE-Version auf eine neue LAST-Version aus. Unmittelbar nach dem Commit ist die LIVE-Version identisch mit der LAST-Version.

PUSH

Überträgt die neuesten Änderungen in das Git-Repository. Dabei wird der in der Basisversion gespeicherte Zweig verwendet, wenn TO git_branch_uri nicht angegeben ist.

Wenn die Basisversion nicht auf einem Git-Zweig basiert, wird ein Fehler ausgelöst.

TO git_branch_uri: Sendet übertragene Änderungen an den angegebenen Zweig.
GIT_CREDENTIALS = snowflake_secret: Gibt das Snowflake-Geheimnis an, das die Anmeldeinformationen enthält, die für die Authentifizierung mit dem Repository zu verwenden sind.
USERNAME = git_username: Gibt einen Git-Benutzernamen an.
PASSWORD = git_password: Gibt ein Git-Kennwort an.
NAME = git_author_name: Gibt den zu verwendenden Namen des Git-Autors an.
EMAIL = git_author_email: Gibt eine gültige E-Mail-Adresse an, die als Name des Git-Autors verwendet werden soll.
COMMENT = git_push_comment: Gibt einen Kommentar an, der in den Git-Push aufgenommen wird.

ABORT

Entfernt die aktuelle Live-Version der App, einschließlich aller in Snowsight vorgenommenen Änderungen, die nicht mit Commit bestätigt wurden.

PULL

Ruft die letzten Änderungen ab. Sie müssen die aktuelle Live-Version abbrechen, bevor Sie diese abrufen.

ADD LIVE VERSION FROM LAST

Erstellt eine neue Live-Version der App basierend auf der letzten bestätigten Version.

Wenn der Eigentümer einer Streamlit-App die App in Snowsight öffnet und keine Live-Version existiert, wird dieser Befehl automatisch ausgeführt. Wenn andere Benutzende die App besuchen und keine Live-Version vorhanden ist, wird ein Fehler zurückgegeben.

Anforderungen an die Zugriffssteuerung¶

Ihre Rolle muss die folgenden Berechtigungen für Objekte haben:

Berechtigung	Objekt
OWNERSHIP	Streamlit-Objekt, das Sie ändern

USAGE-Berechtigung für die übergeordnete Datenbank und das Schema ist erforderlich, um Operationen an einem beliebigen Objekt in einem Schema durchzuführen. Beachten Sie, dass eine Rolle, die eine beliebige Berechtigung für ein Schema erhalten hat, es dieser Rolle erlaubt, das Schema aufzulösen. Zum Beispiel kann eine Rolle, der die CREATE-Berechtigung für ein Schema gewährt wurde, Objekte in diesem Schema erstellen, ohne auch USAGE für dieses Schema gewährt bekommen zu haben.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Nutzungshinweise¶

Wenn Sie die Live-Version der App entfernen, können Benutzende die App erst wieder besuchen, wenn Sie eine der folgenden Aktionen ausführen:
- Führen Sie ALTER STREAMLIT … ADD LIVE VERSION FROM LAST für das Streamlit-Objekt aus.
- Rufen Sie die App in Snowsight mit der Rolle auf, der die App gehört.
Wenn Sie den Befehl ALTER STREAMLIT ausführen, während die Streamlit-App ausgeführt wird, werden die von Ihnen vorgenommenen Änderungen in der App nicht berücksichtigt.

Wenn Sie möchten, dass Ihre Änderungen in die App übernommen werden, müssen Sie die App neu laden oder neu starten.
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.