すべてのプロダクト
Search

このプロダクト

    ApsaraDB for HBase:データクエリ

    ドキュメントセンター

    ApsaraDB for HBase:データクエリ

    最終更新日:Sep 17, 2026

    開発、デバッグ、または本番運用では、HBase のデータをクエリする必要があることがよくあります。HBase シェルを使用して Get リクエストや Scan リクエストを記述する方法に加え、Lindorm Insight はシンプルな SQL クエリのエントリポイントを提供します。SQL 構文を使用して、ApsaraDB for HBase Performance-enhanced Edition のワイドテーブル内のデータをクエリできます。

    前提条件

    開始する前に、次のことを確認してください：

    制限事項

    • データセキュリティを確保するため、各クエリは最大 100 行までしか返せません。

    • ROW フィールドは Lindorm の行キーに対応します。ROW と 修飾子 はどちらも varbinary 型です。修飾子 がカラムファミリーに属していない場合は、カラムファミリーを指定する必要があります。

    • ROW と COL は SQL 予約フィールドです。クエリで使用する際は、バッククォート (`) で囲む必要があります。また、修飾子 にカラムファミリーを指定する場合も、バッククォートで囲む必要があります。

    HBase 互換クエリ

    [データクエリ (HBase 互換)] ページでは、指定したテーブルのクエリやデータの追加ができます。

    既存データのクエリ

    SQL テーブルと HBase テーブル内の既存データをクエリできます。

    1. 左側のナビゲーションペインで、データクエリ > [データクエリ (HBase 互換)] を選択します。

    2. namespace や テーブル などのフィルター条件を設定します。

    3. オプション：[カラムファミリー]、[行キー]、[開始キー]、[終了キー]、[制限] を指定します。

    4. クエリ をクリックします。対象テーブルの既存データが表示されます。

    HBase データの追加

    データを追加できるのは HBase テーブルのみです。この機能は SQL テーブルをサポートしていません。

    1. [追加] をクリックします。

    2. [テーブルデータを追加] ダイアログボックスで、次のパラメーターを入力します。

      パラメーター

      説明

      [Rowkey]

      HBase テーブルの行キーです。

      [列名]

      追加する列の名前です。<カラムファミリー名:列名> の形式でカラムファミリーを指定する必要があります。例：f:name。

      [タイムスタンプ]

      UNIX タイムスタンプのみがサポートされています。

      [値]

      データ値です。サポートされているデータ型のリストについては、基本的なデータ型をご参照ください。

    3. OK をクリックして行を追加します。

    既存データの編集

    SQL テーブルと HBase テーブル内の既存データを編集できます。

    1. 対象行の 操作 列で、編集 をクリックします。image.png

    2. テーブルデータの編集 ダイアログボックスで、タイムスタンプとデータ値を変更します。

    3. OK をクリックして変更を保存します。

    SQL エグゼキュータ

    1. 左側のナビゲーションペインで、データクエリ > [SQL エグゼキュータ] を選択します。

    2. namespace ドロップダウンリストから、名前空間を選択します。名前空間内のテーブルが右側に表示されます。

    3. オプション：16 進数文字列を取得します。手順については、16 進数文字列の取得をご参照ください。

    4. エディターに SQL ステートメントを入力します。

    5. 実行 をクリックします。

      説明

      キーボードショートカットでもステートメントを実行できます。Windows では、CTRL+ENTER キーを押します。macOS では、COMMAND+RETURN キーを押します。

    16 進数文字列の取得

    HBase テーブルの特定の行をクエリする場合や、varbinary フィールドで条件付きクエリを実行する場合、値として 16 進数文字列を使用する必要があります。たとえば、行キー r1 の行をクエリする場合、SQL ステートメントの WHERE 句は WHERE ROW='7321' となります。ここで、7321 は r1 の 16 進数文字列です。データクエリページには、これらの 16 進数文字列を生成するための変換ツールが用意されています。

    1. 左側のナビゲーションペインで、データクエリ > [SQL エグゼキュータ] を選択します。

    2. namespace ドロップダウンリストから、名前空間を選択します。名前空間内のテーブルが右側に表示されます。

    3. 変換された 16 進数文字列を取得します。

      • 方法 1：実行 をクリックして対象テーブルの構造を表示します。対象の文字列を [バイナリから 16 進数文字列への変換] テキストボックスに入力します。変換結果はエディターの上部に表示されます。image.png

      • 方法 2：[HexString] スイッチをオンにして 実行 をクリックします。実行結果には、値が 16 進数文字列に変換されて表示されます。

    4. エディターで SQL ステートメントを記述し、元の値を変換後の 16 進数文字列に置き換えます。

      たとえば、元のクエリステートメントが SELECT * FROM task WHERE ROW = "xxxx1"; の場合、更新後のステートメントは SELECT * FROM task WHERE ROW = "7878787831"; となります。

    1. 実行 をクリックします。