# Propriétés du tOracleConfiguration pour Apache Spark Batch

Ces propriétés sont utilisées pour configurer le tOracleConfiguration s'exécutant dans le framework de Jobs Spark Batch.

Le composant tOracleConfiguration Spark Batch appartient aux familles Stockage et Bases de données.

Le composant de ce framework est disponible dans tous les produits Talend avec Big Data nécessitant une souscription et dans Talend Data Fabric.

## Basic settings

| Propriétés | Description |
| --- | --- |
| Property type | Peut être Built-In ou Repository.<br><br>Built-In : aucune propriété n'est stockée de manière centrale.<br><br>Repository : Sélectionnez le fichier dans lequel sont stockées les propriétés du composant. |
| Connection type | Les pilotes disponibles sont :<br><br><ul> <li> <p> <span>Oracle OCI</span>&nbsp;: sélectionnez ce type de connexion pour utiliser l'interface d'appel d'Oracle (Oracle Call Interface) accompagnée d'un ensemble de logiciels API de langage C qui fournissent une interface à la base de données Oracle.</p> </li> <li> <p> <span>Oracle Custom</span>&nbsp;: sélectionnez ce type de connexion pour accéder à une base de données contenant des clusters. Avec ce type de connexion, les champs <span>Username</span> et <span>Password</span> sont désactivés et vous devez saisir l'URL de connexion dans le champ <span>URL</span> qui s'affiche.</p> <p>Pour plus d'informations concernant la forme valide d'URL, consultez <a href="http://www.dba-resources.com/oracle/jdbc-connection-strings-for-oracle-thin-driver/" target="_blank">JDBC Connection strings</a> (en anglais) dans la documentation Oracle.</p> </li> <li> <p> <span>Oracle Service Name&nbsp;</span>: sélectionnez ce type de connexion pour utiliser l'alias TNS que vous fournissez lorsque vous vous connectez à la base de données distante. </p> </li> <li> <p> <span>WALLET</span>&nbsp;: sélectionnez ce type de connexion pour stocker les informations d'authentification dans un portefeuille (wallet) Oracle.</p> </li> <li> <p> <span>Oracle SID</span>&nbsp;: sélectionnez ce type de connexion pour identifier exclusivement une base de données spécifique sur un système.</p> </li> </ul> |
| DB Version | Sélectionnez la version de la base de données Oracle à utiliser. |
| Utiliser fichier TNS | Cochez cette case pour utiliser les métadonnées d'un contexte contenu dans un fichier Tns.<br><br>Un fichier TNS peut contenir plusieurs contextes.<br><br>TNS File : renseignez manuellement le chemin d'accès ou cliquez sur le bouton [...] pour parcourir vos dossiers jusqu'au fichier.<br><br>Select a DB Connection in Tns File : cliquez sur le bouton [...] pour afficher tous les contextes du fichier TNS et sélectionner celui à utiliser. |
| Host | Saisissez l'adresse IP du serveur de la base de données. |
| Port | Saisissez le numéro du port d'écoute du serveur de la base de données. |
| Database | Saisissez le nom de la base de données à utiliser. |
| Schema | Saisissez le nom du schéma. |
| Username et Password | Saisissez les informations d'authentification de l'utilisateur ou de l'utilisatrice.<br><br>Pour saisir le mot de passe, cliquez sur le bouton [...] à côté du champ Password, puis, dans la boîte de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles et cliquez sur OK afin de sauvegarder les paramètres. |
| Additional JDBC Parameters | Définissez des propriétés de connexion supplémentaires pour la connexion à la base de données que vous créez. Les propriétés sont séparées par un point-virgule et chaque propriété est une paire clé-valeur. Par exemple, *encryption=1;clientname=Talend*.<br><br>Ce champ n'est pas disponible si la case Use an existing connection est cochée. |

## Advanced settings

| Propriétés | Description |
| --- | --- |
| Connection pool | Dans cette zone, configurez, pour chaque exécuteur Spark, le pool de connexions utilisé pour contrôler le nombre de connexions qui restent ouvertes simultanément. Généralement, les valeurs par défaut données aux paramètres suivants du pool de connexions conviennent à la plupart des cas d'utilisation.<br><br><ul> <li> <p> <span>Max total number of connections</span>&nbsp;: saisissez le nombre maximal de connexions (actives ou inactives) autorisées à rester ouvertes simultanément.</p> <p>Le nombre par défaut est&nbsp;<em>8</em>. Si vous saisissez&nbsp;<em>-1</em>, vous autorisez un nombre illimité de connexions ouvertes simultanément.</p> </li> <li> <p> <span>Max waiting time (ms)</span>&nbsp;: saisissez le temps maximum d'attente à la fin duquel la réponse à une demande d'utilisation de connexion doit être retournée par le pool de connexions. Par défaut, la valeur est&nbsp;-1, c'est-à-dire un temps illimité.</p> </li> <li> <p> <span>Min number of idle connections</span>&nbsp;: saisissez le nombre minimal de connexions inactives (connexions non utilisées) maintenues dans le pool de connexions.</p> </li> <li> <p> <span>Max number of idle connections</span>&nbsp;: saisissez le nombre maximal de connexions inactives (connexions non utilisées) maintenues dans le pool de connexions.</p> </li> </ul> |
| Evict connections | Cochez cette case pour définir les critères de destruction de connexions dans le pool de connexions. Les champs suivants sont affichés une fois la case cochée.<br><br><ul> <li> <p> <span>Time between two eviction runs</span>&nbsp;: saisissez l'intervalle de temps (en millisecondes) à la fin duquel le composant vérifie le statut des connexions et détruit les connexions inactives.</p> </li> <li> <p> <span>Min idle time for a connection to be eligible to eviction</span>&nbsp;: saisissez l'intervalle de temps (en millisecondes) à la fin duquel les connexions inactives sont détruites.</p> </li> <li> <p> <span>Soft min idle time for a connection to be eligible to eviction</span>&nbsp;: ce paramètre fonctionne de la même manière que l'option <span>Min idle time for a connection to be eligible to eviction</span> mais garde le nombre minimal de connexions inactives, nombre défini dans le champ <span>Min number of idle connections</span>.</p> </li> </ul> |

## Utilisation

| Conseils d'utilisation | Description |
| --- | --- |
| **Règle d'utilisation** | Ce composant est utilisé sans avoir besoin d'être connecté à d'autres composants.<br><br>La configuration dans un composant tOracleConfiguration s'applique uniquement aux composants Oracle associés, dans le même Job. En d'autres termes, les composants Oracle utilisés dans un Job enfant ou enfant et appelés par un tRunJob ne peuvent réutiliser cette configuration.<br><br>Ce composant, ainsi que la Palette Spark Batch à laquelle il appartient, ne s'affiche que lorsque vous créez un Job Spark Batch.<br><br>Notez que, dans cette documentation, sauf mention contraire, un scénario présente uniquement des Jobs Standard, c'est-à-dire des Jobs Talend traditionnels d'intégration de données. |
| Connexion à Spark | Dans l'onglet Spark Configuration de la vue Run, définissez la connexion à un cluster Spark donné pour le Job complet. De plus, puisque le Job attend ses fichiers .jar dépendants pour l'exécution, vous devez spécifier le répertoire du système de fichiers dans lequel ces fichiers .jar sont transférés afin que Spark puisse accéder à ces fichiers :<br><br><ul> <li> <div> <span>Yarn mode</span> (Yarn Client ou Yarn Cluster) :<ul> <li> <p>Lorsque vous utilisez Google Dataproc, spécifiez un bucket dans le champ <span>Google Storage staging bucket</span> de l'onglet <span>Spark configuration</span>.</p> </li> <li> <p>Lorsque vous utilisez HDInsight, spécifiez le blob à utiliser pour le déploiement du Job, dans la zone <span>Windows Azure Storage configuration</span> de l'onglet <span>Spark configuration</span>.</p> </li> <li>Lorsque vous utilisez Altus, spécifiez le bucket S3 ou le stockage Azure Data Lake Storage (aperçu technique) pour le déploiement du Job, dans l'onglet <span>Spark configuration</span>.</li> <li> <p>Lorsque vous utilisez des distributions sur site (on-premises), utilisez le composant de configuration correspondant au système de fichiers utilisé par votre cluster. Généralement, ce système est HDFS et vous devez utiliser le <a href="https://help.qlik.com/talend/r/fr-FR/8.0/components/hdfs/thdfsconfiguration">tHDFSConfiguration</a>.</p> </li> </ul> </div> </li> <li> <p> <span>Standalone mode</span>&nbsp;: utilisez le composant de configuration correspondant au système de fichiers que votre cluster utilise, comme le <a href="https://help.qlik.com/talend/r/fr-FR/8.0/components/hdfs/thdfsconfiguration-properties-for-apache-spark-batch">tHDFSConfiguration Apache Spark Batch</a> ou le <a href="https://help.qlik.com/talend/r/fr-FR/7.3/components/amazon-s3/ts3configuration-properties-for-apache-spark-batch">tS3Configuration Apache Spark Batch</a>.</p> <p>Si vous utilisez Databricks sans composant de configuration dans votre Job, vos données métier sont écrites directement dans DBFS (Databricks Filesystem).</p> </li> </ul><br><br>Cette connexion fonctionne uniquement pour le Job dans lequel vous l'avez définie. |