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

For Streamlit objects created with ROOT_LOCATION, only the following syntax is supported:

Wichtig

ROOT_LOCATION is a legacy parameter and may be deprecated in a future release. For Streamlit apps created using ROOT_LOCATION, multi-file editing and Git integration are not supported.

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'

Specifies the root stage name and prefix containing the Streamlit Python files, media files, and environment.yml file. This parameter must point to a single directory inside a named internal stage.

RENAME TO new_name

Specifies the new identifier for the Streamlit object. The identifier must be unique for the schema where the object was created.

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.

If the base version is not based on a Git branch, this throws an error.

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.