Phenquestions
Ebben a gyors oktatóanyagban megvizsgáljuk az Elasticsearch alkalmazást, konkrétan azt, hogy miként hozhatunk létre indexeket az Elasticsearch motorban. Bár az oktatóanyag követéséhez nincs szüksége átfogó ismeretekre az ELK veremről, előnyös lehet a következő témák alapos ismerete:
- A terminál használatával, konkrétan, a cURL
- Az API-k és a JSON alapismeretei
- HTTP kérés készítése
JEGYZET: Ez az oktatóanyag azt is feltételezi, hogy az Elasticsearch telepítve van és fut a rendszerén.
Mik azok az Elasticsearch indexek?
A dolgok túl egyszerűsítése vagy túlbonyolítása nélkül az Elasticsearch index a kapcsolódó JSON-dokumentumok gyűjteménye.
Ahogy egy korábbi bejegyzésben említettük, az Elasticsearch indexek a JSON objektumok, amelyek az Elasticsearch tárolásának alapegységének számítanak. Ezeket a kapcsolódó JSON dokumentumokat egyetlen egység tárolja, amely egy indexet alkot. Gondoljon az Elasticsearch dokumentumokra, mint táblákra egy relációs adatbázisban.
Kapcsoljuk össze az Elasticsearch indexet adatbázisként az SQL világban.
- MySQL => Adatbázisok => Táblázatok => Oszlopok / sorok
- Elasticsearch => indexek => típusok => JSON tulajdonságokkal rendelkező dokumentumok
Elasticsearch index létrehozása
Az Elasticsearch egy erőteljes és intuitív REST API-t használ szolgáltatásainak leleplezéséhez. Ez a funkció lehetővé teszi, hogy HTTP kéréseket használjon az Elasticsearch fürt műveleteinek végrehajtására. Ezért egy új index létrehozásához a index index API-t fogjuk használni.
Ebben az útmutatóban a cURL segítségével fogjuk elküldeni a kéréseket, és megőrizzük az integritást és a használhatóságot minden felhasználó számára. Ha azonban hibákat tapasztal a cURL használatával, fontolja meg a Kibana Console használatát.
Az Elasticsearch fürt új indexének létrehozásának szintaxisa:
PUT /Index létrehozásához mindössze annyit kell tennie, hogy más paraméterek nélkül adja át az index nevét, amely indexet hoz létre az alapértelmezett beállítások alapján.
Az index különféle tulajdonságait is megadhatja, például az index törzsében:
- Az index beállításai
- Index álnevek
- Indexmezők leképezései
Az index neve kötelező paraméter; különben hibaüzenetet kap az URIL (/) fájlhoz
curl -X PUT “localhost: 9200”"error": "Helytelen HTTP metódus az uri [/] és a [PUT] metódusok számára, megengedett: [DELETE, HEAD, GET]", "status": 405
Új index létrehozásához single_index néven átadjuk a kérést:
PUT / single_indexA cURL használatához használja a következő parancsot:
curl -X PUT "localhost: 9200 / single_index?szép"Ennek a parancsnak a 200 HTTP HTTP állapotot kell megadnia, és egy üzenetet a nyugtázott: true as:
„Elismert”: igaz,
"shards_acknowledged": igaz,
"index": "single_index"
A fenti kérés létrehoz egy indexet single_index alapértelmezett beállításokkal, mivel nem adtunk meg konfigurációkat.
Index elnevezési szabályok
Az Elasticsearch indexek nevének létrehozásakor be kell tartania a következő elnevezési szabványokat:
- Az indexnév csak kisbetűs lehet.
- Az indexnevek nem kezdődhetnek kötőjellel (-), aláhúzással (_) vagy kiegészítéssel (+)
- A nevek nem lehetnek . vagy…
- Az indexnevek nem tartalmazhatnak speciális karaktereket, például: \, /, *, ?, „, <, >, |, "(szóköz), ,, #
- Az indexnevek hosszának 255 bájtnál kisebbnek kell lennie. A több bájtos karakterek beleszámítanak az indexnév teljes hosszába. Például, ha egyetlen karakter hossza 8 bájt, a név fennmaradó teljes hossza 255-8
- Az Elasticsearch legújabb verziójában az a-val kezdődő nevek . az Elasticsearch bővítmények által használt rejtett indexek és belső indexek számára vannak fenntartva.
Hogyan hozzunk létre egy indextestet
Ha a PUT kérelmet index létrehozására használja, akkor különböző argumentumokat adhat át, amelyek meghatározzák a létrehozni kívánt index beállításait. A törzsben megadható értékek a következők:
- Álnevek: Megadja a létrehozni kívánt index álneveit; ez a paraméter nem kötelező.
- Beállítások: Ez meghatározza a létrehozni kívánt index konfigurációs beállításait. Ha nem ad meg paramétereket, az index az alapértelmezett konfigurációk segítségével jön létre.
- Leképezések: Ez meghatározza az index mezőinek leképezését. A leképezésekbe felvehető specifikációk a következők:
- A mező neve
- Az adattípus
- A leképezési paraméter
Tekintse meg az alábbi kérést a testkonfigurációkkal rendelkező index létrehozására:
PUT / single_index_wody_body"beállítások":
"szilánkok száma": 2,
"Replikák száma": 2
,
„Leképezések”:
"tulajdonságok":
"field1": "type": "object"
CURL egyenértékű kérelem esetén:
curl -XPUT "http: // localhost: 9200 / single_index_with_body" -H 'Content-Type: application / json' -d '"settings": "______________0_0_02_0 ">" "/ number_of_shards": 2, "number_of_replicas": 2, "leképezések" : "tulajdonságok": "mező1": "típus": "objektum" 'A fenti kérés új indexet hoz létre single_index_with_body névvel, 2 darab szilánkkal és 2 replikával. Ezenkívül létrehoz egy leképezést egy mező mező1 névvel és JSON objektumként.
A kérelem elküldése után választ kap a kérelem állapotával:
„Elismert”: igaz,
"shards_acknowledged": igaz,
"index": "single_index_with_body"
Az „Elismert” azt mutatja meg, hogy az index sikeresen létrejött-e a fürtben, míg az „shards_acknowledged” azt mutatja, hogy a megadott index minden darabjára megkezdték-e a szükséges számú szilánkos másolatot időtúllépés előtt.
Az Elasticsearch Index megtekintése
A létrehozott index információinak megtekintéséhez használjon hasonló kérést, mint egy index létrehozása, de a PUT helyett a HTTP metódust használja:
GET / single_index_wody_bodyA CURL számára,
curl -XGET “http: // localhost: 9200 / single_index_with_body”Ez a parancs részletes információkat nyújt a kért indexről:
"single_index_with_body":
"álnevek": ,
"leképezések":
"tulajdonságok":
"field1":
"type": "object"
,
"beállítások" :
"index":
"útvonalválasztás" :
"allokáció":
"include":
"_tier_preference": "data_content"
,
"__szeletek_száma ":" 2 ",
"megadott_név": "single_index_with_body",
"creation_date": "1611045687208",
"Replikák száma": "2",
"uuid": "3TRkO7xmQcSUOOGtb6pXVA",
"verzió":
"teremtett": "7100299"
Következtetés
Ez az útmutató megvitatta, hogyan kell együttműködni az Elasticsearch-szel az index API létrehozása érdekében új indexek létrehozásához. Megbeszéltük azt is, hogyan lehet megfelelő neveket létrehozni az indexekhez és a konfigurációs beállításokhoz.
Az útmutató használatával most létrehozhat és megtekinthet indexeket az Elasticsearch API használatával.
