Connexions aux données
Important
Pour simplifier le passage des connexions aux données jusqu'aux connexions DCM, à partir de la version 2024.2 de Server, il est possible de migrer toutes les connexions aux données et les workflows respectifs en vue de les remplacer par des connexions DCM.
Pour cela, il convient tout d'abord de migrer chaque connexion aux données, puis de déclencher la migration des workflows. Consultez l'article de blog sur notre communauté Maveryx intitulé How to migrate Server Data Connections to DCM (Migrer les connexions aux données de Server vers DCM) pour plus d'informations.
Note
Server-FIPS
Nous avons supprimé les connexions aux données de Server héritées. Vous pouvez utiliser le gestionnaire de connexions aux données (DCM) à la place. Le mode DCM Appliqué est activé et ne peut pas être modifié dans la version compatible FIPS de Server. Le mode DCM permet le stockage sécurisé des identifiants des utilisateurs pour les connexions aux données en dehors du workflow, une sécurité renforcée, une meilleure gestion des identifiants par mot de passe et la synchronisation des identifiants entre Server et Designer. Pour plus d'informations, consultez la page d'aide DCM - Server.
Sur la page Connexion aux données de l'interface d'administration de Server, les administrateurs (administrateurs Server) peuvent créer des connexions aux données Server pour permettre aux utilisateurs Server de se connecter aux bases de données. Une fois configurées, ces sources de données sont disponibles au sein d'une liste, où les utilisateurs qui ont ajouté Server peuvent les sélectionner et les utiliser.
Note
Les connexions aux données dans Server sont différentes de celles dans Designer. Consultez les pages Gérer les connexions aux données et Gérer les connexions en base de données pour plus d'informations sur les connexions aux données dans Designer.
Les connexions aux données Server ne sont pas disponibles pour les connexions en base de données.
Ajouter une connexion aux données
Sur la page Connexion aux données, sélectionnez + Nouveau.
Sélectionnez le type de connexion dans la liste déroulante Technologie.
Dans Nom, saisissez un nom de connexion.
Dans Hôte, saisissez le nom d'hôte de la base de données SQL.
Sélectionnez une option d'authentification.
Windows : utilisez les informations d'identification par défaut ou saisissez des informations d'identification spécifiques pour la connexion aux données.
SQL Server : saisissez les informations d'identification du serveur. Les barres verticales ne sont pas prises en charge dans les mots de passe.
(Facultatif) Sélectionnez Tester la connexion. Un message de vérification ou d'échec de la connexion s'affiche. Vous pouvez enregistrer une connexion si le test échoue.
(Facultatif) Sélectionnez Base de données pour afficher la liste des bases de données sur le serveur. Une liste s'affiche uniquement si le test de connexion a réussi.
Sélectionnez une base de données afin de la définir comme base de données par défaut pour cette connexion.
Sélectionnez Saisir un nom de base de données et saisissez le nom de la base de données sur le serveur. Assurez-vous que le nom contient une barre oblique inversée (\) dans le nom du serveur (RM-LT-013\SQLEXPRESS2, par exemple).
Sélectionnez Créer.
Tous les champs sont obligatoires. Après avoir complété les informations requises, testez la connexion.
Dans Nom, saisissez un nom de connexion.
Dans Hôte, entrez le nom d'hôte ou l'adresse IP du serveur Oracle.
(Facultatif) Dans Nom du service, saisissez le nom de l'application TNS sur le réseau. Cette information est facultative s'il n'existe qu'un seul service.
Dans Port, entrez le port d'écoute réseau de la base de données Oracle. La valeur par défaut est 1521.
Dans Nom d'utilisateur et Mot de passe, saisissez votre nom d'utilisateur et votre mot de passe afin de procéder à la connexion aux données. Les barres verticales ne sont pas prises en charge dans les mots de passe.
(Facultatif) Sélectionnez Tester la connexion. Un message de vérification ou d'échec de la connexion s'affiche. Vous pouvez enregistrer une connexion si le test échoue.
Sélectionnez Créer.
Dans Nom, saisissez un nom pour la connexion.
Saisissez une chaîne de connexion dans Chaîne de connexion.
Les chaînes de connexion doivent comporter 212 caractères maximum.
Les connexions qui n'utilisent pas de nom de source de données (DSN) sont recommandées. Ce type de connexion est également appelée connexion sans DSN.
Copier des chaînes de connexion à partir de Designer
Vous pouvez copier et coller des chaînes de connexion à partir de connexions aux données créées dans Designer. Pour ce faire, connectez-vous à Designer en tant qu'administrateur. Accédez à Options > Options avancées > Gérer les connexions aux données.
Sélectionnez Créer.
Tester les connexions aux données
Tests de connexion sur un Server à plusieurs nœuds
Une configuration à plusieurs nœuds de Server comporte un contrôleur et 2 machines worker ou plus. Dans cette configuration, la fonctionnalité de test permet de tester la connexion sur la machine du contrôleur et non sur les machines worker individuelles. Pour vous assurer que la connexion fonctionne sur n'importe quelle machine, vérifiez que des pilotes de base de données et des versions de pilote identiques sont installés sur chaque machine.
Échec des tests de connexion
Les tests de connexion peuvent échouer pour de nombreuses raisons. Voici les raisons les plus courantes.
Vous n'avez pas accès au serveur ou à la base de données. Dans certains cas, par exemple, seul l'utilisateur final de la connexion a le droit d'accéder au serveur ou à la base de données.
La sécurité réseau peut également vous empêcher de vous connecter au serveur ou à la base de données.
Server ne parvient pas à atteindre l'hôte du serveur de la base de données. Pour résoudre ce problème, envoyez une requête ping à l'hôte du serveur de la base de données pour vous assurer qu'il existe une connectivité réseau lorsqu'il est connecté au serveur sur lequel Server est installé.
Les informations d'identification de la base de données ne sont pas valides ou ne disposent pas des autorisations d'accès appropriées. Contactez l'administrateur de la base de données.
La base de données est hors ligne. Contactez l'administrateur de la base de données pour vérifier que la base de données est connectée et fonctionne comme prévu.
Vous exécutez une configuration à plusieurs nœuds de Server.
Vous pouvez toujours sauvegarder les connexions aux données qui échouent au test de connexion.
Informations d'identification par défaut utilisées lors des tests de connexion
Vous pouvez utiliser l'authentification Windows ou l'authentification SQL Server pour créer une connexion Microsoft SQL Server. Concernant l'authentification Windows, vous pouvez utiliser des informations d'identification par défaut ou des informations d'identification spécifiques pour la connexion aux données. Vous pouvez définir des informations d'identification par défaut à plusieurs emplacements. Le Server recherche les informations d'identification disponibles à ces emplacements et sélectionne celles par défaut dans l'ordre suivant :
Paramètres système > Worker > Exécuter en tant que. Accédez à la page d'aide Worker pour plus d'informations sur les comptes Exécuter en tant qu'utilisateur.
Gestionnaire de serveur Windows > Outils>Services. Localisez AlteryxService, cliquez avec le bouton droit de la souris et sélectionnez Propriétés. Les informations d'identification se trouvent sur l'onglet Connexion, sous Ce compte.
Machine locale.
Le test de connexion échoue si les informations d'identification ne sont pas valides.
Partager une connexion aux données
Après avoir créé une connexion aux données, revenez à la page Connexion aux données pour partager la connexion avec des utilisateurs ou des groupes personnalisés afin de l'utiliser dans Designer.
Important
Pour que le workflow soit exécuté par des utilisateurs ou des groupes spécifiques, vous devez contacter un administrateur (administrateur Server) afin de vous assurer que les connexions aux données nécessaires sont partagées avec eux.
Sur la page Connexions aux données, sélectionnez la connexion aux données que vous souhaitez partager.
Sur l'écran Modifier les connexions de données, sélectionnez Utilisateurs ou Groupes personnalisés.
Sélectionnez + Ajouter.
Saisissez le nom d'un utilisateur ou d'un groupe.
Sélectionnez l'utilisateur ou le groupe.
Sélectionnez Ajouter.
L'utilisateur, le groupe ou le studio avec lequel vous partagez la connexion est répertorié dans l'onglet correspondant. Consultez les pages Outil Entrée de données et Gérer les connexions aux données dans l'aide de Designer pour découvrir comment les utilisateurs accèdent aux connexions partagées et les gèrent dans Designer.
Important
Pour les connexions Microsoft SQL Server, vérifiez que l'utilisateur a installé la même version ou une version plus récente de Microsoft SQL Server Native Client sur son ordinateur. Accédez à la section Résolution des problèmes.
Révoquer l'accès à une connexion aux données
Pour annuler l'accès d'un utilisateur à une connexion, sélectionnez Supprimer dans le menu à trois points pour cet utilisateur. Pour confirmer, sélectionnez Supprimer.
Modifier une connexion aux données
Sur la page Connexion aux données, sélectionnez la connexion aux données à modifier.
Sur l'écran Modifier la connexion aux données, sélectionnez Modifier.
Modifiez les informations dans les champs Nom ou Chaîne de connexion.
Sélectionnez Enregistrer.
Dans les onglets Utilisateurs ou Groupes personnalisés, vous pouvez partager la connexion avec des utilisateurs et des groupes.
Supprimer une connexion aux données
Pour supprimer une connexion, sélectionnez Supprimer dans le Menu à 3 points de cette connexion. Ensuite, sélectionnez Supprimer.
Migrer les connexions aux données et les workflows vers DCM
Pour passer des connexions aux données aux connexions DCM, migrez toutes les connexions aux données et les workflows correspondants.
Migrer une connexion aux données vers DCM
Dans la première étape de la migration de la connexion aux données, il est nécessaire de lier la connexion aux données à une connexion DCM, afin de l'utiliser en remplacement dans les workflows. Alteryx va vous aider à trouver la bonne connexion DCM et à la partager avec le même ensemble d'utilisateurs et de groupes d'utilisateurs.
Sur la page de détails Connexion aux données, sélectionnez Migrer vers DCM.
Sur l'écran Migrer la connexion vers DCM, sélectionnez la connexion DCM à laquelle vous souhaitez associer la connexion aux données dans la liste de toutes les connexions DCM présentes sur Server.
Alteryx tente de trouver la connexion DCM la mieux adaptée et la charge dans la liste déroulante. Il regroupe également toutes les connexions DCM disponibles en catégories, en fonction du type de correspondance avec la connexion aux données de Server. Les groupes sont Correspondance parfaite, Correspondance partielle, Coffre-fort non résolu ou Sans correspondance. Pour plus d'informations sur ces groupes, voir Outil de migration.
Indiquez si vous souhaitez Partager avec des utilisateurs existants. Cela permet de partager la connexion DCM pour la collaboration avec le même ensemble d'utilisateurs et de groupes d'utilisateurs que la connexion aux données qui a été migrée. Cette option est activée par défaut.
Note
La connexion DCM est partagée pour la collaboration avec toutes les informations d'identification associées. Cela reflète le comportement de partage de connexion aux données, permettant aux utilisateurs de voir et d'utiliser la connexion DCM dans Alteryx Designer. Si vous souhaitez modifier les informations d'identification partagées avec d'autres utilisateurs, commencez par procéder au Partage pour collaboration, puis poursuivez la migration.
Pour pouvoir partager la connexion DCM avec d'autres personnes, vous devez en être le propriétaire. Vous pouvez toujours procéder à la migration de la connexion aux données, mais il revient alors au propriétaire de partager manuellement la connexion DCM.
Bien que les workflows utilisant des connexions aux données Server puissent être exécutés par n'importe quel utilisateur Server (avec autorisation sur le workflow), ce n'est pas le cas pour les connexions DCM. Le Partage pour l'exécution sur Server sur la connexion DCM doit être initialisé pour tous les utilisateurs qui exécuteront ce workflow.
Les connexions DCM ne peuvent pas être partagées avec les studios privés. Elles sont actuellement ignorées au cours de cette étape.
Sélectionnez Migrer.
À l'issue de ce processus, la connexion aux données est à l'état Migré. Cela signifie que la connexion aux données est toujours disponible pour tout le monde, mais elle ne peut plus être partagée ou modifiée, toutes ces actions n'étant maintenant disponibles que sur la connexion DCM. À ce stade, aucune modification n'est apportée aux workflows existants.
Il est possible de migrer de nouveau la connexion aux données, ce qui déclenche le processus de migration décrit ci-dessus. Cela permet de choisir une autre connexion DCM vers laquelle procéder à la migration. Remarque : cela n'a aucune répercussion sur le partage de la connexion DCM à partir de la migration initiale.
Migrer des workflows vers DCM
Après avoir lié les connexions DCM à vos connexions aux données, vous pouvez procéder à la migration du workflow. Ce processus analyse tous les workflows sur Server pour les connexions aux données et les remplace par les connexions DCM liées. Les workflows ne contenant aucune connexion aux données sont ignorés.
Sur la page de détails Connexion aux données, sélectionnez Migrer des workflows vers DCM.
Pour confirmer la migration du workflow, sélectionnez Migrer dans la boîte de dialogue Migrer des workflows.
Tous les workflows stockés sur Server sont ensuite vérifiés pour que les connexions aux données soient automatiquement remplacées par les connexions DCM associées.
Le workflow est migré uniquement lorsque toutes les connexions aux données utilisées dans ce workflow sont migrées vers DCM.
Une nouvelle version est créée pour chaque workflow migré.
Bien qu'il soit possible de lancer plusieurs fois la migration du workflow, une seule migration à la fois peut être exécutée sur Server.
L'état de la migration est visible en haut de la page Connexions aux données. Actualisez la page pour mettre à jour l'état actuel.
Technologies prises en charge et limitations
Les formats de fichier de workflow suivants sont pris en charge :
YXMD (workflow normal)
YXWZ (applications analytiques)
YXMC (macros)
Les connexions aux données téléchargées en tant que package de données (format YXZP) ne sont pas migrées, car elles n'incluent pas les métadonnées pour les connexions. Elles ne peuvent donc pas être migrées automatiquement.
Le workflow est migré uniquement lorsque toutes les connexions aux données utilisées dans ce workflow sont migrées vers DCM.
Tous les alias Server dans les outils Entrée de données et Sortie de données sont rassemblés et remplacés lors de la migration du workflow. Les autres outils ne sont pas pris en charge.
Dans une configuration Server à plusieurs nœuds, le journal de migration sera présent uniquement sur le nœud où la migration s'exécute. Il est choisi au hasard.
Résolution des problèmes
Non, vous pouvez créer et partager une connexion aux données sans la tester. Vous pouvez également sauvegarder une connexion aux données si un test de connexion échoue.
Les tests de connexion peuvent échouer pour de nombreuses raisons. Voici les raisons les plus courantes.
Vous n'avez pas accès au serveur ou à la base de données. Dans certains cas, par exemple, seul l'utilisateur final de la connexion a le droit d'accéder au serveur ou à la base de données.
La sécurité réseau peut également vous empêcher de vous connecter au serveur ou à la base de données.
Server ne parvient pas à atteindre l'hôte du serveur de la base de données. Pour résoudre ce problème, envoyez une requête ping à l'hôte du serveur de la base de données pour vous assurer qu'il existe une connectivité réseau lorsqu'il est connecté au serveur sur lequel Server est installé.
Les informations d'identification de la base de données ne sont pas valides ou ne disposent pas des autorisations d'accès appropriées. Contactez l'administrateur de la base de données.
La base de données est hors ligne. Contactez l'administrateur de la base de données pour vérifier que la base de données est connectée et fonctionne comme prévu.
Vous exécutez une configuration à plusieurs nœuds de Server. Accédez à la section Tester les connexions aux données de cet article pour obtenir des informations sur les tests de connexion sur un Server à plusieurs nœuds.
Vous pouvez toujours sauvegarder les connexions aux données qui échouent au test de connexion.
Vous pouvez utiliser l'authentification Windows ou l'authentification SQL Server pour créer une connexion Microsoft SQL Server. Concernant l'authentification Windows, vous pouvez utiliser des informations d'identification par défaut ou des informations d'identification spécifiques pour la connexion aux données. Vous pouvez définir des informations d'identification par défaut à plusieurs emplacements. Le Server recherche les informations d'identification disponibles à ces emplacements et sélectionne celles par défaut dans l'ordre suivant :
Paramètres système > Worker > Exécuter en tant que. Accédez à la page d'aide Worker pour plus d'informations sur les comptes Exécuter en tant qu'utilisateur.
Gestionnaire de serveur Windows > Outils>Services. Localisez AlteryxService, cliquez avec le bouton droit de la souris et sélectionnez Propriétés. Les informations d'identification se trouvent sur l'onglet Connexion, sous Ce compte.
Machine locale.
Le test de connexion échoue si les informations d'identification ne sont pas valides.
Il existe de nombreuses raisons pour lesquelles un utilisateur ne peut pas voir une connexion aux données Server dans Designer. Procédez comme suit pour résoudre le problème.
Confirmez que vous avez partagé la connexion aux données avec l'utilisateur. Modifiez la connexion aux données et recherchez l'utilisateur dans la liste.
Vérifiez que l'adresse e-mail utilisée par l'utilisateur pour se connecter à l'interface utilisateur Server est la même que celle avec laquelle vous avez partagé la connexion.
Demandez à l'utilisateur de supprimer le Server de Designer et de l'ajouter à nouveau en utilisant les bonnes informations d'identification.
Si vous partagez la connexion à un studio, vérifiez que l'utilisateur a accès à ce studio.
Un utilisateur peut recevoir cette erreur dans Designer ou Server lorsqu'il tente d'utiliser une connexion aux données créée sur une machine qui utilise une version du pilote Microsoft SQL Server différente de celle de la machine sur laquelle la connexion aux données est utilisée.
La machine doit avoir la même version ou une version plus récente d'un pilote Microsoft SQL Server. Par exemple, le message d'erreur s'affiche si la machine sur laquelle la connexion aux données est utilisée utilise la version 10.0 d'un pilote Microsoft SQL Server tandis que la machine sur laquelle a été créée la connexion aux données utilise la version 11.0.
L'utilisateur qui a créé le workflow dans Designer et l'a enregistré sur Server n'est peut-être pas autorisé à utiliser la connexion aux données partagée. Pour résoudre ce problème, procédez comme suit.
Ouvrez le journal AlteryxService (AlteryxServiceLog.log). Le journal de service est enregistré à un emplacement défini lors de la configuration. Accédez à Configurer et utiliser les journaux pour plus d'informations.
Recherchez l'horodatage du moment où l'erreur s'est produite et examinez la description de l'erreur.
Si la description indique « Impossible de trouver l'autorisation pour la connexion aux données : [nom de la connexion aux données] », l'utilisateur n'a pas accès à cette connexion aux données.
Modifiez la connexion aux données et partagez-la avec l'utilisateur.