3 データ操作関数
この章では、ストアでデータの読取りおよび書込みを実行するために使用する関数について説明します。一度に複数の単一レコードの読取りまたは書込みをしたり、多くのレコードを1回の操作で読み書きできるようにする関数について説明します。イテレータを返す関数についても説明します。これらを使用して、ストアに含まれる一部またはすべてのレコードを処理できるようになります。
また、この章では、単一の操作順序で編成された複数の書込み操作を実行するために使用する関数についても説明します。つまり、1つのアトミック単位で、新しいレコードを作成する複数のPUT操作を実行してから、これらのレコードを更新する操作、および/またはこれらのレコードを削除するPUT操作を実行できます。これらの順序は、シリアライズ可能な分離を効果的に実現する単一のトランザクションの下で実行されます。
データ操作関数
| データ操作関数 | 説明 |
|---|---|
| kv_delete() |
キーに関連付けられたkey/valueペアを削除します |
| kv_delete_with_options() |
オプションを使用してkey/valueペアを削除します |
| kv_get() |
キーに関連付けられた値を取得します |
| kv_get_with_options() |
オプションに一致する値を取得します |
| kv_put() |
key/valueペアをPUTし、必要に応じて挿入または上書きします |
| kv_put_with_options() |
オプションを使用してkey/valueペアをPUTします |
複数キー操作関数
| 複数キー操作関数 | 説明 |
|---|---|
| kv_init_key_range() |
複数キー操作で使用するためのキー範囲を作成および初期化します |
| kv_init_key_range_prefix() |
接頭辞情報を使用してキー範囲を作成および初期化します |
| kv_iterator_next() |
ストア・イテレータから次のkey/valueペアを返します |
| kv_iterator_next_key() |
ストア・イテレータから次のキーを返します |
| kv_iterator_size() |
ストア・イテレータの要素数を返します |
| kv_multi_delete() |
親キーに関連付けられたすべての子孫key/valueペアを削除します |
| kv_multi_get() |
親キーに関連付けられたすべての子孫key/valueペアを返します |
| kv_multi_get_iterator() |
子孫key/valueペアのトラバースを提供するイテレータを返します |
| kv_multi_get_iterator_keys() |
子孫キーのトラバースを提供するイテレータを返します |
| kv_multi_get_keys() |
親キーに関連付けられた子孫キーを返します |
| kv_parallel_scan_iterator_next() |
パラレル・スキャン・イテレータから次のkey/valueペアを返します |
| kv_parallel_scan_iterator_next_key() |
パラレル・スキャン・イテレータから次のキーを返します |
| kv_parallel_store_iterator() |
パラレル・スキャン・ストア・イテレータを返します |
| kv_parallel_store_iterator_keys() |
ストア・キーのトラバースを提供するパラレル・スキャン・イテレータを返します |
| kv_release_iterator() |
ストア・イテレータを解放します |
| kv_release_parallel_scan_iterator() |
パラレル・スキャン・イテレータを解放します |
| kv_store_iterator() |
すべてのストアのkey/valueペアのトラバースを提供するイテレータを返します |
| kv_store_iterator_keys() |
すべてのストアのキーのトラバースを提供するイテレータを返します |
複数ステップ操作関数
| 複数ステップ操作関数 | 説明 |
|---|---|
| kv_create_delete_op() |
操作シーケンスとともに使用する削除操作を作成します |
| kv_create_delete_with_options_op() |
操作シーケンスとともに使用する削除操作をパラメータとともに作成します |
| kv_create_operations() |
ストア操作のシーケンスを格納するために使用される構造を作成および初期化します |
| kv_create_put_op() |
操作シーケンスとともに使用するPUT操作を作成します |
| kv_create_put_with_options_op() |
操作シーケンスとともに使用するPUT操作をパラメータとともに作成します |
| kv_execute() |
操作を実行します |
| kv_operation_get_abort_on_failure() |
実行が失敗した場合に操作全体が異常終了するかどうかを返します |
| kv_operation_get_key() |
操作に関連付けられたキーを返します |
| kv_operation_get_type() |
操作タイプを返します |
| kv_operation_results_size() |
操作の結果セットのサイズを返します |
| kv_operations_set_copy() |
ユーザー指定の構造およびバッファをコピーする操作のリストを構成します |
| kv_operations_size() |
操作構造の操作数を返します |
| kv_release_operation_results() |
操作の実行によって取得した結果を解放します |
| kv_release_operations() |
操作構造を解放します |
| kv_result_get_previous_value() |
PUTまたは削除操作の場合、キーに関連付けられた前の値を返します |
| kv_result_get_previous_version() |
PUTまたは削除操作の場合、キーに関連付けられたバージョンまたは前の値を返します |
| kv_result_get_success() |
操作が成功したかどうかを返します |
| kv_result_get_version() |
PUT操作の場合、新しいkey/valueペアのバージョンを返します |
ラージ・オブジェクト操作関数
| ラージ・オブジェクト操作関数 | 説明 |
|---|---|
| kv_lob_delete() |
LOBを削除します |
| kv_lob_get_for_read() |
読取り操作用のLOBハンドルをオープンします |
| kv_lob_get_for_write() |
書込み操作用のLOBハンドルをオープンします |
| kv_lob_get_version() |
LOB key/valueペアのバージョンを返します |
| kv_lob_put_from_file() |
LOB key/valueペアをPUTし、必要に応じて挿入または上書きします |
| kv_lob_read() |
ストアからLOBを読み取ります |
| kv_lob_release_handle() |
LOBハンドルを解放します |