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.

  • ✍️ Schrijf met put: Het `put`-commando slaat een waarde op in een tabel, rij, kolom en optioneel met een tijdstempel.
  • 🔍 Lezen met get: De `get`-opdracht retourneert één rij of cel, met de opties `TIMERANGE`, `VERSIONS` en `FILTERS`.
  • 📜 Bladeren met scannen: De scanopdracht geeft een lijst weer van meerdere rijen en hun kolomwaarden in een tabel.
  • ☕ Java API: Dezelfde bewerkingen worden uitgevoerd in Java met behulp van Put, Get, Scan en de Bytes-helperklasse.
  • 🧬 coördinaten: Elke waarde wordt aangeduid met een rijsleutel, kolomfamilie en kolomkwalificatie.
  • 🤖 AI-ondersteuning: AI-assistenten ontwerpen put-, get- en scan-code en stellen efficiënte rij-sleutelontwerpen voor.

HBase put(), get() en scan() query-opdrachten in de shell en Java

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.

HBase shell put-opdracht die de waarden 10, 15 en 30 in de tabel guru99 invoegt

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:

Uitvoer van het HBase shell scan-commando met een lijst van rijen en kolomwaarden in tabel guru99

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 shell get-opdracht retourneert één rij r1 uit tabel guru99

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":

Java Code die een HBase-configuratie aanmaakt en waarden invoegt met de Put API.

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":

Java console-uitvoer die de waarden van de kolommen 'education' en 'projects' uit de HBase-tabel guru99 leest

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.

Veelgestelde vragen

De `get`-opdracht haalt één rij op aan de hand van de rijsleutel en retourneert snel een resultaat. De `scan`-opdracht leest meerdere rijen achter elkaar in een tabel of binnen een sleutelbereik, eventueel gefilterd op kolommen of tijd. Gebruik `get` voor het opzoeken van één rij en `scan` voor het bekijken of exporteren van meerdere rijen.

Een kolomfamilie is een benoemde groep kolommen die samen worden opgeslagen en gedefinieerd bij het aanmaken van de tabel. Een kolomkwalificatie is de individuele kolomnaam binnen die familie, bijvoorbeeld education:col1. Families moeten in het schema aanwezig zijn; kwalificaties kunnen naar wens worden toegevoegd tijdens het schrijven.

Gebruik de opdracht `delete` om één cel te verwijderen, bijvoorbeeld `delete 'guru99', 'r1', 'c1'`. Gebruik `deleteall` om een ​​hele rij te verwijderen: `deleteall 'guru99', 'r1'`. Om een ​​tabel volledig leeg te maken, schakelt u deze uit en voert u vervolgens `truncate 'guru99'` uit. Hiermee wordt de tabel verwijderd en opnieuw aangemaakt.

HBase bewaart meerdere versies van elke cel, voorzien van een tijdstempel. Het aantal bewaarde versies wordt per kolomfamilie ingesteld door het attribuut VERSIONS, dat standaard op 1 staat. Voeg {VERSIONS => 3} toe aan een get- of scan-query om meerdere versies op te halen, of een TIMESTAMP om één exacte versie op te halen.

Gebruik `run list` om alle tabellen in HBase te bekijken. Gebruik `run count 'guru99'` om het aantal rijen in een tabel te tellen, eventueel met een `INTERVAL` voor de voortgang. Gebruik `describe 'guru99'` om kolomfamilies te bekijken en `status 'simple'` om de clusterstatus te controleren.

HBase heeft geen ingebouwde SQL-functionaliteit, maar Apache Phoenix voegt een SQL-laag toe die query's omzet in native put-, get- en scan-bewerkingen. Het ondersteunt de bekende SELECT-, UPSERT- en JOIN-syntaxis, waardoor HBase gemakkelijker te bevragen is voor teams die al bekend zijn met SQL.

AI-codeerassistenten en grote taalmodellen kunnen HBase-shellopdrachten opstellen en Java Clientcode genereren vanuit een eenvoudige prompt, suggesties doen voor rij-sleutelontwerpen en scanfilters uitleggen. Machine learning helpt ook bij het optimaliseren van de prestaties door 'hot regions' te voorspellen, hoewel een engineer elke gegenereerde query moet controleren.

Ja. GitHub-copiloot kan HBase put-, get- en scan-fragmenten genereren in Java of de shell vanuit een korte opmerking, inclusief Bytes.toBytes-aanroepen en scanfilters. RevControleer de uitvoer voor de juiste tabelnaam, kolomfamilies en de huidige tabel-API voordat u deze uitvoert.

Vat dit bericht samen met: