.. -*- rst -*- .. highlightlang:: none grntest ======= åå ---- grntest - groongaãã¹ãããã°ã©ã æ¸å¼ ---- :: grntest [options...] [script] [db] 説æ ---- grntestã¯ãgroongaæ±ç¨ãã¹ããã¼ã«ã§ãã groongaãåç¬ã®ããã»ã¹ã¨ãã¦å©ç¨ããå ´åã¯ãã¡ããããµã¼ãããã°ã©ã ã¨ãã¦å©ç¨ããå ´åã®åä½ç¢ºèªãå®è¡é度測å®ãå¯è½ã§ãã grntestç¨ã®ãã¼ã¿ãã¡ã¤ã«ã¯èªåã§ä½æãããã¨ãæ¢åã®ãã®ãå©ç¨ãããã¨ãã§ãã¾ããæ¢åã®ãã¼ã¿ãã¡ã¤ã«ã¯ãftp.groonga.orgããå¿ è¦ã«å¿ããã¦ã³ãã¼ããã¾ãããã®ãããgroongaåã³grntestãåä½ããã¤ã³ã¿ã¼ãããã«æ¥ç¶ã§ããç°å¢ã§ããã°groongaã³ãã³ãã®ç¥èããªãã¦ãgroongaã®åä½ã確èªã§ãã¾ãã ç¾å¨ã¯ãLinux åã³Windowsä¸ã§åä½ãã¾ããmake installãã¦ãã¤ã³ã¹ãã¼ã«ã¯è¡ããã¾ããã ãªãã·ã§ã³ ---------- .. cmdoption:: -i, --host <ip/hostname> æ¥ç¶ããgroongaãµã¼ãããipã¢ãã¬ã¹ã¾ãã¯ãã¹ãåã§æå®ãã¾ããæå®å ã«groongaãµã¼ããç«ã¡ä¸ãã£ã¦ããªãå ´åãæ¥ç¶ä¸è½ã¨ãªããã¨ã«æ³¨æãã¦ãã ããããã®ãªãã·ã§ã³ãæå®ããªãå ´åãgrntestã¯èªåçã«localhostã®groongaãµã¼ããèµ·åãã¦æ¥ç¶ãã¾ãã .. cmdoption:: -p, --port <port number> èªåçã«èµ·åããgroongaãµã¼ããã¾ãã¯æ示çã«æå®ããæ¥ç¶å ã®groonga ãµã¼ããå©ç¨ãããã¼ãçªå·ãæå®ãã¾ããæ¥ç¶å ã®groongaãµã¼ããå©ç¨ãã¦ãããã¼ãã¨ããã®ãªãã·ã§ã³ã§æå®ãããã¼ãçªå·ãç°ãªãå ´åãæ¥ç¶ä¸è½ã¨ãªããã¨ã«æ³¨æãã¦ãã ããã .. cmdoption:: --dir ftp.groonga.org ã«ç¨æããã¦ããã¹ã¯ãªãããã¡ã¤ã«ã表示ãã¾ãã .. cmdoption:: --ftp ftp.groonga.orgã¨FTPéä¿¡ãè¡ããscriptãã¡ã¤ã«ã®åæããã°ãã¡ã¤ã«ã®éä¿¡ãè¡ãã¾ãã .. cmdoption:: --log-output-dir ããã©ã«ãã§ã¯ãgrntestçµäºå¾ã®ãã°ãã¡ã¤ã«ã®åºåå ã¯ã¯ã«ã¬ã³ããã£ã¬ã¯ããªã§ãããã®ãªãã·ã§ã³ãå©ç¨ããã¨ãä»»æã®ãã£ã¬ã¯ããªã«åºåå ãå¤æ´ãããã¨ãã§ãã¾ãã .. cmdoption:: --groonga <groonga_path> groongaã³ãã³ãã®ãã¹ãæå®ãã¾ããããã©ã«ãã§ã¯ãPATHã®ä¸ããgroongaã³ãã³ããæ¢ãã¾ãã .. cmdoption:: --protocol <gqtp|http> groongaã³ãã³ãã使ããããã³ã«ã¨ã㦠`gqtp` ã¾ã㯠`http` ãæå®ãã¾ãã å¼æ° ---- .. cmdoption:: script grntestã®åä½æ¹æ³(以ä¸ãgrntestå½ä»¤ã¨å¼ã³ã¾ã)ãè¨è¿°ããããã¹ããã¡ã¤ã«ã§ããæ¡å¼µåã¯.scrã§ãã .. cmdoption:: db grntestãå©ç¨ããgroonga ãã¼ã¿ãã¼ã¹ã§ããæå®ããããã¼ã¿ãã¼ã¹ãåå¨ããªãå ´åãgrntestãæ°è¦ã«ä½æãã¾ããã¾ãgroonga ãµã¼ããèªåçã«èµ·åããå ´åããã®å¼æ°ã§æå®ãããã¼ã¿ãã¼ã¹ãå©ç¨ããã¾ããæ¥ç¶ããgroonga ãµã¼ããæ示çã«æå®ããå ´åã«å©ç¨ãããã¼ã¿ãã¼ã¹ã¯ãæ¥ç¶å ãµã¼ãã使ç¨ä¸ã®ãã¼ã¿ãã¼ã¹ã«ãªããã¨ã«æ³¨æãã¦ãã ããã 使ãæ¹ ------ ã¾ããã·ã§ã«ä¸(Windowsãªãã³ãã³ãããã³ããä¸)ã§:: grntest test.scr ä»»æã®DBå ã¨ã¿ã¤ããã¦ãã ãããããgrntestãæ£å¸¸ã«åä½ããã°ã:: test-ã¦ã¼ã¶å-æ°å.log ã¨ãããã¡ã¤ã«ãä½æãããã¯ãã§ããä½æãããªãå ´åããã®ããã¥ã¡ã³ãã®ããã©ãã«ã·ã¥ã¼ãã£ã³ã°ãã®ç« ãåç §ãã¦ãã ããã ã¹ã¯ãªãããã¡ã¤ã« ------------------ ã¹ã¯ãªãããã¡ã¤ã«ã¯ãgrntestå½ä»¤ãè¨è¿°ããããã¹ããã¡ã¤ã«ã§ãã ";"ã»ãã³ãã³ãå©ç¨ãã¦ãä¸è¡ã«è¤æ°ã®grntestå½ä»¤ãè¨è¿°ãããã¨ãã§ãã¾ããä¸è¡ã«è¤æ°ã®grntestå½ä»¤ãããå ´åãåå½ä»¤ã¯ä¸¦åã«å®è¡ããã¾ãã "#"ã§å§ã¾ãè¡ã¯ã³ã¡ã³ãã¨ãã¦æ±ããã¾ãã grntestå½ä»¤ ^^^^^^^^^^^ ç¾å¨ãµãã¼ãããã¦ããgrntestå½ä»¤ã¯ä»¥ä¸ã®8ã¤ã§ãã do_local ã³ãã³ããã¡ã¤ã« [ã¹ã¬ããæ°] [ç¹°ãè¿ãæ°] ã³ãã³ããã¡ã¤ã«ãgrnteståä½ã§å®è¡ãã¾ããã¹ã¬ããæ°ãæå®ããã¦ããå ´åãè¤æ°ã®ã¹ã¬ããã§åãã³ãã³ããã¡ã¤ã«ãåæã«å®è¡ãã¾ããç¹°ãè¿ãæ°ãæå®ããã¦ãå ´åãã³ãã³ããã¡ã¤ã«ã®å 容ãç¹°ãè¿ãå®è¡ãã¾ããã¹ã¬ããæ°ãç¹°ãè¿ãæ°ã¨ãçç¥æã¯1ã§ãã1ã¹ã¬ããã§è¤æ°ååä½ããããå ´åã¯ãdo_local ã³ãã³ããã¡ã¤ã« 1 [ç¹°ãè¿ãæ°]ã¨æ示çã«æå®ãã¦ãã ããã do_gqpt ã³ãã³ããã¡ã¤ã« [ã¹ã¬ããæ°] [ç¹°ãè¿ãæ°] ã³ãã³ããã¡ã¤ã«ãgroongaãµã¼ãã§å®è¡ãã¾ããã¹ã¬ããæ°ãç¹°ãè¿ãæ°ã®æå³ã¯do_localã®å ´åã¨åãã§ãã rep_local ã³ãã³ããã¡ã¤ã« [ã¹ã¬ããæ°] [ç¹°ãè¿ãæ°] ã³ãã³ããã¡ã¤ã«ãgrnteståä½ã§å®è¡ãããã詳細ãªå ±åãè¡ãã¾ãã rep_gqpt ã³ãã³ããã¡ã¤ã« [ã¹ã¬ããæ°] [ç¹°ãè¿ãæ°] ã³ãã³ããã¡ã¤ã«ãgroongaãµã¼ãã§å®è¡ãããã詳細ãªå ±åãè¡ãã¾ãã ã¹ã¬ããæ°ãç¹°ãè¿ãæ°ã®æå³ã¯do_local㨠åãã§ãã out_local ã³ãã³ããã¡ã¤ã« å ¥åãã¡ã¤ã«å ã³ãã³ããã¡ã¤ã«ãgrnteståä½ã§å®è¡ããåã³ãã³ãã®å®è¡çµæããã¹ã¦âåºåãã¡ã¤ã«"ã«æ¸ãã ãã¾ãããã®çµæã¯ãtest_local,ãtest_gqtpå½ä»¤ã§å©ç¨ãã¾ãããªããã®å½ä»¤ã®ãåºåãã¡ã¤ã«ãã¨ã¯ãgrntestå®è¡æã«èªåçã«ä½æããããã°ã¨ã¯å¥ã®ãã®ã§ããgrntestã§ã¯ã³ã¡ã³ããå©ç¨ã§ãã以å¤ã:: groonga < ã³ãã³ããã¡ã¤ã« > åºåãã¡ã¤ã« ã¨ããå ´åã¨åãã§ãã out_gqtp ã³ãã³ããã¡ã¤ã« åºåãã¡ã¤ã«å ã³ãã³ããã¡ã¤ã«ãgroongaãµã¼ãã§å®è¡ãã¾ãããã®ä»ã¯out_localå½ä»¤ã¨åçã§ãã test_local ã³ãã³ããã¡ã¤ã« å ¥åãã¡ã¤ã«å ã³ãã³ããã¡ã¤ã«ãgrnteståä½ã§å®è¡ããåã³ãã³ãã®å®è¡çµæãå ¥åãã¡ã¤ã«ã¨æ¯è¼ãã¾ããå¦çæéãªã©æ¬è³ªçè¦ç´ 以å¤ã«å·®åããã£ãå ´åãå·®åããå ¥åãã¡ã¤ã«.diffã¨ãããã¡ã¤ã«ã«æ¸ãã ãã¾ãã ã³ãã³ããã¡ã¤ã« ^^^^^^^^^^^^^^^^ ã³ãã³ããã¡ã¤ã«ã¯ãgroongaçµã¿è¾¼ã¿ã³ãã³ãã1è¡ã«1ã¤ãã¤è¨è¿°ããããã¹ããã¡ã¤ã«ã§ããæ¡å¼µåã«å¶éã¯ããã¾ãããgroongaçµã¿è¾¼ã¿ã³ãã³ãã«é¢ãã¦ã¯ :doc:`/reference/command` ãåç §ãã¦ãã ããã ãµã³ãã« ^^^^^^^^ ã¹ã¯ãªãããã¡ã¤ã«ã®ãµã³ãã«ã§ãã:: # sample script rep_local test.ddl do_local test.load; do_gqtp test.select 10 10; do_local test.status 10 ä¸è¨ã®æå³ã¯ä»¥ä¸ã®ã¨ããã§ãã 1è¡ç® ã³ã¡ã³ãè¡ã 2è¡ç® test.dll ã¨ããã³ãã³ããã¡ã¤ã«ãgroongaåä½ã§å®è¡ãã詳細ã«å ±åããã 3è¡ç® test.load ã¨ããã³ãã³ããã¡ã¤ã«ãgroongaåä½ã§å®è¡ããã(æå¾ã®";"ã»ãã³ãã³ã¯è¤æ°ã®grntestå½ä»¤ãè¨è¿°ããå ´åã«å¿ è¦ã§ããããã®ä¾ã®ããã«1ã¤ã®grntestå½ä»¤ãå®è¡ããå ´åã«ä»ä¸ãã¦ãåé¡ããã¾ããã) 4è¡ç® test.select ã¨ããã³ãã³ããã¡ã¤ã«ãgroongaãµã¼ãã§10åã®ã¹ã¬ããã§åæã«å®è¡ãããåã¹ã¬ããã¯test.selectã®ä¸èº«ã10åç¹°ãè¿ããã¾ãåæã«ãgroongaåä½ã§test.statusã¨ããã³ãã³ããã¡ã¤ã«ã10åã®ã¹ã¬ããã§å®è¡ããã ç¹æ®å½ä»¤ ^^^^^^^^ ã¹ã¯ãªãããã¡ã¤ã«ã®ã³ã¡ã³ãè¡ã«ã¯ç¹æ®ã³ãã³ããåãè¾¼ããã¨ãå¯è½ã§ããç¾å¨ãµãã¼ãããã¦ããç¹æ®å½ä»¤ã¯ä»¥ä¸ã®äºã¤ã§ãã #SET_HOST <ip/hostname> -i, --hostãªãã·ã§ã³ã¨åçã®æ©è½ã§ããã³ãã³ãã©ã¤ã³ãªãã·ã§ã³ã«æå®ããIPã¢ãã¬ã¹/ãã¹ãåã¨ãSET_HOSTã§æå®ããIPã¢ãã¬ã¹/ãã¹ãåãç°ãªãå ´åãã¾ãã³ãã³ãã©ã¤ã³ãªãã·ã§ã³ãæå®ããªãã£ãå ´åã«ãSET_HOSTãåªå ããã¾ããSET_HOSTãå©ç¨ããå ´åããµã¼ããèªåçã«ã¯èµ·åãããªãã®ãã³ãã³ãã©ã¤ã³ãªãã·ã§ã³ã§æå®ããå ´åã¨åæ§ã§ãã #SET_PORT <port number> -p, --port ãªãã·ã§ã³ã¨åçã®æ©è½ã§ããã³ãã³ãã©ã¤ã³ãªãã·ã§ã³ã«æå®ãããã¼ãçªå·ã¨SET_PORTã§æå®ãããã¼ãçªå·ãç°ãªãå ´åãã¾ãã³ãã³ãã©ã¤ã³ãªãã·ã§ã³ãæå®ããªãã£ãå ´åã«ãSET_PORTãåªå ããã¾ãã ç¹æ®å½ä»¤ã¯ã¹ã¯ãªãããã¡ã¤ã«ã®ä»»æã®å ´æã«æ¸ãè¾¼ããã¨ãã§ãã¾ããåä¸ãã¡ã¤ã«å ã«è¤æ°åç¹æ®å½ä»¤ãè¨è¿°ããå ´åããæå¾ã®ãç¹æ®å½ä»¤ãæå¹ã¨ãªãã¾ãã ä¾ãã°ã :: $ ./grntest --port 20010 test.scr testdb ã¨ã³ãã³ãä¸ã§ãã¼ããæå®ããå ´åã§ããããtest.scrã®ä¸èº«ã :: #SET_PORT 10900 rep_local test.ddl do_local test.load; rep_gqtp test.select 10 10; rep_local test.status 10 #SET_PORT 10400 ã§ããã°ãèªåçã«èµ·åãããgroongaãµã¼ãã¯ãã¼ãçªå·10400ãå©ç¨ãã¾ãã grntestå®è¡çµæ --------------- grntestãæ£å¸¸ã«çµäºããã¨ã(æ¡å¼µåãé¤ãã)ã¹ã¯ãªããå-ã¦ã¼ã¶å-å®è¡éå§æå».logã¨ããå½¢å¼ã®ãã°ãã¡ã¤ã«ãã«ã¬ã³ããã£ã¬ã¯ããªã«ä½ããã¾ãããã°ãã¡ã¤ã«ã¯èªåçã«ftp.groonga.org ã«éä¿¡ããã¾ãããã°ãã¡ã¤ã«ã¯ä»¥ä¸ã®ãããªjsonå½¢å¼ã®ããã¹ãã§ãã :: [{"script": "test.scr", "user": "homepage", "date": "2010-04-14 22:47:04", "CPU": Intel(R) Pentium(R) 4 CPU 2.80GHz", "BIT": 32, "CORE": 1, "RAM": "975MBytes", "HDD": "257662232KBytes", "OS": "Linux 2.4.20-24.7-i686", "HOST": "localhost", "PORT": "10041", "VERSION": "0.1.8-100-ga54c5f8" }, {"jobs": "rep_local test.ddl", "detail": [ [0, "table_create res_table --key_type ShortText", 1490, 3086, [0,1271252824.25846,0.00144 7]], [0, "column_create res_table res_column --type Text", 3137, 5956, [0,1271252824.2601,0.002 741]], [0, "column_create res_table user_column --type Text", 6020, 8935, [0,1271252824.26298,0.0 02841]], [0, "column_create res_table mail_column --type Text", 8990, 11925, [0,1271252824.26595,0. 002861]], [0, "column_create res_table time_column --type Time", 12008, 13192, [0,1271252824.26897,0 .001147]], [0, "status", 13214, 13277, [0,1271252824.27018,3.0e-05]], [0, "table_create thread_table --key_type ShortText", 13289, 14541, [0,1271252824.27025,0. 001213]], [0, "column_create thread_table thread_title_column --type ShortText", 14570, 17380, [0,12 71252824.27153,0.002741]], [0, "status", 17435, 17480, [0,1271252824.2744,2.7e-05]], [0, "table_create lexicon_table --flags 129 --key_type ShortText --default_tokenizer Token Bigram", 17491, 18970, [0,1271252824.27446,0.001431]], [0, "column_create lexicon_table inv_res_column 514 res_table res_column ", 18998, 33248, [0,1271252824.27596,0.01418]], [0, "column_create lexicon_table inv_thread_column 514 thread_table thread_title_column ", 33285, 48472, [0,1271252824.29025,0.015119]], [0, "status", 48509, 48554, [0,1271252824.30547,2.7e-05]]], "summary" :[{"job": "rep_local test.ddl", "latency": 48607, "self": 47719, "qps": 272.4281 73, "min": 45, "max": 15187, "queries": 13}]}, {"jobs": "do_local test.load; ", "summary" :[{"job": "do_local test.load", "latency": 68693, "self": 19801, "qps": 1010.049 997, "min": 202, "max": 5453, "queries": 20}]}, {"jobs": "do_gqtp test.select 10 10; do_local test.status 10", "summary" :[{"job": " do_local test.status 10", "latency": 805990, "self": 737014, "qps": 54.273053, "min": 24, "max": 218, "queries": 40},{"job": "do_gqtp test.select 10 10", "lat ency": 831495, "self": 762519, "qps": 1967.164097, "min": 73, "max": 135631, "queries": 15 00}]}, {"total": 915408, "qps": 1718.359464, "queries": 1573}] å¶éäºé -------- * ã¹ã¯ãªãããã¡ã¤ã«ã®ä¸è¡ã«ã¯è¤æ°ã®grntestå½ä»¤ãè¨è¿°ã§ãã¾ããããã¹ã¦ã®ã¹ã¬ããæ°ã®åè¨ã¯æ大64ã¾ã§ã«å¶éããã¾ãã * ã³ãã³ããã¡ã¤ã«ä¸ã®groongaã³ãã³ãã®é·ãã¯æé·5000000byteã§ãã ãã©ãã«ã·ã¥ã¼ãã£ã³ã° ---------------------- ãããgrntestãæ£å¸¸ã«åä½ããªãå ´åãã¾ã以ä¸ã確èªãã¦ãã ããã * ã¤ã³ã¿ã¼ãããã«æ¥ç¶ãã¦ãããï¼ `--ftp` ãªãã·ã§ã³ãæå®ããã¨ãgrntestã¯åä½ã®ãã³ã«ftp.groonga.orgã¨éä¿¡ãã¾ããftp.groonga.orgã¨éä¿¡å¯è½ã§ãªãå ´åãgrntestã¯æ£å¸¸ã«åä½ãã¾ããã * groonga ãµã¼ããåä½ãã¦ããªããï¼ãgrntestã¯ã-i, --host ãªãã·ã§ã³ã§æ示çã«ãµã¼ããæå®ããªãããããèªåçã«localhostã®groongaãµã¼ããç«ã¡ä¸ãã¾ãããã§ã«groongaãµã¼ããåä½ãã¦ããå ´åãgrntestã¯æ£å¸¸ã«åä½ããªãå¯è½æ§ãããã¾ãã * æå®ããDBãé©åãï¼ grntestã¯ãå¼æ°ã§æå®ããDBã®ä¸èº«ã¯ãã§ãã¯ãã¾ãããããæå®ãããDBãåå¨ããªããã°èªåçã«DBãä½æãã¾ããããããã¡ã¤ã«ã¨ãã¦åå¨ããå ´åã¯ä¸èº«ã«é¢ãããåä½ãç¶ãã¦ãã¾ããçµæãç°å¸¸ã«ãªãå¯è½æ§ãããã¾ãã 以ä¸ã®åå ã§ãªããã°ãåé¡ã¯grntestãgroongaã«ããã¾ãããå ±åããé¡ããã¾ãã