[PYTHON] Avec SQLite3, ajoutez seulement deux lignes et utilisez la bibliothèque d'extension (fonction SQL étendue)!

introduction

Avec SQLite3, il est possible d'introduire une bibliothèque partagée comme bibliothèque d'extension, similaire à EXTENSION (extension) de PostgreSQL. En fait, vous pouvez utiliser la bibliothèque d'extension en ajoutant seulement deux lignes, ** enable_load_extension et load_extension! ** A titre d'exemple, introduisons et utilisons les fonctions d'extension SQL (extension-functions.c) publiées dans SQLite Contributed Files. SQLite3 a moins de fonctions SQL que les autres SGBDR, mais il peut être complété par l'introduction de fonctions SQL étendues. Introduisons-le avec SQLite3 CLI (Command Line Intferface), python3, langage C sur CentOS7.

Obtention et création de fonctions SQL étendues

Téléchargez la fonction SQL étendue depuis SQLite Contributed Files et compilez-la pour créer une bibliothèque partagée.

$ wget http://www.sqlite.org/contrib/download/extension-functions.c?get=25
$ mv extension-functions.c\?get\=25 extension-functions.c
$ gcc -fPIC -lm -shared extension-functions.c -o libsqlitefunctions.so
$ ls lib*
libsqlite3.la  libsqlitefunctions.so  libtclsqlite3.la  libtool

Utiliser la bibliothèque d'extension avec l'interface de ligne de commande SQLite3

Utilisez la CLI SQLite3 pour charger la bibliothèque partagée de fonctions SQL étendues avec la commande .load et essayez d'utiliser la fonction acos.
Avant d'exécuter la commande .load, il y avait une erreur indiquant que la fonction acos n'existait pas, mais après son exécution, vous pouvez confirmer que la fonction acos est exécutée sans aucun problème.

$ sqlite3 test1.db
SQLite version 3.31.1 2020-01-27 19:55:54
Enter ".help" for usage hints.
sqlite> SELECT acos(0.5);
Error: no such function: acos
sqlite> .load ./libsqlitefunctions.so
sqlite> SELECT acos(0.5);
1.0471975511966

Utiliser la bibliothèque d'extensions avec python3

Chargez la bibliothèque partagée de fonctions SQL étendues dans python3 et essayez d'utiliser la fonction acos.
En python3, la fonction load_extension est désactivée, alors activez d'abord la fonction load_extension avec la méthode enable_load_extension, puis chargez la bibliothèque partagée de la fonction SQL étendue avec la méthode load_extension. Vous pouvez voir que la fonction acos est exécutée sans aucun problème et que la valeur est sortie.

python3

$ python3
Python 3.6.8 (default, Aug  7 2019, 17:28:10) 
[GCC 4.8.5 20150623 (Red Hat 4.8.5-39)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import sqlite3
>>> con = sqlite3.connect(":memory:")
>>> con.enable_load_extension(True)
>>> con.load_extension("./libsqlitefunctions.so")
>>> cur = con.cursor()
>>> cur.execute("SELECT acos(0.5)")
<sqlite3.Cursor object at 0x7fa84fdf3c00>
>>> cur.fetchone()
(1.0471975511965979,)

Utiliser la bibliothèque d'extensions en langage C

Chargez la bibliothèque partagée de fonctions SQL étendues dans un programme en langage C et essayez d'utiliser la fonction acos.
Dans la version par défaut, la fonction load_extension est désactivée, alors activez d'abord la fonction load_extension avec la fonction sqlite3_enable_load_extension, puis chargez la bibliothèque partagée de la fonction SQL étendue avec la méthode sqlite3_load_extension.

#include <stdio.h>
#include <assert.h>
#include "sqlite3.h"

int main(int argc, char **argv){
  sqlite3 *db = NULL;
  int rc = SQLITE_OK;
  char *sql = "SELECT acos(0.5);";
  char *zErrMsg = NULL;
  sqlite3_stmt *stmt = NULL;

  rc = sqlite3_open(":memory:", &db);
  assert(rc==SQLITE_OK);
  sqlite3_enable_load_extension(db, 1);
  assert(rc==SQLITE_OK);
  rc = sqlite3_load_extension(db,"./libsqlitefunctions.so", NULL,&zErrMsg);
  assert(rc==SQLITE_OK);
  rc = sqlite3_prepare(db, sql, -1, &stmt, NULL);
  sqlite3_reset(stmt);
  while (SQLITE_ROW == (rc = sqlite3_step(stmt))){
    double  value = sqlite3_column_double(stmt, 0);
    printf("%lf\n", value);
  }
  assert(rc==SQLITE_DONE);
  sqlite3_finalize(stmt);
  sqlite3_close(db);
  return(0);
}

Si vous compilez et exécutez comme suit, vous pouvez voir que la fonction acos est exécutée sans aucun problème et la valeur est sortie.

$ gcc -Wall -o evalext evalext.c -lsqlite3 -L./.lib -I./
$ ./evalext 
1.047198

Résumé

Dans SQLite3, comme introduit cette fois, vous pouvez facilement incorporer la bibliothèque partagée dans SQLite3 en tant que bibliothèque d'extension pour étendre ses fonctions. Diverses bibliothèques d'extensions sont ouvertes au public, mais vous pouvez étendre les fonctions d'origine en créant votre propre bibliothèque d'extensions.

Si vous trouvez des erreurs ou des préoccupations concernant la description, nous vous serions reconnaissants de bien vouloir nous faire part de vos commentaires dans la demande de modification ou le commentaire.

Annexe: Description des fonctions SQL étendues

Les fonctions mathématiques, les fonctions de chaîne et les fonctions d'agrégation suivantes sont disponibles pour les fonctions SQL étendues.

Fonction mathématique

Fonction de chaîne

Fonction d'agrégation

référence

J'ai évoqué les informations suivantes.

• Run-Time Loadable Extensions
• Load An Extension
• Enable Or Disable Extension Loading
• Utiliser la bibliothèque d'extension avec SQLite
• [Erreur non autorisée dans SQLite load_extension](https://a5m2.mmatsubara.com/wp/?topic=sqlite%E3%81%AEload_extension%E3%81%A7not-authorized%E3%82%A8%E3% 83% A9% E3% 83% BC)