Eine App lokal installieren und testen¶

DEVELOP-Berechtigung verwenden¶

Standardmäßig verfügt die Rolle, mit der Sie ein Anwendungspaket erstellen, über die Berechtigungen, mit dem Befehl CREATE APPLICATION eine Anwendung auf Basis des Anwendungspakets zu erstellen.

In einigen Entwicklungsumgebungen müssen Sie jedoch Benutzern mit anderen Rollen erlauben, ein Anwendungspaket zu erstellen und zu testen. Erteilen Sie dazu einer Rolle die DEVELOP-Berechtigung auf Objektebene für das Anwendungspaket.

Die Berechtigung DEVELOP gewährt die erforderlichen Berechtigungen zum Erstellen und Testen einer Anwendung auf Basis eines Anwendungspakets. Mit dieser Berechtigung kann ein Benutzer die folgenden Aufgaben mit dem Anwendungspaket ausführen, auf das er Zugriff erhalten hat:

• Erstellen einer Anwendung auf Basis einer im Anwendungspaket angegebenen Version oder eines Patches.

• Mithilfe des Befehls ALTER APPLICATION auf eine andere Version einer Anwendung aktualisieren.

• Erstellen oder Aktualisieren einer Anwendung mit Dateien in einem benannten Stagingbereich.

• Aktivieren des Debug-Modus für eine Anwendung, die im Entwicklungsmodus erstellt wurde.

Um einer Rolle die Berechtigung DEVELOP zu erteilen, verwenden Sie den Befehl GRANT <Berechtigungen> … TO ROLE wie im folgenden Beispiel gezeigt:

GRANT DEVELOP ON APPLICATION PACKAGE hello_snowflake_package TO ROLE other_dev_role;

Erstellen Sie eine Anwendung mit Stagingdateien¶

Sie können eine Anwendung mithilfe einer Manifestdatei und eines Setup-Skripts erstellen, die in einen benannten Stagingbereich hochgeladen werden. So können Sie Änderungen an diesen Dateien testen, ohne eine neue Version zu einem Anwendungspaket hinzufügen zu müssen.

Verwenden Sie den Befehl CREATE APPLICATION, um eine Anwendung mit Stagingdateien zu erstellen, wie im folgenden Beispiel gezeigt:

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package
  USING '@hello_snowflake_code.core.hello_snowflake_stage';

Eine Anwendung aus einer Version oder einem Patch erstellen¶

Nachdem Sie eine Version oder einen Patch in einem Anwendungspaket definiert haben, können Sie eine Anwendung erstellen, die auf dieser Version oder diesem Patch basiert.

Um eine Anwendung aus einer bestimmten Version zu erstellen, verwenden Sie den Befehl CREATE APPLICATION wie im folgenden Beispiel gezeigt:

CREATE APPLICATION hello_snowflake_app
  FROM APPLICATION PACKAGE hello_snowflake_package
  USING VERSION v1_0;

Um eine Anwendung aus einem bestimmten Patch zu erstellen, verwenden Sie den Befehl CREATE APPLICATION wie im folgenden Beispiel gezeigt:

CREATE APPLICATION hello_snowflake_app
  FROM APPLICATION PACKAGE hello_snowflake_package
  USING VERSION v1_0 PATCH 2;

Eine Anwendung auf der Grundlage einer Release-Richtlinie erstellen¶

Nachdem Sie eine Release-Richtlinie – entweder benutzerdefiniert oder standardmäßig – in einem Anwendungspaket angegeben haben, können Sie eine Anwendung erstellen, die auf dieser Release-Richtlinie basiert.

Um eine Anwendung auf der Grundlage einer Release-Richtlinie zu erstellen, verwenden Sie den Befehl CREATE APPLICATION wie im folgenden Beispiel gezeigt:

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package;

Aktualisieren einer Anwendung über einen Stagingbereich¶

Um eine Anwendung mit Dateien in einem benannten Stagingbereich zu aktualisieren, verwenden Sie den Befehl ALTER APPLICATION wie im folgenden Beispiel gezeigt:

ALTER APPLICATION HelloSnowflake
  UPGRADE USING @CODEDATABASE.CODESCHEMA.AppCodeStage;

Aktualisieren einer Anwendung von einer Version oder einem Patch¶

Um eine Anwendung zu aktualisieren, die mit einer bestimmten Version oder einem bestimmten Patch erstellt wurde, verwenden Sie den Befehl ALTER APPLICATION wie im folgenden Beispiel gezeigt:

ALTER APPLICATION HelloSnowflake
 UPGRADE USING VERSION "v1_1";

Allgemeine Informationen zum Entwicklungsmodus¶

Wenn Sie eine Anwendung lokal aus einem Anwendungspaket erstellen, indem Sie eine Version oder Anwendungsdateien in einem benannten Stagingbereich angeben, wird die Anwendung als im Entwicklungsmodus befindlich betrachtet.

Verwenden Sie den Entwicklungsmodus, um eine Anwendung innerhalb eines einzigen Kontos zu testen und Fehler zu beheben. Im Entwicklungsmodus können Sie eine Anwendung erstellen und testen, die auf einer bestimmten Version eines Anwendungspakets basiert. Sie können eine Anwendung auch mit Anwendungsdateien in einem Stagingbereich erstellen und testen. So können Sie Änderungen am Setup-Skript oder an der Anwendungslogik schnell testen.

Der Entwicklungsmodus bietet einen zusätzlichen Debug-Modus, mit dem Sie alle Objekte innerhalb einer Anwendung anzeigen und testen können, die ein Verbraucher nicht sehen kann.

Wenn Sie im Entwicklungsmodus z. B. die Befehle SHOW oder DESC für Objekte innerhalb der Anwendung ausführen, werden nur die Objekte angezeigt, für die der Benutzer eine Berechtigung zur Anzeige erhalten hat. Im DEBUG-Modus können Sie jedoch alle Objekte innerhalb der Anwendung sehen.

Allgemeine Informationen zum Debug-Modus¶

Im Debug-Modus können Sie alle Objekte innerhalb einer Anwendung anzeigen und ändern. In diesem Modus sind Objekte sichtbar, die als Verbraucher nicht sichtbar wären, z. B. Objekte, die keiner Datenbankrolle zugewiesen sind, oder freigegebene Inhaltsobjekte.

Das Testen einer Anwendung im Debug-Modus erfordert Folgendes:

• Die Anwendung muss im Entwicklungsmodus erstellt werden, d. h. sie muss auf einer bestimmten Version oder Dateien in einem Stagingbereich basieren.

• Sie müssen den Debug-Modus in der Anwendung explizit aktivieren.

Um den Debug-Modus für eine Anwendung zu aktivieren, verwenden Sie den Befehl ALTER APPLICATION wie im folgenden Beispiel gezeigt:

ALTER APPLICATION hello_snowflake_app SET DEBUG_MODE = TRUE;

Dieser Befehl aktiviert den Debug-Modus für eine Anwendung namens hello_snowflake_app. Um den Debug-Modus zu deaktivieren, verwenden Sie denselben Befehl wie im folgenden Beispiel:

ALTER APPLICATION hello_snowflake_app SET DEBUG_MODE = FALSE;

Dieser Befehl deaktiviert den Debug-Modus für die Anwendung namens hello_snowflake_app.

Erforderliche Berechtigungen zur Verwendung des Sitzungs-Debug-Modus¶

Die Verwendung des Sitzungs-Debug-Modus zur Anzeige von Objekten in einer Anwendung hat folgende Voraussetzungen:

• Die Anwendung muss im Entwicklungsmodus erstellt werden. Dazu muss sie auf Basis einer bestimmten Version oder von Dateien erstellt werden, die sich in einem Stagingbereich befinden.

• Die Anwendung muss sich im selben Konto befinden wie das Anwendungspaket, auf dem sie basiert.

• Sie müssen über die Berechtigung OWNERSHIP für die Anwendung verfügen.

• Sie müssen über die Berechtigung DEVELOP für das Anwendungspaket verfügen.

Sitzungs-Debug-Modus für eine Anwendung aktivieren¶

Um den Sitzungs-Debug-Modus für eine Anwendung in der aktuellen Sitzung zu aktivieren, verwenden Sie die Systemfunktion SYSTEM$BEGIN_DEBUG_APPLICATION wie im folgenden Beispiel gezeigt:

SELECT SYSTEM$BEGIN_DEBUG_APPLICATION(‘hello_snowflake_app’);

Diese Funktion aktiviert den Sitzungs-Debug-Modus für die Anwendung mit dem Namen hello_snowflake_app.

Sie können das Sitzungs-Debugging auch aktivieren, indem Sie den Ausführungsmodus für die Anwendung angeben wie im folgenden Beispiel gezeigt:

SYSTEM$BEGIN_DEBUG_APPLICATION( 'hello_snowflake_app', execution_mode ='AS_APPLICATION')

