Les connexions de données disponibles dans l'éditeur de chargement de données et l'Script vous permettent d'enregistrer des raccourcis vers les sources de données que vous utilisez fréquemment : bases de données, fichiers locaux ou fichiers distants.
Connexions de données affiche les connexions que vous avez enregistrées par ordre alphabétique regroupées par les espaces auxquels elles appartiennent. Vous pouvez utiliser la zone de recherche pour réduire la liste aux connexions d'un certain type ou portant un certain nom. Vous pouvez accéder à Connexions de données en cliquant sur Sources de données.
Création d'une nouvelle connexion de données
Procédez comme suit :
-
Cliquez sur Sources de données.
- Cliquez sur Créer une connexion.
-
Sous Espace, sélectionnez l'espace dans lequel sera placée la connexion.
-
Dans la liste déroulante, sélectionnez le type de source de données que vous souhaitez créer.
La boîte de dialogue des paramètres propres au type de source de données sélectionné s'ouvre.
-
Configurez les paramètres de source de données, puis cliquez sur Créer pour créer la connexion de données.
Suppression d'une connexion de données
Procédez comme suit :
Cliquez sur Sources de données.
- Cliquez sur l'icône
de la connexion de données à supprimer. - Confirmez la suppression de la connexion.
La connexion de données est à présent supprimée.
Édition d'une connexion de données
Procédez comme suit :
Cliquez sur Sources de données.
Sous Connexions de données, sélectionnez l'espace contenant la connexion de données à modifier.
- Cliquez sur l'icône
de la connexion de données à modifier. Modifiez les détails de la connexion de données. Les détails de la connexion sont propres au type de connexion sélectionné.
Vous devrez peut-être fournir les informations d'identification de la connexion.
La connexion de données est à présent mise à jour.
À propos des connexions DataFiles
Des connexions DataFiles sont automatiquement créées pour chaque espace auquel vous avez accès. Les connexions sont disponibles à partir de chaque section d'espace sous Connexions de données.
Sélection de données à partir d'une connexion de données
Si vous souhaitez sélectionner des données à partir d'une connexion de données à charger dans votre application, procédez comme suit :
Cliquez sur Sources de données.
- Sélectionnez l'option Créer une connexion pour créer un lien vers la source de données (si la connexion de données n'existe pas encore).
- Choisissez
pour sélectionner des données à partir de la connexion.
Référence à une connexion de données dans le script
Vous pouvez utiliser une connexion de données pour faire référence à des sources de données dans des instructions et des fonctions au sein du script, généralement lorsque vous souhaitez faire référence à un nom de fichier en spécifiant un chemin d'accès.
Dans Qlik Cloud Analytics, la syntaxe permettant de faire référence à un fichier dans le script de chargement est la suivante :
[lib://(nom_d'espace):(nom_de_connexion)/(nom_de_dossier)/(nom_de_fichier)]
Le chemin d'accès au dossier complet doit être fourni. Les chemins d'accès relatifs ne sont pas supportés.
Si l'espace n'existe pas, l'instruction ne peut pas être exécutée et renvoie une erreur.
Le chemin d'accès au dossier peut inclure plusieurs dossiers dans une structure hiérarchique. Chaque nom_de_dossier du chemin d'accès doit être délimité par des caractères /.
Les éléments suivants ne sont pas autorisés dans le chemin d'accès lors du référencement de fichiers résidant dans une structure de dossiers :
//
\
\\
/./
/../
les symboles de point final (.) dans le nom de l'espace, du dossier ou du fichier sont acceptables à condition de ne pas apparaître dans les configurations de la liste ci-dessus.
Syntaxe non conforme
Ces exemples sont considérés comme une syntaxe non valide pour le chemin d'accès :
Selon le type d'instruction de script utilisé, une syntaxe non conforme peut entraîner l'échec du chargement ou être exécutée, mais avec un comportement différent. Pour des détails spécifiques, consultez :
Il est inutile d'ajouter la partie nom_espace dans le cas d'une connexion à un espace personnel.
Exemple : Chargement d'un fichier à partir d'une connexion DataFiles
Dans cet exemple, le fichier orders.csv est chargé à partir d'un espace personnel défini dans la connexion de données Data.
LOAD * FROM [lib://DataFiles/orders.csv];Dans cet exemple, le fichier orders.csv est chargé à partir d'un espace partagé défini dans la connexion de données Data.
LOAD * FROM [lib://TeamSharedConnection:DataFiles/orders.csv];Cet exemple charge le fichier orders_Europe.csv à partir du dossier Orders By Region dans un espace personnel.
LOAD * FROM [lib://DataFiles/Orders By Region/orders_Europe.csv];Cet exemple charge le fichier orders_Europe.csv à partir du dossier Orders By Region dans un espace partagé, un espace géré ou un espace de données. Le nom de l'espace est SalesSpace.
LOAD * FROM [lib://SalesSpace:DataFiles/Orders By Region/orders_Europe.csv];Cet exemple charge le fichier orders.csvà partir de l'espace actif. Si l'application est déplacée vers un autre espace, par exemple, elle utilisera le fichier orders.csv dans le nouvel espace.
LOAD * FROM [lib://:DataFiles/orders.csv];Exemple : Chargement d'une base de données dans l'espace personnel de l'utilisateur actif
Dans cet exemple, la table Sales_data est chargée à partir de la connexion de base de données DataSource dans l'espace personnel d'un utilisateur.
LIB CONNECT TO 'DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;Chargement d'une base de données dans un autre espace
Dans cet exemple, la table Sales_data est chargée à partir de la connexion de base de données DataSource dans l'espace actif.
LIB CONNECT TO ':DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;Chargement d'une base de données dans un espace spécifique
Dans cet exemple, la table Sales_data est chargée à partir de la connexion de base de données DataSource dans l'espace SalesSpace.
LIB CONNECT TO 'SalesSpace:DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;Chargement de données à partir de connexions analytiques
Les exemples suivants montrent comment écrire des expressions permettant de charger des données provenant de connexions analytiques. Utilisez la syntaxe SSE pour vous connecter aux données depuis une connexion analytique.
Ces exemples montrent comment utiliser les connexions dans des scripts. Pour des exemples montrant comment référencer des connexions analytiques dans des graphiques, consultez Utilisation de connexions analytiques et de la syntaxe server-side extension (SSE).
Chargement depuis une connexion analytique dans l'espace actuel
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":":Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});Chargement depuis une connexion analytique dans l'espace personnel du client actuel
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":"Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});Chargement depuis une connexion analytique dans un espace spécifique
Cet exemple charge des données de la connexion nommée Amazon_Titan_(Amazon_Bedrock) dans l'espace SalesSpace.
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":"SalesSpace:Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});