Anwendungspaket erstellen¶
Unter diesem Thema wird beschrieben, wie Sie mit dem Snowflake Native App Framework Anwendungspakete erstellen und verwalten.
Allgemeine Informationen zu Anwendungspaketen¶
Ein Anwendungspaket ist ein Container, der Dateninhalte, Anwendungslogik, Metadaten und das Setup-Skript kapselt, die für eine Anwendung erforderlich sind. Ein Anwendungspaket enthält außerdem Informationen zu den für die Anwendung definierten Versionen und Patch-Level (Revisionsnummern).
Anwendungspaket erstellen¶
Das Snowflake Native App Framework unterstützt das Erstellen eines Anwendungspakets über Snowsight. Sie können aber auch eine Anwendung erstellen, die SQL-Befehle ausführt.
Erforderliche Berechtigungen zum Erstellen eines Anwendungspakets¶
Um ein Anwendungspaket zu erstellen, muss Ihre Rolle über die globale Berechtigung CREATE APPLICATION PACKAGE verfügen.
Manifest-Datei und Setup-Skript in benannten Stagingbereich hochladen¶
Bevor Sie ein Anwendungspaket erstellen, müssen Sie die Manifest-Datei und das Setup-Skript erstellen und in einen benannten Stagingbereich hochladen, auf den Ihr Konto Zugriff hat.
Es gibt zwei Möglichkeiten, Dateien in einen benannten Stagingbereich hochzuladen:
Verwenden von Snowsight. Weitere Informationen dazu finden Sie unter Bereitstellen von Dateien im Stagingbereich mit Snowsight.
Verwenden des Befehls PUT.
Anwendungspaket mit Snowsight erstellen¶
Um ein Anwendungspaket mit Snowsight zu erstellen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Projects » App Packages aus.
Wählen Sie Create » App Package aus.
Geben Sie einen Namen für Ihr Anwendungspaket ein.
Wählen Sie den vorgesehenen Verbraucher für das Anwendungspaket aus:
Wählen Sie Consumers outside of your organization aus, um das Anwendungspaket außerhalb Ihrer Organisation zur Verfügung zu stellen. Wenn Sie diese Option auswählen, wird ein automatischer Sicherheitsscan für jede in Ihrem Anwendungspaket definierte Version und jeden definierten Patch gestartet.
Wählen Sie Consumers within your organization aus, um das Anwendungspaket innerhalb Ihrer Organisation zur Verfügung zu stellen. Der automatische Sicherheitsscan wird nicht gestartet.
Optional können Sie Kommentare zu einem Anwendungspaket eingeben. Diese Kommentare sind für den Verbraucher nicht sichtbar.
Wählen Sie Create aus.
Anwendungspaket mit SQL-Befehlen erstellen¶
Um ein Anwendungspaket mit SQL zu erstellen, verwenden Sie den Befehl CREATE APPLICATION PACKAGE wie im folgenden Beispiel gezeigt:
CREATE APPLICATION PACKAGE HelloSnowflakePackage;
Nachdem Sie ein Anwendungspaket erstellt haben, verwenden Sie den Befehl SHOW APPLICATION PACKAGES, um die Liste der verfügbaren Anwendungspakete anzuzeigen.
Berechtigungen für ein Anwendungspaket erteilen¶
Bei einigen Aufgaben im Zusammenhang mit der Entwicklung eines Anwendungspakets sind bestimmte Berechtigungen für das Anwendungspaket erforderlich. Die folgende Tabelle beschreibt die Berechtigungen, die zum Ausführen der Aufgaben erforderlich sind:
Berechtigung |
Aufgabe |
|---|---|
ATTACH LISTING |
Hinzufügen eines Anwendungspakets zu einem Freigabeangebot |
DEVELOP |
Erstellen eines APPLICATION-Objekts im Entwicklungsmodus aus dem Anwendungspaket |
INSTALL |
Erstellen eines APPLICATION-Objekts auf Basis des Anwendungspakets |
MANAGE RELEASES |
Angeben einer Release-Richtlinie, Anzeigen von Version und Patch-Level |
MANAGE VERSIONS |
Hinzufügen einer Version und eines Patch-Levels zu einem Anwendungspaket |
OWNERSHIP |
Ausführen aller oben genannten Aufgaben |
Berechtigungen für ein Anwendungspaket mit Snowsight erteilen¶
Um die Berechtigungen für ein Anwendungspaket mit Snowsight festzulegen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Projects » App Packages aus.
Wählen Sie das Anwendungspaket aus, und wählen Sie dann die Registerkarte Settings aus.
Wählen Sie im Bereich Privileges das Bearbeitungssymbol neben der Berechtigung aus, die Sie zuweisen möchten.
Wählen Sie Add Role aus, und wählen Sie dann die Rolle aus, der Sie die Berechtigung zuweisen möchten.
Wählen Sie Save aus.
Die Rolle wird neben der Berechtigung angezeigt.
Berechtigungen für ein Anwendungspaket mit SQL-Befehlen erteilen¶
Um einer Rolle mit SQL eine Berechtigung für das Anwendungspaket zuzuweisen, verwenden Sie den Befehl GRANT <Berechtigungen> wie im folgenden Beispiel gezeigt:
GRANT MANAGE RELEASES ON APPLICATION PACKAGE HelloSnowflakePackage TO ROLE app_release_mgr;
Mit diesem Befehl wird der Rolle app_release_mgr die Berechtigung MANAGE RELEASES zugewiesen. Sie können denselben Befehl verwenden, um die anderen Berechtigungen zuzuweisen, die für ein Anwendungspaket verfügbar sind.
Eigentümerschaft an einem Anwendungspaket übertragen¶
Nachdem Sie ein Anwendungspaket erstellt haben, können Sie die Eigentümerschaft an dem Anwendungspaket auf eine andere Rolle auf Kontoebene übertragen.
Eigentümerschaft mit Snowsight übertragen¶
Um die Eigentümerschaft an einem Anwendungspaket mit Snowsight zu übertragen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Projects » App Packages aus.
Wählen Sie neben dem Anwendungspaket, das Sie entfernen möchten, … aus, und wählen Sie dann Transfer Ownership aus.
Wählen Sie unter Transfer to die neue Rolle auf Kontoebene aus.
Wählen Sie Transfer aus.
Eigentümerschaft mit SQL-Befehlen übertragen¶
Um die Eigentümerschaft an einem Anwendungspaket mithilfe von SQL auf eine andere Rolle auf Kontoebene zu übertragen, verwenden Sie den Befehl GRANT OWNERSHIP wie im folgenden Beispiel gezeigt:
GRANT OWNERSHIP ON APPLICATION HelloSnowflakePackage TO ROLE native_app_dev;
Anwendungspaket aus Ihrem Konto entfernen¶
Benutzer mit der Berechtigung OWNERSHIP für ein Anwendungspaket können dieses aus einem Konto entfernen. Sie können jedoch kein Anwendungspaket entfernen, das derzeit einem Freigabeangebot zugeordnet ist.
Nachdem Sie ein Anwendungspaket entfernt haben, ist es im Anbieterkonto nicht mehr verfügbar.
Bemerkung
Nach dem Entfernen eines Freigabeangebots und des angehängten Anwendungspakets kann der Verbraucher die Snowflake Native App, die aus dem Anwendungspaket erstellt wurde, zwar anzeigen, aber nicht mehr darauf zugreifen. Wenn ein Verbraucher versucht, auf die Snowflake Native App zuzugreifen, wird eine Fehlermeldung angezeigt, die besagt, dass das Anwendungspaket entfernt wurde.
Anwendungspaket mit Snowsight entfernen¶
Um ein Anwendungspaket mit Snowsight zu entfernen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Projects » App Packages aus.
Wählen Sie neben dem Anwendungspaket, das Sie entfernen möchten, … aus, und wählen Sie dann Drop aus.
Anwendungspaket mit SQL-Befehlen entfernen¶
Um ein Anwendungspaket mit SQL zu entfernen, führen Sie den Befehl DROP APPLICATION PACKAGE wie im folgenden Beispiel aus:
DROP APPLICATION PACKAGE HelloSnowflakePackage;