すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB for HBase:クイックスタート

最終更新日:Jan 16, 2025

HBase Shell の最新バージョンをダウンロードします。使用手順に基づいて HBase Shell を構成し、HBase クラスタのホワイトリストを構成します。

HBase クラスタでのテーブルの作成

hbase(main):002:0> create 'testTable', {NAME => 'f'}

上記のコマンドは、HBase にテーブルを作成するために使用されます。作成されるテーブルの名前は testTable で、列ファミリは f です。

Search インスタンスでのインデックスの作成

Search インスタンスの詳細ページで、データベース接続 をクリックし、Web UI にアクセス セクションを見つけます。注: Web コンソールにアクセスする前に、ホワイトリストを構成し、パスワードを設定する必要があります。Cluster
config set パラメーターを構成セットとして _indexer_default に設定し、numShards パラメーターをノード数に設定し、他のパラメーターについてはデフォルト値を保持します。次の図を参照してください。Collection

マッピングの作成

たとえば、testTable テーブルの f:name 列を democollection コレクションの name_s 列にマッピングする必要があるとします。 f:name 列の場合、f は列ファミリで、name は列の名前です。 schema.json という名前のファイルに、次のデータを JavaScript Object Notation(JSON)形式で書き込むことができます。

{
  "sourceNamespace": "default",
  "sourceTable": "testTable",
  "targetIndexName": "democollection",
  "indexType": "SOLR",
  "rowkeyFormatterType": "STRING",
  "fields": [
    {
      "source": "f:name",
      "targetField": "name_s",
      "type": "STRING"
    }
  ]
}

注: 前述の JSON 文字列のパラメーターの詳細については、「HBase フルテキストインデックスの管理」をご参照ください。

HBase Shell で次のコマンドを実行します。

hbase(main):006:0> alter_external_index 'testTable', 'schema.json'

コマンドが実行されると、ソース列とターゲット列間のマッピングが作成されます。

HBase へのデータの書き込み

次の HBase Shell コマンドは、サンプルデータレコードを HBase に書き込むために使用されます。

hbase(main):008:0> put 'testTable', 'row1', 'f:name', 'foo'
Took 0.1697 seconds

Search インスタンスでのデータのクエリ

Search サービスの Web コンソールで、作成したインデックス democollection を選択し、クエリ をクリックしてサンプルデータレコードをクエリします。Execute Query

HBase テーブルでの元のデータのクエリ

通常、Search サービスは、HBase テーブルの特定の列を Search インスタンスに同期するために使用されます。これは、多次元クエリを必要とする列のみが JSON 形式のマッピングファイルに書き込まれることを意味します。クエリ結果では、各行のデータに ID 列が含まれており、これは HBase テーブルの行の rowkey です。 rowkey を取得したら、HBase テーブルの完全なデータをクエリできます。