bsddb |
Base de données Berkeley |
|---|---|
Python |
|
Description
Ce module contient une interface avec la bibliothèque de base de données Berkeley DB.
Liste des procédures et fonctions
| Nom | Description |
|---|---|
| close | Cette fonction permet de fermer le fichier sous-jacent. L'objet n'est plus accessible. Comme il n'y a pas de méthode open() pour ces objets, pour ouvrir à nouveau le fichier, une nouvelle fonction d'ouverture du module bsddb doit être appelée. |
| btopen | Cette fonction permet d'ouvrir le fichier au format btree du nom de fichier spécifié. |
| first | Cette fonction permet de positionner le curseur sur le premier élément du fichier DB et de le retourner. L'ordre des clefs dans le fichier n'est pas spécifié, sauf dans le cas des bases de données B-Tree. Cette méthode déclenche si la base de données est vide. |
| hashopen | Cette fonction permet d'ouvrir le fichier de format de hachage du nom de fichier spécifié. |
| has_key | Cette fonction permet de retourner la valeur 1 si le fichier DB contient le paramètre sous forme de clef. |
| keys | Cette fonction permet de demander la liste des clefs contenues dans le fichier DB. L'ordre de la liste n'est pas spécifié et ne doit pas être invoqué. En particulier, l'ordre de la liste retournée est différent pour différents formats de fichiers. |
| last | Cette fonction permet de positionner le curseur sur le dernier élément du fichier DB et de le retourner. L'ordre des clefs dans le fichier n'est pas spécifié. Cette situation n'est pas pris en charge sur les bases de données de hachage (celles ouvertes avec hashopen()). Cette méthode déclenche bsddb.error si la base de données est vide. |
| next | Cette fonction permet de placer le curseur sur l'élément suivant dans le fichier DB et de le retourner. L'ordre des clefs dans le fichier n'est pas spécifié, sauf dans le cas des bases de données B-Tree. |
| previous | Cette fonction permet de positionner le curseur sur l'élément précédent dans le fichier DB et de le retourner. L'ordre des clefs dans le fichier n'est pas spécifié, sauf dans le cas des bases de données B-Tree. Cette situation n'est pas pris en charge sur les bases de données de hachage (celles ouvertes avec hashopen()). |
| rnopen | Cette fonction permet d'ouvrir un fichier au format d'enregistrement DB du nom de fichier spécifié. |
| set_location | Cette fonction permet de positionner le curseur sur l'élément indiqué par la touche et de retourner un tuple contenant la clef et sa valeur. Pour les bases de données d'arbres binaires (ouvertes à l'aide de la fonction btopen()), si la clef n'existe pas réellement dans la base de données, le curseur pointera vers l'élément suivant dans l'ordre trié et renverra cette clef et cette valeur. Pour les autres bases de données, KeyError sera déclenchée si la clef n'est pas trouvée dans la base de données. |
| sync | Cette fonction permet de synchroniser la base de données sur le disque. |
Remarques
- Le module bsddb est déconseillé depuis la version 2.6 de Python et a été supprimé dans Python version 3.
- Le module bsddb fournit une interface avec la bibliothèque Berkeley DB. Les utilisateurs peuvent créer des fichiers de bibliothèque de hachage, btree ou d'enregistrement à l'aide de l'appel ouvert approprié. Les objets Bsddb se comportent généralement comme des dictionnaires. Cependant, les clefs et les valeurs doivent être des chaînes de caractères. Pour utiliser d'autres objets comme clefs ou pour entreposer d'autres types d'objets, l'utilisateur doit les sérialiser d'une manière ou d'une autre, généralement en utilisant marshal.dumps() ou pickle.dumps().
- Le module bsddb nécessite une version de la bibliothèque Berkeley DB de 4.0 à 4.7.
- Une interface d'objet DB, DBEnv et DBSequence plus moderne est disponible dans le module bsddb.db correspondant étroitement à l'API de Berkeley DB de C. Les fonctionnalités supplémentaires fournies par l'API bsddb.db incluent le réglage de fin, les transactions, le journal de bord et l'accès simultané à la base de données multiprocessus.
- À partir de la version 2.5 de Python, cette interface doit être sécurisée pour un accès multi-processus léger. L'API bsddb.db est recommandée pour les utilisateurs de processus léger car elle offre un meilleur contrôle.
Dernière mise à jour : Vendredi, le 3 janvier 2020