索引の作成および管理

索引は、データベース表からデータを効率的に取得できるようにするデータベース構造です。索引を使用すると、検索対象のキーが索引に含まれている場合に表の行にすばやくアクセスできます。

索引は、データの各行がエントリと呼ばれる順序付きマップです。索引は、アトミック・データ型、配列、マップ、JSONおよびGeoJSONデータに対して作成できます。索引には、次の特別な値を格納できます。
  • NULL
  • EMPTY
  • json null (JSON索引にのみ適用可能)

例のとおりに操作する場合は、スクリプトbaggageschema_loaddata.sqlおよびacctstream_loaddata.sqlをダウンロードし、次に示すように実行します。このスクリプトにより、例で使用する表が作成され、表にデータがロードされます。

KVSTOREまたはKVLiteを起動し、SQL.shellを開きます。
java -jar lib/kvstore.jar kvlite -secure-config disable
java -jar lib/sql.jar -helper-hosts localhost:5000 -store kvstore
loadコマンドを使用して、スクリプトを実行します。
load -file baggageschema_loaddata.sql
load -file acctstream_loaddata.sql

索引の分類

索引は、フィールド、スキーマ、エントリまたはそれらの組合せに基づいて分類できます。


images_types.pngの説明が続きます
図images_types.pngの説明

単一フィールド索引: 索引は、表の1つのみのフィールドに対して作成される場合、単一フィールド索引と呼ばれます。

コンポジット索引: 索引は、表の複数のフィールドに対して作成される場合、コンポジット索引と呼ばれます

固定スキーマ索引: 索引は、索引付けされるすべてのフィールドが強く型指定されたデータである場合、固定スキーマ索引と呼ばれます。

ノート:

データ型は、ワイルドカード・タイプのいずれでもない場合は正確とみなされます。正確な型を持つ項目は、厳密に型指定されます。

スキーマレス索引(JSON索引): 索引は、少なくとも1つのフィールドがJSONデータまたはJSONデータ内のフィールドである場合、JSON索引と呼ばれます。

単純索引: 索引は、表のそれぞれのデータ行に対して索引に1つのエントリが作成される場合、単純索引と呼ばれます。

複数キー索引: 索引は、表のそれぞれのデータ行に対して索引に複数のエントリが作成される場合、複数キー索引と呼ばれます。

索引の作成

索引は、CREATE INDEXコマンドを使用して作成できます。

単一のフィールド索引の作成:

例: 乗客予約コードに対する索引を作成します。
CREATE INDEX fixedschema_conf ON baggageInfo(confNo)

これは単一列の固定スキーマ索引の例です。索引は、baggageInfo表のstringデータ型を持つconfNoフィールドに対して作成されます。

コンポジット索引の作成:

例: 乗客のフルネームと電話番号に対する索引を作成します。
CREATE INDEX compindex_namephone ON baggageInfo(fullName,contactPhone)
これはコンポジット索引の例です。索引は、baggageInfoスキーマの2つのフィールド(フルネームと連絡先電話番号)に対して作成されます。

ノート:

この索引の1つ以上のフィールドを固定スキーマ列として指定できます。

JSON索引の作成:

索引は、少なくとも1つのフィールドがJSONデータ内にある場合、JSON索引と呼ばれます。JSONはスキーマレスであるため、索引付けされたJSONフィールドのデータ型は行間で異なることがあります。JSONフィールドに索引を作成するときに、JSONフィールドに必要なデータ型が不明な場合は、anyAtomicデータ型を使用できます。または、Oracle NoSQL Databaseアトミック・データ型のいずれかを指定できます。これを行うには、JSONフィールドへのすべての索引パスの横でASキーワードを使用してデータ型を宣言します。

例1: 乗客の手荷物のタグ番号に対する索引を作成します。
CREATE INDEX jsonindex_tagnum ON baggageInfo(bagInfo[].tagnum as INTEGER)

これはJSON索引の例です。索引は、baggageInfo表のbaginfo JSONフィールドに存在するtagnumフィールドに対して作成されます。索引の作成時にtagnumフィールドのデータ型を指定します。

宣言されたデータ型に違反するデータを持つ行が関連表に含まれている場合、JSON索引の作成は失敗します。同様に、JSON索引の作成後、新しい行がJSON索引で宣言されたデータ型に準拠していない場合、挿入/更新操作は失敗します。

例2: 乗客のルートに対する索引を作成します。
CREATE INDEX jsonindex_routing ON baggageInfo(bagInfo[].routing as ANYATOMIC)
anyAtomicとしてのJSON索引パスの宣言には、索引付けされたJSONフィールドに様々なデータ型の値を格納できるという利点があります。索引エントリは昇順でソートされます。これらの値が索引に格納されると、次のようにソートされます。
  • 数値
  • 文字列
  • ブール

