Connecteur source OData

Le connecteur source OData dans DataSync vous permet de récupérer des données depuis n'importe quel service conforme à OData pour le chargement ou la synchronisation dans votre entrepôt de données. Après avoir créé toutes les connexions sources requises, configurez votre connexion de destination pour finaliser la configuration.

Créer une connexion source dans DataSync

1. Connectez-vous à DataSync.
2. Depuis l'écran d'accueil, sélectionnez Connexions.
3. À côté de Connexions Sources, cliquez sur Nouveau.
4. Sélectionnez OData.
5. Dans le panneau Propriétés de la connexion, entrez les propriétés de connexion.
6. (Optionnel) Dans le panneau Autres propriétés de la connexion, sélectionnez Ajouter une propriété et entrez les paramètres pour chaque propriété.
7. Dans le panneau Paramètres avancés, configurez les paramètres, y compris le Type de suivi et d'autres valeurs selon vos besoins.
8. Cliquez sur Sauvegarder.

Paramètres

Propriétés de la connexion

Paramètre	Description
Description	Nom unique pour la connexion. Exemple : OData
URL	Adresse de l'endpoint OData. Exemple : https://services.odata.org/TripPinRESTierService
Mode d'authentification	Méthode d'authentification utilisée par le connecteur : Basic ou OAuth2.
Nom d'utilisateur	Identifiants de l'utilisateur avec les permissions requises pour accéder à OData (authentification basique uniquement). Exemple : admin
Mot de passe	Mot de passe pour le nom d'utilisateur spécifié (authentification basique uniquement).
URL de rappel	URL de redirection générée automatiquement par DataSync. Doit être ajoutée à l'application OAuth dans votre fournisseur d'identité (OAuth2 uniquement).
Identité du client	Identifiant attribué à l'application OAuth lors de l'enregistrement (OAuth2 uniquement).
Secret du client	Secret généré pour l'application OAuth (OAuth2 uniquement).
URL d'autorisation	URL utilisée pour obtenir le code d'autorisation. Fournie par le fournisseur d'identité (OAuth2 uniquement).
URL de jeton d'accès	URL utilisée pour échanger le code d'autorisation contre un token d'accès. Fournie par le fournisseur d'identité (OAuth2 uniquement).
Privilèges d'accès	Permissions demandées depuis OData (OAuth2 uniquement). Par défaut : openid, api, offline_access.
Convertir toutes les dates et heures en GMT	Conversion des valeurs DateTime d'OData en GMT.
Use client-side paging	Capacité de pagination pour de grands ensembles de données.
Taille de page	Résultats maximum à retourner par page lorsque la pagination côté client est activée. Des valeurs plus importantes retournent plus de lignes par page mais peuvent provoquer des délais d'attente.
Délai	Temps en secondes à attendre pour l'ouverture de la connexion et l'exécution de la requête avant le délai d'attente.
Format de données	Format des données récupérées : ATOM ou JSON.
Verbosité	1 – Journaliser les requêtes, nombres de lignes, début/fin d'exécution, erreurs. 2 – Inclut le niveau 1 plus les requêtes de cache, en-têtes HTTP. 3 – Inclut le niveau 2 plus les corps de requête/réponse. 4 – Inclut le niveau 3 plus la communication au niveau du transport. 5 – Inclut le niveau 4 plus toutes les commandes d'interface.
Activer la mise en Pool	Option de pooling de connexion pour la performance.
Délai d'inactivité du Pool	Temps d'inactivité maximal pour les connexions avant de les retourner au pool, en secondes.
Taille maximale du Pool	Nombre maximum de connexions autorisées dans le pool.
Temps d'attente du Pool	Temps d'attente maximal pour l'attribution de connexion avant qu'une erreur ne soit générée, en secondes.

Autres propriétés de la connexion

Propriétés de chaîne de connexion supplémentaires non spécifiées dans le panneau des Propriétés de connexion. Pour chaque propriété ajoutée, vous pouvez choisir Visible ou Crypé. En sélectionnant Crypé, la valeur est masquée dans l'interface et stockée de manière chiffrée en arrière-plan, comme lors de la définition de mots de passe.

Paramètre	Description
Propriété	Propriété de chaîne de connexion qui définit l'action ou le comportement. Exemple : ReadOnly
Valeur	Valeur pour la propriété. Exemple : True
Type	Visibilité de la propriété : Visible ou Crypé.

Paramètres avancés

Les paramètres avancés contrôlent comment le connecteur OData suit les changements, gère la configuration régionale et horaire, et traite les lots de données lors de l'extraction. Ces options permettent un ajustement fin pour la performance et la précision, et doivent être configurées en fonction de votre environnement système et de vos exigences opérationnelles.

Paramètre	Description
Type de suivi	Méthode pour suivre les changements : Aucun ou Date.
Région	Paramètre de région pour le connecteur, si nécessaire selon votre configuration.
Fuseau horaire	Fuseau horaire correspondant au serveur de l'application OData.
Décalage horaire	Décalage de rafraîchissement en secondes pour compenser les problèmes de timing dans la sélection des enregistrements. Valeur minimum : 0 ; maximum : 3600 secondes.
Taille de lot	Quantité d'enregistrements traités dans chaque lot lors de l'extraction. Des tailles de lot plus grandes augmentent l'utilisation de la mémoire mais peuvent améliorer la performance jusqu'à un certain point. La valeur par défaut est 2000 et le maximum ne doit pas dépasser 10000 enregistrements. Ajustez en fonction de la vitesse de votre réseau et de la performance de votre disque ; dans la plupart des cas, le défaut (2000) fonctionne le mieux.