Diese Funktion setzt den Ausführungsmodus der Anwendung hello_snowflake_app auf AS_APPLICATION. In diesem Modus werden alle Anweisungen mit denselben Berechtigungen ausgeführt, welche die Anwendung hat, wenn sie im Benutzerkonto erstellt wird.

Den Sitzungs-Debug-Status für eine Anwendung in der aktuellen Sitzung anzeigen¶

Um den Sitzungs-Debug-Status in der aktuellen Sitzung anzuzeigen, verwenden Sie die Systemfunktion SYSTEM$GET_DEBUG_STATUS wie im folgenden Beispiel gezeigt:

SELECT SYSTEM$GET_DEBUG_STATUS();

Sitzungs-Debug-Modus für eine Anwendung deaktivieren¶

Um den Sitzungs-Debug-Modus für eine Anwendung in der aktuellen Sitzung zu deaktivieren, verwenden Sie die Systemfunktion SYSTEM$END_DEBUG_APPLICATION wie im folgenden Beispiel gezeigt:

SELECT SYSTEM$END_DEBUG_APPLICATION();

Erforderliche Berechtigungen zum Deaktivieren der Schwärzung von Anbieterdaten beim Testen einer Anwendung¶

Die Deaktivierung der Schwärzung von Anbieterdaten für eine Anwendung erfordert die folgenden Berechtigungen:

• Die Anwendung muss im Entwicklungsmodus erstellt werden, d. h. sie muss auf einer bestimmten Version oder Dateien in einem Stagingbereich basieren.

• Die Anwendung muss im selben Konto erstellt werden, das auch das Anwendungspaket enthält.

• Sie müssen über die Berechtigung OWNERSHIP für die Anwendung verfügen.

• Sie müssen über die Berechtigung DEVELOP für das Anwendungspaket verfügen.

Schwärzung von Anbieterdaten deaktivieren¶

Um Informationen für eine Anwendung zu deaktivieren, verwenden Sie den Befehl ALTER APPLICATION wie im folgenden Beispiel gezeigt:

ALTER APPLICATION hello_snowflake_app SET DISABLE_APPLICATION_REDACTION = TRUE;

Dieser Befehl deaktiviert die Schwärzung von Anbieterdaten für eine Anwendung namens hello_snowflake_app.

Um die Schwärzung von Anbieterdaten zu aktivieren, verwenden Sie denselben Befehl wie im folgenden Beispiel:

ALTER APPLICATION hello_snowflake_app SET DISABLE_APPLICATION_REDACTION = FALSE;

Unterschiede im Entwicklungsmodus¶

Im Entwicklungsmodus werden Apps auf der Grundlage einer der folgenden Möglichkeiten erstellt:

• In einen Stagingbereich hochgeladene Dateien.

• Versionen oder Patches, die in dem Anwendungspaket definiert sind.

Wenn Sie die Ereignisfreigabe lokal im Entwicklungsmodus testen, gibt es Unterschiede in der Verhaltensweise gegenüber Apps, die aus einem Freigabeangebot erstellt wurden.

• Die globale Berechtigung MANAGE EVENT SHARING ist nicht erforderlich, um die Ereignisfreigabe zu aktivieren.

• Freigegebene Ereignisse werden in lokalen Ereignistabellen gesammelt. In der lokalen Ereignistabelle können Anbieter zwei Einträge für ein Ereignis sehen:

  • Das Ereignis, das die App auf der Verbraucherseite ausgibt, wenn die App installiert wird.

  • Das Ereignis, das für den Anbieter freigegeben ist.

Ereignisfreigabe im Entwicklungsmodus testen¶

1. Konfigurieren Sie die App so, dass die Protokollierung und Ablaufverfolgung von Ereignissen verwendet.

2. Richten Sie eine Ereignistabelle im lokalen Entwicklungskonto ein.

3. Erstellen Sie die App lokal, indem Sie einen der folgenden Befehle ausführen:

   CREATE APPLICATION hello_snowflake_app
     FROM APPLICATION PACKAGE hello_snowflake_package
     USING @path_to_staged_files
     AUTHORIZE_TELEMETRY_EVENT_SHARING = TRUE;
   
   CREATE APPLICATION hello_snowflake_app
     FROM APPLICATION PACKAGE hello_snowflake_package
     USING VERSION v1_0
     PATCH 0
     AUTHORIZE_TELEMETRY_EVENT_SHARING = TRUE;
   

   Copy

4. Anzeigen der Protokollmeldungen und Ablaufverfolgungsereignisse in der Ereignistabelle.