
Client Python Groonga. Support de Poyonga au protocole HTTP et GQTP.
De Pip:
Pip Install - Poyonga de mise à niveau
$ groonga -n grn.db # Créer un fichier de base de données Groonga $ groonga -s grn.db # Démarrer le serveur Groonga avec GQTP
> >> from poyonga import Groonga
> >> g = Groonga ()
> >> g . protocol
'http'
> >> ret = g . call ( "status" )
> >> ret
< poyonga . result . GroongaResult object at 0x8505ccc >
> >> ret . status
0
> >> ret . body
{ u'uptime' : 427 , u'max_command_version' : 2 , u'n_queries' : 3 ,
u'cache_hit_rate' : 66.6666666666667 , u'version' : u'1.2.8' , u
'alloc_count' : 156 , u'command_version' : 1 , u'starttime' : 132
8286909 , u'default_command_version' : 1 }
> >> from poyonga import Groonga
import eventlet
eventlet . monkey_patch ()
def fetch ( cmd , ** kwargs ):
g = Groonga ()
ret = g . call ( cmd , ** kwargs )
print ret . status
print ret . body
print "*" * 40
cmds = [( "status" , {}),
( "log_level" , { "level" : "warning" }),
( "table_list" , {})
( "select" , { "table" : "Site" })]
pool = eventlet . GreenPool ()
for cmd , kwargs in cmds :
pool . spawn_n ( fetch , cmd , ** kwargs )
pool . waitall ()Si vous utilisez le chemin de préfixe personnalisé et les bases de données Multi, spécifiez Prefix_path.
# default is '/d/'
g = Groonga ( prefix_path = '/db2/' ) Groonga prend en charge Apache Arrow, utilisez-le avec des commandes load et select .
Utilisez Poyonga avec Apache Arrow, vous avez besoin de Pyarrow.
requrie pyarrow:
$ pip install pyarrow
et appelez avec output_type="apache-arrow" :
from poyonga import Groonga
g = Groonga ()
g . call (
"select" ,
table = "Users" ,
match_columns = "name,location_str,description" ,
query = "東京" ,
output_type = "apache-arrow" ,
output_columns = "_key,name" ,
)Note
output_type peut également spécifier poyonga.const.oututtype.apache_arrow. Si ce n'est pas spécifié, Poyonga.const.oututType.json est spécifié par défaut.
Chargez avec input_type="apache-arrow" :
import pyarrow as pa
from poyonga import Groonga
# use Apache Arrow IPC Streaming Format
data = [ pa . array ([ "groonga.org" ])]
batch = pa . record_batch ( data , names = [ "_key" ])
sink = pa . BufferOutputStream ()
with pa . ipc . new_stream ( sink , batch . schema ) as writer :
writer . write_batch ( batch )
buf = sink . getvalue ()
values = buf . to_pybytes ()
g = Groonga ()
g . call ( "load" , table = "Site" , values = values , input_type = "apache-arrow" )Note
Input_type peut également spécifier poyonga.const.inuttype.apache_arrow. Si ce n'est pas spécifié, Poyonga.const.inutType.json est spécifié par défaut.
Plus d'informations:
Voir le répertoire des exemples
Installez les dépendances de développement:
$ pip install ". [dev]"
Exécutez des tests:
$ pytest
Exécutez Linter:
$ Ruff.
Exécutez le formateur:
$ Black - Diff.