ただし、この利点は領域およびCPUコストによって相殺されます。これは、索引付きフィールドの任意の種類の数値が、索引に格納される前に数値にキャストされるためです。このキャストにはCPU時間がかかり、結果として得られる数値の記憶域は、元の数値の記憶域より大きくなります。

単純索引の作成:

索引は、表のデータ行ごとに1つのエントリが索引に作成される場合、単純索引と呼ばれます。索引は、アトミック・データ型の単一の値または任意の特別な値(SQL NULL、JSON NULL、EMPTY)を返します。基本的に、単純索引の索引パスは、配列、マップまたはネストされたデータ型を返すことはできません。

例: 手荷物が最後に確認された日時、最後に確認されたステーションおよび到着日時という3つのフィールドに対する索引を作成します。
CREATE INDEX simpleindex_arrival ON baggageInfo(bagInfo[].lastSeenTimeGmt as ANYATOMIC,
bagInfo[].bagArrivalDate as ANYATOMIC, bagInfo[].lastSeenTimeStation as ANYATOMIC)

これはJSONフィールドのJSONドキュメントに対して作成される単純索引の例です。索引は、lastSeenTimeGmtbagArrivalDateおよびlastSeenTimeStationに対して作成されます。これらはすべて、baggageInfo表のinfo JSONフィールドのbagInfo JSONドキュメントからのフィールドです。単純な索引パスの評価で空の結果が返された場合、特別な値EMPTYが索引エントリとして使用されます。前述の例で、bagInfo JSONドキュメントにlastSeenTimeGmtbagArrivalDateまたはlastSeenTimeStationエントリがない場合、あるいはbagInfo JSON配列がない場合は、特殊な値EMPTYが索引付けされます。

複数キー索引の作成:

索引は、表のそれぞれのデータ行に対して索引に複数のエントリが作成される場合、複数キー索引と呼ばれます。複数キー索引には、配列またはネストされたデータ型を使用する索引パスが少なくとも1つ存在あります。複数キー索引では、表の行ごとに、索引付けされる配列のすべての要素に対して索引エントリが作成されます。

例1: 複数キー索引: ストリーミング・アカウント・アプリケーションの系列情報配列に対する索引を作成します。
CREATE INDEX multikeyindex1 ON stream_acct (acct_data.seriesInfo[] AS ANYATOMIC);

索引は、stream_acct表のseriesInfo[]配列に対して作成されます。ここでは、stream_acct表の各行に含まれるseriesInfo[]配列のすべての要素が索引付けされます。

例2: ネストされた複数キー索引: ストリーミング・アカウント・アプリケーションのエピソード詳細配列に対する索引を作成します。

索引は、別の配列内に存在する配列内に存在するフィールドに作成される場合、ネストされた複数キー索引です。
CREATE INDEX multikeyindex2 ON stream_acct (
    acct_data.seriesInfo[].episodes[]  AS ANYATOMIC);

これは別の配列内に存在する配列にフィールドが存在する、ネストされた複数キー索引の例です。索引は、stream_acct表のacct_data JSONのseriesInfo[]配列にあるepisodes[]配列に対して作成されます。

例3: コンポジット複数キー索引:

索引は、索引が複数のフィールドに作成され、それらのフィールドの少なくとも1つが複数キーである場合、コンポジット複数キー索引と呼ばれます。コンポジット複数キー索引には、複数キー索引パスと単純索引パスの組合せを使用できます。
CREATE INDEX multikeyindex3 ON stream_acct (acct_data.country AS ANYATOMIC,
acct_data.seriesInfo[].episodes[]  AS ANYATOMIC);

これは1つの複数キー索引パスと1つの単純索引パスを持つコンポジット複数キー索引の例です。索引は、stream_acct表のacct_data JSON列のepisodes[]配列にあるcountryフィールドに対して作成されます。

複数キー索引の制限について学習するには、複数キー索引の仕様および制限に関する項を参照してください。

NO NULLS句を使用した索引の作成

オプションのWITH NO NULLS句を使用して索引を作成できます。その場合、索引付きフィールドのNULLまたはEMPTY (あるいはその両方)の値を持つ行は索引付けされません。
CREATE INDEX nonull_phone ON baggageInfo (contactPhone) WITH NO NULLS;
  • 前述の問合せでは、乗客の電話番号に対する索引が作成されます。一部の乗客に電話番号がない場合、それらのフィールドは索引に含められません。
  • WITH NO NULLS句を使用して作成された索引は、索引付けされたフィールドにNULL値またはEMPTY値(あるいはその両方)が大量に含まれている場合に便利です。これにより、索引付け時の時間と領域のオーバーヘッドが削減されます。
  • ただし、問合せによるこのような索引の使用は制限されています。WITH NO NULLS句を指定して索引を作成した場合、IS NULL条件とNOT EXISTS条件は、その索引の索引条件として使用できません。
  • 実際には、そのような索引は、問合せの索引付きフィールドごとに索引条件がある場合にのみ、問合せで使用できます。

行ごとに一意キーを使用した索引の作成

行ごとの一意キーというプロパティを持つ索引を作成できます。
CREATE INDEX idx_showid ON 
stream_acct(acct_data.contentStreamed[].showId AS INTEGER)
WITH UNIQUE KEYS PER ROW;

前述の問合せでは、索引はshowIdに対して作成され、単一のcontentStreamed配列に重複するshowIdは存在できません。これにより、問合せプロセッサは、ストリーミング・ユーザーの場合、contentStreamed配列に同じshow IDを持つ2つ以上のshowを含めることはできないという通知を受信します。重複したshow IDが存在する場合は索引に含まれないため、この制限が必要となります。1つのcontentStreamed配列に、同じshowIdを持つ2つ以上の項目が含まれる行を挿入すると、エラーがスローされ、挿入操作は成功しません。

問合せ実行時間の最適化:

行ごとに一意キーを持つ索引を作成すると、索引に含まれるエントリはcontentStreamed配列の要素数より少なくなります。この索引を使用する効率的な問合せを記述できます。このような索引を問合せで使用すると、索引が使用されなかった場合よりもFROM句の結果が少なくなります。

索引の表示

データベース内の索引を表示できます。

SHOW INDEXES

SHOW INDEXES文は、指定した表に存在する索引のリストを提供します。出力をJSON形式にする場合、オプションのAS JSONを指定できます。

例1: BaggageInfo表に対する索引をリストします。
SHOW INDEXES ON baggageInfo

indexes
  jsonindex_routing
  jsonindex_tagnum
  simpleindex_arrival
  nonull_phone
例2: BaggageInfo表に対する索引をJSON形式でリストします。
SHOW AS JSON INDEXES ON baggageInfo
{"indexes"  :
["jsonindex_routing","jsonindex_tagnum","simpleindex_arrival"]}

DESCRIBE INDEX

DESCRIBE INDEX文は、表の指定された索引を定義します。出力をJSON形式にする場合、オプションのAS JSONを指定できます。

索引の説明には、次の情報が含まれます。
  • 索引が定義される表の名前。
  • 索引の名前。
  • 索引のタイプ。索引が主索引であるか2次索引であるか。
  • 索引が複数キーかどうか。索引が複数キーの場合は、「Y」が表示されます。それ以外の場合は、「N」が表示されます。
  • 索引が定義されるフィールドのリスト。
  • 索引の宣言された型。
  • 索引の説明。
例1: 索引multikeyindex3を記述します。
DESCRIBE INDEX multikeyindex3 ON stream_acct; 
+-------------+----------------+-----------+----------+-----------------------------------+--------------+-------------+ 
table       |  name          | type      | multiKey | fields                            | declaredType | description
+-------------+----------------+-----------+----------+-----------------------------------+--------------+-------------+
stream_acct | multikeyindex3 | SECONDARY | Y        | acct_data.country                 | ANY_ATOMIC   |                                   | |             |  
            |                |           |          | acct_data.seriesInfo[].episodes[] | ANY_ATOMIC   |            
+-------------+----------------+-----------+----------+-----------------------------------+--------------+-------------+

例2: 索引multikeyindex2をJSON形式で記述します。

DESCRIBE AS JSON INDEX multikeyindex2 ON stream_acct;
{
  "name" : "multikeyindex2",
  "type" :  "secondary",  
  "fields" :["acct_data.seriesInfo[].episodes[]"],  
  "types" : ["ANY_ATOMIC"],  
  "withNoNulls" : false, 
  "withUniqueKeysPerRow" : false
}

索引の削除

不要になった索引をデータベースから削除できます。

DROP INDEXは、指定された索引をデータベースから削除します。指定した名前の索引が存在しない場合、文は失敗し、エラーがレポートされます。オプションのIF EXISTS句がDROP INDEX文で使用され、同じ名前の索引が存在しない場合、その文は実行されず、エラーはレポートされません。

例: 索引multikeyindex1を削除します。
DROP INDEX multikeyindex1 ON stream_acct