Se connecter à un serveur Kernel Gateway

Remarque :

L’environnement de script Insights est disponible dans Insights in ArcGIS Enterprise et Insights desktop. La connexion principale peut utiliser Insights in ArcGIS Enterprise ou Insights in ArcGIS Online.

Les connexions Jupyter Kernel Gateway peuvent être désactivées pour une organisation Insights in ArcGIS Enterprise au cours du processus d’installation. Contactez votre administrateur si les connexions Jupyter Kernel Gateway ne sont pas disponibles. Pour plus d’informations, reportez-vous à la rubrique Installer Insights in ArcGIS Enterprise.

Une connexion Jupyter Kernel Gateway permet d’accéder aux noyaux dans l’environnement de script Insights, dans lequel vous pouvez créer et exécuter des scripts Python et R. Les connexions que vous créez persistent sur une seule page de classeur. Une connexion doit être créée ou appliquée sur chaque page d’un classeur utilisant des scripts. L’enregistrement du classeur enregistrera également les connexions sur les pages.

Vous devez configurer un serveur Jupyter Kernel Gateway avant de créer une connexion à la passerelle.

Créer une connexion

La méthode utilisée pour créer une connexion Jupyter Kernel Gateway dépend de votre déploiement Insights. Dans Insights desktop, la connexion est créée et enregistrée dans un classeur individuel. Dans Insights in ArcGIS Enterprise, les connexions peuvent être créées sur la page d’accueil ou dans un classeur, puis utilisées dans tous les classeurs individuels.

Insights desktop

Pour créer une connexion Kernel Gateway dans Insights desktop, procédez comme suit :

1. Ouvrez un classeur et sélectionnez les données à ajouter au classeur, le cas échéant.

   Conseil :

   Vous pouvez également charger des données depuis l’environnement de scripts.

2. Cliquez sur le bouton Scripting (Scripts)  dans la barre d’outils du classeur.

   S’il n’existe aucune connexion, la fenêtre New Jupyter Kernel Gateway connection (Nouvelle connexion à Jupyter Kernel Gateway) s’ouvre.

3. Saisissez l’URL et l’adresse WebSocket du serveur Jupyter Kernel Gateway dans les zones de texte.
4. Cliquez sur Connect (Connecter).

Une fois la connexion créée, vous pouvez utiliser le menu Select Kernel (Sélectionner Kernel) pour choisir un langage de programmation (Python ou R) et commencer à utiliser l’environnement de script.

Insights in ArcGIS Enterprise

Dans Insights in ArcGIS Enterprise, les connexions Kernel Gateway peuvent être créées sur la page d’accueil ou dans un classeur.

Pour créer une connexion Kernel Gateway à partir de la page d’accueil, procédez comme suit :

1. Sur la page d’accueil, cliquez sur l’onglet Connections (Connexions) .
2. Cliquez sur New connection (Nouvelle connexion).

   Un menu affiche les types de connexions pouvant être créées.

3. Sélectionnez Kernel Gateway comme type de connexion.

   La fenêtre Kernel Gateway connection (Connexion à un serveur Kernel Gateway) s’ouvre.

4. Indiquez un nom pour la connexion Kernel Gateway (par exemple, le nom de la machine sur laquelle la connexion a été créée) ainsi que l’URL du serveur Kernel Gateway.

   Le champ Web socket (WebSocket) est automatiquement renseigné lorsqu’une URL valide est indiquée.

5. Cliquez sur Save (Enregistrer).

La connexion à Jupyter Kernel Gateway est ajoutée sur la page Connections (Connexions).

Pour créer une connexion Kernel Gateway dans un classeur, procédez comme suit :

1. Cliquez sur le bouton Scripting (Scripts)  dans la barre d’outils du classeur.

   La fenêtre Kernel Gateway connection (Connexion Kernel Gateway) s’ouvre sur l’onglet Select a Kernel Gateway (Sélectionner un serveur Kernel Gateway) actif.

2. Cliquez sur l’onglet Add new (Ajouter nouveau).
3. Indiquez un nom pour la connexion Kernel Gateway (par exemple, le nom de la machine sur laquelle la connexion a été créée) ainsi que l’URL du serveur Kernel Gateway.

   Le champ Web socket (WebSocket) est automatiquement renseigné lorsqu’une URL valide est indiquée.

4. Cliquez sur Connect (Connecter).

L’environnement de script Insights se connecte à Jupyter Kernel Gateway. La connexion au serveur Kernel Gateway est également ajoutée à l’onglet Connections (Connexions) de la page d’accueil.

Modifier une connexion

Si vous avez déjà créé une connexion dans la session actuelle, cliquez sur le bouton Scripting (Écriture de scripts) pour ouvrir la fenêtre Jupyter Kernel Gateway. Vous pouvez établir la connexion avec une autre passerelle à l’aide du bouton Switch Connections (Permuter les connexions) .

Si vous utilisez un déploiement Insights in ArcGIS Enterprise qui repose sur ArcGIS Enterprise version 10.8 ou supérieure, vous pouvez également modifier une connexion Kernel Gateway existante à partir de l’onglet Connections (Connexions) de la page d’accueil en cliquant sur le nom de la connexion, en mettant à jour les paramètres de connexion, puis en cliquant sur Save (Enregistrer).