Connecteur source OData

Le connecteur source OData permet à DataSync de récupérer les données de tout service compatible OData et de les charger dans un entrepôt de données. DataSync prend en charge deux modes d'authentification : Basic et OAuth 2.0.

Une fois la connexion source créée, configurez la connexion de destination pour finaliser l'installation.

Créer la connexion source dans DataSync

1. Connectez-vous à DataSync.
2. Depuis l'écran d'accueil, sélectionnez Connexions.
3. À côté de Connexions de la source, cliquez sur Nouveau.
4. Sélectionnez OData.
5. Complétez toutes les propriétés de connexion requises.
6. (Facultatif) Dans le panneau Autres propriétés de la connexion, cliquez sur Ajouter une propriété et définissez les paramètres supplémentaires nécessaires.
7. Configurez les paramètres avancés selon votre environnement, notamment le Type de suivi.
8. Cliquez sur Enregistrer.

Propriétés de la connexion

Propriété	Description
Description	Nom unique attribué à la connexion. Exemple : OData.
URL	Adresse du point de terminaison OData. Exemple : https://services.odata.org/TripPinRESTierService.
Mode d'authentification	Basic ou OAuth2.
Nom d'utilisateur	Basic uniquement Identifiant de connexion pour accéder au service OData. Exemple : admin.
Mot de passe	Basic uniquement Mot de passe associé à ce compte.
URL de rappel	OAuth uniquement URL de redirection générée automatiquement par DataSync. Doit être ajoutée à l'application OAuth chez le fournisseur d'identité.
ID client	OAuth uniquement Identifiant attribué à l'application OAuth lors de son enregistrement.
Secret client	OAuth uniquement Secret généré pour l'application OAuth.
URL d'autorisation	OAuth uniquement URL utilisée pour obtenir le code d'autorisation. Fournie par le fournisseur d'identité.
URL du jeton d'accès	OAuth uniquement URL utilisée pour échanger le code d'autorisation contre un jeton d'accès. Fournie par le fournisseur d'identité.
Privilèges d'accès	OAuth uniquement Autorisations demandées au service OData. Valeurs par défaut : openid, api, offline_access.
Convertir toutes les dates et heures en GMT	Convertit toutes les valeurs DateTime en GMT. Recommandé lorsque le service OData s'exécute dans un fuseau horaire différent et que des horodatages cohérents sont nécessaires.
Pagination côté client	Active la pagination côté client pour les grands volumes de données. Lorsqu'activée, les données sont récupérées par pages plutôt qu'en une seule fois.
Taille de page	Nombre maximum de résultats retournés par page lorsque la pagination côté client est activée. Des valeurs plus élevées retournent davantage de lignes par page mais augmentent le risque d'expiration.
Délai	Durée en secondes avant l'expiration d'une tentative de connexion ou d'une exécution de requête.
Format de données	Format des données récupérées : ATOM ou JSON.
Verbosité	Contrôle le niveau de détail écrit dans le journal. Chaque niveau inclut tout ce qui précède plus des informations supplémentaires. 1 enregistre les requêtes, les nombres de lignes, les heures de début et de fin d'exécution ainsi que les erreurs. 2 ajoute les requêtes de cache et les en-têtes HTTP. 3 ajoute les corps de requête et de réponse. 4 ajoute la communication au niveau du transport. 5 ajoute toutes les commandes d'interface.
Activer le pooling	Active le pooling de connexions, qui conserve un ensemble de connexions ouvertes et les réutilise entre les extractions au lieu d'ouvrir une nouvelle connexion à chaque fois. Réduit la charge et améliore les performances lorsque plusieurs extractions s'exécutent en même temps.
Délai d'inactivité du pool	Temps d'inactivité maximal en secondes avant qu'une connexion soit retournée au pool.
Taille maximale du pool	Nombre maximum de connexions autorisées dans le pool en même temps.
Temps d'attente du pool	Temps d'attente maximal en secondes pour obtenir une connexion avant qu'une erreur ne soit générée.

Autres propriétés de la connexion

Ce panneau permet d'ajouter des propriétés de chaîne de connexion qui ne figurent pas dans le panneau Propriétés de la connexion. Pour les valeurs sensibles comme les mots de passe, choisissez le type Crypté. La valeur reste alors masquée dans l'interface et stockée de façon chiffrée côté serveur.

Propriété	Description
Propriété	Propriété de la chaîne de connexion définissant l'action ou le comportement. Exemple : ReadOnly.
Valeur	Valeur associée à la propriété. Exemple : True.
Type	Visibilité de la valeur : Visible ou Crypté.

Paramètres avancés

Ces paramètres déterminent la façon dont le connecteur suit les modifications de données, gère l'heure et la région, et traite les enregistrements pendant l'extraction. Ajustez-les selon votre environnement OData afin que les résultats restent exacts et cohérents.

Paramètre	Description
Type de suivi	Méthode de suivi des modifications de données : Aucun ou Date.
Region	Paramètre régional du connecteur, si la configuration l'exige.
Fuseau horaire	Fuseau horaire correspondant à l'environnement OData.
Décalage de temps	Décalage d'actualisation en secondes pour compenser les écarts de synchronisation lors de la sélection des enregistrements. Minimum 0, maximum 3600.
Taille du lot	Nombre d'enregistrements traités par lot lors de l'extraction. Des lots plus grands peuvent améliorer les performances mais consomment davantage de mémoire. La valeur par défaut est 2000, le maximum est 10000. À ajuster selon la vitesse du réseau et les performances du disque. La valeur par défaut convient dans la plupart des cas.

Exemple de configuration avec authentification Basic

Connexion source OData avec authentification Basic entièrement configurée dans DataSync, avec toutes les propriétés et tous les paramètres complétés.

Exemple de configuration avec authentification OAuth

Connexion source OData avec authentification OAuth entièrement configurée dans DataSync, avec toutes les propriétés et tous les paramètres complétés.