Voorbeeld van een HBase-query: de commando's put(), get() en scan().
⚡ Slimme samenvatting
HBase put, get en scan zijn de belangrijkste commando's voor het schrijven en lezen van data. Hiermee kun je een celwaarde per rij en kolom opslaan, een enkele rij ophalen of door meerdere rijen bladeren vanuit de shell. Java API.

Gegevens schrijven naar HBase-tabel: Shell
Deze voorbeelden gaan ervan uit dat HBase geïnstalleerd en operationeel, de HBase-shell is geopend, en een tabel met de naam guru99 Het bestaat al met de rubriek 'Gezinnen, onderwijs en projecten'.
Het `put`-commando wordt gebruikt om gegevens in een tabel op te slaan.
Syntax: put <'tablename'>,<'rowname'>,<'columnvalue'>,<'value'>
Dit commando wordt gebruikt voor de volgende doeleinden:
- Het plaatst een celwaarde in een gedefinieerde of gespecificeerde tabel, rij of kolom.
- Het kan optioneel een tijdstempel toevoegen.
Hier plaatsen we bijvoorbeeld waarden in tabel "guru99" onder rij r1 en kolom c1:
hbase> put 'guru99', 'r1', 'c1', 'value', 10
We hebben drie waarden, 10, 15 en 30, in tabel "guru99" geplaatst, zoals te zien is in de onderstaande schermafbeelding.
Stel dat de tabel "guru99" een tabelverwijzing heeft, bijvoorbeeld g. Je kunt de opdracht ook uitvoeren op de tabelverwijzing, zoals dit:
hbase> g.put 'guru99', 'r1', 'c1', 'value', 10
De uitvoer ziet eruit zoals weergegeven in de bovenstaande schermafbeelding nadat waarden in "guru99" zijn ingevoerd.
Gegevens lezen uit de HBase-tabel: Shell
In dit gedeelte controleren we het volgende in de HBase-schaal:
- Waarden die worden ingevoegd in de HBase-tabel "guru99".
- Kolomnamen met de waarden die aanwezig zijn in de HBase-tabel guru99.
De onderstaande scanuitvoer toont elke waarde die in “guru99” is ingevoerd, samen met de bijbehorende rij- en kolomnamen:
Uit de bovenstaande schermafbeelding kunnen we het volgende afleiden:
- Als we het commando "scan" uitvoeren in de HBase-shell, worden de ingevoegde waarden in "guru99" als volgt weergegeven.
- In de HBase-shell worden de door onze code ingevoegde waarden weergegeven, inclusief de kolom- en rijnamen.
- Hier zien we dat de ingevoegde kolomnamen 'onderwijs' en 'projecten' zijn.
- De waarden die in de genoemde kolommen zijn ingevoerd, zijn "BigData" en "HBase Tutorials".
Je kunt de `get`-opdracht ook gebruiken om gegevens uit een tabel te lezen.
Syntax: get <'tablename'>, <'rowname'>, {< Additional parameters>}
De extra parameters omvatten hier TIMERANGE, TIMESTAMP, VERSIONS en FILTERS. Met deze opdracht krijgt u een rij of de celinhoud uit de tabel. U kunt extra parameters toevoegen, zoals TIMESTAMP, TIMERANGE, VERSIONS of FILTERS, om een specifieke rij of celinhoud op te halen. De onderstaande tabel geeft een overzicht van deze parameters:
| Parameter | Doel |
|---|---|
| TIJDSBESTEK | Retourneert cellen waarvan de tijdstempel binnen een bepaald begin- en eindtijdstip valt. |
| TIJDSTAMP | Geeft alleen de celversie terug die op een exact tijdstempel is opgeslagen. |
| VERSIES | Hiermee wordt ingesteld hoeveel versies van een cel moeten worden geretourneerd (de standaardwaarde is 1). |
| FILTERS | Past een filter toe om te bepalen welke rijen of kolommen worden weergegeven. |
| COLUMN | Beperkt het resultaat tot specifieke kolomfamilies of kwalificaties. |
Hieronder volgen enkele voorbeelden van het gebruik van het `get`-commando:
hbase> get 'guru99', 'r1', {COLUMN => 'c1'}
Voor tabel "guru99" worden de waarden van rij r1 en kolom c1 weergegeven met behulp van dit commando, zoals te zien is in de onderstaande schermafbeelding.
hbase> get 'guru99', 'r1'
Voor tabel “guru99” worden de waarden van rij r1 weergegeven met behulp van dit commando.
hbase> get 'guru99', 'r1', {TIMERANGE => [ts1, ts2]}
Voor tabel “guru99” worden de waarden van rij r1 in het tijdsbereik ts1 tot ts2 weergegeven met behulp van dit commando.
hbase> get 'guru99', 'r1', {COLUMN => ['c1', 'c2', 'c3']}
Voor tabel “guru99” worden de waarden van rij r1 en kolomfamilies c1, c2 en c3 weergegeven met behulp van dit commando.
Gegevens naar HBase-tabel schrijven: JAVA API
In deze stap gaan we gegevens schrijven naar de HBase-tabel "guru99".
Allereerst moeten we code schrijven om waarden in HBase in te voegen en op te halen, met behulp van het programma HBaseLoading.java. Voor het aanmaken en invoegen van waarden in een tabel op kolomniveau, gebruikt u de onderstaande code.
De onderstaande schermafbeelding toont de Java Code die de HBase-configuratie opbouwt en waarden invoegt in "guru99":
Uit de bovenstaande schermafbeelding:
- Bij het aanmaken van de HBase-configuratie verwijst deze naar de configuraties die we tijdens de HBase-installatie in de bestanden hbase-site.xml en hbase-default.xml hebben ingesteld.
- Het aanmaken van de tabel "guru99" met behulp van de HTable-methode.
- Rij 1 toevoegen aan tabel “guru99”.
- De kolomnamen "onderwijs" en "projecten" worden gespecificeerd en er worden waarden ingevoegd in de respectievelijke kolomnamen in rij 1. De hier ingevoegde waarden zijn bigdata en “HBaseTutorials”.
Gegevens uit de HBase-tabel lezen: Java API
De waarden die we in het vorige gedeelte in de HBase-tabel hebben geplaatst, gaan we hier ophalen en weergeven.
De onderstaande console-uitvoer toont de gegevens die worden teruggelezen uit de HBase-tabel "guru99":
Voor het ophalen van resultaten die zijn opgeslagen in “guru99”:
- Hier gaan we de waarden ophalen die zijn opgeslagen in de kolomfamilies, namelijk "onderwijs" en "projecten".
- Met behulp van het commando "get" gaan we de opgeslagen waarden uit de HBase-tabel ophalen.
- Scanresultaten met behulp van het commando "scan". De waarden die in rij 1 zijn opgeslagen, worden op de console weergegeven.
Zodra de code geschreven is, voer je deze uit. Java toepassing soortgelijk:
Klik met de rechtermuisknop op HBaseLoading.java -> Uitvoeren als -> Java Toepassing.
Na het uitvoeren van “HBaseLoading.java” worden de waarden ingevoegd in “guru99” in elke kolom in HBase, en in hetzelfde programma kunnen de waarden ook weer worden opgehaald.
Hier is de volledige code:
import java.io.IOException; import org.apache.hadoop.hbase.HBaseConfiguration; import org.apache.hadoop.hbase.client.Get; import org.apache.hadoop.hbase.client.HTable; import org.apache.hadoop.hbase.client.Put; import org.apache.hadoop.hbase.client.Result; import org.apache.hadoop.hbase.client.ResultScanner; import org.apache.hadoop.hbase.client.Scan; import org.apache.hadoop.hbase.util.Bytes; public class HBaseLoading { public static void main(String[] args) throws IOException { /* When you create a HBaseConfiguration, it reads in whatever you've set into your hbase-site.xml and in hbase-default.xml, as long as these can be found on the CLASSPATH*/ org.apache.hadoop.conf.Configuration config = HBaseConfiguration.create(); /*This instantiates an HTable object that connects you to the "test" table*/ HTable table = new HTable(config, "guru99"); /* To add to a row, use Put. A Put constructor takes the name of the row you want to insert into as a byte array.*/ Put p = new Put(Bytes.toBytes("row1")); /*To set the value you'd like to update in the row 'row1', specify the column family, column qualifier, and value of the table cell you'd like to update. The column family must already exist in your table schema. The qualifier can be anything.*/ p.add(Bytes.toBytes("education"), Bytes.toBytes("col1"),Bytes.toBytes("BigData")); p.add(Bytes.toBytes("projects"),Bytes.toBytes("col2"),Bytes.toBytes("HBaseTutorials")); // Once you've adorned your Put instance with all the updates you want to make, to commit it do the following table.put(p); // Now, to retrieve the data we just wrote. Get g = new Get(Bytes.toBytes("row1")); Result r = table.get(g); byte [] value = r.getValue(Bytes.toBytes("education"),Bytes.toBytes("col1")); byte [] value1 = r.getValue(Bytes.toBytes("projects"),Bytes.toBytes("col2")); String valueStr = Bytes.toString(value); String valueStr1 = Bytes.toString(value1); System.out.println("GET: " +"education: "+ valueStr+"projects: "+valueStr1); Scan s = new Scan(); s.addColumn(Bytes.toBytes("education"), Bytes.toBytes("col1")); s.addColumn(Bytes.toBytes("projects"), Bytes.toBytes("col2")); ResultScanner scanner = table.getScanner(s); try { for (Result rr = scanner.next(); rr != null; rr = scanner.next()) { System.out.println("Found row : " + rr); } } finally { // Make sure you close your scanners when you are done! scanner.close(); } } }
Opmerking over API-versies: Het bovenstaande voorbeeld gebruikt de HTable-klasse en de add()-methode, die de oudere HBase-client-API weerspiegelen. Sinds HBase 1.0 is HTable verouderd. Moderne code verkrijgt een tabel via ConnectionFactory.createConnection(…).getTable(…) en bouwt een put-verzoek met addColumn() in plaats van add(). De logica van put, get en scan blijft hetzelfde.





