mssqlconn/fr: what changed
Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.
Title: mssqlconn/fr
| Old | New | Line | |
|---|---|---|---|
| 1 | + | **mssqlconn** est un unité de fcl-db contenant le code du connecteur pour [[TMSSQLConnection/fr|TMSSQLConnection]] (MS SQL Server) et [[TSybaseConnection/fr|TSybaseConnection]] (Sybase ASE). | |
| 2 | + | ||
| 3 | + | Lazarus utilise mssqlconn pour présenter un connecteur MS SQL et un connecteur Sybase ASE. | |
| 4 | + | ||
| 5 | + | ## DBLib | |
| 6 | + | ||
| 7 | + | mssqlconn utilise l'unité de bas-niveau dblib qui nécessite la bibliothèque [FreeTDS](http://www.freetds.org) (.dll/.dylib/.so) pour se connecter au serveur. | |
| 8 | + | ||
| 9 | + | ## Installation | |
| 10 | + | ||
| 11 | + | La seule chose dont vous avez besoin est une bibliothèque dll/dylib/so FreeTDS pour votre plate-forme. | |
| 12 | + | ||
| 13 | + | - Sur Linux, téléchargez le paquet freetds qui fournit **libsybdb.so** (p.ex. dans la Debian, cela est fourni par le paquet **libsybdb5**) et le paquet de développement associé en utilisant votre gestionnaire de paquet. vous aurez aussi besoin d'ajouter un lien symbolique libsybdb.so vers libsybdb.so.5. | |
| 14 | + | - Sur Windows, vous pouvez télécharger une version 32 ou 64 bits récente de la bibliothèque FreeTDS **dblib.dll** ici : [1](ftp://ftp.freepascal.org/fpc/contrib/windows/) | |
| 15 | + | ||
| 16 | + | Utilisation avancée : en modifiant le fichier FPC **dblib.pas** SQLDB pourrait utiliser la bibliothèque "native" **ntwdblib.dll** au lieu de la bibliothèque FreeTDS par défaut **dblib.dll** (dans ce cas, FPC a besoin d'être recompilé). | |
| 17 | + | ||
| 18 | + | ## Documentation | |
| 19 | + | ||
| 20 | + | Documentation officielle : [Documentation FPC sur mssqlconn](http://www.freepascal.org/docs-html/fcl/mssqlconn/index.html) | |
| 21 | + | ||
| 22 | + | ## Limitations et conseils | |
| 23 | + | ||
| 24 | + | - Port Sybase : le port par défaut pour Sybase ASE est le 5000. Comme FreeTDS/mssqlconn utilise 1433 par défaut, vous pouvez vouloir ajouter :5000 à la propriété hostname automatiquement ou après le retour d'information de l'utilisateur final. | |
| 25 | + | ||
| 26 | + | Comme la documentation le spécifie : | |
| 27 | + | ||
| 28 | + | - vous pouvez avoir besoin affiner certains paramètres pour la prise en charge des BLOB. | |
| 29 | + | - les ensembles résultats multiple de MS SQL (*multiple resultsets*,MARS) ne sont pas pris en charge. | |
| 30 | + | ||
| 31 | + | ### Paramètres de sorties et procédures stockées | |
| 32 | + | ||
| 33 | + | Aussi, **TMSSQLConnection** et **TSybaseConnection** ne prennent pas en charge la gestion des status de retour et les paramètres de sortie (*output parameters*) des procédures stockées. Pour plus d'information, voir : <http://www.freetds.org/faq.html#ms.output.parameters>. | |
| 34 | + | ||
| 35 | + | ``` pascal | |
| 36 | + | with SQLQuery1 do begin | |
| 37 | + | SQL.Text:='declare @param int; declare @ret int;'+ | |
| 38 | + | 'exec @ret=MyStoredProc 1, @param OUTPUT;'+ | |
| 39 | + | 'select @ret as return_status, @param as out_param'; | |
| 40 | + | Open; | |
| 41 | + | end; | |
| 42 | + | ``` | |
| 43 | + | ||
| 44 | + | Quelques conseils de plus : | |
| 45 | + | ||
| 46 | + | - Vous pourriez vouloir faire un YourConnection.ExecuteDirect('SET ANSI_NULL_DFLT_ON ON'); si vous voulez permettre les valeurs NULL pour les colonnes à la création des tables. Voir la documentation : <http://msdn.microsoft.com/en-us/library/ms174979.aspx>. | |
| 47 | + | - Vous pourriez vouloir de manière similaire définir SET ANSI_PADDING à ON pour activre ne meilleure compatibilité avec les fonctions de comparaison de texte de SQLdb. Voir la documentation MS : <http://msdn.microsoft.com/en-us/library/ms187403.aspx>. | |
| 48 | + | ||
| 49 | + | ## Messages d'erreur | |
| 50 | + | ||
| 51 | + | ### Error 20009 : Unable to connect: Adaptive Server is unavailable or does not exist | |
| 52 | + | ||
| 53 | + | - Vérifier si le protocole TCP/IP est activé sur le serveur SQL en utilisant "SQL Server Configuration Manager" - "SQL Server Network Configuration". | |
| 54 | + | - Vérifier si le port TCP 1433 est ouvert. | |
| 55 | + | - Si vous vous connecter à une instance spécifique de SQL Server (ce qui est aussi le cas de SQL Server Express), vérifier si le SQL Server Browser Service est en cours d'exécution sur le serveur (le service écoute sur le port UDP 1434). | |
| 56 | + | ||
| 57 | + | ### Erreur 20019 : Attempt to initiate a new Adaptive Server operation with results pending | |
| 58 | + | ||
| 59 | + | - Mettez la propriété TSQLQuery.PacketRecords à -1. | |
| 60 | + | - Pour plus d'information, voir : <http://www.freetds.org/faq.html#pending>. | |
| 61 | + | ||
| 62 | + | ### Erreur 20047 : DBPROCESS is dead or not enabled | |
| 63 | + | ||
| 64 | + | - SQL Server vérifie périodiquement (toutes les 30 secondes par défaut) si la connection TCP/IP idle est toujours intact en envoyant un paquet 'keep alive' à ses paires. Si le système distant est toujours joignable et en cours de fonctionnement, un paquet d'accusé de réception est envoyé en retour. Sinon, le TCP local réinitialisera la connexion. | |
| 65 | + | - Ajuster SQL Server Configuration Manager -\> SQL Server Network Configuration -\> Protocols -\> TCP/IP : "Keep Alive". | |
| 66 | + | ||
| 67 | + | ### EINOutError/Can not load DB-Lib client library "dblib.dll". Check your installation | |
| 68 | + | ||
| 69 | + | - Assurez-vous que toutes les dll nécessaires sont installées (p.ex. **dblib.dll**, **libiconv2.dll**) | |
| 70 | + | - Assurez-vous que tout le bibliothèque d'exécution (*runtime libraries*) C/C++ dont dépend **dblib.dll** sont installées. | |
| 71 | + | - Assurez-vous que la taille d'adressage (*bitness*, 32 ou 64 bit) de la bibliothèque dblib et celle de votre programme concordent. | |
| 72 | + | ||
| 73 | + | ## Exemples | |
| 74 | + | ||
| 75 | + | ### Création d'une base de données | |
| 76 | + | ||
| 77 | + | L'exemple ci-dessous crée une base de données dans un serveur MS SQL. Pour cela, le paramètre de connection AutoCommit doit être mis à 'On'. Pour les connexion normale suivantes, vous pouvez le basculer à 'Off' à nouveau et utiliser les **StartTransaction** et **Commit** normales. | |
| 78 | + | ||
| 79 | + | ``` pascal | |
| 80 | + | // Set up a form with a button called DBButton, | |
| 81 | + | // textbox called DatabaseNameEdit, | |
| 82 | + | // '''MSSQLConnection''' called FConn | |
| 83 | + | // ***make sure the Autocommit parameter is on for the create db part before connectiong: | |
| 84 | + | //FConn.Params.Add('AutoCommit=true'); | |
| 85 | + | procedure TForm1.CreateDBButtonClick(Sender: TObject); | |
| 86 | + | var | |
| 87 | + | CurrentDB: string; | |
| 88 | + | begin | |
| 89 | + | if DatabaseNameEdit.Text='' then | |
| 90 | + | begin | |
| 91 | + | showmessage('Empty database name. Please specify database name first.'); | |
| 92 | + | exit; | |
| 93 | + | end; | |
| 94 | + | ||
| 95 | + | CurrentDB:=FConn.DatabaseName; | |
| 96 | + | try | |
| 97 | + | // For FPC 2.6.1+ | |
| 98 | + | FConn.ExecuteDirect('CREATE DATABASE '+DatabaseNameEdit.Text); | |
| 99 | + | { | |
| 100 | + | // This works with FPC 2.7.1, not on 2.6.1 | |
| 101 | + | FConn.CreateDB; | |
| 102 | + | } | |
| 103 | + | except | |
| 104 | + | on E: Exception do | |
| 105 | + | begin | |
| 106 | + | showmessage('Exception running CreateDB: '+E.Message); | |
| 107 | + | end; | |
| 108 | + | end; | |
| 109 | + | end; | |
| 110 | + | ``` | |
| 111 | + | ||
| 112 | + | --- | |
| 113 | + | *From the Free Pascal wiki, page "mssqlconn/fr", as it stood on 2020-02-20 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |