# Propriétés du tCosmosDBSQLAPIOutput Standard

Availability-note[subscription](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-subscription)

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

Le composant tCosmosDBSQLAPIOutput Standard appartient à la famille Bases de données NoSQL.

Le composant de ce framework est disponible dans les produits Talend nécessitant une souscription.

Note InformationsRemarque : Ce composant est disponible uniquement si vous avez installé la mise à jour mensuelle du Studio R2020-06 ou une mise à jour plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.

## Basic settings

| Property type | Peut être Built-in ou Repository .<br><br><ul> <li> <span>Built-in</span>&nbsp;: propriétés utilisées ponctuellement sans stockage dans le référentiel.</li> <li> <span>Repository</span>&nbsp;: 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 champs (colonnes) à traiter et à passer au composant suivant. Lorsque vous créez un Job Spark, évitez le mot réservé line lors du nommage des champs.<br><br><ul> <li> <p> <span>Built-in</span>&nbsp;: le schéma est créé et conservé localement pour ce composant seulement.</p> </li> <li> <p> <span>Repository</span>&nbsp;: le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé dans des Jobs et projets.</p> </li> </ul><br><br>Créez le schéma en cliquant sur le bouton Edit Schema.<br><br>Note InformationsRemarque : Si vous effectuez des modifications, le schéma passe automatiquement en type built-in.<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. 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> |
| URI | Saisissez l'URI de votre compte utilisateur·rice Cosmos. Comme le champ le demande, l'URI d'un compte utilisateur·rice Cosmos DB est au format https://{votre\_compte}.document.azure.com:443. Vous pouvez obtenir l'URI dans le panneau Keys du portail Azure portal. Consultez [Créer un compte Azure Cosmos](https://docs.microsoft.com/en-US/azure/cosmos-db/create-cosmosdb-resources-portal) (uniquement en anglais) pour plus d'informations. |
| Primary key | Saisissez la clé primaire de votre compte utilisateur·rice CosmosDB. Vous pouvez obtenir la clé primaire dans le panneau Keys du portail Azure portal. Consultez [Créer un compte Azure Cosmos](https://docs.microsoft.com/en-US/azure/cosmos-db/create-cosmosdb-resources-portal) (uniquement en anglais) pour plus d'informations. |
| Database ID | Saisissez le nom de la base de données. |
| Collection ID | Saisissez le nom de la collection. |
| Create collection if not exist | Sélectionnez cette option pour créer la collection spécifiée dans le champ Collection ID si elle n'existe pas. Cette option n'est pas disponible lorsque l'option Update ou Delete est sélectionnée dans la liste Data action. |
| Data action | Sélectionnez l'une des options suivantes :<br><br><ul> <li> <p> <span>Insert</span>&nbsp;: insère des documents.</p> </li> <li> <p> <span>Update</span> : remplace les documents existants par les données d'entrée mais conserve l'ID technique de ces documents.</p> </li> <li> <p> <span>Upsert</span> : insère un document s'il n'existe pas, sinon applique les mêmes règles que l'action <span>Update</span>.</p> </li> <li> <p> <span>Delete</span>&nbsp;: supprime les documents.</p> </li> </ul> |
| Auto ID generation | Sélectionnez cette option afin de générer des ID pour les documents traités. |

## Paramètres avancés

| tStatCatcher Statistics | Cochez cette case afin de collecter les données de log au niveau des composants. |
| --- | --- |
| Connection mode | Spécifiez le mode de connexion à utiliser. Deux options sont disponibles : Gateway et DirectHttps. Cliquez sur [ConnectionMode](https://learn.microsoft.com/en-US/java/api/com.microsoft.azure.cosmosdb.connectionmode?view=azure-java-archive&viewFallbackFrom=azure-java-legacy) (uniquement en anglais) pour plus d'informations. |
| Max connection pool size | Configurez la taille maximale du pool de connexions. La valeur par défaut est 1000. |
| Consistency level | Configurez le niveau de cohérence. Cliquez sur [Niveaux de cohérence dans Azure Cosmos DB](https://docs.microsoft.com/en-US/azure/cosmos-db/consistency-levels) (uniquement en anglais) pour plus d'informations. |
| Clé de partition | Saisissez la clé de la partition de laquelle supprimer les documents. Cette option est disponible lorsque l'option Delete est sélectionnée dans la liste Data action. |

## 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. |
| --- | --- |
| NB\_LINE | Nombre de lignes traitées. Cette variable est une variable After et retourne un entier. |

## Utilisation

| **Règle d'utilisation** | Le tCosmosDBSQLAPIOutput exécute l'action définie sur la collection dans la base de données, à partir du flux entrant depuis le composant précédent dans le Job. |
| --- | --- |