Modifier les notebooks dans les applications natives partagées de manière déclarative

Les Declarative Native Apps peuvent inclure des notebooks pour interroger, visualiser et explorer les données. Cette rubrique décrit comment utiliser l”édition active des notebooks pour rationaliser le développement et le test des notebooks au sein d’une application.

Grâce à la fonctionnalité Édition active des notebooks, vous pouvez accélérer le processus de développement en éditant et en testant des notebooks directement dans une application. Cela vous évite d’avoir à développer des notebooks en externe, ou de reconstruire le paquet d’application pour chaque modification.

L”édition active des notebooks utilise un mode de développement qui vous permet d’apporter des modifications aux notebooks « actifs » à l’intérieur d’une instance d’application. Vos modifications sont enregistrées dans une version active du paquet d’application, ce qui permet des tests et des itérations rapides et à la volée.

Fonctionnement

Le workflow utilise une version active de votre paquet d’application, qui fonctionne comme un environnement sandbox de développement. Ce tutoriel décrit comment configurer et utiliser la fonctionnalité d’édition active du notebook.

Étape 1 : Configurer l’environnement de développement

Pour commencer, vous avez besoin d’un paquet qui contient les éléments suivants :

  • Un fichier manifeste qui définit l’application et ses composants.

  • Un notebook que vous pouvez modifier et tester.

Vous créez ensuite une instance d’application à partir de la version active de votre paquet. La version active est créée automatiquement lorsque vous créez votre application.

  1. Créez le paquet.

    ALTER APPLICATION PACKAGE pkg_name BUILD;
    Copy

  2. Créez une instance d’application à partir de la version active. Les notebooks de cette nouvelle application seront automatiquement en mode développement, ce qui permet une édition active. Avant cette étape, les notebooks de l’application étaient en mode lecture seule.

    CREATE APPLICATION live_app_name
  FROM APPLICATION PACKAGE pkg_name
  USING VERSION LIVE;
    Copy

Étape 2 : Édition active et notebooks de test

Avec votre application live_app_name en cours d’exécution, dans SnowSight, ouvrez votre application dans la liste des applications de votre compte et ouvrez l’un de ses notebooks depuis sa page d’annonces. Après avoir créé l’application à partir du paquet d’application à l’étape précédente, les notebooks des applications seront en mode développeur. Vous pouvez maintenant procéder comme suit :

  • Modifiez les cellules du notebook directement dans le navigateur.

  • Exécutez et testez votre code immédiatement dans le contexte de l’application.

Toutes les modifications que vous apportez sont instantanément enregistrées dans la version active du paquet d’application pkg_name. Cela vous permet d’itérer rapidement les modifications apportées à votre application, sans avoir besoin d’effectuer une version complète du paquet pour chaque ajustement mineur.

Étape 3 : Finaliser et publier les modifications

Lorsque vous êtes satisfait de l’état de vos notebooks, vous pouvez passer de la version active à une version stable. Cette opération gèle l’état actuel de vos notebooks et les intègre dans une version permanente de l’application. Le framework des applications crée automatiquement un numéro de version pour votre version.

  • Publiez la version active pour finaliser votre travail.

ALTER APPLICATION PACKAGE pkg_name RELEASE LIVE VERSION;
Copy

Cette commande crée une nouvelle version immuable de votre paquet d’application contenant toutes les modifications de notebook que vous avez apportées. Pour plus d’informations sur le paquet d’application et la version active, consultez Paquets d’application dans le partage déclaratif du framework des applications natives.

Langage: Français