DESCRIPTION.

Modifie la valeur d'une limitation imposée aux bases de données du standard SQL.

SYNTAXE.

Variable = BDD_Base.setlimit ( categorie , limite )

Variable = ⇨ variable qui recevra la valeur [ optionnel ]

BDD_Base ⇨ objet connexion avec une base de données [ OBLIGATOIRE ]

.setlimit ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

categorie ⇨ identifiant de la catégorie [ OBLIGATOIRE ]

limite ⇨ valeur de la limite [ OBLIGATOIRE ]

REMARQUES. 

catégorie doit être l'une des constantes identifiants une catégorie SQLite, ou un int ( ) lui correspondant, suivantes : 

- 0 ou sqlite3.SQLITE_LIMIT_LENGTH, taille maximale de toute chaîne, BLOB ou ligne de table, en octets ; 

- 1 ou sqlite3.SQLITE_LIMIT_SQL_LENGTH, longueur maximale d'une instruction SQL, en octets ; 

- 2 ou sqlite3.SQLITE_LIMIT_COLUMN, nombre maximum de colonnes dans une définition de table ; 

- 3 ou sqlite3.SQLITE_LIMIT_EXPR_DEPTH, profondeur maximale de l'arbre d'analyse sur n'importe quelle expression ; 

- 4 ou sqlite3.SQLITE_LIMIT_COMPOUND_SELECT, nombre maximum de termes dans une instruction SELECT composée ; 

- 5 ou sqlite3.SQLITE_LIMIT_VDBE_OP, Nombre maximum d'instructions dans un programme de machine virtuelle ; 

- 6 ou sqlite3.SQLITE_LIMIT_FUNCTION_ARG, nombre maximum d'arguments sur une fonction ; 

- 7 ou sqlite3.SQLITE_LIMIT_ATTACHED, nombre maximum de bases de données attachées ; 

- 8 ou sqlite3.SQLITE_LIMIT_LIKE_PATTERN_LENGTH, longueur maximale de l'argument de modèle pour LIKE ou GLOB ; 

- 9 ou sqlite3.SQLITE_LIMIT_VARIABLE_NUMBER, numéro d'index maximum dans une instruction SQL ; 

- 10 ou sqlite3.SQLITE_LIMIT_TRIGGER_DEPTH, profondeur maximale de récursion pour les déclencheurs ; 

- 11 ou sqlite3.SQLITE_LIMIT_WORKER_THREADS, nombre maximum de threads qu'une seule instruction peut démarrer.

limite doit être un int ( ) positife, quelconque mais valide pour categorie. 

Si limite est supérieur à la valeur maximum pour categorie, l'appel de la méthode objet.setlimit ( ) sera ignorée.

L'appel de la méthode objet.setlimit ( ) retourne toujours un int ( ) donnant la valeur précédente pour categorie.

Voir la méthode objet.getlimit ( ) qui retourne la valeur d'une limitation.

EXEMPLE. 

import sqlite3

BDD_Connexion = sqlite3.Connection ( ":memory:" )

print ( "SQLITE_LIMIT_LENGTH :" , BDD_Connexion.getlimit ( sqlite3.SQLITE_LIMIT_LENGTH ) )

BDD_Connexion.getlimit ( sqlite3.SQLITE_LIMIT_LENGTH , 5 )

print ( "SQLITE_LIMIT_LENGTH :" , BDD_Connexion.getlimit ( sqlite3.SQLITE_LIMIT_LENGTH ) )

print ( BDD_Connexion.getlimit ( sqlite3.SQLITE_LIMIT_LENGTH , 10 ) )

print ( "SQLITE_LIMIT_LENGTH :" , BDD_Connexion.getlimit ( sqlite3.SQLITE_LIMIT_LENGTH ) )

BDD_Connexion.close ( )