
عميل Python Groonga. دعم Poyonga لبروتوكول HTTP و GQTP.
من PIP:
PIP تثبيت -ترقية Poyonga
$ groonga -n grn.db # إنشاء ملف قاعدة بيانات Groonga $ groonga -s grn.db # ابدأ خادم Groonga مع 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 ()إذا كنت تستخدم مسار البادئة المخصصة وقواعد البيانات المتعددة ، فحدد prefix_path.
# default is '/d/'
g = Groonga ( prefix_path = '/db2/' ) Groonga يدعم Apache Arrow ، واستخدمه مع load select الأوامر.
استخدم Poyonga مع Apache Arrow ، تحتاج إلى Pyarrow.
Requrie Pyarrow:
$ pip تثبيت pyarrow
والاتصال باستخدام 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" ,
)ملحوظة
يمكن أيضًا تحديد poyonga.const.outputtype.apache_arrow poyonga.const.outputtype.apache_arrow. إذا لم يتم تحديدها ، تم تحديد poyonga.const.outputtype.json بشكل افتراضي.
تحميل باستخدام 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" )ملحوظة
يمكن أن يحدد input_type أيضًا poyonga.const.inputtype.apache_arrow. إذا لم يتم تحديدها ، تم تحديد poyonga.const.inputtype.json بشكل افتراضي.
مزيد من المعلومات:
انظر دليل الأمثلة
تثبيت تبعيات DEV:
تثبيت $ pip ". [dev]"
إجراء اختبارات:
$ pytest
Run Linter:
$ ruff.
تشغيل التنسيق:
$ أسود -ديف.