ApsaraDB for HBase:Quick start

前提条件

開始する前に、以下が準備できていることを確認してください：

• HBase 拡張版の Shell アクセスページからダウンロードし、使用手順に従って設定した最新バージョンの HBase Shell

• ご利用の HBase クラスターに設定されたホワイトリスト

• Web コンソールにアクセス可能な実行中の検索インスタンス

ステップ 1：HBase クラスターにテーブルを作成する

HBase Shell で次のコマンドを実行して、カラムファミリー f を持つ testTable という名前のテーブルを作成します：

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

ステップ 2：検索インスタンスにインデックスを作成する

1. 検索インスタンスの詳細ページで、[データベース接続] をクリックします。

2. [Web UI へのアクセス] セクションで、Web コンソールを開きます。

   Web コンソールにアクセスする前に、ホワイトリストを設定し、パスワードを設定してください。

   

3. 他のすべてのパラメーターはデフォルト値のまま、以下の設定でコレクションを作成します：

   パラメーター	値
   config set	_indexer_default
   numShards	クラスター内のノード数

   

ステップ 3：マッピングの作成

マッピングは、どの HBase カラムを Solr フィールドに同期するかを定義します。この例では、testTable の f:name カラムが democollection コレクションの name_s フィールドにマッピングされます。ここで、f はカラムファミリー、name はカラム修飾子です。

schema.json という名前のファイルに、以下の内容を記述して作成します：

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

スキーマの主要なフィールド：

サポートされているパラメーターの完全なリストについては、「HBase のフルテキストインデックスの管理」をご参照ください。

以下を実行してマッピングを適用します：

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

コマンドが実行されると、ソースカラムと送信先カラム間のマッピングが作成されます。

ステップ 4：HBase にデータを書き込む

testTable にサンプルレコードを書き込みます：

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

ステップ 5：検索インスタンスでデータをクエリする

1. 検索サービスの Web コンソールを開きます。

2. democollection インデックスを選択します。

3. [クエリ] をクリックしてデータを検索します。

   

ステップ 4 で書き込んだレコードが結果に表示されます。各結果には ID フィールドが含まれており、これは HBase の対応する行の行キーです。

ステップ 6：元の HBase レコードを検索する

検索サービスは、マッピングファイルで定義されたカラムのみを同期し、HBase の行全体は同期しません。完全なレコードを取得するには、検索結果の ID 値を行キーとして使用し、HBase に直接クエリを実行します。

次のステップ

• 高度なマッピングオプションについては、「HBase のフルテキストインデックスの管理」をご参照ください。