# tPineconeClient

Disponible dans...

* Cloud Data Fabric
* Data Fabric
* Qlik Talend Cloud Enterprise Edition
* Real-Time Big Data Platform

Ce composant effectue des upserts, des requêtes, des mises à jour ou des suppressions sur des enregistrements dans des espaces de noms d'index Pinecone.

Note InformationsRemarque :

Ce composant n'est pas intégré par défaut à votre Studio Talend. Vous devez l'installer à l'aide du gestionnaire des fonctionnalités. Pour plus d'informations, consultez [Installer les fonctionnalités à l'aide du Gestionnaire des fonctionnalités](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/install-features-to-talend-studio).

Pour une présentation rapide de l'utilisation de ce composant dans votre Job, visionnez la vidéo suivante :

## Propriétés du tPineconeClient Standard

Ces propriétés sont utilisées pour configurer le tPineconeClient s'exécutant dans le framework de Jobs Standard.

Le composant tPineconeClient Standard appartient à la famille IA.

Note InformationsRemarque : Ce composant est une version spécifique d'un connecteur à une base de données dynamique. Les propriétés associées aux paramètres de la base de données dépendent du type de base de données sélectionné. Pour plus d'informations concernant les connecteurs dynamiques de bases de données, consultez [Composants génériques de bases de données](https://help.qlik.com/talend/r/fr-FR/8.0/components/db-generic/db-generic-component).

## Basic settings

| Propriétés | Description |
| --- | --- |
| Base de données | Sélectionnez le type de base de données dans la liste et cliquez sur Apply (Appliquer). |
| Property type | Peut-être Built-In ou Repository.<br><br><ul> <li> <span>Built-In</span> : propriétés utilisées ponctuellement.</li> <li> <span>Repository</span> : sélectionnez le référentiel dans lequel sont stockées les propriétés. Les champs suivants sont automatiquement renseignés à l'aide des données récupérées.</li> </ul> |
| Schema et Edit Schema | Un schéma est une description de lignes, il définit le nombre de champ qui sont traités et passés au composant suivant. Le schéma est soit local (Built-in), soit distant dans le Repository.<br><br><ul> <li> <p> <span>Built-in</span>&nbsp;: le schéma est créé et stocké localement pour ce composant seulement. Pour plus d'informations concernant les schémas des composants dans l'onglet <span>Basic settings (Paramètres simples)</span>, consultez <a href="https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/basic-settings-tab" target="_blank">Onglet Basic settings</a>.</p> </li> <li> <p> <span>Repository</span>&nbsp;: le schéma existe déjà et est stocké dans le <span>Repository</span>. Ainsi, il peut être réutilisé dans des Jobs et projets. Pour plus d'informations concernant les schémas des composants dans l'onglet <span>Basic settings (Paramètres simples)</span>, consultez <a href="https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/basic-settings-tab" target="_blank">Onglet Basic settings</a>.</p> </li> </ul><br><br>Créez le schéma en cliquant sur le bouton Edit Schema. Si le schéma est en mode Repository, trois options sont disponibles :<br><br><ul> <li> <p> <span>View schema</span>&nbsp;: sélectionnez cette option afin de voir uniquement le schéma.</p> </li> <li> <p> <span>Change to built-in property</span>&nbsp;: sélectionnez cette option pour passer le schéma en mode <span>Built-In</span> et effectuer des modifications locales.</p> </li> <li> <p> <span>Update repository connection</span>&nbsp;: sélectionnez cette option afin de modifier le schéma stocké dans le référentiel et décider de propager ou non les modifications à tous les Jobs.</p> <p>Si vous souhaitez propager les modifications uniquement au Job courant, cliquez sur <span>No</span> et sélectionnez à nouveau la métadonnée du schéma dans la fenêtre <span>Repository Content</span>.</p> </li> </ul> |
| Sync columns | Cliquez sur ce bouton pour récupérer le schéma du composant précédent. |
| Guess schema | Cliquez sur ce bouton pour récupérer le schéma en fonction de vos paramètres. |
| Clé API | Saisissez la clé API Pinecone dans ce champ.<br><br>Pour saisir la clé brute (raw key), cliquez sur le bouton [...] près du champ correspondant pour ouvrir la boîte de dialogue Enter a new password, saisissez la clé dans le champ de texte et cliquez sur OK. Vous pouvez également utiliser une variable de contexte dans ce champ.<br><br>Pour plus d'informations concernant l'emplacement de votre clé d'API Pinecone, consultez [Authentication](https://docs.pinecone.io/guides/get-started/authentication) (en anglais). |
| Host | Saisissez l'adresse IP de la base de donnée Pinecone dans ce champ ou cliquez sur le bouton [...] près du champ pour la récupérer.<br><br>Vous pouvez également utiliser une variable de contexte dans ce champ. |
| Operation (Opération) | Sélectionnez l'opération à effectuer sur les données et les enregistrements de données entrants dans la table de base de données Pinecone :<br><br><ul> <li> <span>Upsert</span>&nbsp;: crée de nouveaux enregistrements et écrase les enregistrements existants dans l'espace de noms de l'index spécifié.</li> <li> <span>Query</span>&nbsp;: récupère l'ID des enregistrements les plus similaires dans l'index, avec leur score de similarité. Vous devez spécifier le nombre de résultats à retourner dans le champ <span>Top K</span>, en sachant que ce nombre est lié au nombre d'enregistrements existants&nbsp;: si vous saisissez 7 dans ce champ et que la base de données ne contient que cinq enregistrements, vous obtenez cinq enregistrements.</li> <li> <span>Fetch</span>&nbsp;: récupère les enregistrements par ID depuis l'espace de noms de l'index spécifié.</li> <li> <span>Update</span>&nbsp;: met à jour des enregistrements existants dans l'espace de noms de l'index spécifié.</li> <li> <span>Delete</span>&nbsp;: supprime des enregistrements de l'espace de noms de l'index spécifié. Si vous devez appliquer cette action sur tous les enregistrements de l'espace de noms de l'index spécifié, cochez la case <span>Delete all</span>.</li> <li> <span>Get index stats</span>&nbsp;: récupère les détails d'un index Pinecone.</li> </ul><br><br>Pour plus d'informations concernant ces opérations de données, consultez [Data](https://docs.pinecone.io/guides/data/upsert-data) (en anglais). |
| Namespace | Saisissez le nom de l'espace de noms d'index Pinecone sur lequel appliquer les opérations de données. |

## Advanced settings

| Propriétés | Description |
| --- | --- |
| tStatCatcher Statistics | Cochez cette case pour collecter les données de log au niveau du Job ainsi qu'au niveau de chaque composant. |
| Max batch size | Configurez le nombre maximal d'enregistrements autorisés dans chaque lot.<br><br>Pour plus d'informations concernant ces opérations de données, consultez [Upsert limits](https://docs.pinecone.io/guides/data/upsert-data#upsert-limits) (en anglais). |
| API version | Spécifiez la version de l'API Pinecone à utiliser dans vos requêtes.<br><br>Pour plus d'informations concernant le versionnement des API, consultez [Specifying an API version](https://docs.pinecone.io/reference/api/versioning#specifying-an-api-version) (en anglais). |
| Filter | Spécifiez une expression de filtre à utiliser lors d'une requête sur l'index Pinecone.<br><br>Pour plus d'informations concernant les expressions de filtre, consultez [Filter with metadata](https://docs.pinecone.io/guides/data/filter-with-metadata) (en anglais). |

## Variables globales

| Variables | Description |
| --- | --- |
| Variables globales | ERROR\_MESSAGE : message d'erreur généré par le composant lorsqu'une erreur survient. Cette variable est une variable After et retourne une chaîne de caractères. Cette variable fonctionne uniquement si la case Die on error est décochée, lorsque le composant contient cette case.<br><br>NB\_LINE : nombre de lignes lues par un composant d'entrée ou passées à un composant de sortie. Cette variable est une variable After et retourne un entier. |

**Tâches associées**

* [Indexer des évaluations de téléphones avec une base de données et des intégrations vectorielles](https://help.qlik.com/talend/fr-FR/components/8.0/ai/tembeddingai-tpineconeclient-tmap-indexing-phone-reviews-with-embeddings-and-vector-db "Ce Job lit des fichiers texte d'évaluations de téléphones depuis un dossier, scinde le contenu en morceaux plus petits pour une meilleure analyse, génère des intégrations vectorielles à l'aide d'Azure OpenAI et les stocke dans une base de données Pinecone vectorielle, pour implémenter la recherche sémantique.")