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 à chaque page d’un classeur sur laquelle des scripts seront utilisés. 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

Procédez comme suit pour créer une connexion à un serveur Kernel Gateway dans Insights desktop :

1. Ouvrez un classeur. 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.

   Si aucune connexion n’est présente, la fenêtre New Jupyter Kernel Gateway connection (Nouvelle connexion à Jupyter Kernel Gateway) s’ouvre.

3. Saisissez l’URL et les adresses de socket web de votre 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 à un serveur Kernel Gateway peuvent être créées sur la page d’accueil ou dans un classeur.

Procédez comme suit pour créer une connexion à un serveur Kernel Gateway à partir de la page d’accueil :

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. Saisissez le nom que vous souhaitez donner à la connexion au serveur Kernel Gateway (par exemple, le nom de la machine sur laquelle la connexion a été créée) et l’URL du serveur Kernel Gateway. Le champ Web socket (Socket Web) est automatiquement rempli lorsqu’une URL valide est saisie.
5. Cliquez sur Save (Enregistrer).

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

Procédez comme suit pour créer une connexion à un serveur Kernel Gateway dans un classeur :

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

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

2. Cliquez sur l’onglet Add new (Ajouter nouveau).
3. Saisissez le nom que vous souhaitez donner à la connexion au serveur Kernel Gateway (par exemple, le nom de la machine sur laquelle la connexion a été créée) et l’URL du serveur Kernel Gateway. Le champ Web socket (Socket Web) est automatiquement rempli lorsqu’une URL valide est saisie.
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 votre session actuelle, cliquez sur le bouton Scripting (Script) 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 mettre à jour une connexion existante à un serveur Kernel Gateway à 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 la connexion, puis en cliquant sur Save (Enregistrer).