集合メソッドはPLサブプログラムに属し、集合情報を返す関数または集合を操作する手続きのいずれかです。
適用対象
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
集合メソッドにより、集合の使用と保守が容易になります。
説明
空集合に対して、EXISTSは定義済み例外COLLECTION_IS_NULLを発生させない唯一の集合メソッドです。
OceanBaseデータベースでサポートされている集合メソッドは以下の表のとおりです。
メソッド |
タイプ |
説明 |
|---|---|---|
| DELETE | ストアドプロシージャ | コレクション内の要素を削除します。 |
| TRIM | ストアドプロシージャ | 可変配列またはネスト表の末尾から要素を削除します。 |
| EXTEND | ストアドプロシージャ | 要素を可変配列またはネスト表の末尾に追加します。 |
| EXISTS | 関数 | 指定された可変配列またはネスト表の要素が存在する場合にのみ、TRUE を返します。 |
| FIRST | 関数 | コレクション内の最初のインデックスを返します。 |
| LAST | 関数 | コレクション内の最後のインデックスを返します。 |
| COUNT | 関数 | コレクション内の要素数を返します。 |
| LIMIT | 関数 | コレクションが収容できる最大要素数を返します。 |
| PRIOR | 関数 | 指定されたインデックスの前のインデックスを返します。 |
| NEXT | 関数 | 指定されたインデックスの次のインデックスを返します。 |
集合メソッドを呼び出す基本構文は以下のとおりです：
collection_name.method
集合メソッドは、その型（関数または手続き）のPLサブプログラム内で呼び出すことができますが、SQLステートメント内では呼び出せません。
サブプログラム内では、集合パラメータはバインドされたパラメータの属性を継承します。このようなパラメータに集合メソッドを適用できます。可変配列パラメータの場合、パラメータモードに関係なく、LIMITの値は常にパラメータ型の定義から得られます。