SET INDEX
SET INDEX ( aField ; index {; *} )
| 引数 | 型 | 説明 | |
|---|---|---|---|
| aField | Field | → | インデックスを作成または削除するフィールド |
| index | Boolean, Integer | → | True=作成、False=削除、または インデックスを作成: -1=キーワード、 0=デフォルト、1=標準B-Tree、3=クラスタB-Tree |
| * | Operator | → | *を渡すと非同期にインデックスを作成 |
互換性に関する注意
SET INDEX は旧式のコマンドではありますが、これは完全にサポートされており、既存のコードを書き換えることなくアプリケーション内で維持してよいコマンドです。しかしながら、インデックスを管理するためにはCREATE INDEX および DELETE INDEX コマンドを使用した方が、より多くの機能が提供されるため、推奨されています。
説明
SET INDEX には2つのシンタックスがあります。
- 引数indexにブールを渡す場合、コマンドはaFieldに渡したフィールド用のインデックスを作成したり、削除したりします。
- 引数indexに整数を渡す場合、コマンドは指定されたタイプのインデックスを作成します。
index = ブール
フィールドをインデックスするには、indexにTrueを渡します。コマンドはデフォルトタイプのインデックスを作成します。インデックスが既に存在する場合、呼び出しは機能しません。
indexにFalesを渡すと、コマンドはフィールドに関連づけられたすべての標準インデックス (非複合、非キーワード) を削除します。インデックスが存在しない場合、呼び出しは機能しません。
index = 整数
コマンドはaFieldに対して指定されたインデックスを作成します。Index Type テーマにある以下の定数のいずれか1つを渡します。
| 定数 | 型 | 値 | コメント |
|---|---|---|---|
| Cluster BTree Index | 倍長整数 | 3 | クラスタを使用するB-Treeタイプのインデックス。このインデックスタイプは、インデックスが少数のキーを持つ場合、つまり同じ値がデータ内で頻繁に生じる場合に最も適しています。 |
| Default Index Type | 倍長整数 | 0 | 4Dはフィールドに応じて最適なインデックスのタイプを設定します (キーワードインデックスを除く) 。 |
| Keywords Index | 倍長整数 | -1 | キーワードタイプのインデックス。キーワードを複合タイプにすることはできません。fieldsArray配列にはひとつだけフィールドを渡します。 |
| Standard BTree Index | 倍長整数 | 1 | 標準 B-Treeタイプのインデックス。この多目的用のインデックスタイプは4Dの以前のバージョンで使用されています。 |
注: テキスト型のフィールドに設定されたBツリーインデックスは最大で最初の1024文字をインデックス化します。この場合、1024文字以上を含む文字列の検索結果は正しくなりません。
SET INDEX コマンドはロックされたレコードのインデックス付けは行いません。レコードがロック解除されるまで待機します。
オプション引数***を用いて、非同期に（同時に）インデックスが付けられるようになりました。非同期なインデックス付けにより、インデックス付けが終了したかどうかに関係なく、呼び出し側のメソッドの実行をそのまま続行できます。ただし、インデックスが必要なコマンドを実行すると失敗します。
注:
- このコマンドで作成されたインデックスには名前がありません。名前に基づくシンタックスを用いているDELETE INDEX コマンドでそれらのインデックスを削除することはできません。
- 複合インデックスを作成したり削除するために、このコマンドを使用することはできません。
- このコマンドを使用して、CREATE INDEX で作成されたキーワードインデックスを削除することはできません。
配布に関する注意
このコマンドはデータベースストラクチャーを変更するため、読み出し専用のパッケージアプリ(Program Files フォルダ内にまたは.4dz ファイル内にインストールされている.4dc ファイル)のコンテキストにおいては使用することができません。
例題 1
以下の例は、[Customers]IDフィールドにインデックスを付けます。
UNLOAD RECORD([Customers])
SET INDEX([Customers]ID;True)
例題 2
[Customers]Name フィールドを非同期モードでインデックスします:
SET INDEX([Customers]Name;True;*)
例題 3
キーワードインデックスを作成します:
SET INDEX([Books]Summary;Keywords Index)
参照
CREATE INDEX
DELETE INDEX
GET FIELD PROPERTIES
ORDER BY
QUERY
プロパティ
| コマンド番号 | 344 |
| スレッドセーフである | ✓ |