Gestionnaire de connexions OData

  • Article

S’applique à :SQL Server SSIS Integration Runtime dans Azure Data Factory

Connectez-vous à une source de données OData via un gestionnaire de connexions OData. Un composant source OData utilise un gestionnaire de connexions ODatase pour se connecter à une source de données OData et consommer les données du service. Pour plus d'informations, consultez OData Source.

Ajout d’un gestionnaire de connexions OData à un package SSIS

Vous pouvez ajouter un nouveau gestionnaire de connexions OData à un package SSIS de trois manières :

  • Cliquez sur le bouton Nouveau... dans Éditeur de source OData.

  • Cliquez avec le bouton droit sur le dossier Gestionnaires de connexions dans l’Explorateur de solutions, puis cliquez sur Nouveau gestionnaire de connexions. Sélectionnez ODATA pour Type du gestionnaire de connexions.

  • Cliquez avec le bouton droit dans le volet Gestionnaires de connexions au bas du concepteur de packages, puis sélectionnez Nouvelle connexion. Sélectionnez ODATA pour Type du gestionnaire de connexions.

Notes

Vérifiez que la langue des paramètres internationaux de Visual Studio/SQL Server Data Tools (SSDT) correspond à la langue par défaut de l’instance SQL Server cible dans laquelle les packages SSIS sont déployés.

Authentification du gestionnaire de connexions

Le gestionnaire de connexions OData prend en charge cinq modes d’authentification.

  • Authentification Windows

  • Authentification de base (avec nom d’utilisateur et mot de passe)

  • Microsoft Dynamics AX Online (avec nom d’utilisateur et mot de passe)

  • Microsoft Dynamics CRM Online (avec nom d’utilisateur et mot de passe)

  • Microsoft Online Services (avec nom d’utilisateur et mot de passe)

Pour un accès anonyme, sélectionnez l’option Authentification Windows.

Pour vous connecter à Microsoft Dynamics AX Online ou Microsoft Dynamics CRM Online, vous ne pouvez pas utiliser l’option d’authentification Microsoft Online Services. Par ailleurs, vous ne pouvez utiliser aucun option qui est configurée pour l’authentification multifacteur. L’authentification moderne n’est pas prise en charge pour l’instant.

Spécification des informations d'identification

Si votre service OData requiert l’authentification de base, spécifiez un nom d’utilisateur et un mot de passe dans OData Connection Manager Editor. Les valeurs que vous entrez dans l'éditeur sont conservées dans le package. La valeur du mot de passe est chiffrée selon le niveau de protection du package.

Il existe plusieurs façons de paramétrer les valeurs nom d’utilisateur et mot de passe ou de les stocker en dehors du package. Vous pouvez par exemple utiliser des paramètres ou définir directement les propriétés du gestionnaire de connexions lorsque vous exécutez le package à partir de SQL Server Management Studio.

Propriétés du gestionnaire de connexions OData

Le tableau suivant répertorie les propriétés du gestionnaire de connexions OData.

Propriété Valeur par défaut Description
Connexion persistante False Valeur de l’en-tête « Keep-Alive » lors de l’envoi de la requête web.
Taille maximale des messages reçus 4To Taille maximale des messages reçus, en octets, lors de l’envoi d’une requête web.
Nombre de tentatives 5 Nombre de nouvelles tentatives lors de l’envoi d’une requête web.
Nouvelle tentative d’attente 100 Temps d’attente en millisecondes avant une nouvelle tentative lors de l’envoi d’une requête web.
Délai d’expiration 600 Délai d’expiration en secondes lors de l’envoi d’une requête web.
Url URL vers le document de service.
UserName Nom d’utilisateur à utiliser pour l’authentification, si nécessaire.
Mot de passe Mot de passe à utiliser pour l’authentification, si nécessaire.
ConnectionString Inclut d’autres propriétés du gestionnaire de connexions.

Éditeur du gestionnaire de connexions OData

La boîte de dialogue Éditeur du gestionnaire de connexions OData vous permet d’ajouter ou de modifier une connexion à une source de données OData existante.

Options

Nom du gestionnaire de connexions
Nom du gestionnaire de connexions.

Emplacement du document de service
URL du service OData. Par exemple : https://services.odata.org/V3/Northwind/Northwind.svc/.

Authentification
Sélectionnez l’une des options suivantes :

  • Authentification Windows. Pour l’accès anonyme, sélectionnez cette option.
  • Authentification de base
  • Microsoft Dynamics AX Online pour Dynamics AX Online
  • Microsoft Dynamics CRM Online pour Dynamics CRM Online
  • Microsoft Online Services pour Microsoft Online Services

Si vous sélectionnez une option autre que Authentification Windows, entrez le nom d’utilisateur et le mot de passe.

Pour vous connecter à Microsoft Dynamics AX Online ou Microsoft Dynamics CRM Online, vous ne pouvez pas utiliser l’option d’authentification Microsoft Online Services. Par ailleurs, vous ne pouvez utiliser aucun option qui est configurée pour l’authentification multifacteur.

Tester la connexion
Cliquez sur ce bouton pour tester la connexion à la source OData.