Connexion à un serveur DataSnap (FireDAC)

De RAD Studio
Aller à : navigation, rechercher

Remonter à Connectivité des bases de données (FireDAC)

Cette rubrique explique comment établir une connexion à des serveurs DataSnap multiniveaux.

Versions prises en charge

Le pilote DataSnap multiniveaux de FireDAC prend en charge :

  • les serveurs DataSnap construits avec RAD Studio 2007 et ultérieur ;
  • les clients DataSnap construits avec RAD Studio XE2 Enterprise et ultérieur.

Logiciel client

FireDAC lie statiquement le pilote Embarcadero DataSnap dbExpress, afin qu'aucun fichier ni DLL supplémentaire ne soit requis. Les versions prises en charge sont RAD Studio XE2 Enterprise et ultérieur.

Liaison du pilote

Pour lier le pilote DataSnap :

Paramètres de définition de la connexion

Pour établir une connexion au serveur DataSnap, la plupart des applications vous demandent de spécifier les paramètres DriverID, Protocol, Server, Port, User_Name, Password. Pour plus de détails, voir Définition d'une connexion (FireDAC).

DriverID=DS

Paramètre Description Valeur exemple
Protocol

Protocole utilisé pour la connexion au serveur DataSnap. Il peut prendre l'une des valeurs suivantes :

  • TCP/IP. Etablir la connexion en utilisant le protocole TCP/IP. Il s'agit du protocole par défaut.
  • HTTP. Etablir la connexion en utilisant le protocole HTTP.
 TCP/IP
Server Adresse du serveur auquel établir la connexion. 127.0.0.1
Port Port d'écoute TCP/IP ou HTTP du serveur DataSnap. La valeur par défaut pour TCP/IP est 211. Pour HTTP, c'est 8080. 211
User_Name Nom d'utilisateur utilisé pour l'authentification sur le serveur DataSnap.
Password Mot de passe utilisateur utilisé pour l'authentification sur le serveur DataSnap.
BufferKBSize Taille du tampon en kilo-octets à utiliser pour les opérations de lecture et d'écriture. La valeur par défaut est 32 Ko. 64
Filters Filtres client utilisés pour stocker la configuration des filtres. La valeur par défaut est vide. Voir TDBXPropertyNames.Filters. { "ZLibCompression": {} }
URLPath HTTP uniquement. Chemin URL utilisé pour le service DataSnap HTTP lorsque le protocole HTTP est utilisé. La valeur par défaut est vide.
DatasnapContext HTTP uniquement. Chemin d'accès au service DS HTTP utilisé pour composer l'URL. La convention actuelle est : 'http://x.com/datasnap/provider/classname/method/params'. L'utilisateur peut remplacer ou supprimer le mot "datasnap" dans ce chemin. La valeur par défaut est 'datasnap/'.
DSProxyHost HTTP uniquement. Hôte vers lequel acheminer les demandes de proxy, ou chaîne vide si vous n'utilisez pas de proxy. La valeur par défaut est vide.
DSProxyPort HTTP uniquement. Port sur l'hôte proxy via lequel vous pouvez acheminer les demandes de proxy. Il est ignoré si DSProxyHost n'est pas défini. La valeur par défaut est vide.
DSProxyUsername HTTP uniquement. Nom d'utilisateur utilisé pour l'authentification de proxy. La valeur par défaut est vide.
DSProxyPassword HTTP uniquement. Mot de passe utilisé pour l'authentification de proxy. La valeur par défaut est vide.
DSAuthenticationScheme HTTP uniquement. Schéma d'authentification DataSnap. Utilisé en conjonction avec le nom d'utilisateur et le mot de passe DataSnap pour l'authentification à l'aide du protocole HTTP. Définir sur "basic" pour transmettre les valeurs User_Name / Password en utilisant l'authentification HTTP basique, en plus de transmettre ces valeurs dans la chaîne de connexion DBX. L'authentification HTTP basique peut être utilisée pour transmettre les informations d'identification à un serveur tunnel DataSnap HTTP interprocessus. La valeur par défaut est vide.
LoginTimeout HTTP uniquement. Valeur du délai de connexion. La valeur indique le nombre de millisecondes pendant lesquelles le client tente d'établir une connexion. Elle fournit le délai d'attente de la réponse du premier serveur plutôt que celui de la phase complète de connexion/authentification. Elle doit être utilisée pour éviter un gel de l'application lorsqu'il est possible d'effectuer des tentatives de connexion aux versions plus anciennes de serveur DataSnap ou à d'autres applications qui ne reconnaissent pas le protocole de communication en cours. La valeur par défaut est vide.
CommunicationTimeout HTTP uniquement. Valeur en millisecondes du délai d'attente d'une réponse après l'établissement de la connexion. La valeur par défaut est vide.

Exemples d'utilisation

Etablir une connexion au serveur DataSnap local avec les paramètres par défaut : 


DriverID=DS

Etablir une connexion au serveur DataSnap en utilisant le protocole TCP/IP exécuté sur un hôte local : 


DriverID=DS
Protocol=tcp/ip
Server=127.0.0.1
Port=211
User_Name=dsusr
Password=123

Voir aussi

Récupérée de « https://docwiki.embarcadero.com/RADStudio/Athens/f/index.php?title=Connexion_à_un_serveur_DataSnap_(FireDAC)&oldid=208230 »