ApsaraDB for HBase:フルテキストインデックスの管理

マッピングパラメーター

動的カラム

検索サービスでは、フィールド型を自動的に識別するためにサフィックス命名規則を利用する動的カラムがサポートされています。managed_schema 構成セットで各フィールドを事前定義する必要はありません。

一般的なサフィックスと対応する型は以下のとおりです。

たとえば、name_s は自動的に STRING 型のフィールドとして認識され、age_i は INT 型のフィールドとして認識されます。サポートされるサフィックスの完全な一覧については、「構成セットの更新」をご参照ください。

HBase のデータの型の動作

HBase では、すべてのデータが生のバイト列として格納されます。type パラメーターは、同期時に検索サービスがこれらのバイト列をどのように解釈するかを指定します。

int age = 25;
byte[] ageValue = Bytes.toBytes(age);
put.addColumn(Bytes.toBytes("f"), Bytes.toBytes("age"), ageValue);

String name = "25";
byte[] nameValue = Bytes.toBytes(name);
put.addColumn(Bytes.toBytes("f"), Bytes.toBytes("name"), nameValue);

この例では、f:age は INT 型、f:name は STRING 型です — 両方とも偶然に値 25 を保持しているにもかかわらずです。type を誤って設定すると、検索サービスが誤ったデコードメソッド（たとえば、文字列カラムに対して Bytes.toInt()）を呼び出し、データの同期が破損または失敗する原因になります。

ソースカラムの型とインデックスフィールドの型は一致させる必要はありません。たとえば、f:age は HBase 内で STRING 型として格納されていても、targetField がインデックス内の age_i（INT）を指すように設定できます。検索サービスが値を自動的に変換します。ただし、文字列の値を INT フィールドに変換できない場合（たとえば、INT フィールドに数値以外の値が含まれている場合）は、同期中にエラーが発生します。

現在のマッピングの表示

JSON 形式で完全なマッピングスキーマを取得するには、describe_external_index を実行します。

hbase(main):005:0> describe_external_index 'testTable'

マッピングの変更

alter_external_index を使用して、マッピングスキーマ全体を置き換えます。schema.json ファイルを HBase Shell の起動ディレクトリに配置するか、相対パスまたは絶対パスを指定します。

hbase(main):006:0> alter_external_index 'HBase table name', 'schema.json'

各 alter_external_index の呼び出しは、スキーマ全体を置き換えます。複数のカラムを一度に追加、更新、削除するには、単一の JSON ファイルにすべてのカラムを含めてください。

テーブルからすべてのフィールドマッピングを削除するには、fields を空の配列に設定します。

{
  "sourceNamespace": "default",
  "sourceTable": "testTable",
  "targetIndexName": "democollection",
  "indexType": "SOLR",
  "rowkeyFormatterType": "STRING",
  "fields": []
}

マッピングへのカラムの追加

add_external_index_field を使用して、スキーマ全体を置き換えずに個別のカラムを追加します。

hbase shell> add_external_index_field 'testTable', {FAMILY => 'f', QUALIFIER => 'money', TARGETFIELD => 'money_f', TYPE => 'FLOAT'}

マッピングからのカラムの削除

remove_external_index を使用して、特定のカラムマッピングを削除します。

hbase shell> remove_external_index 'testTable', 'f:name', 'f:age'